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 eEventCategories = Availability, Backup.
Se si specificano entrambi SourceType e SourceIds (ad esempio SourceType = db-instance eSourceIdentifier = myDBInstance1), si riceve una notifica di tutti gli db-instance eventi relativi all'origine specificata. Se specifichi a SourceType ma non specifichi aSourceIdentifier, riceverai una notifica degli eventi per quel tipo di sorgente per tutte le tue fonti Amazon DocumentDB. Se non specifichi SourceType né ilSourceIdentifier, 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.
- 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
Campo obbligatorio: sì
- SubscriptionName
-
Il nome dell'abbonamento.
Vincoli: il nome deve contenere meno di 255 caratteri.
Tipo: stringa
Campo obbligatorio: sì
- Enabled
-
Un valore booleano; impostato
trueper attivare l'abbonamento, impostato perfalsecreare l'abbonamento ma non attivarlo.Tipo: Booleano
Campo obbligatorio: no
- EventCategories. EventCategoryN.
-
Un elenco di categorie di eventi a
SourceTypecui desideri iscriverti.Tipo: matrice di stringhe
Campo obbligatorio: no
- SourceIds. SourceIdN.
-
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
SourceIdsvengono forniti,SourceTypedevono essere forniti anche. -
Se il tipo di origine è un'istanza, è
DBInstanceIdentifiernecessario fornire a. -
Se il tipo di origine è un gruppo di sicurezza, è
DBSecurityGroupNamenecessario fornire un. -
Se il tipo di origine è un gruppo di parametri, è
DBParameterGroupNamenecessario fornire a. -
Se il tipo di origine è un'istantanea, è
DBSnapshotIdentifiernecessario fornire a.
Tipo: matrice di stringhe
Campo 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-instanceSe 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
Campo obbligatorio: no
- Tag.Tag.N
-
I tag da assegnare all'abbonamento all'evento.
Tipo: matrice di oggetti Tag
Campo 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
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- 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 uno degli AWS SDK specifici della lingua, consulta quanto segue:
