DeleteActivation -

Usage notes

Before you call this operation to delete an activation code, make sure that the activation code has never been used to register managed instances.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	DeleteActivation	The operation that you want to perform. Set the value to DeleteActivation.
RegionId	String	Yes	cn-hangzhou	The region ID of the activation code. Supported regions: China (Qingdao), China (Beijing), China (Zhangjiakou), China (Hohhot), China (Ulanqab), China (Hangzhou), China (Shanghai), China (Shenzhen), China (Heyuan), China (Guangzhou), China (Chengdu), China (Hong Kong), Singapore, Japan (Tokyo), US (Silicon Valley), and US (Virginia). You can call the DescribeRegions operation to query the most recent region list.
ActivationId	String	Yes	4ECEEE12-56F1-4FBC-9AB1-890F1234****	The ID of the activation code.

Response parameters


Parameter	Type	Example	Description
RequestId	String	4ECEEE12-56F1-4FBC-9AB1-890F74942176	The request ID.
Activation	Object		The activation code and its usage information.
CreationTime	String	2021-01-20T06:00:00Z	The time when the activation code was created.
DeregisteredCount	Integer	0	The number of instances that were deregistered.
InstanceCount	Integer	1	The maximum number of times that the activation code can be used to register managed instances.
Description	String	This is description.	The description of the activation code.
RegisteredCount	Integer	0	The number of instances that were registered.
InstanceName	String	test-InstanceName	The default instance name prefix.
IpAddressRange	String	0.0.0.0/0	The IP addresses of the hosts that can use the activation code.
TimeToLiveInHours	Long	4	The validity period of the activation code. Unit: hours.
ActivationId	String	4ECEEE12-56F1-4FBC-9AB1-890F1234****	The ID of the activation code.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DeleteActivation
&ActivationId=4ECEEE12-56F1-4FBC-9AB1-890F1234****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteActivationResponse>
    <RequestId>4ECEEE12-56F1-4FBC-9AB1-890F74942176</RequestId>
    <Activation>
        <InstanceName>test-InstanceName</InstanceName>
        <DeregisteredCount>0</DeregisteredCount>
        <InstanceCount>1</InstanceCount>
        <Description>This is description.</Description>
        <CreationTime>2021-01-20T06:00:00Z</CreationTime>
        <ActivationId>4ECEEE12-56F1-4FBC-9AB1-890F1234****</ActivationId>
        <RegisteredCount>0</RegisteredCount>
        <TimeToLiveInHours>4</TimeToLiveInHours>
        <IpAddressRange>0.0.0.0/0</IpAddressRange>
    </Activation>
</DeleteActivationResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4ECEEE12-56F1-4FBC-9AB1-890F74942176",
  "Activation" : {
    "InstanceName" : "test-InstanceName",
    "DeregisteredCount" : "0",
    "InstanceCount" : "1",
    "Description" : "This is description.",
    "CreationTime" : "2021-01-20T06:00:00Z",
    "ActivationId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
    "RegisteredCount" : "0",
    "TimeToLiveInHours" : "4",
    "IpAddressRange" : "0.0.0.0/0"
  }
}

Error codes


HttpCode	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	This operation cannot be performed in the specified region. Check whether the RegionId parameter is valid.
403	ActivationId.InUse	The specified activation id is in use.	The specified activation code is in use.
403	Operation.Forbidden	The operation is not permitted.	The operation is not supported.
404	ActivationId.NotFound	The specified activation id does not exist.	The specified activation code is not found.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	An error occurred while the request was being sent. Try again later.

For a list of error codes, see Service error codes.