Dela via

az eventgrid partner topic event-subscription

  • Referens

Kommentar

Den här kommandogruppen har kommandon som definieras i både Azure CLI och minst ett tillägg. Installera varje tillägg för att dra nytta av dess utökade funktioner. Läs mer om tillägg.

Hantera händelseprenumerationer för partnerämne.

Kommandon

Name Description Typ Status
az eventgrid partner topic event-subscription create

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

 Kärna Allmän tillgänglighet
az eventgrid partner topic event-subscription create (eventgrid anknytning)

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

 Anknytning Förhandsgranska
az eventgrid partner topic event-subscription delete

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

 Kärna Allmän tillgänglighet
az eventgrid partner topic event-subscription delete (eventgrid anknytning)

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

 Anknytning Förhandsgranska
az eventgrid partner topic event-subscription list

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

 Kärna Allmän tillgänglighet
az eventgrid partner topic event-subscription list (eventgrid anknytning)

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

 Anknytning Förhandsgranska
az eventgrid partner topic event-subscription show

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

 Kärna Allmän tillgänglighet
az eventgrid partner topic event-subscription show (eventgrid anknytning)

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

 Anknytning Förhandsgranska
az eventgrid partner topic event-subscription update

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

 Kärna Allmän tillgänglighet
az eventgrid partner topic event-subscription update (eventgrid anknytning)

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

 Anknytning Förhandsgranska

az eventgrid partner topic event-subscription create

Redigera

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

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--aad-tenant-id]
                                                     [--advanced-filter]
                                                     [--azure-active-directory-application-id-or-uri]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays {false, true}]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                                     [--event-ttl]
                                                     [--expiration-date]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--max-delivery-attempts]
                                                     [--max-events-per-batch]
                                                     [--preferred-batch-size-in-kilobytes]
                                                     [--qttl]
                                                     [--subject-begins-with]
                                                     [--subject-case-sensitive {false, true}]
                                                     [--subject-ends-with]

Exempel

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med hjälp av standardfilter.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med ett filter som anger ett ämnesprefix.

az eventgrid partner topic event-subscription create --name es4 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med standardfilter och CloudEvent V 1.0 som leveransschema.

az eventgrid partner topic event-subscription create -n es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Skapa en ny händelseprenumeration för en Event Grid-partnertopic, med ett deadletter-mål och en anpassad återförsöksprincip på högst 10 leveransförsök och en händelse-TTL på 2 timmar (beroende på vilket som inträffar tidigare) och förfallodatum.

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120 --expiration-date "2022-10-31"

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med Azure Active Directory-aktiverad Webhook som mål .

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med Azure Function som mål.

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med lagringskö som mål med meddelande-ttl på 5 min

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med avancerad filtrering på matriser aktiverat

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--aad-tenant-id --azure-active-directory-tenant-id

Azure Active Directory-klient-ID:t för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange 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 jpg 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 BoolEqual sant IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

--azure-active-directory-application-id-or-uri

Azure Active Directory-program-ID eller URI för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

Exempel: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--delivery-attribute-mapping

Lägg till leveransattributmappning för att skicka ytterligare information via HTTP-huvuden när händelser levereras. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --delivery-attribute-mapping argument.

Användning: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --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 dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--enable-advanced-filtering-on-arrays --enable-af-arr

Gör att avancerade filter kan utvärderas mot en matris med värden i stället för att förvänta sig ett singularvärde.

Godkända värden: false, true
--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten. Det förväntas att målslutpunkten redan har skapats och är tillgänglig för användning innan ett Event Grid-kommando körs.

--endpoint-type

Typ av målslutpunkt.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Standardvärde: webhook
--event-delivery-schema

Schemat där händelser ska levereras för den här händelseprenumerationen. Som standard levereras händelser i samma schema där de publiceras (baserat på motsvarande ämnes indataschema).

Godkända värden: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Händelsetid till live (i minuter). Måste vara ett tal mellan 1 och 1440.

Standardvärde: 1440
--expiration-date

Datum eller datetime (i UTC, t.ex. "2018-11-30T11:59:59+00:00" eller "2018-11-30") varefter händelseprenumerationen upphör att gälla. Som standard går det inte att förfalla för händelseprenumerationen.

--included-event-types

En blankstegsavgränsad lista över händelsetyper (t.ex. Microsoft.Storage.BlobCreated och Microsoft.Storage.BlobDeleted). Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet. För event grid-ämnen är händelsetyper kunddefinierade. För Azure-händelser, t.ex. lagringskonton, IoT Hub osv., kan du fråga deras händelsetyper med hjälp av det här CLI-kommandot "az eventgrid topic-type list-event-types".

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

--max-delivery-attempts

Maximalt antal leveransförsök. Måste vara ett tal mellan 1 och 30.

Standardvärde: 30
--max-events-per-batch

Maximalt antal händelser i en batch. Måste vara ett tal mellan 1 och 5 000.

--preferred-batch-size-in-kilobytes

Önskad batchstorlek i kilobyte. Måste vara ett tal mellan 1 och 1024.

--qttl --storage-queue-msg-ttl

Lagringskö meddelandetid att leva i sekunder.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-case-sensitive

Ange om ämnesfälten ska jämföras på ett skiftlägeskänsligt sätt. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription create (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

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

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--azure-active-directory-application-id-or-uri]
                                                     [--azure-active-directory-tenant-id]
                                                     [--deadletter-endpoint]
                                                     [--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]
                                                     [--subject-begins-with]
                                                     [--subject-case-sensitive {false, true}]
                                                     [--subject-ends-with]

Exempel

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med hjälp av standardfilter.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med ett filter som anger ett ämnesprefix.

az eventgrid partner topic event-subscription create --name es4 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med standardfilter och CloudEvent V 1.0 som leveransschema.

az eventgrid partner topic event-subscription create -n es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Skapa en ny händelseprenumeration för en Event Grid-partnertopic, med ett deadletter-mål och en anpassad återförsöksprincip på högst 10 leveransförsök och en händelse-TTL på 2 timmar (beroende på vilket som inträffar tidigare) och förfallodatum.

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120 --expiration-date "2022-10-31"

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med Azure Active Directory-aktiverad Webhook som mål .

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Skapa en ny händelseprenumeration för ett Event Grid-partnerämne med Azure Function som mål.

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange 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 Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

--azure-active-directory-application-id-or-uri

Azure Active Directory-program-ID eller URI för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--azure-active-directory-tenant-id

Azure Active Directory-klient-ID:t för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

Exempel: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--endpoint-type

Typ av målslutpunkt.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Standardvärde: webhook
--event-delivery-schema

Schemat där händelser ska levereras för den här händelseprenumerationen. Som standard levereras händelser i samma schema där de publiceras (baserat på motsvarande ämnes indataschema).

Godkända värden: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Händelsetid till live (i minuter). Måste vara ett tal mellan 1 och 1440.

Standardvärde: 1440
--expiration-date

Datum eller datetime (i UTC, t.ex. "2018-11-30T11:59:59+00:00" eller "2018-11-30") varefter händelseprenumerationen upphör att gälla. Som standard går det inte att förfalla för händelseprenumerationen.

--included-event-types

En blankstegsavgränsad lista över händelsetyper. Exempel: Microsoft.Storage.BlobSkapat Microsoft.Storage.BlobDeleted. Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet.

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

--max-delivery-attempts

Maximalt antal leveransförsök. Måste vara ett tal mellan 1 och 30.

Standardvärde: 30
--max-events-per-batch

Maximalt antal händelser i en batch. Måste vara ett tal mellan 1 och 5 000.

--preferred-batch-size-in-kilobytes

Önskad batchstorlek i kilobyte. Måste vara ett tal mellan 1 och 1024.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-case-sensitive

Ange om ämnesfälten ska jämföras på ett skiftlägeskänsligt sätt. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription delete

Redigera

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

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--yes]

Exempel

Ta bort en händelseprenumeration för ett Event Grid-partnerämne.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription delete (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

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

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group

Exempel

Ta bort en händelseprenumeration för ett Event Grid-partnerämne.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription list

Redigera

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

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]

Exempel

Visa en lista över alla händelseprenumerationer som skapats för ett Event Grid-partnerämne.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Obligatoriska parametrar

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

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.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription list (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

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

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]

Exempel

Visa en lista över alla händelseprenumerationer som skapats för ett Event Grid-partnerämne.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Obligatoriska parametrar

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--odata-query

Frågan som används för att filtrera resultaten med hjälp av OData-syntax.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription show

Redigera

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

az eventgrid partner topic event-subscription show --name
                                                   --partner-topic-name
                                                   --resource-group
                                                   [--include-attrib-secret {false, true}]
                                                   [--include-full-endpoint-url {false, true}]

Exempel

Visa information om en händelseprenumeration för ett Event Grid-partneravsnitt.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Visa information om en händelseprenumeration för ett Event Grid-partnerämne och inkludera hemligheter för statiska leveransattribut

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--include-attrib-secret --include-static-delivery-attribute-secret

Ange om några hemligheter för statiska leveransattribut ska returneras. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--include-full-endpoint-url

Ange om den fullständiga slutpunkts-URL:en ska returneras. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription show (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

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

az eventgrid partner topic event-subscription show --name
                                                   --partner-topic-name
                                                   --resource-group
                                                   [--include-full-endpoint-url {false, true}]

Exempel

Visa information om en händelseprenumeration för ett Event Grid-partneravsnitt.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--include-full-endpoint-url

Ange om den fullständiga slutpunkts-URL:en ska returneras. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription update

Redigera

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

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays {false, true}]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--qttl]
                                                     [--subject-begins-with]
                                                     [--subject-ends-with]

Exempel

Uppdatera en händelseprenumeration för ett Event Grid-partneravsnitt för att ange en ny slutpunkt.

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Uppdatera en händelseprenumeration för ett Event Grid-partneravsnitt för att ange ett nytt ämnesslut med filter.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Uppdatera en händelseprenumeration för ett Event Grid-partnerämne för att ange en ny slutpunkt och ett nytt ämne med filter för en ny lista över inkluderade händelsetyper.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Uppdatera en händelseprenumeration för ett Azure Event Grid-partnerämne för att inkludera ett deadletter-mål.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Uppdatera en händelseprenumeration för ett Azure Event Grid-partnerämne med hjälp av avancerade filter.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Uppdatera en händelseprenumeration för ett Event Grid-partnerämne med lagringskö som mål med meddelande-ttl i 5 minuter

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Uppdatera en händelseprenumeration för ett Event Grid-partnerämne med avancerad filtrering på matriser aktiverat

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange 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 jpg 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 BoolEqual sant IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

--delivery-attribute-mapping

Lägg till leveransattributmappning för att skicka ytterligare information via HTTP-huvuden när händelser levereras. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --delivery-attribute-mapping argument.

Användning: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --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 dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--enable-advanced-filtering-on-arrays --enable-af-arr

Gör att avancerade filter kan utvärderas mot en matris med värden i stället för att förvänta sig ett singularvärde.

Godkända värden: false, true
--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten. Det förväntas att målslutpunkten redan har skapats och är tillgänglig för användning innan ett Event Grid-kommando körs.

--endpoint-type

Typ av målslutpunkt.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Standardvärde: webhook
--included-event-types

En blankstegsavgränsad lista över händelsetyper (t.ex. Microsoft.Storage.BlobCreated och Microsoft.Storage.BlobDeleted). Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet. För event grid-ämnen är händelsetyper kunddefinierade. För Azure-händelser, t.ex. lagringskonton, IoT Hub osv., kan du fråga deras händelsetyper med hjälp av det här CLI-kommandot "az eventgrid topic-type list-event-types".

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

--qttl --storage-queue-msg-ttl

Lagringskö meddelandetid att leva i sekunder.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az eventgrid partner topic event-subscription update (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

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

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--deadletter-endpoint]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--subject-begins-with]
                                                     [--subject-ends-with]

Exempel

Uppdatera en händelseprenumeration för ett Event Grid-partneravsnitt för att ange en ny slutpunkt.

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Uppdatera en händelseprenumeration för ett Event Grid-partneravsnitt för att ange ett nytt ämnesslut med filter.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Uppdatera en händelseprenumeration för ett Event Grid-partnerämne för att ange en ny slutpunkt och ett nytt ämne med filter för en ny lista över inkluderade händelsetyper.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Uppdatera en händelseprenumeration för ett Azure Event Grid-partnerämne för att inkludera ett deadletter-mål.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Uppdatera en händelseprenumeration för ett Azure Event Grid-partnerämne med hjälp av avancerade filter.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

--partner-topic-name

Namnet på partnerämnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange 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 Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--endpoint-type

Typ av målslutpunkt.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Standardvärde: webhook
--included-event-types

En blankstegsavgränsad lista över händelsetyper. Exempel: Microsoft.Storage.BlobSkapat Microsoft.Storage.BlobDeleted. Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet.

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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