az eventgrid system-topic event-subscription

Odwołanie

Zarządzanie subskrypcjami zdarzeń tematu systemowego.

Polecenia

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

az eventgrid system-topic event-subscription create

Edytuj

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

az eventgrid system-topic event-subscription create --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--advanced-filter]
                                                    [--azure-active-directory-application-id-or-uri]
                                                    [--azure-active-directory-tenant-id]
                                                    [--deadletter-endpoint]
                                                    [--delivery-attribute-mapping]
                                                    [--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]
                                                    [--subject-begins-with]
                                                    [--subject-case-sensitive {false, true}]
                                                    [--subject-ends-with]

Przykłady

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

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Utwórz nową subskrypcję zdarzeń dla tematu systemu usługi Event Grid z filtrem określającym prefiks tematu.

az eventgrid system-topic event-subscription create --name es4 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Utwórz nową subskrypcję zdarzeń dla tematu systemu usługi Event Grid przy użyciu filtrów domyślnych i cloudEvent v 1.0 jako schematu dostarczania.

az eventgrid system-topic event-subscription create -n es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Utwórz nową subskrypcję zdarzeń dla tematu systemu usługi Event Grid z miejscem docelowym deadletter i niestandardowymi zasadami ponawiania wynoszącymi maksymalnie 10 prób dostarczenia oraz 2 godzinami czasu wygaśnięcia zdarzenia (w zależności od tego, co nastąpi wcześniej) i datą wygaśnięcia.

az eventgrid system-topic event-subscription create --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 --expiration-date "2022-10-31"

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

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 systemu usługi Event Grid przy użyciu funkcji platformy Azure jako miejsca docelowego.

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Tworzenie nowej subskrypcji zdarzeń dla tematu systemu usługi Event Grid przy użyciu kolejki Storage jako miejsca docelowego z 5-minutowym limitem czasu wygaśnięcia

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 systemu usługi Event Grid i włączanie zaawansowanego filtrowania tablic

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
    --enable-advanced-filtering-on-arrays true

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

--resource-group -g

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

--system-topic-name

Nazwa tematu systemowego.

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

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

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

--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 system-topic event-subscription delete

Edytuj

Usuwanie subskrypcji zdarzeń tematu systemowego.

az eventgrid system-topic event-subscription delete --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--yes]

Przykłady

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

az eventgrid system-topic event-subscription delete --name es1 \
    -g rg1 --system-topic-name systemtopic1 \

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

--resource-group -g

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

--system-topic-name

Nazwa tematu systemowego.

Parametry opcjonalne

--yes -y

Nie monituj o potwierdzenie.

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 system-topic event-subscription list

Edytuj

Wyświetlanie listy subskrypcji zdarzeń określonego tematu systemowego.

az eventgrid system-topic event-subscription list --resource-group
                                                  --system-topic-name
                                                  [--odata-query]

Przykłady

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

az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1

Parametry wymagane

--resource-group -g

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

--system-topic-name

Nazwa tematu systemowego.

Parametry opcjonalne

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

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 system-topic event-subscription show

Edytuj

Uzyskaj szczegółowe informacje o subskrypcji zdarzeń tematu systemowego.

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

Przykłady

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

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1

Pokaż szczegóły subskrypcji zdarzeń dla tematu systemu usługi Event Grid obejmują wszystkie statyczne wpisy tajne atrybutu dostarczania.

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1 --include-attrib-secret

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

--resource-group -g

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

--system-topic-name

Nazwa tematu systemowego.

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

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 system-topic event-subscription update

Edytuj

Aktualizowanie subskrypcji zdarzeń tematu systemowego.

az eventgrid system-topic event-subscription update --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--advanced-filter]
                                                    [--deadletter-endpoint]
                                                    [--delivery-attribute-mapping]
                                                    [--enable-advanced-filtering-on-arrays {false, true}]
                                                    [--endpoint]
                                                    [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                    [--included-event-types]
                                                    [--labels]
                                                    [--qttl]
                                                    [--subject-begins-with]
                                                    [--subject-ends-with]

Przykłady

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

az eventgrid system-topic event-subscription update --name es1 \
    -g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Aktualizowanie subskrypcji zdarzeń dla tematu systemu usługi Event Grid w celu określenia nowego tematu z filtrem.

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --subject-ends-with .jpg

Aktualizowanie subskrypcji zdarzeń dla tematu systemu usługi Event Grid w celu określenia nowego punktu końcowego i nowego tematu z filtrem nowej listy uwzględnionych typów zdarzeń.

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Aktualizowanie subskrypcji zdarzeń dla tematu systemu Azure Event Grid w celu uwzględnienia miejsca docelowego deadletter.

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Aktualizowanie subskrypcji zdarzeń dla tematu systemu Azure Event Grid przy użyciu filtrów zaawansowanych.

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --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

Aktualizowanie subskrypcji zdarzeń dla tematu systemu usługi Event Grid przy użyciu kolejki Storage jako miejsca docelowego z wartością czasu wygaśnięcia 5 minut

az eventgrid system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --storage-queue-msg-ttl 300

Aktualizowanie subskrypcji zdarzeń dla tematu systemu usługi Event Grid przy użyciu zaawansowanego filtrowania w tablicach z włączoną obsługą

az eventgrid system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --enable-advanced-filtering-on-arrays true

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

--resource-group -g

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

--system-topic-name

Nazwa tematu systemowego.

Parametry opcjonalne

--advanced-filter

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

--deadletter-endpoint

--delivery-attribute-mapping

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

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

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