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á.
CreateLogicallyAirGappedBackupVault
Cria um contêiner lógico para o qual os backups podem ser copiados.
Essa solicitação inclui um nome, a região, o número máximo de dias de retenção, o número mínimo de dias de retenção e, opcionalmente, pode incluir tags e um ID de solicitação do criador.
nota
Não inclua dados confidenciais, como números de passaporte, no nome de um cofre de backup.
Sintaxe da Solicitação
PUT /logically-air-gapped-backup-vaults/backupVaultName
HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string
" : "string
"
},
"CreatorRequestId": "string
",
"MaxRetentionDays": number
,
"MinRetentionDays": number
}
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 logicamente isolados são identificados por nomes que são exclusivos da conta usada para criá-los e a região em que são criados.
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 etiquetas a serem atribuídas ao cofre.
Tipo: mapa de string para string
Obrigatório: não
- CreatorRequestId
-
O ID da solicitação de criação.
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
- MaxRetentionDays
-
O período máximo de retenção durante o qual o cofre retém seus pontos de recuperação. Se esse parâmetro não estiver especificado, o AWS Backup não aplicará um período máximo de retenção nos pontos de recuperação no cofre (permitindo armazenamento indefinido).
Se esse parâmetro for especificado, qualquer trabalho de backup ou cópia para o cofre deverá ter uma política de ciclo de vida com um período de retenção igual ou inferior ao período máximo de retenção. Se o período de retenção do trabalho for maior do que o período máximo de retenção, haverá falha do cofre no trabalho de backup ou de cópia e você deverá modificar as configurações do ciclo de vida ou usar um cofre diferente.
Tipo: longo
Obrigatório: Sim
- MinRetentionDays
-
Essa configuração especifica o período mínimo de retenção que o cofre retém seus pontos de recuperação. Se esse parâmetro não for especificado, o período mínimo de retenção será aplicado.
Se for especificado, qualquer trabalho de backup ou de cópia para o cofre deverá ter uma política de ciclo de vida com um período de retenção igual ou superior ao período mínimo de retenção. Se o período de retenção do trabalho for mais curto do que o período mínimo de retenção, haverá falha do cofre no trabalho de backup ou de cópia e você deverá modificar as configurações do ciclo de vida ou usar um cofre diferente.
Tipo: longo
Exigido: Sim
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "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.
- BackupVaultArn
-
O ARN (Amazon Resource Name) do cofre.
Tipo: sequência
- BackupVaultName
-
O nome de um contêiner lógico onde os backups são armazenados. Os cofres de backup logicamente isolados são identificados por nomes que são exclusivos da conta usada para criá-los e a região em que são criados.
Tipo: string
Padrão:
^[a-zA-Z0-9\-\_]{2,50}$
- CreationDate
-
A data e a hora em que o cofre foi criado.
Esse valor está no formato Unix, Tempo Universal Coordenado (UTC) e 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
- VaultState
-
O estado atual do cofre.
Tipo: sequências
Valores Válidos:
CREATING | AVAILABLE | FAILED
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
- InvalidRequestException
-
Indica que há algo errado com a entrada da solicitação. Por exemplo, um parâmetro é do tipo errado.
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: