GetInstanceScreenshot - : Central de Documentação do Alibaba Cloud

Observações de uso

O ECS retorna a captura de tela da instância codificada em Base64 no formato JPG. Decodifique a imagem após o recebimento. Recomendamos esta operação para solução de problemas e diagnósticos. Observe os seguintes pontos:

A instância deve estar no estado Running.
Não é possível obter capturas de tela de instâncias com tipos descontinuados. Para mais informações, consulte Tipos de instância descontinuados.
Ao chamar esta operação várias vezes para a mesma instância, mantenha um intervalo mínimo de 10 segundos entre as chamadas. Caso contrário, o sistema retornará o erro Throttling.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetInstanceScreenshot	A operação que você deseja executar. Defina o valor como GetInstanceScreenshot.
RegionId	String	Sim	cn-shenzhen	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
InstanceId	String	Sim	i-bp1gbz20g229bvu5****	O ID da instância.
WakeUp	Boolean	Não	false	Especifica se a instância em modo de suspensão deve ser ativada. Valores válidos: true false Valor padrão: false.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
InstanceId	String	i-bp1gbz20g229bvu5****	O ID da instância.
Screenshot	String	iVBORw0KGgoA...AAABJRU5ErkJggg==	A captura de tela da instância codificada em Base64 no formato JPG.

Exemplos

Exemplos de solicitações

http://ecs-cn-hangzhou.example.com/?Action=GetInstanceScreenshot
&InstanceId=i-bp1gbz20g229bvu5****
&RegionId=cn-shenzhen
&WakeUp=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

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

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s	Um parâmetro obrigatório não foi especificado.
404	InvalidParameter	%s	Valor de parâmetro inválido.
405	IncorrectInstanceStatus	%s	Esta operação não pode ser executada na instância no estado atual.
405	NotSupported	%s	Sua operação é inválida.
429	Throttling	%s	A solicitação foi negada devido ao throttling.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.