Dela via

az eventgrid topic

  • Referens

Hantera Azure Event Grid-ämnen.

Kommandon

Name Description Typ Status
az eventgrid topic create

Skapa ett ämne.

 Kärna GA
az eventgrid topic delete

Ta bort ett ämne.

 Kärna GA
az eventgrid topic event-subscription

Hantera händelseprenumerationer för ämnet.

 Kärna GA
az eventgrid topic event-subscription create

Skapa en ny händelseprenumeration för ett ämne.

 Kärna GA
az eventgrid topic event-subscription delete

Ta bort en händelseprenumeration för ett ämne.

 Kärna GA
az eventgrid topic event-subscription list

Lista händelseprenumerationer för ett specifikt ämne.

 Kärna GA
az eventgrid topic event-subscription show

Hämta information om en händelseprenumeration för ett ämne.

 Kärna GA
az eventgrid topic event-subscription update

Uppdatera en händelseprenumeration för ett ämne.

 Kärna GA
az eventgrid topic key

Hantera delade åtkomstnycklar för ett ämne.

 Kärna GA
az eventgrid topic key list

Visa en lista över delade åtkomstnycklar för ett ämne.

 Kärna GA
az eventgrid topic key regenerate

Återskapa en nyckel för delad åtkomst i ett ämne.

 Kärna GA
az eventgrid topic list

Lista tillgängliga ämnen.

 Kärna GA
az eventgrid topic show

Hämta information om ett ämne.

 Kärna GA
az eventgrid topic update

Uppdatera ett ämne.

 Kärna GA

az eventgrid topic create

Redigera

Skapa ett ämne.

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]

Exempel

Skapa ett nytt ämne.

az eventgrid topic create -g rg1 --name topic1 -l westus2

Skapa ett nytt ämne med anpassade indatamappningar.

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

Skapa ett nytt ämne som accepterar händelser som publicerats i CloudEvents V1.0-schema.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema cloudeventschemav1_0

Skapa ett nytt ämne som tillåter specifika inkommande IP-regler med Basic SKU och systemtilldelad identitet

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

Skapa ett nytt ämne i Azure.

az eventgrid topic create -g rg1 --name topic1 -l westus2

Skapa ett nytt ämne i Azure.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --kind azure

Skapa ett nytt ämne i AzureArc för en anpassad plats.

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

Obligatoriska parametrar

--name -n

Namnet på ämnet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--extended-location-name
Förhandsgranskning

Namnet på den utökade platsen om kind==azurearc.

--extended-location-type
Förhandsgranskning

Den utökade platstypen if kind==azurearc.

Godkända värden: customlocation
--identity
Förhandsgranskning Inaktuell

Argumentet "identitet" har blivit inaktuellt och tas bort i en framtida version.

Resursens hanterade identitetstyp. Kommer att bli inaktuell och ersättas av --mi-system-assigned-identity i framtiden.

Godkända värden: noidentity, systemassigned
--inbound-ip-rules

Lista över inkommande IP-regler.

Lista över inkommande IP-regler som anger IP-adress i CIDR-notation, t.ex. 10.0.0.0/8 tillsammans med motsvarande åtgärd som ska utföras baserat på matchningen eller ingen matchning av IpMask. Möjliga värden är – Tillåt.

--input-mapping-default-values

När indataschema anges som customeventschema kan den här parametern användas för att ange indatamappningar baserat på standardvärden. Du kan använda den här parametern när ditt anpassade schema inte innehåller ett fält som motsvarar ett av de tre fält som stöds av den här parametern. Ange blankstegsavgränsade mappningar i formatet "key=value". Tillåtna nyckelnamn är "subject", "eventtype", "dataversion". Motsvarande värdenamn ska ange de standardvärden som ska användas för mappningen och de används endast när den publicerade händelsen inte har en giltig mappning för ett visst fält.

--input-mapping-fields

När input-schema anges som customeventschema används den här parametern för att ange indatamappningar baserat på fältnamn. Ange blankstegsavgränsade mappningar i formatet "key=value". Tillåtna nyckelnamn är "id", "topic", "eventtime", "subject", "eventtype", "dataversion". Motsvarande värdenamn ska ange namnen på fälten i det anpassade indataschemat. Om det inte finns någon mappning för antingen "id" eller "eventtime" genereras automatiskt ett standardvärde för dessa två fält.

--input-schema

Schema där inkommande händelser kommer att publiceras till det här ämnet/domänen. Om du anger customeventschema som värde för den här parametern måste du också ange värden för minst en av --input_mapping_default_values/--input_mapping_fields.

Godkända värden: cloudeventschemav1_0, customeventschema, eventgridschema
Standardvärde: eventgridschema
--kind
Förhandsgranskning

Typ av ämnesresurs.

Godkända värden: azure, azurearc
Standardvärde: Azure
--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--mi-system-assigned

Förekomsten av den här param anger att SystemAssigned managed identity (SystemAssigned managed identity) kommer att användas.

--mi-user-assigned
Förhandsgranskning

Lägg till användartilldelade identiteter när identityType är användare eller blandat. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --mi-user-assigned argument.

--public-network-access

Detta avgör om trafik tillåts via offentligt nätverk. Som standard är den aktiverad. Du kan ytterligare begränsa till specifika IP-adresser genom att konfigurera.

Godkända värden: disabled, enabled
--sku
Förhandsgranskning

Resursens SKU-namn.

Godkända värden: basic, premium
Standardvärde: Basic
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid topic delete

Redigera

Ta bort ett ämne.

az eventgrid topic delete [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]

Exempel

Ta bort ett ämne.

az eventgrid topic delete -g rg1 --name topic1

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på ämnet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid topic list

Redigera

Lista tillgängliga ämnen.

az eventgrid topic list [--odata-query]
                        [--resource-group]

Exempel

Visa en lista över alla ämnen i den aktuella Azure-prenumerationen.

az eventgrid topic list

Visa en lista över alla ämnen i en resursgrupp.

az eventgrid topic list -g rg1

Lista alla ämnen i en resursgrupp vars namn innehåller mönstret "XYZ"

az eventgrid topic list -g rg1 --odata-query "Contains(name, 'XYZ')"

Lista alla ämnen i en resursgrupp utom domänen med namnet "name1"

az eventgrid topic list -g rg1 --odata-query "NOT (name eq 'name1')"

Valfria parametrar

--odata-query

OData-frågan som används för att filtrera listresultatet. Filtrering tillåts för närvarande endast på egenskapen Namn. De åtgärder som stöds är: CONTAINS, eq (för lika), ne (för inte lika), AND, OR och NOT.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid topic show

Redigera

Hämta information om ett ämne.

az eventgrid topic show [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Exempel

Visa information om ett ämne.

az eventgrid topic show -g rg1 -n topic1

Visa information om ett ämne baserat på resurs-ID.

az eventgrid topic show --ids /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på ämnet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid topic update

Redigera

Uppdatera ett ämne.

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]

Exempel

Uppdatera egenskaperna för ett befintligt ämne med ny sku, identitet och offentlig nätverksåtkomstinformation.

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

Valfria parametrar

--identity
Förhandsgranskning Inaktuell

Argumentet "identitet" har blivit inaktuellt och tas bort i en framtida version.

Resursens hanterade identitetstyp. Kommer att bli inaktuell och ersättas av --mi-system-assigned-identity i framtiden.

Godkända värden: noidentity, systemassigned
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--inbound-ip-rules

Lista över inkommande IP-regler som anger IP-adress i CIDR-notation, t.ex. 10.0.0.0/8 tillsammans med motsvarande åtgärd som ska utföras baserat på matchningen eller ingen matchning av IpMask. Möjliga värden är – Tillåt.

--mi-system-assigned

Förekomsten av den här param anger att SystemAssigned managed identity (SystemAssigned managed identity) kommer att användas.

--mi-user-assigned
Förhandsgranskning

Lägg till användartilldelade identiteter när identityType är användare eller blandat. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --mi-user-assigned argument.

--name -n

Namnet på ämnet.

--public-network-access

Detta avgör om trafik tillåts via offentligt nätverk. Som standard är den aktiverad. Du kan ytterligare begränsa till specifika IP-adresser genom att konfigurera.

Godkända värden: disabled, enabled
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--sku
Förhandsgranskning

Resursens SKU-namn.

Godkända värden: basic, premium
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.