PutBackupVaultNotifications - AWS Backup
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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"
}

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

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 in formato JSON.

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 Usare Amazon SNS 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 (a titolo di 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

Il nome della risorsa Amazon (ARN) che specifica l'argomento per gli eventi di un vault di backup, 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'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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.

Codice di stato HTTP: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

Codice di stato HTTP: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

Codice di stato HTTP: 400

ServiceUnavailableException

La richiesta non è riuscita a causa di un errore temporaneo del server.

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: