az eventgrid event-subscription

Odwołanie

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

az eventgrid event-subscription create	Utwórz nową subskrypcję zdarzeń.
az eventgrid event-subscription delete	Usuwanie subskrypcji zdarzeń.
az eventgrid event-subscription list	Wyświetlanie listy subskrypcji zdarzeń.
az eventgrid event-subscription show	Uzyskaj szczegółowe informacje o subskrypcji zdarzeń.
az eventgrid event-subscription update	Aktualizowanie subskrypcji zdarzeń.

az eventgrid event-subscription create

Edytuj

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-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 {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]
                                       [--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, używając 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, używając filtrów domyślnych i 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 miejscem docelowym deadletter i niestandardowymi zasadami ponawiania wynoszącymi maksymalnie 10 prób dostarczenia oraz 2 godziny czasu wygaśnięcia zdarzenia (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 Azure Active Directory włączonego elementu webhook 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

Tworzenie nowej subskrypcji zdarzeń dla tematu usługi Event Grid przy użyciu usługi EventHub z przypisaną przez system tożsamością tożsamości usługi zarządzanej jako lokalizacją docelową i za pomocą funkcji deadletter z tożsamością tożsamości usługi zarządzanej

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 Storage jako miejsca docelowego z limitem czasu wygaśnięcia komunikatu o wartości 5 minut

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 przypisaną przez system 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

--advanced-filter

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

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

Identyfikator aplikacji lub identyfikator URI 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.

--azure-active-directory-tenant-id

Identyfikator dzierżawy 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 dla miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować, że zdarzenia nie będą dostępne do uzyskania w tej subskrypcji zdarzeń.

--deadletter-identity

Typ tożsamości zasobu docelowego deadletter.

akceptowane wartości: systemassigned

--deadletter-identity-endpoint

Identyfikator zasobu platformy Azure dla miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować, że zdarzenia nie dostarczną do uzyskania w 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. Wiele atrybutów można określić przy użyciu więcej niż jednego --delivery-attribute-mapping argumentu.

--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

--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.

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órej 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. Obiekty blobTworzone i Microsoft. Storage. Obiekt 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 Storage, IoT Hub itp., można wykonywać zapytania dotyczące ich 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

Storage czas wygaśnięcia komunikatu w kolejce w sekundach.

--source-resource-id

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

--subject-begins-with

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

--subject-case-sensitive

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

akceptowane wartości: false, true

--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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription delete

Edytuj

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.

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription list

Edytuj

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 Storage lub tematy usługi Event Grid) są regionalne, natomiast 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:

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.
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ą".
Aby wyświetlić listę wszystkich subskrypcji zdarzeń w regionie (we wszystkich typach tematów), określ tylko parametr --location.
W przypadku wartości #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ń 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ń Storage (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świetlanie listy 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.

--topic-type-name

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

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription show

Edytuj

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 mają być zwracane jakiekolwiek wpisy tajne atrybutu dostarczania statycznego. Wartość True, jeśli flaga jest obecna.

akceptowane wartości: false, true

--include-full-endpoint-url

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

akceptowane wartości: false, true

--source-resource-id

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

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az eventgrid event-subscription update

Edytuj

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 {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Przykłady

Aktualizowanie subskrypcji zdarzeń dla tematu usługi Event Grid w celu określenia nowego punktu końcowego.

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-ends-with filter.

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 filtr tematu.

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

Aktualizowanie subskrypcji zdarzeń dla konta magazynu w celu uwzględnienia miejsca docelowego 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ń przy użyciu 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 lub ciąg JSON>.

--advanced-filter

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

--deadletter-endpoint

--deadletter-identity

Typ tożsamości zasobu docelowego deadletter.

akceptowane wartości: systemassigned

--deadletter-identity-endpoint

--delivery-attribute-mapping

--delivery-identity

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

akceptowane wartości: systemassigned

--delivery-identity-endpoint

--delivery-identity-endpoint-type

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

--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.

--included-event-types

--labels

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

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

Storage czas wygaśnięcia komunikatu w kolejce w sekundach.

--remove

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

--set

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

--source-resource-id

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

--subject-begins-with

Opcjonalny ciąg do 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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.