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

ListGateways

Lista os gateways de backup pertencentes a uma Conta da AWS em uma Região da AWS. A lista retornada é solicitada pelo Nome do recurso da Amazon (ARN) do gateway.

Sintaxe da Solicitação

{
   "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.

MaxResults

O número máximo de gateways a serem listados.

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

{
   "Gateways": [ 
      { 
         "GatewayArn": "string",
         "GatewayDisplayName": "string",
         "GatewayType": "string",
         "HypervisorId": "string",
         "LastSeenTime": number
      }
   ],
   "NextToken": "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.

Gateways

Uma lista dos seus gateways.

Tipo: matriz de objetos Gateway

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: ^.+$

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: