查看雲助手命令的執行結果,在指定 ECS 實例中的實際輸出資訊(Output
)。
描述
當您使用介面 DescribeInvocations 查看命令執行狀態後,如果返回參數 InvokeStatus
為 Finished
,僅表示命令進程執行完成,不代表一定有預期的命令效果,您需要通過 DescribeInvocationResults 中的參數 Output
查看實際的具體執行結果,以實際輸出結果為準。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:DescribeInvocationResults |
RegionId | String | 是 | 地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
InvokeId | String | 是 | 命令執行 ID。命令進程執行 ID。您可以通過介面 DescribeInvocations 查詢 InvokeId 。 |
InstanceId | String | 否 | 實例 ID。 |
PageNumber | Integer | 否 | 當前頁碼,起始值:1 預設值:1 |
PageSize | Integer | 否 | 分頁查詢時設定的每頁行數,最大值:20 預設值:10 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
TotalCount | Integer | 命令總個數 |
PageNumber | Integer | 查詢結果的頁碼 |
PageSize | Integer | 每頁行數 |
InvocationResults | Array | 命令執行結果集(InvocationResultSetType ) |
命令執行結果集 InvocationResultSetType
名稱 | 類型 | 描述 |
---|---|---|
InvocationResult | Array | 實例執行結果類型(InvocationResultType )(如果是一次性執行,則只有一個結果) |
實例執行結果類型 InvocationResultType
名稱 | 類型 | 描述 |
---|---|---|
InvokeId | String | 執行 ID |
InstanceId | String | 實例 ID |
FinishedTime | String | 命令進程的完成時間。如果命令進程出現逾時情況,命令進程的完成時間以 CreateCommand 中指定的參數 TimedOut 為準 |
Output | String | 命令進程完成後的實際結果,輸出內容以 Base 64 編碼的形式傳輸 |
ExitCode | Integer | 命令進程的退出碼:
|
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=DescribeInvocationResults
&RegionId=cn-hangzhou
&InvokeId=t-7d2a745b412b4601b2d47f6a768d3a14
&<公共請求參數>
正常返回樣本
XML 格式
<DescribeInvocationResultsResponse>
<TotalCount>5</TotalCount>
<PageNumber>1</PageNumber>
<PageSize>5</PageSize>
<InvocationResults>
<InvocationResult>
<FinishedTime>2018-01-05 15:45:02</FinishedTime>
<InstanceId>i-uf614fhehhzmxdqw</InstanceId>
<Output>MTU6NDU6MDEK</Output>
<InvokeRecordStatus> Finished<InvokeRecordStatus>
<ExitCode>0</ExitCode>
</InvocationResult>
<InvocationResult>
<FinishedTime>2018-01-05 15:40:02</FinishedTime>
<InstanceId>i-uf614fhehhzmxdqw</InstanceId>
<Output> </Output>
<InvokeRecordStatus> Finished<InvokeRecordStatus>
<ExitCode>0</ExitCode>
</InvocationResult>
<InvocationResult>
<FinishedTime>2018-01-05 15:30:02</FinishedTime>
<InstanceId>i-uf614fhehhzmxdqw</InstanceId>
<Output>MTU6MzA6MDEK</Output>
<ExitCode>0</ExitCode>
</InvocationResult>
<InvocationResult>
<FinishedTime>2018-01-05 15:20:02</FinishedTime>
<InstanceId>i-uf614fhehhzmxdqw</InstanceId>
<Output> </Output>
<ExitCode>0</ExitCode>
</InvocationResult>
<InvocationResult>
<FinishedTime>2018-01-05 15:15:02</FinishedTime>
<InstanceId>i-uf614fhehhzmxdqw</InstanceId>
<Output>MTU6MTU6MDEK</Output>
<ExitCode>0</ExitCode>
</InvocationResult>
</InvocationResults>
<RequestId>"E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
</DescribeInvocationResultsResponse>
JSON 格式
{
"Invocation": {
"TotalCount": 5,
"PageNumber": 1,
"InvocationResults": {
"InvocationResult": [
{
"FinishedTime": "2018-01-05 15:45:02",
"InstanceId": "i-uf614fhehhzmxdqw",
"Output": "MTU6NDU6MDEK",
“InvokeRecordStatus”:“Finished”,
"ExitCode": 0
},
{
"FinishedTime": "2018-01-05 15:40:02",
"InstanceId": "i-uf614fhehhzmxdqw",
“InvokeRecordStatus”:“Finished”,
"Output": "",
"ExitCode": 0
},
{
"FinishedTime": "2018-01-05 15:30:02",
"InstanceId": "i-uf614fhehhzmxdqw",
"Output": "MTU6MzA6MDEK",
"ExitCode": 0
},
{
"FinishedTime": "2018-01-05 15:20:02",
"InstanceId": "i-uf614fhehhzmd3zj4k74",
"Output": "",
"ExitCode": 0
},
{
"FinishedTime": "2018-01-05 15:15:02",
"InstanceId": "i-uf614fhehhzmd3zj4k74",
“InvokeRecordStatus”:“Finished”,
"Output": "MTU6MTU6MDEK",
"ExitCode": 0
}
]
},
"PageSize": 5
},
"RequestId": ""E69EF3CC-94CD-42E7-8926-F133B86387C0"
}
異常返回樣本
XML 格式
<Error>
<RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
<HostId>ecs.aliyuncs.com</HostId>
<Code>MissingParameter.RegionId</Code>
<Message>The input parameter “RegionId” that is mandatory for processing this request is not supplied.</Message>
</Error>
JSON 格式
{
"RequestId": "E69EF3CC-94CD-42E7-8926-F133B86387C0",
"HostId": "ecs.aliyuncs.com"
"Code": "MissingParameter.RegionId"
"Message": "The input parameter “RegionId” that is mandatory for processing this request is not supplied."
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心 。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
MissingParameter.RegionId | The input parameter “RegionId” that is mandatory for processing this request is not supplied. | 400 | 您必須指定必需參數 RegionId ,或者您暫時不能使用指定 RegionId 裡的資源。 |
InvalidParam.pageNumber | The specified parameter is invalid. | 403 | 指定的頁碼不合法。 |
InvalidParam.PageSize | The specified parameter is invalid. | 403 | 指定的頁面大小不合法。 |
InvalidRegionId.NotFound | The RegionId provided does not exist in our items. | 404 | 指定的 RegionId 不存在。 |
InternalError.Dispatch | An internal error occurred when dispatch the request. | 500 | 內部錯誤,請稍後嘗試。 |