All Products
Search
Document Center

:DeregisterManagedInstance

更新時間:Dec 19, 2023

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

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 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.