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

描述

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

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:StopInvocation
RegionId String 地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
InvokeId String 命令进程执行ID。您可以通过接口DescribeInvocations查询所有的InvokeId
InstanceId.N Array 需要停止执行命令的实例列表,最多能指定20台实例ID。N的取值范围为[1, 20]。

返回参数

全是公共返回参数。参阅公共返回参数

示例

请求示例
https://ecs.aliyuncs.com/?Action=StopInvocation
&RegionId=cn-hangzhou
&InvokeId=t-1fad2a8876de47068cc734d57703aa76
&<公共请求参数>
正常返回示例

XML格式

<StopInvocationResponse>
    <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
</StopInvocationResponse>
JSON格式
{
    "RequestId":"E69EF3CC-94CD-42E7-8926-F133B86387C0",
}
异常返回示例

XML格式

<Error>
    <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
    <HostId>ecs.aliyuncs.com</HostId>
    <Code>InvalidInstance.NoClient</Code>
    <Message>The specified instances have no cloud assistant client installed.</Message>
</Error>
JSON格式
{
    "RequestId": "E69EF3CC-94CD-42E7-8926-F133B86387C0",
    "HostId": "ecs.aliyuncs.com",
    "Code": "InvalidInstance.NoClient",
    "Message": "The specified instances have no cloud assistant client installed."
}

错误码

以下为本接口特有的错误码。更多错误码,请访问API错误中心

错误代码 错误信息 HTTP状态码 说明
InvalidInvokeId.NotFound The specified InvokeId does not exist. 400 指定的InvokeId不存在。
MissingParameter.RegionId The input parameter “RegionId” that is mandatory for processing this request is not supplied. 400 您必须指定必需参数RegionId,或者您暂时不能使用指定RegionId里的资源。
MissingParameter.InvokeId The input parameter “InvokeId” that is mandatory for processing this request is not supplied. 400 您必须指定必需参数InvokeId
InvalidRegionId.NotFound The RegionId provided does not exist in our items. 404 指定的RegionId不存在。
InternalError.Dispatch An internal error occurred when dispath the request 500 内部错误,请稍后尝试。