调用GetInstanceScreenshot获取实例的截屏信息。

接口说明

云服务器ECS返回Base64编码后的JPG图像格式的实例截屏后,您需要自行解码。您可以在排查故障时调用该接口,并请注意:

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String i-myInstance

实例ID。

RegionId String cn-shenzhen

实例所在地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

Action String GetInstanceScreenshot

系统规定参数。取值:GetInstanceScreenshot

WakeUp Boolean false

是否唤醒处于休眠状态的实例。

默认值:false

返回数据

名称 类型 示例值 描述
InstanceId String i-myInstance

实例ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。

Screenshot String iVBORw0KGgoA...AAABJRU5ErkJggg==

JPG图像格式的实例截屏,返回Base64编码后的图像。

示例

请求示例

http://ecs-cn-hangzhou.example.com/?Action=GetInstanceScreenshot
&InstanceId=i-myInstance
&RegionId=cn-shenzhen
&WakeUp=false
&<公共请求参数>

正常返回示例

XML 格式

<GetInstanceScreenshotResponse>
      <RequestId>22A1933F-AD02-4560-A6A7-53CF2231D942</RequestId>
      <InstanceId>i-j5e42sbbthlokka11***</InstanceId>
      <Screenshot>iVBORw0KGgoA...AAABJRU5ErkJggg==</Screenshot>
</GetInstanceScreenshotResponse>

JSON 格式

{
	"Screenshot":"iVBORw0KGgoA...AAABJRU5ErkJggg==",
	"InstanceId":"i-j5e42sbbthlokka11***",
	"RequestId":"22A1933F-AD02-4560-A6A7-53CF2231D942"
}

错误码

HttpCode 错误码 错误信息 描述
400 MissingParameter %s 缺失必需参数。
404 InvalidParameter %s 参数格式不正确。
405 IncorrectInstanceStatus %s 实例当前的状态不支持该操作。
405 NotSupported %s HPC集群不存在。
429 Throttling %s 请求被流控。

访问错误中心查看更多错误码。