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.
PutBackupVaultNotifications
Active les notifications sur un coffre-fort de sauvegarde pour la rubrique et les événements spécifiés.
Syntaxe de la requête
PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string" ],
"SNSTopicArn": "string"
}URIParamètres de demande
La demande utilise les URI paramètres 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
La demande accepte les données suivantes au JSON format suivant.
- BackupVaultEvents
-
Tableau d'événements qui indiquent le statut des tâches de sauvegarde des ressources dans le coffre-fort de sauvegarde.
Pour des cas d'utilisation courants et des 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 -
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. Reportez-vous à 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
-
Le nom de la ressource Amazon (ARN) qui spécifie le sujet des événements d'un coffre-fort de sauvegarde ; 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 HTTP corps 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.
HTTPCode de statut : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
HTTPCode de statut : 400
- ResourceNotFoundException
-
Aucune ressource requise pour l'action n'existe.
HTTPCode de statut : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
HTTPCode de statut : 500
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
