PutBackupVaultNotifications - AWS Backup

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: