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á.
CreateBackupVault
Cria um contêiner lógico onde os backups são armazenados. Uma solicitação CreateBackupVault
inclui um nome, opcionalmente uma ou mais tags de recurso, uma chave de criptografia e um ID de solicitação.
nota
Não inclua dados confidenciais, como números de passaporte, no nome de um cofre de backup.
Sintaxe da Solicitação
PUT /backup-vaults/backupVaultName
HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string
" : "string
"
},
"CreatorRequestId": "string
",
"EncryptionKeyArn": "string
"
}
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- backupVaultName
-
O nome de um contêiner lógico onde os backups são armazenados. Os cofres de backup são identificados por nomes que são exclusivos da conta usada para criá-los e a região da AWS em que são criados. Eles consistem em letras, números e hifens.
Padrão:
^[a-zA-Z0-9\-\_]{2,50}$
Exigido: Sim
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- BackupVaultTags
-
As tags a serem atribuídas ao cofre de backup.
Tipo: mapa de string para string
Obrigatório: não
- CreatorRequestId
-
Uma string exclusiva que identifica a solicitação e permite que as solicitações com falha sejam repetidas sem o risco de a operação ser executada duas vezes. Esse parâmetro é opcional.
Se usado, esse parâmetro deve conter de 1 a 50 caracteres alfanuméricos ou “-_” .
Tipo: sequência
Obrigatório: não
- EncryptionKeyArn
-
A chave de criptografia no lado do servidor usada para proteger seus backups, por exemplo,
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
.Tipo: sequência
Obrigatório: não
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number
}
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.
- BackupVaultArn
-
Um Nome do recurso da Amazon (ARN) que identifica exclusivamente um cofre de backup, por exemplo,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
.Tipo: sequência
- BackupVaultName
-
O nome de um contêiner lógico onde os backups são armazenados. Os cofres de backup são identificados por nomes que são exclusivos da conta usada para criá-los e a região da em que são criados. Eles consistem em letras minúsculas, números e hifens.
Tipo: string
Padrão:
^[a-zA-Z0-9\-\_]{2,50}$
- CreationDate
-
A data e hora em que um cofre de backup foi criado, em formato de hora Unix e Tempo Universal Coordenado (UTC). O valor de
CreationDate
tem precisão de milissegundos. Por exemplo, o valor 1516925490,087 representa sexta-feira, 26 de janeiro de 2018, 0:11:30,087.Tipo: carimbo de data/hora
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- AlreadyExistsException
-
O recurso necessário já existe.
Código de Status HTTP: 400
- 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
- LimitExceededException
-
Um limite na solicitação foi excedido; por exemplo, o número máximo de itens permitidos em uma solicitação.
Código de Status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
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 um dos AWS SDKs específicos da linguagem, consulte o seguinte: