停止一台或多台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 | 內部錯誤,請稍後嘗試。 |