az eventgrid event-subscription
Uwaga
Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.
Zarządzanie subskrypcjami zdarzeń.
Zarządzanie subskrypcjami zdarzeń dla tematu usługi Event Grid, domeny, tematu domeny, subskrypcji platformy Azure, grupy zasobów lub dowolnego innego zasobu platformy Azure obsługującego powiadomienia o zdarzeniach.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az eventgrid event-subscription create |
Utwórz nową subskrypcję zdarzeń. |
Podstawowe funkcje | Ogólna dostępność |
az eventgrid event-subscription create (eventgrid rozszerzenie) |
Utwórz nową subskrypcję zdarzeń. |
Numer wewnętrzny | Podgląd |
az eventgrid event-subscription delete |
Usuwanie subskrypcji zdarzeń. |
Podstawowe funkcje | Ogólna dostępność |
az eventgrid event-subscription delete (eventgrid rozszerzenie) |
Usuwanie subskrypcji zdarzeń. |
Numer wewnętrzny | Podgląd |
az eventgrid event-subscription list |
Wyświetlanie listy subskrypcji zdarzeń. |
Podstawowe funkcje | Ogólna dostępność |
az eventgrid event-subscription list (eventgrid rozszerzenie) |
Wyświetlanie listy subskrypcji zdarzeń. |
Numer wewnętrzny | Podgląd |
az eventgrid event-subscription show |
Uzyskaj szczegółowe informacje o subskrypcji zdarzeń. |
Podstawowe funkcje | Ogólna dostępność |
az eventgrid event-subscription show (eventgrid rozszerzenie) |
Uzyskaj szczegółowe informacje o subskrypcji zdarzeń. |
Numer wewnętrzny | Podgląd |
az eventgrid event-subscription update |
Aktualizowanie subskrypcji zdarzeń. |
Podstawowe funkcje | Ogólna dostępność |
az eventgrid event-subscription update (eventgrid rozszerzenie) |
Aktualizowanie subskrypcji zdarzeń. |
Numer wewnętrzny | Podgląd |
az eventgrid event-subscription create
Utwórz nową subskrypcję zdarzeń.
az eventgrid event-subscription create --name
[--aad-tenant-id]
[--advanced-filter]
[--azure-active-directory-application-id-or-uri]
[--deadletter-endpoint]
[--deadletter-identity {systemassigned}]
[--deadletter-identity-endpoint]
[--delivery-attribute-mapping]
[--delivery-identity {systemassigned}]
[--delivery-identity-endpoint]
[--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--endpoint-type]
[--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
[--event-ttl]
[--expiration-date]
[--included-event-types]
[--labels]
[--max-delivery-attempts]
[--max-events-per-batch]
[--preferred-batch-size-in-kilobytes]
[--qttl]
[--source-resource-id]
[--subject-begins-with]
[--subject-case-sensitive {false, true}]
[--subject-ends-with]
Przykłady
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla grupy zasobów przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.
az eventgrid event-subscription create --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--advanced-filter data.blobType StringIn BlockBlob
--advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure z filtrem określającym prefiks tematu.
az eventgrid event-subscription create --name es4 \
--source-resource-id /subscriptions/{SubID} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Utwórz nową subskrypcję zdarzeń dla grupy zasobów z filtrem określającym sufiks tematu.
az eventgrid event-subscription create --name es5 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-ends-with mysubject_suffix
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i usługi EventHub jako miejsca docelowego.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint-type eventhub \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure Storage jako miejsca docelowego.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure ServiceBusQueue jako miejsca docelowego.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint-type servicebusqueue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1
Utwórz nową subskrypcję zdarzeń dla domeny usługi Event Grid przy użyciu filtrów domyślnych i CloudEvent V 1.0 jako schemat dostarczania.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Utwórz nową subskrypcję zdarzeń dla konta magazynu z docelową nieaktywną lokalizacją docelową i niestandardowymi zasadami ponawiania wynoszącymi maksymalnie 10 prób dostarczenia oraz ttl zdarzenia wynoszącym 2 godziny (w zależności od tego, co nastąpi wcześniej).
az eventgrid event-subscription create --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
--max-delivery-attempts 10 --event-ttl 120
Utwórz nową subskrypcję zdarzeń dla tematu domeny.
az eventgrid event-subscription create --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń (dla konta magazynu) z datą wygaśnięcia.
az eventgrid event-subscription create --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--expiration-date "2018-10-31"
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu elementu webhook z włączoną usługą Azure Active Directory jako miejsca docelowego.
az eventgrid event-subscription create --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu funkcji platformy Azure jako miejsca docelowego.
az eventgrid event-subscription create --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu usługi EventHub z tożsamością msi przypisaną przez system jako lokalizacją docelową i z elementem deadletter z tożsamością msi
az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
--deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}
Tworzenie nowej subskrypcji zdarzeń dla tematu usługi Event Grid przy użyciu kolejki magazynu jako miejsca docelowego z komunikatem o czasie wygaśnięcia o 5 minutach
az eventgrid event-subscription create -n es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300
Tworzenie nowej subskrypcji zdarzeń dla tematu usługi Event Grid przy użyciu kolejki magazynu z systemassigned tożsamości msi jako miejsca docelowego
az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300
Tworzenie nowej subskrypcji zdarzeń dla tematu usługi Event Grid z zaawansowanym filtrowaniem włączonym w tablicach
az eventgrid event-subscription create -n es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--enable-advanced-filtering-on-arrays true
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
Identyfikator dzierżawy usługi Azure Active Directory, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczenia. Dotyczy tylko elementu webhook jako miejsca docelowego.
Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.
Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter
argumentu.
Identyfikator aplikacji usługi Azure Active Directory lub identyfikator URI, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczania. Dotyczy tylko elementu webhook jako miejsca docelowego.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.
Przykład: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.
Typ tożsamości zasobu docelowego deadletter.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.
Dodaj mapowanie atrybutów dostarczania, aby wysyłać dodatkowe informacje za pośrednictwem nagłówków HTTP podczas dostarczania zdarzeń. Ten atrybut jest prawidłowy dla wszystkich typów docelowych z wyjątkiem StorageQueue. Można określić wiele atrybutów przy użyciu więcej niż jednego --delivery-attribute-mapping
argumentu.
Użycie: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Statyczne mapowanie atrybutów: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename somevalue Zarówno statyczne, jak i dynamiczne: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).
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.
Typ docelowego punktu końcowego z tożsamością zasobu.
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órym subskrypcja zdarzeń wygaśnie. Domyślnie nie ma wygaśnięcia subskrypcji zdarzeń.
Rozdzielona spacjami lista typów zdarzeń (np. Microsoft.Storage.BlobCreated i Microsoft.Storage.BlobDeleted). Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu. W przypadku tematów usługi Event Grid typy zdarzeń są definiowane przez klienta. W przypadku zdarzeń platformy Azure, np. kont magazynu, usługi IoT Hub itp., można wykonywać zapytania dotyczące typów zdarzeń przy użyciu tego polecenia interfejsu wiersza polecenia "az eventgrid topic-type list-event-types".
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.
Czas wygaśnięcia komunikatu kolejki magazynu w sekundach.
W pełni kwalifikowany identyfikator zasobu platformy Azure, do którego należy utworzyć subskrypcję zdarzeń.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.
Określ, czy pola podmiotu mają być porównywane w sposób uwzględniający wielkość liter. Prawda, jeśli flaga jest obecna.
Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription create (eventgrid rozszerzenie)
Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Utwórz nową subskrypcję zdarzeń.
az eventgrid event-subscription create --name
[--advanced-filter]
[--azure-active-directory-application-id-or-uri]
[--azure-active-directory-tenant-id]
[--deadletter-endpoint]
[--deadletter-identity {systemassigned}]
[--deadletter-identity-endpoint]
[--delivery-identity {systemassigned}]
[--delivery-identity-endpoint]
[--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--endpoint]
[--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
[--event-ttl]
[--expiration-date]
[--included-event-types]
[--labels]
[--max-delivery-attempts]
[--max-events-per-batch]
[--preferred-batch-size-in-kilobytes]
[--source-resource-id]
[--subject-begins-with]
[--subject-case-sensitive {false, true}]
[--subject-ends-with]
Przykłady
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla grupy zasobów przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów domyślnych.
az eventgrid event-subscription create --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.
az eventgrid event-subscription create --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--advanced-filter data.blobType StringIn BlockBlob
--advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure z filtrem określającym prefiks tematu.
az eventgrid event-subscription create --name es4 \
--source-resource-id /subscriptions/{SubID} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Utwórz nową subskrypcję zdarzeń dla grupy zasobów z filtrem określającym sufiks tematu.
az eventgrid event-subscription create --name es5 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-ends-with mysubject_suffix
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i usługi EventHub jako miejsca docelowego.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint-type eventhub \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure Storage jako miejsca docelowego.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1
Utwórz nową subskrypcję zdarzeń dla subskrypcji platformy Azure przy użyciu filtrów domyślnych i kolejki usługi Azure ServiceBusQueue jako miejsca docelowego.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID} \
--endpoint-type servicebusqueue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1
Utwórz nową subskrypcję zdarzeń dla domeny usługi Event Grid przy użyciu filtrów domyślnych i CloudEvent V 1.0 jako schemat dostarczania.
az eventgrid event-subscription create --name es2 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Utwórz nową subskrypcję zdarzeń dla konta magazynu z docelową nieaktywną lokalizacją docelową i niestandardowymi zasadami ponawiania wynoszącymi maksymalnie 10 prób dostarczenia oraz ttl zdarzenia wynoszącym 2 godziny (w zależności od tego, co nastąpi wcześniej).
az eventgrid event-subscription create --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
--max-delivery-attempts 10 --event-ttl 120
Utwórz nową subskrypcję zdarzeń dla tematu domeny.
az eventgrid event-subscription create --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Utwórz nową subskrypcję zdarzeń (dla konta magazynu) z datą wygaśnięcia.
az eventgrid event-subscription create --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--expiration-date "2018-10-31"
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu elementu webhook z włączoną usługą Azure Active Directory jako miejsca docelowego.
az eventgrid event-subscription create --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu funkcji platformy Azure jako miejsca docelowego.
az eventgrid event-subscription create --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Utwórz nową subskrypcję zdarzeń dla tematu usługi Event Grid przy użyciu usługi EventHub z tożsamością msi przypisaną przez system jako lokalizacją docelową i z elementem deadletter z tożsamością msi
az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
--deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.
Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data. property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter
argumentu.
Identyfikator aplikacji usługi Azure Active Directory lub identyfikator URI, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczania. Dotyczy tylko elementu webhook jako miejsca docelowego.
Identyfikator dzierżawy usługi Azure Active Directory, aby uzyskać token dostępu, który zostanie uwzględniony jako token elementu nośnego w żądaniach dostarczenia. Dotyczy tylko elementu webhook jako miejsca docelowego.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.
Przykład: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.
Typ tożsamości zasobu docelowego deadletter.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.
Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).
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.
Typ docelowego punktu końcowego z tożsamością zasobu.
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.
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órym subskrypcja zdarzeń wygaśnie. Domyślnie nie ma wygaśnięcia subskrypcji zdarzeń.
Rozdzielona spacjami lista typów zdarzeń. Przykład: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu.
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.
W pełni kwalifikowany identyfikator zasobu platformy Azure, do którego należy utworzyć subskrypcję zdarzeń.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.
Określ, czy pola podmiotu mają być porównywane w sposób uwzględniający wielkość liter. Prawda, jeśli flaga jest obecna.
Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription delete
Usuwanie subskrypcji zdarzeń.
az eventgrid event-subscription delete --name
[--source-resource-id]
Przykłady
Usuwanie subskrypcji zdarzeń dla tematu usługi Event Grid.
az eventgrid event-subscription delete --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
Usuwanie subskrypcji zdarzeń dla tematu domeny usługi Event Grid.
az eventgrid event-subscription delete --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1
Usuwanie subskrypcji zdarzeń dla domeny usługi Event Grid.
az eventgrid event-subscription delete --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1
Usuwanie subskrypcji zdarzeń dla subskrypcji platformy Azure.
az eventgrid event-subscription delete --name es2 \
--source-resource-id /subscriptions/{SubID}
Usuwanie subskrypcji zdarzeń dla grupy zasobów.
az eventgrid event-subscription delete --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}
Usuwanie subskrypcji zdarzeń dla konta magazynu.
az eventgrid event-subscription delete --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać usunięta.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription delete (eventgrid rozszerzenie)
Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Usuwanie subskrypcji zdarzeń.
az eventgrid event-subscription delete --name
[--source-resource-id]
Przykłady
Usuwanie subskrypcji zdarzeń dla tematu usługi Event Grid.
az eventgrid event-subscription delete --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
Usuwanie subskrypcji zdarzeń dla tematu domeny usługi Event Grid.
az eventgrid event-subscription delete --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1
Usuwanie subskrypcji zdarzeń dla domeny usługi Event Grid.
az eventgrid event-subscription delete --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1
Usuwanie subskrypcji zdarzeń dla subskrypcji platformy Azure.
az eventgrid event-subscription delete --name es2 \
--source-resource-id /subscriptions/{SubID}
Usuwanie subskrypcji zdarzeń dla grupy zasobów.
az eventgrid event-subscription delete --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}
Usuwanie subskrypcji zdarzeń dla konta magazynu.
az eventgrid event-subscription delete --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać usunięta.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription list
Wyświetlanie listy subskrypcji zdarzeń.
Usługa Event Grid obsługuje zarówno regionalne, jak i globalne subskrypcje zdarzeń: subskrypcje zdarzeń w zasobach regionalnych (takich jak konta magazynu lub tematy usługi Event Grid) są regionalne, a subskrypcje zdarzeń w zasobach globalnych (takich jak subskrypcja platformy Azure lub grupa zasobów) są globalne. W związku z tym można wyświetlić listę subskrypcji zdarzeń na kilka różnych sposobów:
- 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 plików #2 i 3 powyżej, aby filtrować tylko według grupy zasobów, można dodatkowo określić parametr --resource-group.
az eventgrid event-subscription list [--location]
[--odata-query]
[--resource-group]
[--source-resource-id]
[--topic-type-name]
Przykłady
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla tematu usługi Event Grid.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla konta magazynu.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla subskrypcji platformy Azure.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla grupy zasobów.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}
Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1
Wyświetl listę wszystkich subskrypcji zdarzeń dla tematu domeny usługi Event Grid.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1
Wyświetl listę wszystkich subskrypcji zdarzeń usługi Storage (w ramach aktualnie wybranej subskrypcji platformy Azure) w regionie westus2.
az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2
Wyświetl listę wszystkich subskrypcji zdarzeń magazynu (w ramach danej grupy zasobów) w westus2.
az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}
Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych (w ramach aktualnie wybranej subskrypcji platformy Azure).
az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global
Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych w ramach określonej grupy zasobów.
az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}
Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid, której nazwa zawiera wzorzec "XYZ"
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"
Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid z wyjątkiem subskrypcji zdarzeń o nazwie "name1"
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"
Parametry opcjonalne
Lokalizacja. Wartości z: az account list-locations
. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>
.
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.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wymieniona.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Nazwa typu tematu, którego subskrypcje zdarzeń muszą być wymienione. Po określeniu tej opcji należy również określić --location.
Przykład 1: Wyświetlanie listy wszystkich subskrypcji zdarzeń magazynu w regionie WestUS2 --resource-group TestRG --topic-type-name Microsoft.StorageAccounts --location westus2 Przykład 2: Wyświetlanie listy wszystkich subskrypcji zdarzeń w subskrypcjach platformy Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription list (eventgrid rozszerzenie)
Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Wyświetlanie listy subskrypcji zdarzeń.
Usługa Event Grid obsługuje zarówno regionalne, jak i globalne subskrypcje zdarzeń: subskrypcje zdarzeń w zasobach regionalnych (takich jak konta magazynu lub tematy usługi Event Grid) są regionalne, a subskrypcje zdarzeń w zasobach globalnych (takich jak subskrypcja platformy Azure lub grupa zasobów) są globalne. W związku z tym można wyświetlić listę subskrypcji zdarzeń na kilka różnych sposobów:
- 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 plików #2 i 3 powyżej, aby filtrować tylko według grupy zasobów, można dodatkowo określić parametr --resource-group.
az eventgrid event-subscription list [--location]
[--odata-query]
[--resource-group]
[--source-resource-id]
[--topic-type-name]
Przykłady
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla tematu usługi Event Grid.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla konta magazynu.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla subskrypcji platformy Azure.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}
Wyświetl listę wszystkich subskrypcji zdarzeń utworzonych dla grupy zasobów.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}
Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1
Wyświetl listę wszystkich subskrypcji zdarzeń dla tematu domeny usługi Event Grid.
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1
Wyświetl listę wszystkich subskrypcji zdarzeń usługi Storage (w ramach aktualnie wybranej subskrypcji platformy Azure) w regionie westus2.
az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2
Wyświetl listę wszystkich subskrypcji zdarzeń magazynu (w ramach danej grupy zasobów) w westus2.
az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}
Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych (w ramach aktualnie wybranej subskrypcji platformy Azure).
az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global
Wyświetl listę wszystkich subskrypcji zdarzeń regionalnych lub globalnych w ramach określonej grupy zasobów.
az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}
Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid, której nazwa zawiera wzorzec "XYZ"
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"
Wyświetl listę wszystkich subskrypcji zdarzeń dla domeny usługi Event Grid z wyjątkiem subskrypcji zdarzeń o nazwie "name1"
az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"
Parametry opcjonalne
Lokalizacja. Wartości z: az account list-locations
. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>
.
Zapytanie używane do filtrowania wyników przy użyciu składni OData.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wymieniona.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Nazwa typu tematu, którego subskrypcje zdarzeń muszą być wymienione. Po określeniu tej opcji należy również określić --location.
Przykład 1: Wyświetlanie listy wszystkich subskrypcji zdarzeń magazynu w regionie WestUS2 --resource-group TestRG --topic-type-name Microsoft.StorageAccounts --location westus2 Przykład 2: Wyświetlanie listy wszystkich subskrypcji zdarzeń w subskrypcjach platformy Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription show
Uzyskaj szczegółowe informacje o subskrypcji zdarzeń.
az eventgrid event-subscription show --name
[--include-attrib-secret {false, true}]
[--include-full-endpoint-url {false, true}]
[--source-resource-id]
Przykłady
Pokaż szczegóły subskrypcji zdarzeń dla tematu usługi Event Grid.
az eventgrid event-subscription show --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1
Pokaż szczegóły subskrypcji zdarzeń dla subskrypcji platformy Azure.
az eventgrid event-subscription show --name es2 \
--source-resource-id /subscriptions/{SubID}
Pokaż szczegóły subskrypcji zdarzeń dla grupy zasobów.
az eventgrid event-subscription show --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/rg1
Pokaż szczegóły subskrypcji zdarzeń dla konta magazynu.
az eventgrid event-subscription show --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob
Pokaż szczegóły subskrypcji zdarzeń dla grupy zasobów, w tym wszystkie statyczne wpisy tajne atrybutu dostarczania.
az eventgrid event-subscription show --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
--include-static-delivery-attribute-secret
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
Określ, czy powinny zostać zwrócone jakiekolwiek wpisy tajne atrybutu dostarczania statycznego. Prawda, jeśli flaga jest obecna.
Określ, czy ma zostać zwrócony pełny adres URL punktu końcowego. Prawda, jeśli flaga jest obecna.
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wyświetlana.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription show (eventgrid rozszerzenie)
Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Uzyskaj szczegółowe informacje o subskrypcji zdarzeń.
az eventgrid event-subscription show --name
[--include-full-endpoint-url {false, true}]
[--source-resource-id]
Przykłady
Pokaż szczegóły subskrypcji zdarzeń dla tematu usługi Event Grid.
az eventgrid event-subscription show --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1
Pokaż szczegóły subskrypcji zdarzeń dla subskrypcji platformy Azure.
az eventgrid event-subscription show --name es2 \
--source-resource-id /subscriptions/{SubID}
Pokaż szczegóły subskrypcji zdarzeń dla grupy zasobów.
az eventgrid event-subscription show --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/rg1
Pokaż szczegóły subskrypcji zdarzeń dla konta magazynu.
az eventgrid event-subscription show --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
Określ, czy ma zostać zwrócony pełny adres URL punktu końcowego. Prawda, jeśli flaga jest obecna.
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi być wyświetlana.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription update
Aktualizowanie subskrypcji zdarzeń.
az eventgrid event-subscription update --name
[--add]
[--advanced-filter]
[--deadletter-endpoint]
[--deadletter-identity {systemassigned}]
[--deadletter-identity-endpoint]
[--delivery-attribute-mapping]
[--delivery-identity {systemassigned}]
[--delivery-identity-endpoint]
[--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--endpoint-type]
[--force-string]
[--included-event-types]
[--labels]
[--qttl]
[--remove]
[--set]
[--source-resource-id]
[--subject-begins-with]
[--subject-ends-with]
Przykłady
Zaktualizuj subskrypcję zdarzeń dla tematu usługi Event Grid, aby określić nowy punkt końcowy.
az eventgrid event-subscription update --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Zaktualizuj subskrypcję zdarzeń dla subskrypcji platformy Azure, aby określić nowy temat z filtrem.
az eventgrid event-subscription update --name es2 \
--source-resource-id /subscriptions/{SubID} \
--subject-ends-with .jpg
Zaktualizuj subskrypcję zdarzeń dla grupy zasobów, aby określić nowy punkt końcowy i nowy temat z filtrem.
az eventgrid event-subscription update --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby określić nową listę uwzględnionych typów zdarzeń.
az eventgrid event-subscription update --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby uwzględnić miejsce docelowe deadletter.
az eventgrid event-subscription update --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Zaktualizuj subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.
az eventgrid event-subscription update --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--advanced-filter data.blobType StringIn BlockBlob
--advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net
Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby uwzględnić czas wygaśnięcia komunikatu ustawiony na 5 minut.
az eventgrid event-subscription update --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
--storage-queue-msg-ttl 300
Aktualizowanie subskrypcji zdarzeń za pomocą zaawansowanego filtrowania włączonego w tablicach
az eventgrid event-subscription update --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
--enable-advanced-filtering-on-arrays true
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>
.
Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.
Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter
argumentu.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.
Typ tożsamości zasobu docelowego deadletter.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.
Dodaj mapowanie atrybutów dostarczania, aby wysyłać dodatkowe informacje za pośrednictwem nagłówków HTTP podczas dostarczania zdarzeń. Ten atrybut jest prawidłowy dla wszystkich typów docelowych z wyjątkiem StorageQueue. Można określić wiele atrybutów przy użyciu więcej niż jednego --delivery-attribute-mapping
argumentu.
Użycie: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Statyczne mapowanie atrybutów: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename somevalue Zarówno statyczne, jak i dynamiczne: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).
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.
Typ docelowego punktu końcowego z tożsamością zasobu.
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.
W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.
Rozdzielona spacjami lista typów zdarzeń (np. Microsoft.Storage.BlobCreated i Microsoft.Storage.BlobDeleted). Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu. W przypadku tematów usługi Event Grid typy zdarzeń są definiowane przez klienta. W przypadku zdarzeń platformy Azure, np. kont magazynu, usługi IoT Hub itp., można wykonywać zapytania dotyczące typów zdarzeń przy użyciu tego polecenia interfejsu wiersza polecenia "az eventgrid topic-type list-event-types".
Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.
Czas wygaśnięcia komunikatu kolejki magazynu w sekundach.
Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>
.
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać zaktualizowana.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.
Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az eventgrid event-subscription update (eventgrid rozszerzenie)
Grupa poleceń "az eventgrid" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Aktualizowanie subskrypcji zdarzeń.
az eventgrid event-subscription update --name
[--add]
[--advanced-filter]
[--deadletter-endpoint]
[--deadletter-identity {systemassigned}]
[--deadletter-identity-endpoint]
[--delivery-identity {systemassigned}]
[--delivery-identity-endpoint]
[--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--endpoint]
[--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--force-string]
[--included-event-types]
[--labels]
[--remove]
[--set]
[--source-resource-id]
[--subject-begins-with]
[--subject-ends-with]
Przykłady
Zaktualizuj subskrypcję zdarzeń dla tematu usługi Event Grid, aby określić nowy punkt końcowy.
az eventgrid event-subscription update --name es1 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Zaktualizuj subskrypcję zdarzeń dla subskrypcji platformy Azure, aby określić nowy temat z filtrem.
az eventgrid event-subscription update --name es2 \
--source-resource-id /subscriptions/{SubID} \
--subject-ends-with .jpg
Zaktualizuj subskrypcję zdarzeń dla grupy zasobów, aby określić nowy punkt końcowy i nowy temat z filtrem.
az eventgrid event-subscription update --name es3 \
--source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby określić nową listę uwzględnionych typów zdarzeń.
az eventgrid event-subscription update --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
Zaktualizuj subskrypcję zdarzeń dla konta magazynu, aby uwzględnić miejsce docelowe deadletter.
az eventgrid event-subscription update --name es2 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Zaktualizuj subskrypcję zdarzeń dla konta magazynu przy użyciu filtrów zaawansowanych.
az eventgrid event-subscription update --name es3 \
--source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--advanced-filter data.blobType StringIn BlockBlob
--advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net
Parametry wymagane
Nazwa subskrypcji zdarzeń.
Parametry opcjonalne
Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>
.
Filtr zaawansowany umożliwia filtrowanie zdarzeń na podstawie określonej właściwości zdarzenia.
Użycie: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data. property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true Wiele zaawansowanych filtrów można określić za pomocą więcej niż jednego --advanced-filter
argumentu.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage, w którym usługa EventGrid powinna spowodować nieuprawnione zdarzenia dla tej subskrypcji zdarzeń.
Typ tożsamości zasobu docelowego deadletter.
Identyfikator zasobu platformy Azure miejsca docelowego kontenera obiektów blob usługi Azure Storage z tożsamością, w której usługa EventGrid powinna spowodować zakleszczenia niemożliwych zdarzeń dla tej subskrypcji zdarzeń.
Typ tożsamości zasobu docelowego dostarczania (np. kolejka magazynu lub eventhub).
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.
Typ docelowego punktu końcowego z tożsamością zasobu.
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.
Typ docelowego punktu końcowego.
W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.
Rozdzielona spacjami lista typów zdarzeń. Przykład: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Aby zasubskrybować wszystkie domyślne typy zdarzeń, nie należy określać żadnej wartości dla tego argumentu.
Rozdzielona spacjami lista etykiet do skojarzenia z tą subskrypcją zdarzeń.
Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>
.
W pełni kwalifikowany identyfikator zasobu platformy Azure, którego subskrypcja zdarzeń musi zostać zaktualizowana.
Użycie: --source-resource-id Azure-Resource-ID Dla subskrypcji platformy Azure: --source-resource-id /subscriptions/{SubID} Dla grupy zasobów: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Dla tematu eventgrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Dla konta magazynu: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Dla domeny EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.
Opcjonalny ciąg filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie prefiksu. Symbole wieloznaczne nie są obsługiwane.
Opcjonalny ciąg do filtrowania zdarzeń dla subskrypcji zdarzeń na podstawie sufiksu. Symbole wieloznaczne nie są obsługiwane.
Parametry globalne
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. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.