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à.
# CreateEventSubscription
Crea un abbonamento per la notifica degli eventi di Amazon DocumentDB. Questa azione richiede un argomento Amazon Resource Name (ARN) creato utilizzando la console Amazon DocumentDB, la console Amazon SNS o l'API Amazon SNS. Per ottenere un ARN con Amazon SNS, devi creare un argomento in Amazon SNS e abbonarti all'argomento. L'ARN viene visualizzato nella console Amazon SNS.
Puoi specificare il tipo di fonte (`SourceType`) di cui desideri ricevere una notifica. Puoi anche fornire un elenco di fonti Amazon DocumentDB (`SourceIds`) che attivano gli eventi e puoi fornire un elenco di categorie di eventi (`EventCategories`) per gli eventi di cui desideri ricevere notifiche. Ad esempio, puoi specificare `SourceType = db-instance` `SourceIds = mydbinstance1, mydbinstance2` e`EventCategories = Availability, Backup`.
Se si specificano entrambi `SourceType` e `SourceIds` (ad esempio `SourceType = db-instance` e`SourceIdentifier = myDBInstance1`), si riceve una notifica di tutti gli `db-instance` eventi relativi all'origine specificata. Se specifichi a `SourceType` ma non specifichi a`SourceIdentifier`, riceverai una notifica degli eventi per quel tipo di sorgente per tutte le tue fonti Amazon DocumentDB. Se non specifichi `SourceType` né il`SourceIdentifier`, riceverai una notifica degli eventi generati da tutte le fonti Amazon DocumentDB appartenenti al tuo account cliente.
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
** SnsTopicArn **
L'Amazon Resource Name (ARN) dell'argomento SNS creato per la notifica di eventi. Amazon SNS crea l'ARN quando crei un argomento e ti iscrivi.
Tipo: stringa
Obbligatorio: sì
** SubscriptionName **
Il nome dell'abbonamento.
Vincoli: il nome deve contenere meno di 255 caratteri.
Tipo: stringa
Obbligatorio: sì
** Enabled **
Un valore booleano; impostato `true` per attivare l'abbonamento, impostato per `false` creare l'abbonamento ma non attivarlo.
Tipo: Booleano
Obbligatorio: no
**EventCategories. EventCategory**N.
Un elenco di categorie di eventi a `SourceType` cui desideri iscriverti.
Tipo: array di stringhe
Obbligatorio: no
**SourceIds. SourceId**N.
L'elenco di identificatori di origini di eventi per le quali vengono restituiti gli eventi. Se non è specificato, tutte le origini sono incluse nella risposta. Un identificare deve iniziare con una lettera e deve contenere solo caratteri ASCII, cifre e trattini, non può terminare con un trattino o contenere due trattini consecutivi.
Vincoli:
+ Se `SourceIds` vengono forniti, `SourceType` devono essere forniti anche.
+ Se il tipo di origine è un'istanza, è `DBInstanceIdentifier` necessario fornire a.
+ Se il tipo di origine è un gruppo di sicurezza, è `DBSecurityGroupName` necessario fornire un.
+ Se il tipo di origine è un gruppo di parametri, è `DBParameterGroupName` necessario fornire a.
+ Se il tipo di origine è un'istantanea, è `DBSnapshotIdentifier` necessario fornire a.
Tipo: array di stringhe
Obbligatorio: no
** SourceType **
Il tipo di origine che genera gli eventi. Ad esempio, se desideri ricevere una notifica degli eventi generati da un'istanza, devi impostare questo parametro su. `db-instance` Se questo valore non viene specificato, vengono restituiti tutti gli eventi.
Valori validi: `db-instance`, `db-cluster`, `db-parameter-group`, `db-security-group`, `db-cluster-snapshot`
▬Tipo: stringa
Obbligatorio: no
**Tag.Tag.N**
I tag da assegnare all'abbonamento all'evento.
Tipo: matrice di oggetti [Tag](API_Tag.md)
Obbligatorio: no
## Elementi di risposta
Il servizio restituisce il seguente elemento.
** EventSubscription **
Informazioni dettagliate su un evento a cui ti sei iscritto.
Tipo: oggetto [EventSubscription](API_EventSubscription.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
** EventSubscriptionQuotaExceeded **
Hai raggiunto il numero massimo di iscrizioni agli eventi.
Codice di stato HTTP: 400
** SNSInvalidTopic **
Amazon SNS ha risposto che c'è un problema con l'argomento specificato.
Codice di stato HTTP: 400
** SNSNoAuthorization **
Non sei autorizzato a pubblicare sull'argomento SNS Amazon Resource Name (ARN).
Codice di stato HTTP: 400
** SNSTopicArnNotFound **
L'argomento SNS Amazon Resource Name (ARN) non esiste.
Codice di stato HTTP: 404
** SourceNotFound **
La fonte richiesta non è stata trovata.
Codice di stato HTTP: 404
** SubscriptionAlreadyExist **
Il nome di abbonamento fornito esiste già.
Codice di stato HTTP: 400
** SubscriptionCategoryNotFound **
La categoria fornita non esiste.
Codice di stato HTTP: 404
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateEventSubscription)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateEventSubscription)