Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
PutBackupVaultNotifications
Attiva le notifiche su un vault di backup per l'argomento e gli eventi specificati.
Sintassi della richiesta
PUT /backup-vaults/backupVaultName
/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string
" ],
"SNSTopicArn": "string
"
}
URIParametri di richiesta
La richiesta utilizza i seguenti URI parametri.
- backupVaultName
-
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello:
^[a-zA-Z0-9\-\_]{2,50}$
Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- BackupVaultEvents
-
Un array di eventi che indica lo stato dei processi per il backup delle per il vault di backup.
Per casi d'uso comuni ed esempi di codice, consulta SNSUsare Amazon per tracciare AWS Backup gli eventi.
Sono supportati i seguenti eventi:
-
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
L'elenco seguente include sia gli eventi supportati che gli eventi obsoleti che non sono più in uso (come riferimento). Gli eventi obsoleti non restituiscono stati o notifiche. Consulta l'elenco precedente per gli eventi supportati.
Tipo: matrice di stringhe
Valori validi:
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
Campo obbligatorio: sì
-
- SNSTopicArn
-
L'Amazon Resource Name (ARN) che specifica l'argomento per gli eventi di un backup vault; ad esempio,.
arn:aws:sns:us-west-2:111122223333:MyVaultTopic
Tipo: stringa
Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200 con un corpo vuotoHTTP.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InvalidParameterValueException
-
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
HTTPCodice di stato: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
HTTPCodice di stato: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: