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á.
PutBackupVaultNotifications
Ativa as notificações em um cofre de backup para o tópico e os eventos especificados.
Sintaxe da Solicitação
PUT /backup-vaults/backupVaultName
/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string
" ],
"SNSTopicArn": "string
"
}
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 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.
Padrão:
^[a-zA-Z0-9\-\_]{2,50}$
Exigido: Sim
Corpo da Solicitação
A solicitação aceita os seguintes dados no JSON formato.
- BackupVaultEvents
-
Uma matriz de eventos que indicam o status de trabalhos para recursos de backup para o cofre de backup.
Para casos de uso comuns e exemplos de código, consulte Usando SNS a Amazon para rastrear AWS Backup eventos.
Os seguintes eventos são compatíveis:
-
BACKUP_JOB_STARTED
|BACKUP_JOB_COMPLETED
-
COPY_JOB_STARTED
|COPY_JOB_SUCCESSFUL
|COPY_JOB_FAILED
-
RESTORE_JOB_STARTED
|RESTORE_JOB_COMPLETED
|RECOVERY_POINT_MODIFIED
-
S3_BACKUP_OBJECT_FAILED
|S3_RESTORE_OBJECT_FAILED
nota
A lista abaixo inclui eventos compatíveis e eventos obsoletos que não estão mais em uso (para referência). Eventos obsoletos não retornam status ou notificações. Consulte a lista acima para ver os eventos suportados.
Tipo: Matriz de strings
Valores Válidos:
BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED
Obrigatório: Sim
-
- SNSTopicArn
-
O Amazon Resource Name (ARN) que especifica o tópico dos eventos de um cofre de backup; por exemplo,.
arn:aws:sns:us-west-2:111122223333:MyVaultTopic
Tipo: string
Obrigatório: Sim
Sintaxe da Resposta
HTTP/1.1 200
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta de HTTP 200 com o HTTP corpo vazio.
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.
HTTPCódigo de status: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
Um recurso necessário para a ação não existe.
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: