Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
PutBackupVaultNotifications
Aktiviert Benachrichtigungen auf einem Backup-Tresor für das angegebene Thema und die angegebenen Ereignisse.
Anforderungssyntax
PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string" ],
"SNSTopicArn": "string"
}URIParameter anfordern
Die Anfrage verwendet die folgenden URI Parameter.
- backupVaultName
-
Der Name eines logischen Containers, in dem die Sicherungen gespeichert werden. Backup-Tresore werden durch Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und die AWS -Region, in der sie erstellt wurden, eindeutig sind.
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$Erforderlich: Ja
Anforderungstext
Die Anfrage akzeptiert die folgenden Daten im JSON Format.
- BackupVaultEvents
-
Ein Array von Ereignissen, die den Status der Aufträge zur Sicherung von Ressourcen im Sicherungstresor angeben.
Allgemeine Anwendungsfälle und Codebeispiele finden Sie unter AWS Backup Ereignisse mit Amazon SNS verfolgen.
Folgende Ereignisse werden unterstützt:
-
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
Anmerkung
Die folgende Liste enthält sowohl unterstützte Ereignisse als auch veraltete Ereignisse, die nicht mehr verwendet werden (als Referenz). Veraltete Ereignisse geben keine Statusmeldungen oder Benachrichtigungen zurück. Die unterstützten Ereignisse finden Sie in der obigen Liste.
Typ: Zeichenfolgen-Array
Zulässige Werte:
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_FAILEDErforderlich: Ja
-
- SNSTopicArn
-
Der Amazon-Ressourcenname (ARN), der das Thema für die Ereignisse eines Backup-Tresors angibt, zum Beispiel
arn:aws:sns:us-west-2:111122223333:MyVaultTopic.Typ: Zeichenfolge
Erforderlich: Ja
Antwortsyntax
HTTP/1.1 200
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort mit einem leeren HTTP Text zurück.
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- InvalidParameterValueException
-
Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.
HTTPStatuscode: 400
- MissingParameterValueException
-
Zeigt an, dass ein erforderlicher Parameter fehlt.
HTTPStatuscode: 400
- ResourceNotFoundException
-
Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.
HTTPStatuscode: 400
- ServiceUnavailableException
-
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.
HTTPStatuscode: 500
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
