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á.
Retorna metadados da versão de seus planos de backup, incluindo Amazon Resource Names (ARNs), plano de backup IDs, datas de criação e exclusão, nomes de planos e versão. IDs
Sintaxe da Solicitação
GET /backup/plans/backupPlanId
/versions/?maxResults=MaxResults
&nextToken=NextToken
HTTP/1.1
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- backupPlanId
-
Identifica exclusivamente um plano de backup.
Obrigatório: sim
- MaxResults
-
O número máximo de itens a serem retornados.
Intervalo válido: 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, oNextToken
permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.
Corpo da Solicitação
Essa solicitação não tem corpo.
Sintaxe da resposta
HTTP/1.1 200
Content-type: application/json
{
"BackupPlanVersionsList": [
{
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string" : "string"
},
"ResourceType": "string"
}
],
"BackupPlanArn": "string",
"BackupPlanId": "string",
"BackupPlanName": "string",
"CreationDate": number,
"CreatorRequestId": "string",
"DeletionDate": number,
"LastExecutionDate": number,
"VersionId": "string"
}
],
"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.
- BackupPlanVersionsList
-
Uma matriz de itens da lista de versões contendo metadados sobre seus planos de backup.
Tipo: matriz de objetos BackupPlansListMember
- 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, oNextToken
permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.Tipo: string
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.
Código de status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
Código de status HTTP: 400
- ResourceNotFoundException
-
Um recurso necessário para a ação não existe.
Código de status HTTP: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
Código de status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte: