调用StopInvocation停止一台或多台ECS实例中一条正在进行中(Running)的云助手命令进程。

接口说明

  • 停止单次命令进程后,已经开始执行的实例会继续执行,未开始执行的实例将不再执行。
  • 停止周期命令进程后,已经开始执行的命令将继续执行,但后续将不会再进行下一次的执行。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String StopInvocation

系统规定参数。取值:StopInvocation

RegionId String cn-hangzhou

地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

InvokeId String t-7d2a745b412b4601b2d47f6a768d****

命令执行ID。您可以通过接口DescribeInvocations查询所有的InvokeId。

InstanceId.N String i-bp67acfmxazb4p****

要停止执行命令的实例列表,最多能指定50台实例ID。N的取值范围为1~50。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=StopInvocation
&InvokeId=t-7d2a745b412b4601b2d47f6a768d****
&RegionId=cn-hangzhou
&InstanceId.1=bp67acfmxazb4p****
&<公共请求参数>

正常返回示例

XML格式

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

<StopInvocationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</StopInvocationResponse>

JSON格式

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HttpCode 错误码 错误信息 描述
400 RegionId.ApiNotSupported The api is not supported in this region. 指定地域下不支持调用 API。请检查 RegionId 参数取值是否正确。
403 InstanceIds.ExceedLimit The number of instance IDs exceeds the upper limit. 目标实例数量超过上限。
403 Operation.Forbidden The operation is not permitted. 该操作是不被允许的。
404 InvalidInvokeId.NotFound The specified invoke ID does not exist. 指定的参数 InvokeId 不存在,请确认该参数是否正确。
500 InternalError.Dispatch An error occurred when you dispatched the request. 发送请求时发生错误,请稍后重试。

访问错误中心查看更多错误码。