Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Active les notifications sur un coffre-fort de sauvegarde pour la rubrique et les événements spécifiés.
Syntaxe de la demande
PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string" ],
"SNSTopicArn": "string"
}Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- backupVaultName
-
Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms spécifiques pour le compte utilisé pour les créer et la région AWS dans laquelle ils sont créés.
Modèle :
^[a-zA-Z0-9\-\_]{2,50}$Obligatoire : oui
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- BackupVaultEvents
-
Tableau d'événements qui indiquent le statut des tâches de sauvegarde des ressources dans le coffre-fort de sauvegarde.
Pour les cas d'utilisation courants et les exemples de code, consultez Utiliser Amazon SNS pour suivre AWS Backup les événements.
Les événements suivants sont pris en charge :
-
BACKUP_JOB_STARTED|BACKUP_JOB_COMPLETED|BACKUP_JOB_FAILED -
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
Note
La liste ci-dessous inclut à la fois les événements pris en charge et les événements obsolètes qui ne sont plus utilisés (à titre de référence). Les événements déconseillés ne renvoient ni statuts ni notifications. Consultez la liste ci-dessus pour connaître les événements pris en charge.
Type : tableau de chaînes
Valeurs valides :
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_FAILEDObligatoire : oui
-
- SNSTopicArn
-
L'Amazon Resource Name (ARN) qui spécifie la rubrique des événements d'un coffre-fort de secours ; par exemple,
arn:aws:sns:us-west-2:111122223333:MyVaultTopic.Type : String
Obligatoire : oui
Syntaxe de la réponse
HTTP/1.1 200
Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InvalidParameterValueException
-
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.
Code d’état HTTP : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
Code d’état HTTP : 400
- ResourceNotFoundException
-
Aucune ressource requise pour l'action n'existe.
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
Code d’état HTTP : 500
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
