Deregisters a managed instance. After you deregister a managed instance, you can no longer use Cloud Assistant to send commands or files to the instance.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | DeregisterManagedInstance | The operation that you want to perform. Set the value to DeregisterManagedInstance. |
RegionId | String | Yes | cn-hangzhou | The region ID of the managed instance. 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. |
InstanceId | String | Yes | mi-hz01axdfas**** | The managed instance ID. |
Response parameters
Parameter |
Type |
Example |
Description |
RequestId | String | 4ECEEE12-56F1-4FBC-9AB1-890F74942176 | The request ID. |
Instance | Object | The managed instance. |
|
LastInvokedTime | String | 2021-01-20T09:00:40Z | The time when the Cloud Assistant task was last executed. |
InternetIp | String | 47.8.**.** | The public IP address of the managed instance. |
Hostname | String | test-Hostname | The hostname of the managed instance. |
InstanceId | String | mi-hz01axdfas**** | The managed instance ID. |
ActivationId | String | 4ECEEE12-56F1-4FBC-9AB1-890F7494**** | The activation code ID. |
IntranetIp | String | 10.0.**.** | The internal IP address of the managed instance. |
AgentVersion | String | 2.2.0.102 | The version number of Cloud Assistant Agent. |
RegistrationTime | String | 2021-01-20T08:57:56Z | The time when the managed instance was registered. |
InstanceName | String | test-InstanceName-001 | The name of the managed instance. |
OsType | String | linux | The operating system type of the managed instance. |
OsVersion | String | Linux_#38~18.04.1-Ubuntu SMP Wed Jan 6 18:26:30 UTC 2021_x86_64 | The version information about the operating system. |
InvocationCount | Long | 2 | The number of times that Cloud Assistant tasks were executed on the managed instance. |
MachineId | String | e03231b37ab14e53b5795ad625fc**** | The machine code of the managed instance. |
ResourceGroupId | String | rg-123****** | The ID of the resource group to which the managed instance belongs. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=DeregisterManagedInstance
&InstanceId=mi-hz01axdfas****
&RegionId=cn-hangzhou
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DeregisterManagedInstanceResponse>
<RequestId>4ECEEE12-56F1-4FBC-9AB1-890F74942176</RequestId>
<Instance>
<MachineId>e03231b37ab14e53b5795ad625fc****</MachineId>
<AgentVersion>2.2.0.102</AgentVersion>
<InstanceId>mi-hz01axdfas****</InstanceId>
<InvocationCount>2</InvocationCount>
<OsVersion>Linux_#38~18.04.1-Ubuntu SMP Wed Jan 6 18:26:30 UTC 2021_x86_64</OsVersion>
<Hostname>test-Hostname</Hostname>
<ActivationId>4ECEEE12-56F1-4FBC-9AB1-890F7494****</ActivationId>
<RegistrationTime>2021-01-20T08:57:56Z</RegistrationTime>
<IntranetIp>10.0.**.**</IntranetIp>
<InstanceName>test-InstanceName-001</InstanceName>
<InternetIp>47.8.**.**</InternetIp>
<OsType>linux</OsType>
<LastInvokedTime>2021-01-20T09:00:40Z</LastInvokedTime>
</Instance>
</DeregisterManagedInstanceResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "4ECEEE12-56F1-4FBC-9AB1-890F74942176",
"Instance" : {
"MachineId" : "e03231b37ab14e53b5795ad625fc****",
"AgentVersion" : "2.2.0.102",
"InstanceId" : "mi-hz01axdfas****",
"InvocationCount" : "2",
"OsVersion" : "Linux_#38~18.04.1-Ubuntu SMP Wed Jan 6 18:26:30 UTC 2021_x86_64",
"Hostname" : "test-Hostname",
"ActivationId" : "4ECEEE12-56F1-4FBC-9AB1-890F7494****",
"RegistrationTime" : "2021-01-20T08:57:56Z",
"IntranetIp" : "10.0.**.**",
"InstanceName" : "test-InstanceName-001",
"InternetIp" : "47.8.**.**",
"OsType" : "linux",
"LastInvokedTime" : "2021-01-20T09:00:40Z"
}
}
Error codes
HTTP status code |
Error code |
Error message |
Description |
400 | RegionId.ApiNotSupported | The api is not supported in this region. | The operation cannot be called in the specified region. Check whether the region ID specified by the RegionId parameter is valid. |
403 | Operation.Forbidden | The operation is not permitted. | The operation is not supported. |
404 | InvalidInstance.NotFound | The specified instance id does not exist. | The specified instance ID 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.