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.
# CreateEventSubscription
Erstellt ein Abonnement für Amazon DocumentDB DocumentDB-Ereignisbenachrichtigungen. Für diese Aktion ist ein Thema mit dem Amazon Resource Name (ARN) erforderlich, das mithilfe der Amazon DocumentDB DocumentDB-Konsole, der Amazon SNS SNS-Konsole oder der Amazon SNS SNS-API erstellt wurde. Um einen ARN mit Amazon SNS zu erhalten, müssen Sie ein Thema in Amazon SNS erstellen und das Thema abonnieren. Der ARN wird in der Amazon SNS SNS-Konsole angezeigt.
Sie können den Typ der Quelle (`SourceType`) angeben, über die Sie benachrichtigt werden möchten. Sie können auch eine Liste der Amazon DocumentDB DocumentDB-Quellen (`SourceIds`) bereitstellen, die die Ereignisse auslösen, und Sie können eine Liste von Ereigniskategorien (`EventCategories`) für Ereignisse bereitstellen, über die Sie benachrichtigt werden möchten. Sie können beispielsweise angeben`SourceType = db-instance`, `SourceIds = mydbinstance1, mydbinstance2` und`EventCategories = Availability, Backup`.
Wenn Sie sowohl als auch angeben `SourceIds` (z. B. `SourceType = db-instance` und`SourceIdentifier = myDBInstance1`), werden Sie über alle `db-instance` Ereignisse für die angegebene Quelle informiert. `SourceType` Wenn Sie eine angeben, `SourceType` aber keine angeben`SourceIdentifier`, erhalten Sie eine Benachrichtigung über die Ereignisse für diesen Quelltyp für alle Ihre Amazon DocumentDB DocumentDB-Quellen. Wenn Sie weder das noch das `SourceType` angeben, werden Sie über Ereignisse informiert`SourceIdentifier`, die aus allen Amazon DocumentDB DocumentDB-Quellen generiert wurden, die zu Ihrem Kundenkonto gehören.
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
** SnsTopicArn **
Der Amazon-Ressourcenname (ARN) des SNS-Themas, das für die Ereignisbenachrichtigung erstellt wurde. Amazon SNS erstellt den ARN, wenn Sie ein Thema erstellen und es abonnieren.
Typ: Zeichenfolge
Erforderlich: Ja
** SubscriptionName **
Der Name des Abonnements.
Einschränkungen: Der Name muss weniger als 255 Zeichen lang sein.
Typ: Zeichenfolge
Erforderlich: Ja
** Enabled **
Ein boolescher Wert. Wird auf gesetzt, `true` um das Abonnement zu aktivieren, gesetzt auf, `false` um das Abonnement zu erstellen, aber nicht zu aktivieren.
Typ: Boolesch
Erforderlich: Nein
**EventCategories. EventCategory**N
Eine Liste der Veranstaltungskategorien für eine`SourceType`, die Sie abonnieren möchten.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
**SourceIds. SourceId**N
Die Liste der IDs der Ereignisquellen, für die Ereignisse zurückgegeben werden. Wenn nicht angegeben, werden alle Quellen zur Antwort hinzugefügt. Eine ID muss mit einem Buchstaben beginnen und darf nur ASCII-Buchstaben, Ziffern und Bindestriche enthalten; sie darf nicht mit einem Bindestrich oder zwei aufeinander folgenden Bindestrichen enden.
Einschränkungen:
+ Wenn `SourceIds` angegeben, `SourceType` muss auch angegeben werden.
+ Wenn der Quelltyp eine Instanz ist, `DBInstanceIdentifier` muss a angegeben werden.
+ Wenn der Quelltyp eine Sicherheitsgruppe ist, `DBSecurityGroupName` muss a angegeben werden.
+ Wenn der Quelltyp eine Parametergruppe ist, `DBParameterGroupName` muss a angegeben werden.
+ Wenn der Quelltyp ein Snapshot ist, `DBSnapshotIdentifier` muss a angegeben werden.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
** SourceType **
Der Typ der Quelle, die die Ereignisse generiert. Wenn Sie beispielsweise über Ereignisse informiert werden möchten, die von einer Instanz generiert wurden, würden Sie diesen Parameter auf setzen`db-instance`. Wenn der Wert nicht angegeben ist, werden alle Ereignisse zurückgegeben.
Gültige Werte: `db-instance`, `db-cluster`, `db-parameter-group`, `db-security-group`, `db-cluster-snapshot`
Typ: Zeichenfolge
Erforderlich: Nein
**Tags.Tag.N**
Die Tags, die dem Event-Abonnement zugewiesen werden sollen.
Typ: Array von [Tag](API_Tag.md)-Objekten
Erforderlich: Nein
## Antwortelemente
Das folgende Element wird vom Dienst zurückgegeben.
** EventSubscription **
Detaillierte Informationen zu einer Veranstaltung, die Sie abonniert haben.
Typ: [EventSubscription](API_EventSubscription.md) Objekt
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** EventSubscriptionQuotaExceeded **
Sie haben die maximale Anzahl von Event-Abonnements erreicht.
HTTP-Statuscode: 400
** SNSInvalidTopic **
Amazon SNS hat geantwortet, dass es ein Problem mit dem angegebenen Thema gibt.
HTTP-Statuscode: 400
** SNSNoAuthorization **
Sie sind nicht berechtigt, zum SNS-Thema Amazon Resource Name (ARN) zu veröffentlichen.
HTTP-Statuscode: 400
** SNSTopicArnNotFound **
Das SNS-Thema Amazon Resource Name (ARN) existiert nicht.
HTTP-Statuscode: 404
** SourceNotFound **
Die angeforderte Quelle konnte nicht gefunden werden.
HTTP-Statuscode: 404
** SubscriptionAlreadyExist **
Der angegebene Abonnementname ist bereits vorhanden.
HTTP-Statuscode: 400
** SubscriptionCategoryNotFound **
Die angegebene Kategorie ist nicht vorhanden.
HTTP-Statuscode: 404
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateEventSubscription)