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
}URIParâmetros de solicitação
A solicitação usa os seguintes URI parâmetros.
- 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 seguintes dados no JSON formato.
- 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: string
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.
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.
O valor mínimo aceito é de 7 dias.
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 de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- BackupVaultArn
-
O ARN (Amazon Resource Name) do cofre.
Tipo: string
- 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: string
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.
HTTPCódigo de status: 400
- 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
- InvalidRequestException
-
Indica que há algo errado com a entrada da solicitação. Por exemplo, um parâmetro é do tipo errado.
HTTPCódigo de status: 400
- LimitExceededException
-
Um limite na solicitação foi excedido; por exemplo, o número máximo de itens permitidos em uma solicitação.
HTTPCódigo de status: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
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:
