ListRecoveryPointsByResource - AWS Backup
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo da SolicitaçãoSintaxe da respostaElementos de RespostaErrosConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

ListRecoveryPointsByResource

As informações sobre os pontos de recuperação do tipo especificado por um recurso Amazon Resource Name (ARN).

nota

Para a Amazon EFS e a AmazonEC2, essa ação lista apenas os pontos de recuperação criados por AWS Backup.

Sintaxe da Solicitação

GET /resources/resourceArn/recovery-points/?managedByAWSBackupOnly=ManagedByAWSBackupOnly&maxResults=MaxResults&nextToken=NextToken HTTP/1.1

URIParâmetros de solicitação

A solicitação usa os seguintes URI parâmetros.

ManagedByAWSBackupOnly

Esse atributo filtra os pontos de recuperação com base na propriedade.

Se estiver definido comoTRUE, a resposta conterá pontos de recuperação associados aos recursos selecionados que são gerenciados pelo AWS Backup.

Se estiver definido comoFALSE, a resposta conterá todos os pontos de recuperação associados ao recurso selecionado.

Tipo: booliano

MaxResults

O número máximo de itens a serem retornados.

nota

A Amazon RDS exige um valor de pelo menos 20.

Faixa válida: valor mínimo de 1. Valor máximo de 1.000.

NextToken

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

resourceArn

E ARN isso identifica um recurso de forma única. O formato do ARN depende do tipo de recurso.

Obrigatório: Sim

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da resposta

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "BackupSizeBytes": number,
         "BackupVaultName": "string",
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "IsParent": boolean,
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceName": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}

Elementos de Resposta

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

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

NextToken

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

Tipo: string

RecoveryPoints

Uma matriz de objetos que contém informações detalhadas sobre os pontos de recuperação do tipo de recurso especificado.

nota

Somente os pontos de EC2 recuperação da Amazon EFS e da Amazon retornam BackupVaultName.

Tipo: matriz de objetos RecoveryPointByResource

Erros

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

InvalidParameterValueException

Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.

HTTPCódigo de status: 400

MissingParameterValueException

Indica que um parâmetro necessário está ausente.

HTTPCódigo de status: 400

ResourceNotFoundException

Um recurso necessário para a ação não existe.

HTTPCódigo de status: 400

ServiceUnavailableException

Houve falha na solicitação devido a um erro temporário do servidor.

HTTPCódigo de status: 500

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: