az eventgrid event-subscription

  • Referência

Nota

Este grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerencie assinaturas de eventos.

Gerencie assinaturas de eventos para um tópico, domínio, tópico de domínio, assinatura do Azure, grupo de recursos ou para qualquer outro recurso do Azure que ofereça suporte a notificações de eventos.

Comandos

Name Description Tipo Estado
az eventgrid event-subscription create

Crie uma nova assinatura de evento.

 Principal GA
az eventgrid event-subscription create (eventgrid extensão)

Crie uma nova assinatura de evento.

 Extensão Pré-visualizar
az eventgrid event-subscription delete

Exclua uma assinatura de evento.

 Principal GA
az eventgrid event-subscription delete (eventgrid extensão)

Exclua uma assinatura de evento.

 Extensão Pré-visualizar
az eventgrid event-subscription list

Listar assinaturas de eventos.

 Principal GA
az eventgrid event-subscription list (eventgrid extensão)

Listar assinaturas de eventos.

 Extensão Pré-visualizar
az eventgrid event-subscription show

Obtenha os detalhes de uma assinatura de evento.

 Principal GA
az eventgrid event-subscription show (eventgrid extensão)

Obtenha os detalhes de uma assinatura de evento.

 Extensão Pré-visualizar
az eventgrid event-subscription update

Atualizar uma assinatura de evento.

 Principal GA
az eventgrid event-subscription update (eventgrid extensão)

Atualizar uma assinatura de evento.

 Extensão Pré-visualizar

az eventgrid event-subscription create

Editar

Crie uma nova assinatura de evento.

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

Exemplos

Crie uma nova assinatura de evento para um tópico da Grade de Eventos, usando filtros padrão.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para uma assinatura do Azure, usando filtros padrão.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para um grupo de recursos, usando filtros padrão.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para uma conta de armazenamento, usando filtros padrão.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para uma conta de armazenamento, usando filtros avançados.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Crie uma nova assinatura de evento para uma assinatura do Azure, com um filtro especificando um prefixo de assunto.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Crie uma nova assinatura de evento para um grupo de recursos, com um filtro especificando um sufixo de assunto.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Crie uma nova assinatura de evento para uma assinatura do Azure, usando filtros padrão, e um EventHub como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Crie uma nova assinatura de evento para uma assinatura do Azure, usando filtros padrão e uma fila de Armazenamento do Azure como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Crie uma nova assinatura de evento para uma assinatura do Azure, usando filtros padrão, e um ServiceBusQueue do Azure como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

Crie uma nova assinatura de evento para um domínio de Grade de Eventos, usando filtros padrão, e o CloudEvent V 1.0 como o esquema de entrega.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Crie uma nova assinatura de evento para uma conta de armazenamento, com um destino de carta morta e uma política de repetição personalizada de no máximo 10 tentativas de entrega e um TTL de evento de 2 horas (o que acontecer primeiro).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120

Crie uma nova assinatura de evento para um tópico de domínio.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento (para uma conta de armazenamento) com uma data de validade.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

Crie uma nova assinatura de evento para um tópico da Grade de Eventos, usando o Webhook habilitado para o Ative Directory do Azure como destino.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Crie uma nova assinatura de evento para um tópico da Grade de Eventos, usando a Função do Azure como destino.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Criar uma nova assinatura de evento para um tópico da Grade de Eventos, usando o Eventhub com identidade MSI atribuída pelo sistema como destino e com letra morta com identidade MSI

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Criar uma nova assinatura de evento para um tópico de Grade de Eventos usando a Fila de Armazenamento como destino com a mensagem ttl em 5 minutos

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Criar uma nova assinatura de evento para um tópico de Grade de Eventos usando StorageQueue com identidade MSI atribuída pelo sistema como destino

az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Criar uma nova assinatura de evento para um tópico de Grade de Eventos com filtragem avançada habilitada em matrizes

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

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

A ID de Locatário do Azure Ative Directory para obter o token de acesso que será incluído como o token de portador nas solicitações de entrega. Aplicável apenas para webhook como destino.

--advanced-filter

Um filtro avançado permite a filtragem de eventos com base em uma propriedade de evento específica.

Uso: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALOR [VALOR ...] StringIn: --advanced-filter data. Cor StringIn Azul Vermelho Laranja Amarelo StringNotIn: --advanced-filter data. Cor StringNotIn Azul Vermelho Laranja Amarelo StringContains: --assunto de filtro avançado StringContains Vermelho Azul StringNotContains: --assunto de filtro avançado StringNotContains Vermelho Azul StringBeginsWith: --assunto de filtro avançado StringBeginsCom vermelho azul StringNotBeginsWith: --assunto de filtro avançado StringNotBeginsCom vermelho azul StringEndsWith: --assunto de filtro avançado StringEndsCom img png jpg StringNotEndsWith: --sujeito de filtro avançado 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 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Vários filtros avançados podem ser especificados usando mais de um --advanced-filter argumento.

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

A ID ou Uri do Aplicativo do Azure Ative Directory para obter o token de acesso que será incluído como o token de portador nas solicitações de entrega. Aplicável apenas para webhook como destino.

--deadletter-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure onde EventGrid deve fazer deadletter de eventos não entregues para esta assinatura de evento.

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

--deadletter-identity
Pré-visualizar

O tipo de identidade do recurso de destino de letra morta.

valores aceites: systemassigned
--deadletter-identity-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure com identidade onde EventGrid deve fazer deadletter de eventos não entregáveis para esta assinatura de evento.

--delivery-attribute-mapping

Adicione o mapeamento de atributos de entrega para enviar informações adicionais por meio de cabeçalhos HTTP ao entregar eventos. Esse atributo é válido para todos os tipos de destino, exceto StorageQueue. Vários atributos podem ser especificados usando mais de um --delivery-attribute-mapping argumento.

Uso: --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 Estático e Dinâmico: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Pré-visualizar

O tipo de identidade do recurso de destino de entrega (por exemplo, fila de armazenamento ou eventhub).

valores aceites: systemassigned
--delivery-identity-endpoint
Pré-visualizar

Ponto de extremidade com identidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade.

--delivery-identity-endpoint-type
Pré-visualizar

O tipo do ponto de extremidade de destino com identidade de recurso.

valores aceites: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Permite que filtros avançados sejam avaliados em relação a uma matriz de valores em vez de esperar um valor singular.

valores aceites: false, true
--endpoint

Ponto de extremidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade. Espera-se que o ponto de extremidade de destino já esteja criado e disponível para uso antes de executar qualquer comando da Grade de Eventos.

--endpoint-type

O tipo do ponto de extremidade de destino.

valor predefinido: webhook
--event-delivery-schema

O esquema no qual os eventos devem ser entregues para esta assinatura de evento. Por padrão, os eventos serão entregues no mesmo esquema em que são publicados (com base no esquema de entrada do tópico correspondente).

valores aceites: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Tempo de vida do evento (em minutos). Deve ser um número entre 1 e 1440.

valor predefinido: 1440
--expiration-date

Data ou data/hora (em UTC, por exemplo, '2018-11-30T11:59:59+00:00' ou '2018-11-30') após a qual a subscrição do evento expiraria. Por padrão, não há expiração para a assinatura do evento.

--included-event-types

Uma lista separada por espaços de tipos de eventos (por exemplo, Microsoft.Storage.BlobCreated e Microsoft.Storage.BlobDeleted). Para se inscrever em todos os tipos de evento padrão, não especifique nenhum valor para esse argumento. Para tópicos de grade de eventos, os tipos de evento são definidos pelo cliente. Para eventos do Azure, por exemplo, Contas de Armazenamento, Hub IoT, etc., você pode consultar seus tipos de evento usando este comando da CLI 'az eventgrid topic-type list-event-types'.

--labels

Uma lista separada por espaços de etiquetas para associar a esta subscrição de evento.

--max-delivery-attempts

Número máximo de tentativas de entrega. Deve ser um número entre 1 e 30.

valor predefinido: 30
--max-events-per-batch

Número máximo de eventos em um lote. Deve ser um número entre 1 e 5000.

--preferred-batch-size-in-kilobytes

Tamanho de lote preferido em kilobytes. Deve ser um número entre 1 e 1024.

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

Tempo de vida da mensagem da fila de armazenamento em segundos.

--source-resource-id

Identificador totalmente qualificado do recurso do Azure para o qual a assinatura de evento precisa ser criada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo. Não há suporte para caracteres curinga.

--subject-case-sensitive

Especificar para indicar se os campos temáticos devem ser comparados de uma forma que diferencie maiúsculas de minúsculas. True se a bandeira estiver presente.

valores aceites: false, true
valor predefinido: False
--subject-ends-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo. Não há suporte para caracteres curinga.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription create (eventgrid extensão)

Pré-visualizar

O grupo de comandos 'az eventgrid' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie uma nova assinatura de evento.

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

Exemplos

Crie uma nova assinatura de evento para um tópico da Grade de Eventos, usando filtros padrão.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para uma assinatura de assinatura do Azure, usando filtros padrão.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para um grupo de recursos, usando filtros padrão.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para uma conta de armazenamento, usando filtros padrão.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento para uma conta de armazenamento, usando filtros avançados.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Crie uma nova assinatura de evento para uma assinatura do Azure, com um filtro especificando um prefixo de assunto.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Crie uma nova assinatura de evento para um grupo de recursos, com um filtro especificando um sufixo de assunto.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Crie uma nova assinatura de evento para uma assinatura do Azure, usando filtros padrão, e um EventHub como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Crie uma nova assinatura de evento para uma assinatura do Azure, usando filtros padrão e uma fila de Armazenamento do Azure como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Crie uma nova assinatura de evento para uma assinatura do Azure, usando filtros padrão, e um ServiceBusQueue do Azure como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

Crie uma nova assinatura de evento para um domínio de Grade de Eventos, usando filtros padrão, e o CloudEvent V 1.0 como o esquema de entrega.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Crie uma nova assinatura de evento para uma conta de armazenamento, com um destino de carta morta e uma política de repetição personalizada de no máximo 10 tentativas de entrega e um TTL de evento de 2 horas (o que acontecer primeiro).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120

Crie uma nova assinatura de evento para um tópico de domínio.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Crie uma nova assinatura de evento (para uma conta de armazenamento) com uma data de validade.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

Crie uma nova assinatura de evento para um tópico da Grade de Eventos, usando o Webhook habilitado para o Ative Directory do Azure como destino.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Crie uma nova assinatura de evento para um tópico da Grade de Eventos, usando a Função do Azure como destino.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Criar uma nova assinatura de evento para um tópico da Grade de Eventos, usando o Eventhub com identidade MSI atribuída pelo sistema como destino e com letra morta com identidade MSI

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

--advanced-filter

Um filtro avançado permite a filtragem de eventos com base em uma propriedade de evento específica.

Uso: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALOR [VALOR ...] StringIn: --advanced-filter data. Cor StringIn Azul Vermelho Laranja Amarelo StringNotIn: --advanced-filter data. Cor StringNotIn Azul Vermelho Laranja Amarelo 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 Vários filtros avançados podem ser especificados usando mais de um --advanced-filter argumento.

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

A ID ou Uri do Aplicativo do Azure Ative Directory para obter o token de acesso que será incluído como o token de portador nas solicitações de entrega. Aplicável apenas para webhook como destino.

--azure-active-directory-tenant-id

A ID de Locatário do Azure Ative Directory para obter o token de acesso que será incluído como o token de portador nas solicitações de entrega. Aplicável apenas para webhook como destino.

--deadletter-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure onde EventGrid deve fazer deadletter de eventos não entregues para esta assinatura de evento.

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

--deadletter-identity

O tipo de identidade do recurso de destino de letra morta.

valores aceites: systemassigned
--deadletter-identity-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure com identidade onde EventGrid deve fazer deadletter de eventos não entregáveis para esta assinatura de evento.

--delivery-identity

O tipo de identidade do recurso de destino de entrega (por exemplo, fila de armazenamento ou eventhub).

valores aceites: systemassigned
--delivery-identity-endpoint

Ponto de extremidade com identidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade.

--delivery-identity-endpoint-type

O tipo do ponto de extremidade de destino com identidade de recurso.

valores aceites: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Ponto de extremidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade.

--endpoint-type

O tipo do ponto de extremidade de destino.

valores aceites: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
valor predefinido: webhook
--event-delivery-schema

O esquema no qual os eventos devem ser entregues para esta assinatura de evento. Por padrão, os eventos serão entregues no mesmo esquema em que são publicados (com base no esquema de entrada do tópico correspondente).

valores aceites: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Tempo de vida do evento (em minutos). Deve ser um número entre 1 e 1440.

valor predefinido: 1440
--expiration-date

Data ou data/hora (em UTC, por exemplo, '2018-11-30T11:59:59+00:00' ou '2018-11-30') após a qual a subscrição do evento expiraria. Por padrão, não há expiração para a assinatura do evento.

--included-event-types

Uma lista separada por espaços de tipos de eventos. Exemplo: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Para assinar todos os tipos de evento padrão, não especifique nenhum valor para esse argumento.

--labels

Uma lista separada por espaços de etiquetas para associar a esta subscrição de evento.

--max-delivery-attempts

Número máximo de tentativas de entrega. Deve ser um número entre 1 e 30.

valor predefinido: 30
--max-events-per-batch

Número máximo de eventos em um lote. Deve ser um número entre 1 e 5000.

--preferred-batch-size-in-kilobytes

Tamanho de lote preferido em kilobytes. Deve ser um número entre 1 e 1024.

--source-resource-id

Identificador totalmente qualificado do recurso do Azure para o qual a assinatura de evento precisa ser criada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo. Não há suporte para caracteres curinga.

--subject-case-sensitive

Especificar para indicar se os campos temáticos devem ser comparados de uma forma que diferencie maiúsculas de minúsculas. True se a bandeira estiver presente.

valores aceites: false, true
valor predefinido: False
--subject-ends-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo. Não há suporte para caracteres curinga.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription delete

Editar

Exclua uma assinatura de evento.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Exemplos

Excluir uma assinatura de evento para um tópico da Grade de Eventos.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Excluir uma assinatura de evento para um tópico de domínio da Grade de Eventos.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Exclua uma assinatura de evento para um domínio da Grade de Eventos.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Exclua uma assinatura de evento para uma assinatura do Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Excluir uma assinatura de evento para um grupo de recursos.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Exclua uma assinatura de evento para uma conta de armazenamento.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser excluída.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription delete (eventgrid extensão)

Pré-visualizar

O grupo de comandos 'az eventgrid' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua uma assinatura de evento.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Exemplos

Excluir uma assinatura de evento para um tópico da Grade de Eventos.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Excluir uma assinatura de evento para um tópico de domínio da Grade de Eventos.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Exclua uma assinatura de evento para um domínio da Grade de Eventos.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Exclua uma assinatura de evento para uma assinatura do Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Excluir uma assinatura de evento para um grupo de recursos.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Exclua uma assinatura de evento para uma conta de armazenamento.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser excluída.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription list

Editar

Listar assinaturas de eventos.

A Grade de Eventos dá suporte a assinaturas de eventos regionais e globais: as assinaturas de eventos em recursos regionais (como contas de Armazenamento ou tópicos de Grade de Eventos) são regionais, enquanto as assinaturas de eventos em recursos globais (como uma assinatura do Azure ou grupo de recursos) são globais. Assim, você pode listar assinaturas de eventos de algumas maneiras diferentes:

  1. Para listar pela ID do recurso cujas assinaturas de evento você deseja listar, especifique o parâmetro --source-resource-id. Nenhum outro parâmetro deve ser especificado.
  2. Para listar por um tipo de tópico (por exemplo, contas de armazenamento), especifique o parâmetro --topic-type junto com o parâmetro --location (por exemplo, "westus2"). Para tipos de tópicos globais (por exemplo, "Microsoft.Resources.Subscriptions"), especifique o valor do local como "global".
  3. Para listar todas as assinaturas de eventos em uma região (em todos os tipos de tópico), especifique apenas o parâmetro --location.
  4. Para #2 e #3 acima, para filtrar apenas por um grupo de recursos, você pode especificar adicionalmente o parâmetro --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Exemplos

Liste todas as assinaturas de eventos criadas para um tópico da Grade de Eventos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Liste todas as assinaturas de eventos criadas para uma conta de armazenamento.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Liste todas as assinaturas de eventos criadas para uma assinatura do Azure.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Liste todas as assinaturas de eventos criadas para um grupo de recursos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Liste todas as assinaturas de eventos para um domínio da Grade de Eventos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Liste todas as assinaturas de eventos para um tópico de domínio da Grade de Eventos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Liste todas as assinaturas de eventos de armazenamento (sob a assinatura do Azure atualmente selecionada) no westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Liste todas as assinaturas de eventos de armazenamento (sob o grupo de recursos fornecido) no westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Liste todas as assinaturas de eventos regionais ou globais (sob a assinatura do Azure selecionada no momento).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Liste todas as assinaturas de eventos regionais ou globais em um grupo de recursos especificado.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Listar todas as assinaturas de eventos para um domínio de Grade de Eventos cujo nome contém o padrão "XYZ"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Listar todas as assinaturas de eventos para um domínio da Grade de Eventos, exceto a assinatura de evento com o nome "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Parâmetros Opcionais

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--odata-query

A consulta OData usada para filtrar os resultados da lista. Atualmente, a filtragem é permitida apenas na propriedade Name. As operações suportadas incluem: CONTÉM, eq (para igual), ne (para não igual), E, OU e NÃO.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser listada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nome do tipo de tópico cujas assinaturas de evento precisam ser listadas. Quando isso é especificado, você também deve especificar --location.

Exemplo 1: Listar todas as assinaturas de eventos de armazenamento no WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Exemplo 2: Listar todas as assinaturas de eventos em assinaturas do Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription list (eventgrid extensão)

Pré-visualizar

O grupo de comandos 'az eventgrid' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Listar assinaturas de eventos.

A Grade de Eventos dá suporte a assinaturas de eventos regionais e globais: as assinaturas de eventos em recursos regionais (como contas de Armazenamento ou tópicos de Grade de Eventos) são regionais, enquanto as assinaturas de eventos em recursos globais (como uma assinatura do Azure ou grupo de recursos) são globais. Assim, você pode listar assinaturas de eventos de algumas maneiras diferentes:

  1. Para listar pela ID do recurso cujas assinaturas de evento você deseja listar, especifique o parâmetro --source-resource-id. Nenhum outro parâmetro deve ser especificado.
  2. Para listar por um tipo de tópico (por exemplo, contas de armazenamento), especifique o parâmetro --topic-type junto com o parâmetro --location (por exemplo, "westus2"). Para tipos de tópicos globais (por exemplo, "Microsoft.Resources.Subscriptions"), especifique o valor do local como "global".
  3. Para listar todas as assinaturas de eventos em uma região (em todos os tipos de tópico), especifique apenas o parâmetro --location.
  4. Para #2 e #3 acima, para filtrar apenas por um grupo de recursos, você pode especificar adicionalmente o parâmetro --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Exemplos

Liste todas as assinaturas de eventos criadas para um tópico da Grade de Eventos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Liste todas as assinaturas de eventos criadas para uma conta de armazenamento.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Liste todas as assinaturas de eventos criadas para uma assinatura do Azure.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Liste todas as assinaturas de eventos criadas para um grupo de recursos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Liste todas as assinaturas de eventos para um domínio da Grade de Eventos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Liste todas as assinaturas de eventos para um tópico de domínio da Grade de Eventos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Liste todas as assinaturas de eventos de armazenamento (sob a assinatura do Azure atualmente selecionada) no westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Liste todas as assinaturas de eventos de armazenamento (sob o grupo de recursos fornecido) no westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Liste todas as assinaturas de eventos regionais ou globais (sob a assinatura do Azure selecionada no momento).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Liste todas as assinaturas de eventos regionais ou globais em um grupo de recursos especificado.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Listar todas as assinaturas de eventos para um domínio de Grade de Eventos cujo nome contém o padrão "XYZ"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Listar todas as assinaturas de eventos para um domínio da Grade de Eventos, exceto a assinatura de evento com o nome "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Parâmetros Opcionais

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--odata-query

A consulta usada para filtrar os resultados usando a sintaxe OData.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser listada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nome do tipo de tópico cujas assinaturas de evento precisam ser listadas. Quando isso é especificado, você também deve especificar --location.

Exemplo 1: Listar todas as assinaturas de eventos de armazenamento no WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Exemplo 2: Listar todas as assinaturas de eventos em assinaturas do Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription show

Editar

Obtenha os detalhes de uma assinatura de evento.

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

Exemplos

Mostrar os detalhes de uma assinatura de evento para um tópico da Grade de Eventos.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Mostrar os detalhes de uma assinatura de evento para uma assinatura do Azure.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Mostrar os detalhes de uma assinatura de evento para um grupo de recursos.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Mostrar os detalhes de uma assinatura de evento para uma conta de armazenamento.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Mostrar os detalhes de uma assinatura de evento para um grupo de recursos, incluindo quaisquer segredos de atributo de entrega estático.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
    --include-static-delivery-attribute-secret

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

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

Indique se algum segredo de atributo de entrega estático deve ser retornado. True se a bandeira estiver presente.

valores aceites: false, true
valor predefinido: False
--include-full-endpoint-url

Especifique para indicar se a URL completa do ponto de extremidade deve ser retornada. True se a bandeira estiver presente.

valores aceites: false, true
valor predefinido: False
--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser mostrada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription show (eventgrid extensão)

Pré-visualizar

O grupo de comandos 'az eventgrid' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Obtenha os detalhes de uma assinatura de evento.

az eventgrid event-subscription show --name
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Exemplos

Mostrar os detalhes de uma assinatura de evento para um tópico da Grade de Eventos.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Mostrar os detalhes de uma assinatura de evento para uma assinatura do Azure.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Mostrar os detalhes de uma assinatura de evento para um grupo de recursos.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Mostrar os detalhes de uma assinatura de evento para uma conta de armazenamento.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

--include-full-endpoint-url

Especifique para indicar se a URL completa do ponto de extremidade deve ser retornada. True se a bandeira estiver presente.

valores aceites: false, true
valor predefinido: False
--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser mostrada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription update

Editar

Atualizar uma assinatura de evento.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Exemplos

Atualize uma assinatura de evento para um tópico de Grade de Eventos para especificar um novo ponto de extremidade.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Atualize uma assinatura de evento para uma assinatura do Azure para especificar um novo filtro assunto-termina-com.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Atualize uma assinatura de evento para um grupo de recursos para especificar um novo ponto de extremidade e um novo filtro assunto-termina-com.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Atualize uma assinatura de evento para uma conta de armazenamento para especificar uma nova lista de tipos de eventos incluídos.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Atualize uma assinatura de evento para uma conta de armazenamento, para incluir um destino de letra morta.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Atualize uma assinatura de evento para uma conta de armazenamento, usando filtros avançados.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Atualize uma assinatura de evento para uma conta de armazenamento para incluir a mensagem ttl definida como 5 minutos.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

Atualizar uma assinatura de evento com filtragem avançada habilitada em matrizes

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --enable-advanced-filtering-on-arrays true

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

valor predefinido: []
--advanced-filter

Um filtro avançado permite a filtragem de eventos com base em uma propriedade de evento específica.

Uso: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALOR [VALOR ...] StringIn: --advanced-filter data. Cor StringIn Azul Vermelho Laranja Amarelo StringNotIn: --advanced-filter data. Cor StringNotIn Azul Vermelho Laranja Amarelo StringContains: --assunto de filtro avançado StringContains Vermelho Azul StringNotContains: --assunto de filtro avançado StringNotContains Vermelho Azul StringBeginsWith: --assunto de filtro avançado StringBeginsCom vermelho azul StringNotBeginsWith: --assunto de filtro avançado StringNotBeginsCom vermelho azul StringEndsWith: --assunto de filtro avançado StringEndsCom img png jpg StringNotEndsWith: --sujeito de filtro avançado 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 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Vários filtros avançados podem ser especificados usando mais de um --advanced-filter argumento.

--deadletter-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure onde EventGrid deve fazer deadletter de eventos não entregues para esta assinatura de evento.

--deadletter-identity
Pré-visualizar

O tipo de identidade do recurso de destino de letra morta.

valores aceites: systemassigned
--deadletter-identity-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure com identidade onde EventGrid deve fazer deadletter de eventos não entregáveis para esta assinatura de evento.

--delivery-attribute-mapping

Adicione o mapeamento de atributos de entrega para enviar informações adicionais por meio de cabeçalhos HTTP ao entregar eventos. Esse atributo é válido para todos os tipos de destino, exceto StorageQueue. Vários atributos podem ser especificados usando mais de um --delivery-attribute-mapping argumento.

Uso: --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 Estático e Dinâmico: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Pré-visualizar

O tipo de identidade do recurso de destino de entrega (por exemplo, fila de armazenamento ou eventhub).

valores aceites: systemassigned
--delivery-identity-endpoint
Pré-visualizar

Ponto de extremidade com identidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade.

--delivery-identity-endpoint-type
Pré-visualizar

O tipo do ponto de extremidade de destino com identidade de recurso.

valores aceites: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Permite que filtros avançados sejam avaliados em relação a uma matriz de valores em vez de esperar um valor singular.

valores aceites: false, true
--endpoint

Ponto de extremidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade. Espera-se que o ponto de extremidade de destino já esteja criado e disponível para uso antes de executar qualquer comando da Grade de Eventos.

--endpoint-type

O tipo do ponto de extremidade de destino.

valor predefinido: webhook
--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

valor predefinido: False
--included-event-types

Uma lista separada por espaços de tipos de eventos (por exemplo, Microsoft.Storage.BlobCreated e Microsoft.Storage.BlobDeleted). Para se inscrever em todos os tipos de evento padrão, não especifique nenhum valor para esse argumento. Para tópicos de grade de eventos, os tipos de evento são definidos pelo cliente. Para eventos do Azure, por exemplo, Contas de Armazenamento, Hub IoT, etc., você pode consultar seus tipos de evento usando este comando da CLI 'az eventgrid topic-type list-event-types'.

--labels

Uma lista separada por espaços de etiquetas para associar a esta subscrição de evento.

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

Tempo de vida da mensagem da fila de armazenamento em segundos.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valor predefinido: []
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

valor predefinido: []
--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser atualizada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo. Não há suporte para caracteres curinga.

--subject-ends-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo. Não há suporte para caracteres curinga.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az eventgrid event-subscription update (eventgrid extensão)

Pré-visualizar

O grupo de comandos 'az eventgrid' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualizar uma assinatura de evento.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Exemplos

Atualize uma assinatura de evento para um tópico de Grade de Eventos para especificar um novo ponto de extremidade.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Atualize uma assinatura de evento para uma assinatura do Azure para especificar um novo filtro assunto-termina-com.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Atualize uma assinatura de evento para um grupo de recursos para especificar um novo ponto de extremidade e um novo filtro assunto-termina-com.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Atualize uma assinatura de evento para uma conta de armazenamento para especificar uma nova lista de tipos de eventos incluídos.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Atualize uma assinatura de evento para uma conta de armazenamento, para incluir um destino de letra morta.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Atualize uma assinatura de evento para uma conta de armazenamento, usando filtros avançados.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Parâmetros Obrigatórios

--name -n

Nome da assinatura do evento.

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

valor predefinido: []
--advanced-filter

Um filtro avançado permite a filtragem de eventos com base em uma propriedade de evento específica.

Uso: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALOR [VALOR ...] StringIn: --advanced-filter data. Cor StringIn Azul Vermelho Laranja Amarelo StringNotIn: --advanced-filter data. Cor StringNotIn Azul Vermelho Laranja Amarelo 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 Vários filtros avançados podem ser especificados usando mais de um --advanced-filter argumento.

--deadletter-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure onde EventGrid deve fazer deadletter de eventos não entregues para esta assinatura de evento.

--deadletter-identity

O tipo de identidade do recurso de destino de letra morta.

valores aceites: systemassigned
--deadletter-identity-endpoint

A ID de recurso do Azure de um destino de contêiner de blob de Armazenamento do Azure com identidade onde EventGrid deve fazer deadletter de eventos não entregáveis para esta assinatura de evento.

--delivery-identity

O tipo de identidade do recurso de destino de entrega (por exemplo, fila de armazenamento ou eventhub).

valores aceites: systemassigned
--delivery-identity-endpoint

Ponto de extremidade com identidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade.

--delivery-identity-endpoint-type

O tipo do ponto de extremidade de destino com identidade de recurso.

valores aceites: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Ponto de extremidade onde o EventGrid deve fornecer eventos correspondentes a essa assinatura de evento. Para o tipo de ponto de extremidade webhook, este deve ser o URL de webhook correspondente. Para outros tipos de ponto de extremidade, esse deve ser o identificador de recurso do Azure do ponto de extremidade.

--endpoint-type

O tipo do ponto de extremidade de destino.

valores aceites: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
valor predefinido: webhook
--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

valor predefinido: False
--included-event-types

Uma lista separada por espaços de tipos de eventos. Exemplo: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Para assinar todos os tipos de evento padrão, não especifique nenhum valor para esse argumento.

--labels

Uma lista separada por espaços de etiquetas para associar a esta subscrição de evento.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valor predefinido: []
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

valor predefinido: []
--source-resource-id

Identificador totalmente qualificado do recurso do Azure cuja assinatura de evento precisa ser atualizada.

Uso: --source-resource-id Azure-Resource-ID Para assinatura do Azure: --source-resource-id /subscriptions/{SubID} Para grupo de recursos: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Para o tópico EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Para conta de armazenamento: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Para domínio EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Para o tópico de domínio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo. Não há suporte para caracteres curinga.

--subject-ends-with

Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo. Não há suporte para caracteres curinga.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.