az eventgrid event-subscription

Uwaga

Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.

Zarządzanie subskrypcjami zdarzeń.

Zarządzanie subskrypcjami zdarzeń dla tematu usługi Event Grid, domeny, tematu domeny, subskrypcji platformy Azure, grupy zasobów lub dowolnego innego zasobu platformy Azure obsługującego powiadomienia o zdarzeniach.

Polecenia

Nazwa Opis Typ Stan
az eventgrid event-subscription create

Utwórz nową subskrypcję zdarzeń.

Podstawowe funkcje Ogólna dostępność
az eventgrid event-subscription create (eventgrid rozszerzenie)

Utwórz nową subskrypcję zdarzeń.

Numer wewnętrzny Podgląd
az eventgrid event-subscription delete

Usuwanie subskrypcji zdarzeń.

Podstawowe funkcje Ogólna dostępność
az eventgrid event-subscription delete (eventgrid rozszerzenie)

Usuwanie subskrypcji zdarzeń.

Numer wewnętrzny Podgląd
az eventgrid event-subscription list

Wyświetlanie listy subskrypcji zdarzeń.

Podstawowe funkcje Ogólna dostępność
az eventgrid event-subscription list (eventgrid rozszerzenie)

Wyświetlanie listy subskrypcji zdarzeń.

Numer wewnętrzny Podgląd
az eventgrid event-subscription show

Uzyskaj szczegółowe informacje o subskrypcji zdarzeń.

Podstawowe funkcje Ogólna dostępność
az eventgrid event-subscription show (eventgrid rozszerzenie)

Uzyskaj szczegółowe informacje o subskrypcji zdarzeń.

Numer wewnętrzny Podgląd
az eventgrid event-subscription update

Aktualizowanie subskrypcji zdarzeń.

Podstawowe funkcje Ogólna dostępność
az eventgrid event-subscription update (eventgrid rozszerzenie)

Aktualizowanie subskrypcji zdarzeń.

Numer wewnętrzny Podgląd

az eventgrid event-subscription create

Utwórz nową subskrypcję zdarzeń.

az eventgrid event-subscription create --name
                                       [--aad-tenant-id]
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                       [--event-ttl]
                                       [--expiration-date]
                                       [--included-event-types]
                                       [--labels]
                                       [--max-delivery-attempts]
                                       [--max-events-per-batch]
                                       [--preferred-batch-size-in-kilobytes]
                                       [--qttl]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Przykłady

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla grupy zasobów przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure z filtrem określającym prefiks tematu.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Utwórz nową subskrypcję zdarzeń dla grupy zasobów z filtrem określającym sufiks tematu.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i usługi EventHub jako miejsca docelowego.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure Storage jako miejsca docelowego.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure ServiceBusQueue jako miejsca docelowego.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

Utwórz nową subskrypcję zdarzeń dla domeny usługi Event Grid przy użyciu filtrów domyślnych i CloudEvent V 1.0 jako schemat dostarczania.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Utwórz nową subskrypcję zdarzeń dla konta magazynu z docelową nieaktywną lokalizacją docelową i niestandardowymi zasadami ponawiania wynoszącymi maksymalnie 10 prób dostarczenia oraz ttl zdarzenia wynoszącym 2 godziny (w zależności od tego, co nastąpi wcześniej).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120

Utwórz nową subskrypcję zdarzeń dla tematu domeny.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń (dla konta magazynu) z datą wygaśnięcia.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu elementu webhook z włączoną usługą Azure Active Directory jako miejsca docelowego.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu funkcji platformy Azure jako miejsca docelowego.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu usługi EventHub z tożsamością msi przypisaną przez system jako lokalizacją docelową i z elementem deadletter z tożsamością msi

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Tworzenie nowej subskrypcji zdarzeń dla tematu usługi Event Grid przy użyciu kolejki magazynu jako miejsca docelowego z komunikatem o czasie wygaśnięcia o 5 minutach

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Tworzenie nowej subskrypcji zdarzeń dla tematu usługi Event Grid przy użyciu kolejki magazynu z systemassigned tożsamości msi jako miejsca docelowego

az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Tworzenie nowej subskrypcji zdarzeń dla tematu usługi Event Grid z zaawansowanym filtrowaniem włączonym w tablicach

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--aad-tenant-id --azure-active-directory-tenant-id

Identyfikator dzierżawy usługi Azure Active Directory, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczenia. Dotyczy tylko elementu webhook jako miejsca docelowego.

--advanced-filter

Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.

Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter argumentu.

--azure-active-directory-application-id-or-uri

Identyfikator aplikacji usługi Azure Active Directory lub identyfikator URI, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczania. Dotyczy tylko elementu webhook jako miejsca docelowego.

--deadletter-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.

Przykład: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity
Wersja zapoznawcza

Typ tożsamości zasobu docelowego deadletter.

akceptowane wartości: systemassigned
--deadletter-identity-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.

--delivery-attribute-mapping

Dodaj mapowanie atrybutów dostarczania, aby wysyłać dodatkowe informacje za pośrednictwem nagłówków HTTP podczas dostarczania zdarzeń. Ten atrybut jest prawidłowy dla wszystkich typów docelowych z wyjątkiem StorageQueue. Można określić wiele atrybutów przy użyciu więcej niż jednego --delivery-attribute-mapping argumentu.

Użycie: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Statyczne mapowanie atrybutów: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename somevalue Zarówno statyczne, jak i dynamiczne: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Wersja zapoznawcza

Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).

akceptowane wartości: systemassigned
--delivery-identity-endpoint
Wersja zapoznawcza

Punkt końcowy z tożsamością, w której usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego.

--delivery-identity-endpoint-type
Wersja zapoznawcza

Typ docelowego punktu końcowego z tożsamością zasobu.

akceptowane wartości: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Umożliwia ocenianie filtrów zaawansowanych względem tablicy wartości zamiast oczekiwać pojedynczej wartości.

akceptowane wartości: false, true
--endpoint

Punkt końcowy, w którym usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego. Oczekuje się, że docelowy punkt końcowy zostanie już utworzony i dostępny do użycia przed wykonaniem dowolnego polecenia usługi Event Grid.

--endpoint-type

Typ docelowego punktu końcowego.

wartość domyślna: webhook
--event-delivery-schema

Schemat, w którym zdarzenia powinny być dostarczane dla tej subskrypcji zdarzeń. Domyślnie zdarzenia będą dostarczane w tym samym schemacie, w którym są publikowane (na podstawie schematu wejściowego odpowiedniego tematu).

akceptowane wartości: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Czas wygaśnięcia zdarzenia (w minutach). Musi być liczbą z zakresu od 1 do 1440.

wartość domyślna: 1440
--expiration-date

Data lub data/godzina (w formacie UTC, np. "2018-11-30T11:59:59+00:00" lub "2018-11-30"), po którym subskrypcja zdarzeń wygaśnie. Domyślnie nie ma wygaśnięcia subskrypcji zdarzeń.

--included-event-types

Rozdzielona spacjami lista typów zdarzeń (np. Microsoft.Storage.BlobCreated i Microsoft.Storage.BlobDeleted). Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu. W przypadku tematów usługi Event Grid typy zdarzeń są definiowane przez klienta. W przypadku zdarzeń platformy Azure, np. kont magazynu, usługi IoT Hub itp., można wykonywać zapytania dotyczące typów zdarzeń przy użyciu tego polecenia interfejsu wiersza polecenia "az eventgrid topic-type list-event-types".

--labels

Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.

--max-delivery-attempts

Maksymalna liczba prób dostarczenia. Musi być liczbą z zakresu od 1 do 30.

wartość domyślna: 30
--max-events-per-batch

Maksymalna liczba zdarzeń w partii. Musi być liczbą z zakresu od 1 do 5000.

--preferred-batch-size-in-kilobytes

Preferowany rozmiar partii w kilobajtach. Musi być liczbą z zakresu od 1 do 1024.

--qttl --storage-queue-msg-ttl

Czas wygaśnięcia komunikatu kolejki magazynu w sekundach.

--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, do którego należy utworzyć subskrypcję zdarzeń.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.

--subject-case-sensitive

Określ, czy pola podmiotu mają być porównywane w sposób uwzględniający wielkość liter. Prawda, jeśli flaga jest obecna.

akceptowane wartości: false, true
wartość domyślna: False
--subject-ends-with

Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription create (eventgrid rozszerzenie)

Wersja zapoznawcza

Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Utwórz nową subskrypcję zdarzeń.

az eventgrid event-subscription create --name
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--azure-active-directory-tenant-id]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                       [--event-ttl]
                                       [--expiration-date]
                                       [--included-event-types]
                                       [--labels]
                                       [--max-delivery-attempts]
                                       [--max-events-per-batch]
                                       [--preferred-batch-size-in-kilobytes]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Przykłady

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla grupy zasobów przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów domyślnych.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure z filtrem określającym prefiks tematu.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Utwórz nową subskrypcję zdarzeń dla grupy zasobów z filtrem określającym sufiks tematu.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i usługi EventHub jako miejsca docelowego.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure Storage jako miejsca docelowego.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure ServiceBusQueue jako miejsca docelowego.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

Utwórz nową subskrypcję zdarzeń dla domeny usługi Event Grid przy użyciu filtrów domyślnych i CloudEvent V 1.0 jako schemat dostarczania.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Utwórz nową subskrypcję zdarzeń dla konta magazynu z docelową nieaktywną lokalizacją docelową i niestandardowymi zasadami ponawiania wynoszącymi maksymalnie 10 prób dostarczenia oraz ttl zdarzenia wynoszącym 2 godziny (w zależności od tego, co nastąpi wcześniej).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120

Utwórz nową subskrypcję zdarzeń dla tematu domeny.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń (dla konta magazynu) z datą wygaśnięcia.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu elementu webhook z włączoną usługą Azure Active Directory jako miejsca docelowego.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu funkcji platformy Azure jako miejsca docelowego.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu usługi EventHub z tożsamością msi przypisaną przez system jako lokalizacją docelową i z elementem deadletter z tożsamością msi

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--advanced-filter

Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.

Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data. property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter argumentu.

--azure-active-directory-application-id-or-uri

Identyfikator aplikacji usługi Azure Active Directory lub identyfikator URI, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczania. Dotyczy tylko elementu webhook jako miejsca docelowego.

--azure-active-directory-tenant-id

Identyfikator dzierżawy usługi Azure Active Directory, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczenia. Dotyczy tylko elementu webhook jako miejsca docelowego.

--deadletter-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.

Przykład: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity

Typ tożsamości zasobu docelowego deadletter.

akceptowane wartości: systemassigned
--deadletter-identity-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.

--delivery-identity

Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).

akceptowane wartości: systemassigned
--delivery-identity-endpoint

Punkt końcowy z tożsamością, w której usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego.

--delivery-identity-endpoint-type

Typ docelowego punktu końcowego z tożsamością zasobu.

akceptowane wartości: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Punkt końcowy, w którym usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego.

--endpoint-type

Typ docelowego punktu końcowego.

akceptowane wartości: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
wartość domyślna: webhook
--event-delivery-schema

Schemat, w którym zdarzenia powinny być dostarczane dla tej subskrypcji zdarzeń. Domyślnie zdarzenia będą dostarczane w tym samym schemacie, w którym są publikowane (na podstawie schematu wejściowego odpowiedniego tematu).

akceptowane wartości: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Czas wygaśnięcia zdarzenia (w minutach). Musi być liczbą z zakresu od 1 do 1440.

wartość domyślna: 1440
--expiration-date

Data lub data/godzina (w formacie UTC, np. "2018-11-30T11:59:59+00:00" lub "2018-11-30"), po którym subskrypcja zdarzeń wygaśnie. Domyślnie nie ma wygaśnięcia subskrypcji zdarzeń.

--included-event-types

Rozdzielona spacjami lista typów zdarzeń. Przykład: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu.

--labels

Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.

--max-delivery-attempts

Maksymalna liczba prób dostarczenia. Musi być liczbą z zakresu od 1 do 30.

wartość domyślna: 30
--max-events-per-batch

Maksymalna liczba zdarzeń w partii. Musi być liczbą z zakresu od 1 do 5000.

--preferred-batch-size-in-kilobytes

Preferowany rozmiar partii w kilobajtach. Musi być liczbą z zakresu od 1 do 1024.

--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, do którego należy utworzyć subskrypcję zdarzeń.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.

--subject-case-sensitive

Określ, czy pola podmiotu mają być porównywane w sposób uwzględniający wielkość liter. Prawda, jeśli flaga jest obecna.

akceptowane wartości: false, true
wartość domyślna: False
--subject-ends-with

Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription delete

Usuwanie subskrypcji zdarzeń.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Przykłady

Usuwanie subskrypcji zdarzeń dla tematu usługi Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Usuwanie subskrypcji zdarzeń dla tematu domeny usługi Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Usuwanie subskrypcji zdarzeń dla domeny usługi Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Usuwanie subskrypcji zdarzeń dla subskrypcji platformy Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Usuwanie subskrypcji zdarzeń dla grupy zasobów.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Usuwanie subskrypcji zdarzeń dla konta magazynu.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać usunięta.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription delete (eventgrid rozszerzenie)

Wersja zapoznawcza

Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Usuwanie subskrypcji zdarzeń.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Przykłady

Usuwanie subskrypcji zdarzeń dla tematu usługi Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Usuwanie subskrypcji zdarzeń dla tematu domeny usługi Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Usuwanie subskrypcji zdarzeń dla domeny usługi Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Usuwanie subskrypcji zdarzeń dla subskrypcji platformy Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Usuwanie subskrypcji zdarzeń dla grupy zasobów.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Usuwanie subskrypcji zdarzeń dla konta magazynu.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać usunięta.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription list

Wyświetlanie listy subskrypcji zdarzeń.

Usługa Event Grid obsługuje zarówno regionalne, jak i globalne subskrypcje zdarzeń: subskrypcje zdarzeń w zasobach regionalnych (takich jak konta magazynu lub tematy usługi Event Grid) są regionalne, a subskrypcje zdarzeń w zasobach globalnych (takich jak subskrypcja platformy Azure lub grupa zasobów) są globalne. W związku z tym można wyświetlić listę subskrypcji zdarzeń na kilka różnych sposobów:

  1. Aby wyświetlić listę według identyfikatora zasobu, którego subskrypcje zdarzeń chcesz wyświetlić, określ parametr --source-resource-id. Nie trzeba określać żadnych innych parametrów.
  2. Aby wyświetlić listę według typu tematu (np. konta magazynu), określ parametr --topic-type wraz z parametrem --location (np. "westus2"). W przypadku globalnych typów tematów (np. "Microsoft.Resources.Subscriptions") określ wartość lokalizacji jako "globalną".
  3. Aby wyświetlić listę wszystkich subskrypcji zdarzeń w regionie (we wszystkich typach tematów), określ tylko parametr --location.
  4. W przypadku plików #2 i 3 powyżej, aby filtrować tylko według grupy zasobów, można dodatkowo określić parametr --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Przykłady

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla tematu usługi Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla konta magazynu.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla subskrypcji platformy Azure.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla grupy zasobów.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Wyświetl listę wszystkich subskrypcji zdarzeń dla tematu domeny usługi Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Wyświetl listę wszystkich subskrypcji zdarzeń usługi Storage (w ramach aktualnie wybranej subskrypcji platformy Azure) w regionie westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Wyświetl listę wszystkich subskrypcji zdarzeń magazynu (w ramach danej grupy zasobów) w westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych (w ramach aktualnie wybranej subskrypcji platformy Azure).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych w ramach określonej grupy zasobów.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid, której nazwa zawiera wzorzec "XYZ"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid z wyjątkiem subskrypcji zdarzeń o nazwie "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Parametry opcjonalne

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--odata-query

Zapytanie OData używane do filtrowania wyników listy. Filtrowanie jest obecnie dozwolone tylko dla właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wymieniona.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nazwa typu tematu, którego subskrypcje zdarzeń muszą być wymienione. Po określeniu tej opcji należy również określić --location.

Przykład 1: Wyświetlanie listy wszystkich subskrypcji zdarzeń magazynu w regionie WestUS2 --resource-group TestRG --topic-type-name Microsoft.StorageAccounts --location westus2 Przykład 2: Wyświetlanie listy wszystkich subskrypcji zdarzeń w subskrypcjach platformy Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription list (eventgrid rozszerzenie)

Wersja zapoznawcza

Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Wyświetlanie listy subskrypcji zdarzeń.

Usługa Event Grid obsługuje zarówno regionalne, jak i globalne subskrypcje zdarzeń: subskrypcje zdarzeń w zasobach regionalnych (takich jak konta magazynu lub tematy usługi Event Grid) są regionalne, a subskrypcje zdarzeń w zasobach globalnych (takich jak subskrypcja platformy Azure lub grupa zasobów) są globalne. W związku z tym można wyświetlić listę subskrypcji zdarzeń na kilka różnych sposobów:

  1. Aby wyświetlić listę według identyfikatora zasobu, którego subskrypcje zdarzeń chcesz wyświetlić, określ parametr --source-resource-id. Nie trzeba określać żadnych innych parametrów.
  2. Aby wyświetlić listę według typu tematu (np. konta magazynu), określ parametr --topic-type wraz z parametrem --location (np. "westus2"). W przypadku globalnych typów tematów (np. "Microsoft.Resources.Subscriptions") określ wartość lokalizacji jako "globalną".
  3. Aby wyświetlić listę wszystkich subskrypcji zdarzeń w regionie (we wszystkich typach tematów), określ tylko parametr --location.
  4. W przypadku plików #2 i 3 powyżej, aby filtrować tylko według grupy zasobów, można dodatkowo określić parametr --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Przykłady

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla tematu usługi Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla konta magazynu.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla subskrypcji platformy Azure.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla grupy zasobów.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Wyświetl listę wszystkich subskrypcji zdarzeń dla tematu domeny usługi Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Wyświetl listę wszystkich subskrypcji zdarzeń usługi Storage (w ramach aktualnie wybranej subskrypcji platformy Azure) w regionie westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Wyświetl listę wszystkich subskrypcji zdarzeń magazynu (w ramach danej grupy zasobów) w westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych (w ramach aktualnie wybranej subskrypcji platformy Azure).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych w ramach określonej grupy zasobów.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid, której nazwa zawiera wzorzec "XYZ"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid z wyjątkiem subskrypcji zdarzeń o nazwie "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Parametry opcjonalne

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--odata-query

Zapytanie używane do filtrowania wyników przy użyciu składni OData.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wymieniona.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nazwa typu tematu, którego subskrypcje zdarzeń muszą być wymienione. Po określeniu tej opcji należy również określić --location.

Przykład 1: Wyświetlanie listy wszystkich subskrypcji zdarzeń magazynu w regionie WestUS2 --resource-group TestRG --topic-type-name Microsoft.StorageAccounts --location westus2 Przykład 2: Wyświetlanie listy wszystkich subskrypcji zdarzeń w subskrypcjach platformy Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription show

Uzyskaj szczegółowe informacje o subskrypcji zdarzeń.

az eventgrid event-subscription show --name
                                     [--include-attrib-secret {false, true}]
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Przykłady

Pokaż szczegóły subskrypcji zdarzeń dla tematu usługi Event Grid.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Pokaż szczegóły subskrypcji zdarzeń dla subskrypcji platformy Azure.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Pokaż szczegóły subskrypcji zdarzeń dla grupy zasobów.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Pokaż szczegóły subskrypcji zdarzeń dla konta magazynu.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Pokaż szczegóły subskrypcji zdarzeń dla grupy zasobów, w tym wszystkie statyczne wpisy tajne atrybutu dostarczania.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
    --include-static-delivery-attribute-secret

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--include-attrib-secret --include-static-delivery-attribute-secret

Określ, czy powinny zostać zwrócone jakiekolwiek wpisy tajne atrybutu dostarczania statycznego. Prawda, jeśli flaga jest obecna.

akceptowane wartości: false, true
wartość domyślna: False
--include-full-endpoint-url

Określ, czy ma zostać zwrócony pełny adres URL punktu końcowego. Prawda, jeśli flaga jest obecna.

akceptowane wartości: false, true
wartość domyślna: False
--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wyświetlana.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription show (eventgrid rozszerzenie)

Wersja zapoznawcza

Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Uzyskaj szczegółowe informacje o subskrypcji zdarzeń.

az eventgrid event-subscription show --name
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Przykłady

Pokaż szczegóły subskrypcji zdarzeń dla tematu usługi Event Grid.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Pokaż szczegóły subskrypcji zdarzeń dla subskrypcji platformy Azure.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Pokaż szczegóły subskrypcji zdarzeń dla grupy zasobów.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Pokaż szczegóły subskrypcji zdarzeń dla konta magazynu.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--include-full-endpoint-url

Określ, czy ma zostać zwrócony pełny adres URL punktu końcowego. Prawda, jeśli flaga jest obecna.

akceptowane wartości: false, true
wartość domyślna: False
--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wyświetlana.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription update

Aktualizowanie subskrypcji zdarzeń.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Przykłady

Zaktualizuj subskrypcję zdarzeń dla tematu usługi Event Grid, aby określić nowy punkt końcowy.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Zaktualizuj subskrypcję zdarzeń dla subskrypcji platformy Azure, aby określić nowy temat z filtrem.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Zaktualizuj subskrypcję zdarzeń dla grupy zasobów, aby określić nowy punkt końcowy i nowy temat z filtrem.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby określić nową listę uwzględnionych typów zdarzeń.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby uwzględnić miejsce docelowe deadletter.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Zaktualizuj subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby uwzględnić czas wygaśnięcia komunikatu ustawiony na 5 minut.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

Aktualizowanie subskrypcji zdarzeń za pomocą zaawansowanego filtrowania włączonego w tablicach

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --enable-advanced-filtering-on-arrays true

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

wartość domyślna: []
--advanced-filter

Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.

Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter argumentu.

--deadletter-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.

--deadletter-identity
Wersja zapoznawcza

Typ tożsamości zasobu docelowego deadletter.

akceptowane wartości: systemassigned
--deadletter-identity-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.

--delivery-attribute-mapping

Dodaj mapowanie atrybutów dostarczania, aby wysyłać dodatkowe informacje za pośrednictwem nagłówków HTTP podczas dostarczania zdarzeń. Ten atrybut jest prawidłowy dla wszystkich typów docelowych z wyjątkiem StorageQueue. Można określić wiele atrybutów przy użyciu więcej niż jednego --delivery-attribute-mapping argumentu.

Użycie: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Statyczne mapowanie atrybutów: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename somevalue Zarówno statyczne, jak i dynamiczne: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Wersja zapoznawcza

Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).

akceptowane wartości: systemassigned
--delivery-identity-endpoint
Wersja zapoznawcza

Punkt końcowy z tożsamością, w której usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego.

--delivery-identity-endpoint-type
Wersja zapoznawcza

Typ docelowego punktu końcowego z tożsamością zasobu.

akceptowane wartości: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Umożliwia ocenianie filtrów zaawansowanych względem tablicy wartości zamiast oczekiwać pojedynczej wartości.

akceptowane wartości: false, true
--endpoint

Punkt końcowy, w którym usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego. Oczekuje się, że docelowy punkt końcowy zostanie już utworzony i dostępny do użycia przed wykonaniem dowolnego polecenia usługi Event Grid.

--endpoint-type

Typ docelowego punktu końcowego.

wartość domyślna: webhook
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

wartość domyślna: False
--included-event-types

Rozdzielona spacjami lista typów zdarzeń (np. Microsoft.Storage.BlobCreated i Microsoft.Storage.BlobDeleted). Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu. W przypadku tematów usługi Event Grid typy zdarzeń są definiowane przez klienta. W przypadku zdarzeń platformy Azure, np. kont magazynu, usługi IoT Hub itp., można wykonywać zapytania dotyczące typów zdarzeń przy użyciu tego polecenia interfejsu wiersza polecenia "az eventgrid topic-type list-event-types".

--labels

Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.

--qttl --storage-queue-msg-ttl

Czas wygaśnięcia komunikatu kolejki magazynu w sekundach.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

wartość domyślna: []
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

wartość domyślna: []
--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać zaktualizowana.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.

--subject-ends-with

Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription update (eventgrid rozszerzenie)

Wersja zapoznawcza

Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Aktualizowanie subskrypcji zdarzeń.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Przykłady

Zaktualizuj subskrypcję zdarzeń dla tematu usługi Event Grid, aby określić nowy punkt końcowy.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Zaktualizuj subskrypcję zdarzeń dla subskrypcji platformy Azure, aby określić nowy temat z filtrem.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Zaktualizuj subskrypcję zdarzeń dla grupy zasobów, aby określić nowy punkt końcowy i nowy temat z filtrem.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby określić nową listę uwzględnionych typów zdarzeń.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby uwzględnić miejsce docelowe deadletter.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Zaktualizuj subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

wartość domyślna: []
--advanced-filter

Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.

Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data. property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter argumentu.

--deadletter-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.

--deadletter-identity

Typ tożsamości zasobu docelowego deadletter.

akceptowane wartości: systemassigned
--deadletter-identity-endpoint

Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.

--delivery-identity

Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).

akceptowane wartości: systemassigned
--delivery-identity-endpoint

Punkt końcowy z tożsamością, w której usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego.

--delivery-identity-endpoint-type

Typ docelowego punktu końcowego z tożsamością zasobu.

akceptowane wartości: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Punkt końcowy, w którym usługa EventGrid powinna dostarczać zdarzenia pasujące do tej subskrypcji zdarzeń. W przypadku typu punktu końcowego elementu webhook powinien to być odpowiedni adres URL elementu webhook. W przypadku innych typów punktów końcowych powinien to być identyfikator zasobu platformy Azure punktu końcowego.

--endpoint-type

Typ docelowego punktu końcowego.

akceptowane wartości: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
wartość domyślna: webhook
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

wartość domyślna: False
--included-event-types

Rozdzielona spacjami lista typów zdarzeń. Przykład: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu.

--labels

Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

wartość domyślna: []
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

wartość domyślna: []
--source-resource-id

W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać zaktualizowana.

Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.

--subject-ends-with

Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.