az eventgrid topic
Zarządzanie tematami usługi Azure Event Grid.
Polecenia
| Nazwa | Opis | Typ | Stan |
|---|---|---|---|
| az eventgrid topic create |
Utwórz temat. |
Core | ogólna dostępność |
| az eventgrid topic delete |
Usuń temat. |
Core | ogólna dostępność |
| az eventgrid topic event-subscription |
Zarządzanie subskrypcjami zdarzeń tematu. |
Core | ogólna dostępność |
| az eventgrid topic event-subscription create |
Utwórz nową subskrypcję zdarzeń dla tematu. |
Core | ogólna dostępność |
| az eventgrid topic event-subscription delete |
Usuwanie subskrypcji zdarzeń tematu. |
Core | ogólna dostępność |
| az eventgrid topic event-subscription list |
Wyświetlanie listy subskrypcji zdarzeń określonego tematu. |
Core | ogólna dostępność |
| az eventgrid topic event-subscription show |
Uzyskaj szczegółowe informacje o subskrypcji zdarzeń tematu. |
Core | ogólna dostępność |
| az eventgrid topic event-subscription update |
Aktualizowanie subskrypcji zdarzeń tematu. |
Core | ogólna dostępność |
| az eventgrid topic key |
Zarządzanie kluczami dostępu współdzielonego tematu. |
Core | ogólna dostępność |
| az eventgrid topic key list |
Wyświetlanie listy kluczy dostępu współdzielonego tematu. |
Core | ogólna dostępność |
| az eventgrid topic key regenerate |
Wygeneruj ponownie klucz dostępu współdzielonego tematu. |
Core | ogólna dostępność |
| az eventgrid topic list |
Lista dostępnych tematów. |
Core | ogólna dostępność |
| az eventgrid topic show |
Uzyskaj szczegółowe informacje o temacie. |
Core | ogólna dostępność |
| az eventgrid topic update |
Aktualizowanie tematu. |
Core | ogólna dostępność |
az eventgrid topic create
Utwórz temat.
az eventgrid topic create --name
--resource-group
[--extended-location-name]
[--extended-location-type {customlocation}]
[--identity {noidentity, systemassigned}]
[--inbound-ip-rules]
[--input-mapping-default-values]
[--input-mapping-fields]
[--input-schema {cloudeventschemav1_0, customeventschema, eventgridschema}]
[--kind {azure, azurearc}]
[--location]
[--mi-system-assigned]
[--mi-user-assigned]
[--public-network-access {disabled, enabled}]
[--sku {basic, premium}]
[--tags]
Przykłady
Utwórz nowy temat.
az eventgrid topic create -g rg1 --name topic1 -l westus2
Utwórz nowy temat z niestandardowymi mapowaniami danych wejściowych.
az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema customeventschema --input-mapping-fields topic=myTopicField eventType=myEventTypeField --input-mapping-default-values subject=DefaultSubject dataVersion=1.0
Utwórz nowy temat, który akceptuje zdarzenia opublikowane w schemacie CloudEvents V1.0.
az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema cloudeventschemav1_0
Utwórz nowy temat, który zezwala na określone reguły adresów IP dla ruchu przychodzącego przy użyciu podstawowej jednostki SKU i tożsamości przypisanej przez system
az eventgrid topic create -g rg1 --name topic1 -l westus2 --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --sku Basic --identity systemassigned
Utwórz nowy temat na platformie Azure.
az eventgrid topic create -g rg1 --name topic1 -l westus2
Utwórz nowy temat na platformie Azure.
az eventgrid topic create -g rg1 --name topic1 -l westus2 --kind azure
Utwórz nowy temat w usłudze AzureArc przeznaczony dla lokalizacji niestandardowej.
az eventgrid topic create -g rg1 --name topic1 -l eastus2euap --kind azurearc --extended-location-name /subscriptions/<subid>/resourcegroups/<rgname>/providers/microsoft.extendedlocation/customlocations/<cust-loc-name> --extended-location-type customlocation --input-schema CloudEventSchemaV1_0
Parametry wymagane
Nazwa tematu.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Nazwa lokalizacji rozszerzonej, jeśli kind==azurearc.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Arc Arguments |
Typ lokalizacji rozszerzonej, jeśli rodzaj==azurearc.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Arc Arguments |
| Dopuszczalne wartości: | customlocation |
Argument "identity" został przestarzały i zostanie usunięty w przyszłej wersji.
Typ tożsamości zarządzanej zasobu. W przyszłości zostanie wycofana i zastąpiona przez --mi-system-assigned-identity.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | noidentity, systemassigned |
Lista reguł adresów IP dla ruchu przychodzącego.
Lista reguł adresów IP dla ruchu przychodzącego określająca adres IP w notacji CIDR, np. 10.0.0.0/8 wraz z odpowiednią akcją do wykonania na podstawie dopasowania lub braku dopasowania maski ip. Możliwe wartości to: Zezwalaj.
Gdy schemat wejściowy jest określony jako customeventschema, ten parametr może służyć do określania mapowań wejściowych na podstawie wartości domyślnych. Tego parametru można użyć, gdy schemat niestandardowy nie zawiera pola odpowiadającego jednemu z trzech pól obsługiwanych przez ten parametr. Określ mapowania rozdzielone spacjami w formacie "key=value". Dozwolone nazwy kluczy to "subject", "eventtype", "dataversion". Odpowiednie nazwy wartości powinny określać wartości domyślne, które mają być używane do mapowania i będą używane tylko wtedy, gdy opublikowane zdarzenie nie ma prawidłowego mapowania dla określonego pola.
Gdy schemat wejściowy jest określony jako customeventschema, ten parametr służy do określania mapowań wejściowych na podstawie nazw pól. Określ mapowania rozdzielone spacjami w formacie "key=value". Dozwolone nazwy kluczy to "id", "topic", "eventtime", "subject", "eventtype", "dataversion". Odpowiednie nazwy wartości powinny określać nazwy pól w niestandardowym schemacie wejściowym. Jeśli nie podano mapowania dla wartości "id" lub "eventtime", usługa Event Grid automatycznie wygeneruje wartość domyślną dla tych dwóch pól.
Schemat, w którym zdarzenia przychodzące zostaną opublikowane w tym temacie/domenie. Jeśli określisz wartość customeventschema dla tego parametru, musisz również podać wartości dla co najmniej jednego z --input_mapping_default_values / --input_mapping_fields.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | eventgridschema |
| Dopuszczalne wartości: | cloudeventschemav1_0, customeventschema, eventgridschema |
Rodzaj zasobu tematu.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | Azure |
| Dopuszczalne wartości: | azure, azurearc |
Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.
Obecność tego parametru wskazuje, że zostanie użyta tożsamość zarządzana SystemAssigned.
Dodaj tożsamości przypisane przez użytkownika, gdy typ identityType jest użytkownikiem lub mieszanym. 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 argumentu --mi-user-assigned.
Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest on włączony. Możesz dodatkowo ograniczyć do określonych adresów IP, konfigurując.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | disabled, enabled |
Nazwa jednostki SKU zasobu.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | Basic |
| Dopuszczalne wartości: | basic, premium |
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az eventgrid topic delete
Usuń temat.
az eventgrid topic delete [--ids]
[--name]
[--resource-group]
[--subscription]
Przykłady
Usuń temat.
az eventgrid topic delete -g rg1 --name topic1
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Nazwa tematu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az eventgrid topic list
Lista dostępnych tematów.
az eventgrid topic list [--odata-query]
[--resource-group]
Przykłady
Wyświetl listę wszystkich tematów w bieżącej subskrypcji platformy Azure.
az eventgrid topic list
Wyświetl listę wszystkich tematów w grupie zasobów.
az eventgrid topic list -g rg1
Wyświetl listę wszystkich tematów w grupie zasobów, której nazwa zawiera wzorzec "XYZ"
az eventgrid topic list -g rg1 --odata-query "Contains(name, 'XYZ')"
Wyświetl listę wszystkich tematów w grupie zasobów z wyjątkiem domeny o nazwie "name1"
az eventgrid topic list -g rg1 --odata-query "NOT (name eq 'name1')"
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
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 az configure --defaults group=<name>.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az eventgrid topic show
Uzyskaj szczegółowe informacje o temacie.
az eventgrid topic show [--ids]
[--name]
[--resource-group]
[--subscription]
Przykłady
Pokaż szczegóły tematu.
az eventgrid topic show -g rg1 -n topic1
Pokaż szczegóły tematu na podstawie identyfikatora zasobu.
az eventgrid topic show --ids /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Nazwa tematu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az eventgrid topic update
Aktualizowanie tematu.
az eventgrid topic update [--identity {noidentity, systemassigned}]
[--ids]
[--inbound-ip-rules]
[--mi-system-assigned]
[--mi-user-assigned]
[--name]
[--public-network-access {disabled, enabled}]
[--resource-group]
[--sku {basic, premium}]
[--subscription]
[--tags]
Przykłady
Zaktualizuj właściwości istniejącego tematu przy użyciu nowych informacji o dostępie do jednostki SKU, tożsamości i sieci publicznej.
az eventgrid topic update -g rg1 --name topic1 --sku Premium --identity systemassigned --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --tags Dept=IT --sku basic
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Argument "identity" został przestarzały i zostanie usunięty w przyszłej wersji.
Typ tożsamości zarządzanej zasobu. W przyszłości zostanie wycofana i zastąpiona przez --mi-system-assigned-identity.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | noidentity, systemassigned |
Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Lista reguł adresów IP dla ruchu przychodzącego określająca adres IP w notacji CIDR, np. 10.0.0.0/8 wraz z odpowiednią akcją do wykonania na podstawie dopasowania lub braku dopasowania maski ip. Możliwe wartości to: Zezwalaj.
Obecność tego parametru wskazuje, że zostanie użyta tożsamość zarządzana SystemAssigned.
Dodaj tożsamości przypisane przez użytkownika, gdy typ identityType jest użytkownikiem lub mieszanym. 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 argumentu --mi-user-assigned.
Nazwa tematu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest on włączony. Możesz dodatkowo ograniczyć do określonych adresów IP, konfigurując.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | disabled, enabled |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Nazwa jednostki SKU zasobu.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | basic, premium |
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Resource Id Arguments |
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |