调用DeregisterManagedInstance注销一个托管实例。注销后您将无法再使用云助手向实例发送命令或文件。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DeregisterManagedInstance | 系统规定参数。取值:DeregisterManagedInstance。 |
RegionId | String | 是 | cn-hangzhou | 地域ID。目前支持的地域:华北1(青岛)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华北6(乌兰察布)、华东1(杭州)、华东2(上海)、华南1(深圳)、华南2(河源)、华南3(广州)、西南1(成都)、中国香港、新加坡、日本(东京)、美国(硅谷)、美国(弗吉尼亚)。 您可以调用DescribeRegions查看地域对应的ID等信息。 |
InstanceId | String | 是 | mi-hz01axdfas**** | 托管实例ID。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 4ECEEE12-56F1-4FBC-9AB1-890F74942176 | 请求ID。 |
Instance | Object | 托管实例的信息组成的集合。 |
|
LastInvokedTime | String | 2021-01-20T09:00:40Z | 最后一次执行云助手任务的时间。 |
InternetIp | String | 47.8.**.** | 托管实例的公网IP。 |
Hostname | String | test-Hostname | 托管实例主机名。 |
InstanceId | String | mi-hz01axdfas**** | 托管实例ID。 |
ActivationId | String | 4ECEEE12-56F1-4FBC-9AB1-890F7494**** | 激活码ID。 |
IntranetIp | String | 10.0.**.** | 托管实例的内网IP。 |
AgentVersion | String | 2.2.0.102 | 云助手Agent的版本号。 |
RegistrationTime | String | 2021-01-20T08:57:56Z | 托管实例的注册时间。 |
InstanceName | String | test-InstanceName-001 | 托管实例名称。 |
OsType | String | linux | 托管实例的操作系统。 |
OsVersion | String | Linux_#38~18.04.1-Ubuntu SMP Wed Jan 6 18:26:30 UTC 2021_x86_64 | 操作系统的版本信息。 |
InvocationCount | Long | 2 | 托管实例执行云助手任务的次数。 |
MachineId | String | e03231b37ab14e53b5795ad625fc**** | 托管实例的机器码。 |
ResourceGroupId | String | rg-123****** | 托管实例所属的资源组ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DeregisterManagedInstance
&InstanceId=mi-hz01axdfas****
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
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
格式
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"
}
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | RegionId.ApiNotSupported | The api is not supported in this region. | 指定地域下不支持调用 API。请检查 RegionId 参数取值是否正确。 |
403 | Operation.Forbidden | The operation is not permitted. | 该操作是不被允许的。 |
404 | InvalidInstance.NotFound | The specified instance id does not exist. | 指定的实例ID不存在。 |
500 | InternalError.Dispatch | An error occurred when you dispatched the request. | 发送请求时发生错误,请稍后重试。 |
访问错误中心查看更多错误码。