Udostępnij przez


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

--name -n

Nazwa tematu.

--resource-group -g

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.

--extended-location-name
Wersja zapoznawcza

Nazwa lokalizacji rozszerzonej, jeśli kind==azurearc.

Właściwość Wartość
Grupa parametrów: Azure Arc Arguments
--extended-location-type
Wersja zapoznawcza

Typ lokalizacji rozszerzonej, jeśli rodzaj==azurearc.

Właściwość Wartość
Grupa parametrów: Azure Arc Arguments
Dopuszczalne wartości: customlocation
--identity
Wersja zapoznawcza Przestarzałe

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
--inbound-ip-rules

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.

--input-mapping-default-values

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.

--input-mapping-fields

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.

--input-schema

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
--kind
Wersja zapoznawcza

Rodzaj zasobu tematu.

Właściwość Wartość
Domyślna wartość: Azure
Dopuszczalne wartości: azure, azurearc
--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--mi-system-assigned

Obecność tego parametru wskazuje, że zostanie użyta tożsamość zarządzana SystemAssigned.

--mi-user-assigned
Wersja zapoznawcza

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.

--public-network-access

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
--sku
Wersja zapoznawcza

Nazwa jednostki SKU zasobu.

Właściwość Wartość
Domyślna wartość: Basic
Dopuszczalne wartości: basic, premium
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

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.

--ids

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

Nazwa tematu.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

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

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

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

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.

--odata-query

Zapytanie OData używane do filtrowania wyników listy. Filtrowanie jest obecnie dozwolone tylko dla właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

--resource-group -g

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

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.

--ids

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

Nazwa tematu.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

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

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

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

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.

--identity
Wersja zapoznawcza Przestarzałe

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

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
--inbound-ip-rules

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.

--mi-system-assigned

Obecność tego parametru wskazuje, że zostanie użyta tożsamość zarządzana SystemAssigned.

--mi-user-assigned
Wersja zapoznawcza

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.

--name -n

Nazwa tematu.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--public-network-access

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
--resource-group -g

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
--sku
Wersja zapoznawcza

Nazwa jednostki SKU zasobu.

Właściwość Wartość
Dopuszczalne wartości: basic, premium
--subscription

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

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False