Todos os produtos
Search
Central de documentação

Elastic Compute Service:GetInstanceScreenshot

Última atualização: Oct 16, 2026

Obtém a captura de tela de uma instância.

Descrição da operação

Após o Elastic Compute Service retornar a captura de tela da instância no formato JPG com codificação Base64, você deve decodificá-la. Você pode chamar esta operação para solucionar falhas. Observe as seguintes precauções:

  • A instância deve estar no estado Running.

  • Não é possível obter capturas de tela para tipos de instância descontinuados.

  • Se você chamar esta operação várias vezes na mesma instância, o intervalo entre as chamadas deve ser de pelo menos 10 segundos. Caso contrário, o código de erro Throttling será retornado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região da instância. Você pode chamar a operação DescribeRegions para consultar a lista mais recente de regiões da Alibaba Cloud.

cn-shenzhen

InstanceId

string

Sim

O ID da instância.

i-bp1gbz20g229bvu5****

WakeUp

boolean

Não

Especifica se a instância hibernada deve ser despertada.

Valor padrão: false.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

InstanceId

string

O ID da instância.

i-bp1gbz20g229bvu5****

Screenshot

string

A captura de tela da instância no formato JPG, retornada como uma string codificada em Base64.

iVBORw0KGgoA...AAABJRU5ErkJggg==

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "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 está ausente.
404 InvalidParameter %s
405 IncorrectInstanceStatus %s
405 NotSupported %s A operação atual é inválida.
429 Throttling %s

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.