ListVirtualMachines - AWS Backup
Sintaxe da SolicitaçãoParâmetros da solicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte Também

ListVirtualMachines

Lista suas máquinas virtuais.

Sintaxe da Solicitação

{
   "HypervisorArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}

Parâmetros da solicitação

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte Parâmetros comuns.

A solicitação aceita os dados a seguir no formato JSON.

HypervisorArn

O Nome do recurso da Amazon (ARN) do hipervisor conectado à sua máquina virtual.

Tipo: string

Restrições de tamanho: tamanho mínimo de 50. Tamanho máximo de 500.

Padrão: ^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$

Obrigatório: Não

MaxResults

O número máximo de máquinas virtuais a serem listadas.

Tipo: número inteiro

Intervalo válido: valor mínimo de 1.

Obrigatório: Não

NextToken

O próximo item após uma lista parcial dos recursos retornados. Por exemplo, se uma solicitação for feita para retornar o número maxResults de recursos, o NextToken permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.000.

Padrão: ^.+$

Obrigatório: Não

Sintaxe da Resposta

{
   "NextToken": "string",
   "VirtualMachines": [ 
      { 
         "HostName": "string",
         "HypervisorId": "string",
         "LastBackupDate": number,
         "Name": "string",
         "Path": "string",
         "ResourceArn": "string"
      }
   ]
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

NextToken

O próximo item após uma lista parcial dos recursos retornados. Por exemplo, se uma solicitação for feita para retornar o número maxResults de recursos, o NextToken permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.000.

Padrão: ^.+$

VirtualMachines

Uma lista de seus objetos VirtualMachine, ordenada por Nomes de recursos da Amazon (ARNs).

Tipo: matriz de objetos VirtualMachine

Erros

Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.

InternalServerException

A operação não teve êxito porque ocorreu um erro interno. Tente novamente mais tarde.

Código de Status HTTP: 500

ThrottlingException

O TPS foi limitado para proteger contra altos volumes de solicitações intencionais ou não intencionais.

Código de Status HTTP: 400

ValidationException

A operação não teve êxito porque ocorreu um erro de validação.

Código de Status HTTP: 400

Consulte Também

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: