獲取一台執行個體的系統命令列輸出,資料以 Base 64 編碼後返回。
描述
Elastic Compute Service 是虛擬化的雲上服務,無法接入顯示裝置,也無法手動截屏。但是我們緩存了執行個體最近一次啟動、重啟或者關機時的系統命令列輸出,您可以調用 GetInstanceConsoleOutput
獲取。
已停售的執行個體規格 無法獲取系統命令列輸出。
Windows 執行個體暫不支援獲取系統命令列輸出。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:GetInstanceConsoleOutput |
RegionId | String | 是 | 執行個體所在地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
InstanceId | String | 是 | 執行個體 ID。 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
InstanceId | String | 執行個體 ID。 |
ConsoleOutput | String | 執行個體的系統命令列輸出,根據 Base 64 編碼後輸出。 |
LastUpdateTime | String | 執行個體最近一次啟動、重啟或者關機的時間。參數取值使用 UTC 時間,時區為 UTC+0,按照 ISO8601 標準表示,格式為 YYYY-MM-DDTHH:mm:ssZ。 |
樣本
請求樣本
http://ecs-cn-hangzhou.aliyuncs.com/?Action=GetInstanceConsoleOutput
&RegionId=cn-shenzhen-finance-1
&InstanceId=i-j5e42sbbthlokka11eci
&<公共請求參數>
正常返回樣本
XML 格式
<GetInstanceConsoleOutputResponse>
<RequestId>22A1933F-AD02-4560-A6A7-53CF2231D942</RequestId>
<InstanceId>i-j5e42sbbthlokka11ech</InstanceId>
<LastUpdateTime>2018-03-22 10:04:57</LastUpdateTime>
<ConsoleOutput>V2VsY29tZSB0byBDZW50T1MgCgpDaGVja2luZyBmaWxlc3lzdGVtcwpDaGVja2luZyBhbGwgZmlsZSBzeXN0ZW1zLgpbL3NiaW4vZnNjay5leHQ0ICgxKSAtLSAvXSBmc2NrLmV4dDQgLWEgL2Rldi92ZGExIAovZGV2L3ZkYTE6IGNsZWFuLCAzMjAxNi8yNjIxNDQwIGZpbGVzLCA0NDc5NzQvMTA0ODU1MDQgYmxvY2tzCgpFbnRlcmluZyBub24taW50ZXJhY3RpdmUgc3RhcnR1cApDYWxsaW5nIHRoZSBzeXN0ZW0gYWN0aXZpdHkgZGF0YSBjb2xsZWN0b3IgKHNhZGMpLi4uIAoKQnJpbmdpbmcgdXAgaW50ZXJmYWNlIGV0aDA6ICAKRGV0ZXJtaW5pbmcgSVAgaW5mb3JtYXRpb24gZm9yIGV0aDAuLi4gZG9uZS4KCmFsaXl1bi1zZXJ2aWNlIHN0YXJ0L3J1bm5pbmcsIHByb2Nlc3MgMTczMwpmaW5pc2hlZAoKQ2VudE9TIHJlbGVhc2UgNi44IChGaW5hbCkKS2VybmVsIDIuNi4zMi02OTYuMy4yLmVsNi5pNjg2IG9uIGFuIGk2ODYKCmlaMnplZDk2ZTQ2MmF5cjBxemw2czhaIGxvZ2luOg==</ConsoleOutput>
</GetInstanceConsoleOutputResponse>
JSON 格式
{
"RequestId": "22A1933F-AD02-4560-A6A7-53CF2231D942",
"InstanceId": "i-j5e42sbbthlokka11ech",
"LastUpdateTime": "2018-03-22 10:04:57",
"ConsoleOutput": "V2VsY29tZSB0byBDZW50T1MgCgpDaGVja2luZyBmaWxlc3lzdGVtcwpDaGVja2luZyBhbGwgZmlsZSBzeXN0ZW1zLgpbL3NiaW4vZnNjay5leHQ0ICgxKSAtLSAvXSBmc2NrLmV4dDQgLWEgL2Rldi92ZGExIAovZGV2L3ZkYTE6IGNsZWFuLCAzMjAxNi8yNjIxNDQwIGZpbGVzLCA0NDc5NzQvMTA0ODU1MDQgYmxvY2tzCgpFbnRlcmluZyBub24taW50ZXJhY3RpdmUgc3RhcnR1cApDYWxsaW5nIHRoZSBzeXN0ZW0gYWN0aXZpdHkgZGF0YSBjb2xsZWN0b3IgKHNhZGMpLi4uIAoKQnJpbmdpbmcgdXAgaW50ZXJmYWNlIGV0aDA6ICAKRGV0ZXJtaW5pbmcgSVAgaW5mb3JtYXRpb24gZm9yIGV0aDAuLi4gZG9uZS4KCmFsaXl1bi1zZXJ2aWNlIHN0YXJ0L3J1bm5pbmcsIHByb2Nlc3MgMTczMwpmaW5pc2hlZAoKQ2VudE9TIHJlbGVhc2UgNi44IChGaW5hbCkKS2VybmVsIDIuNi4zMi02OTYuMy4yLmVsNi5pNjg2IG9uIGFuIGk2ODYKCmlaMnplZDk2ZTQ2MmF5cjBxemw2czhaIGxvZ2luOg=="
}
異常返回樣本
XML 格式
<Error>
<RequestId>C38E0D94-C18B-44F3-8C05-6E35BE334088</RequestId>
<HostId>ecs.aliyuncs.com</HostId>
<Code>NotSupported</Code>
<Message>The operation is not supported for "i-j5e42sbbthlokkaXXXXX".</Message>
</Error>
JSON 格式
{
"RequestId": "C38E0D94-C18B-44F3-8C05-6E35BE334088",
"HostId": "ecs.aliyuncs.com",
"Code": "NotSupported",
"Message": "The operation is not supported for "i-j5e42sbbthlokkaXXXXX"."
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心 。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
MissingParameter | The input parameter “instanceId” that is mandatory for processing this request is not supplied. | 400 | 您必須指定參數 InstanceId 。 |
InvalidParameter | The “instanceId” provided is not valid. | 404 | 指定的 InstanceId 不存在。 |
IncorrectInstanceStatus | The instance status “{status}” is not applicable | 405 | 指定的執行個體已被釋放或者已停止。 |
NotSupported | The operation is not supported for “{instanceId}” | 405 | 已停售的執行個體規格 無法獲取系統命令列輸出。 |