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: String
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: String
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 de forma exclusiva um cofre de backup, por exemplo,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.Tipo: String
- 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: sequência
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
CreationDatetem precisão de milissegundos. Por exemplo, o valor 1516925490,087 representa sexta-feira, 26 de janeiro de 2018, 0:11:30,087.Tipo: Timestamp
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- AlreadyExistsException
-
O recurso necessário já existe.
- Arn
- Context
- CreatorRequestId
- Type
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.
- Context
- Type
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.
- Context
- Type
Código de Status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
- Context
- Type
Código de Status HTTP: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
- Context
- Type
Código de Status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
