az eventgrid partner topic event-subscription

Zarządzanie subskrypcjami zdarzeń tematu partnera.

Polecenia

az eventgrid partner topic event-subscription create

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

az eventgrid partner topic event-subscription delete

Usuwanie subskrypcji zdarzeń tematu partnera.

az eventgrid partner topic event-subscription list

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

az eventgrid partner topic event-subscription show

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

az eventgrid partner topic event-subscription update

Aktualizowanie subskrypcji zdarzeń tematu partnera.

az eventgrid partner topic event-subscription create

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

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--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 partnera usługi Event Grid przy użyciu filtrów domyślnych.

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

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

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

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

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

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

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partnera usługi Event Grid przy użyciu Azure Active Directory włączonego elementu webhook jako miejsca docelowego.

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

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

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

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partnera usługi Event Grid z włączonym zaawansowanym filtrowaniem tablic

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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ń.

--partner-topic-name

Nazwa tematu partnera.

--resource-group -g

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

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.

az eventgrid partner topic event-subscription delete

Usuwanie subskrypcji zdarzeń tematu partnera.

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

Przykłady

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

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

--partner-topic-name

Nazwa tematu partnera.

--resource-group -g

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

Parametry opcjonalne

--yes -y

Nie monituj o potwierdzenie.

az eventgrid partner topic event-subscription list

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

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

Przykłady

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

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Parametry wymagane

--partner-topic-name

Nazwa tematu partnera.

--resource-group -g

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

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.

az eventgrid partner topic event-subscription show

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

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

Przykłady

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

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Wyświetlanie szczegółów subskrypcji zdarzeń dla tematu partnera usługi Event Grid i dołączanie statycznych wpisów tajnych atrybutów dostarczania

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

Parametry wymagane

--name -n

Nazwa subskrypcji zdarzeń.

--partner-topic-name

Nazwa tematu partnera.

--resource-group -g

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

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

az eventgrid partner topic event-subscription update

Aktualizowanie subskrypcji zdarzeń tematu partnera.

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--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 partnera usługi Event Grid w celu określenia nowego punktu końcowego.

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

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

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

Aktualizowanie subskrypcji zdarzeń dla tematu partnera 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 partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partnera Azure Event Grid w celu uwzględnienia miejsca docelowego deadletter.

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

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

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partnera usługi Event Grid przy użyciu kolejki Storage jako miejsca docelowego z godziną wygaśnięcia komunikatu o 5 minutach

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

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

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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ń.

--partner-topic-name

Nazwa tematu partnera.

--resource-group -g

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

Parametry opcjonalne

--advanced-filter

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

--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 zaawansowanych filtrów 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 zgodne z tą subskrypcją 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 powinno 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
--included-event-types

Rozdzielona spacjami lista typów zdarzeń (np. Microsoft.Storage. Obiekt BlobCreated 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ń.

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

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

--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 filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.