Schema di sottoscrizione per Griglia di eventi
Per creare una sottoscrizione di Griglia di eventi, si invia una richiesta all'operazione di sottoscrizione Crea evento. Utilizzare il seguente formato:
PUT /subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/{resource-provider}/{resource-type}/{resource-name}/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01
Ad esempio, per creare una sottoscrizione eventi per un account di archiviazione denominato examplestorage
in un gruppo di risorse denominato examplegroup
, usare il formato seguente:
PUT /subscriptions/{subscription-id}/resourceGroups/examplegroup/providers/Microsoft.Storage/storageaccounts/examplestorage/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01
Il nome della sottoscrizione eventi deve essere composto da 3 a 64 caratteri e solo da a-z, A-Z, 0-9, e "-". L'articolo descrive le proprietà e lo schema per il corpo della richiesta.
Proprietà delle sottoscrizioni eventi
Proprietà | Type | Descrizione |
---|---|---|
destination | object | Oggetto che definisce l'endpoint. |
filter | object | Campo facoltativo per il filtro dei tipi di eventi. |
oggetto destination
Proprietà | Type | Descrizione |
---|---|---|
endpointType | string | Tipo di endpoint per la sottoscrizione (webhook/HTTP, hub eventi o coda). |
endpointUrl | string | URL di destinazione per gli eventi della sottoscrizione di eventi. |
oggetto filter
Proprietà | Type | Descrizione |
---|---|---|
includedEventTypes | array | Corrisponde se il tipo di evento nel messaggio di evento è una corrispondenza esatta a uno di questi nomi di tipo di evento. Genera un errore se il nome dell'evento non corrisponde ad alcuno dei nomi di tipo di evento registrati per l'origine evento. Il valore predefinito corrisponde a tutti i tipi di evento. |
subjectBeginsWith | string | Filtro di corrispondenza del prefisso per il campo dell'oggetto nel messaggio dell'evento. La stringa predefinita o una stringa vuota corrisponde sempre. |
subjectEndsWith | string | Filtro di corrispondenza del suffisso per il campo dell'oggetto nel messaggio dell'evento. La stringa predefinita o una stringa vuota corrisponde sempre. |
isSubjectCaseSensitive | string | Controlla la corrispondenza tra maiuscole e minuscole per i filtri. |
enableAdvancedFilteringOnArrays | boolean | Abilita l'uso di matrici per le chiavi nel filtro avanzato. Per altre informazioni, vedere Filtro avanzato. |
Schema di sottoscrizione di esempio
{
"properties": {
"destination": {
"endpointType": "webhook",
"properties": {
"endpointUrl": "https://example.azurewebsites.net/api/HttpTriggerCSharp1?code=VXbGWce53l48Mt8wuotr0GPmyJ/nDT4hgdFj9DpBiRt38qqnnm5OFg=="
}
},
"filter": {
"includedEventTypes": [ "Microsoft.Storage.BlobCreated", "Microsoft.Storage.BlobDeleted" ],
"subjectBeginsWith": "/blobServices/default/containers/mycontainer/blobs/log",
"subjectEndsWith": ".jpg",
"isSubjectCaseSensitive ": "true"
}
}
}
Passaggi successivi
- Per un'introduzione a Griglia di eventi, vedere Informazioni su Griglia di eventi