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
Nazwa subskrypcji zdarzeń.
Nazwa tematu partnera.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.
Parametry opcjonalne
Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.
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.
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.
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ń.
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.
Umożliwia ocenianie filtrów zaawansowanych względem tablicy wartości zamiast oczekiwać pojedynczej wartości.
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.
Typ docelowego punktu końcowego.
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).
Czas wygaśnięcia zdarzenia (w minutach). Musi być liczbą z zakresu od 1 do 1440.
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ń.
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".
Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.
Maksymalna liczba prób dostarczenia. Musi być liczbą z zakresu od 1 do 30.
Maksymalna liczba zdarzeń w partii. Musi być liczbą z zakresu od 1 do 5000.
Preferowany rozmiar partii w kilobajtach. Musi być liczbą z zakresu od 1 do 1024.
Storage czas wygaśnięcia komunikatu w kolejce w sekundach.
Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.
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.
Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.
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
Nazwa subskrypcji zdarzeń.
Nazwa tematu partnera.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.
Parametry opcjonalne
Nie monituj o potwierdzenie.
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.
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
Nazwa tematu partnera.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.
Parametry opcjonalne
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.
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.
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
Nazwa subskrypcji zdarzeń.
Nazwa tematu partnera.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.
Parametry opcjonalne
Określ, czy mają być zwracane jakiekolwiek wpisy tajne atrybutu dostarczania statycznego. Wartość True, jeśli flaga jest obecna.
Określ, aby wskazać, czy ma zostać zwrócony pełny adres URL punktu końcowego. Wartość True, jeśli flaga jest obecna.
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.
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
Nazwa subskrypcji zdarzeń.
Nazwa tematu partnera.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.
Parametry opcjonalne
Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.
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ń.
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.
Umożliwia ocenianie zaawansowanych filtrów względem tablicy wartości zamiast oczekiwać pojedynczej wartości.
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.
Typ docelowego punktu końcowego.
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".
Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.
Storage czas wygaśnięcia komunikatu kolejki w sekundach.
Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.
Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.