查看雲助手命令的執行結果,在指定 ECS 實例中的實際輸出資訊(Output)。

描述

當您使用介面 DescribeInvocations 查看命令執行狀態後,如果返回參數 InvokeStatusFinished,僅表示命令進程執行完成,不代表一定有預期的命令效果,您需要通過 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 命令進程的退出碼:
  • Linux 實例為 Shell 進程的退出碼
  • Windows 實例為 Bat 或者 PowerShell 進程的退出碼

樣本

請求樣本
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 內部錯誤,請稍後嘗試。