Share via


az eventgrid namespace topic

Nota

Essa referência faz parte da extensão eventgrid para a CLI do Azure (versão 2.51.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az eventgrid namespace topic . Saiba mais sobre extensões.

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

Tópico Gerenciar namespace de grade de eventos.

Comandos

Name Description Tipo Estado
az eventgrid namespace topic create

Crie um novo tópico de namespace.

Extensão Pré-visualizar
az eventgrid namespace topic delete

Excluir tópico de namespace existente.

Extensão Pré-visualizar
az eventgrid namespace topic event-subscription

Gerenciar assinatura de evento do tópico do namespace eventgrid.

Extensão Pré-visualizar
az eventgrid namespace topic event-subscription create

Crie uma assinatura de evento de um tópico de namespace.

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

Exclua uma assinatura de evento existente de um tópico de namespace.

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

Listar assinaturas de eventos que pertencem a um tópico de namespace específico.

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

Mostrar uma assinatura de evento de um tópico de namespace.

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

Atualizar uma assinatura de evento de um tópico de namespace.

Extensão Pré-visualizar
az eventgrid namespace topic event-subscription wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Extensão Pré-visualizar
az eventgrid namespace topic list

Liste todos os tópicos de namespace em um namespace.

Extensão Pré-visualizar
az eventgrid namespace topic list-key

Liste as duas chaves usadas para publicar em um tópico de namespace.

Extensão Pré-visualizar
az eventgrid namespace topic regenerate-key

Regenere uma chave de acesso compartilhada para um tópico de namespace.

Extensão Pré-visualizar
az eventgrid namespace topic show

Mostrar um tópico de namespace.

Extensão Pré-visualizar
az eventgrid namespace topic update

Atualize um tópico de namespace.

Extensão Pré-visualizar
az eventgrid namespace topic wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Extensão Pré-visualizar

az eventgrid namespace topic create

Pré-visualizar

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

Crie um novo tópico de namespace.

az eventgrid namespace topic create --name
                                    --namespace-name
                                    --resource-group
                                    [--event-retention-in-days]
                                    [--input-schema {CloudEventSchemaV1_0}]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--publisher-type {Custom}]

Exemplos

Criar tópico

az eventgrid namespace topic create -g rg -n topic --namespace-name name --event-retention-in-days 1 --publisher-type custom

Parâmetros Obrigatórios

--name --topic-name -n

Nome do tópico do namespace.

--namespace-name

Nome do namespace.

--resource-group -g

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

Parâmetros Opcionais

--event-retention-in-days

Retenção de eventos para o tópico de namespace expresso em dias.

--input-schema

Isso determina o formato esperado para eventos de entrada publicados no tópico.

valores aceites: CloudEventSchemaV1_0
valor predefinido: CloudEventSchemaV1_0
--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--publisher-type

Tipo de editor do tópico namespace.

valores aceites: Custom
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 namespace topic delete

Pré-visualizar

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

Excluir tópico de namespace existente.

az eventgrid namespace topic delete [--ids]
                                    [--name]
                                    [--namespace-name]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

Exemplos

Excluir tópico

az eventgrid namespace topic delete -g rg -n topic --namespace-name name

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --topic-name -n

Nome do tópico.

--namespace-name

Nome do namespace.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--yes -y

Não solicite confirmação.

valor predefinido: False
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 namespace topic list

Pré-visualizar

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

Liste todos os tópicos de namespace em um namespace.

az eventgrid namespace topic list --namespace-name
                                  --resource-group
                                  [--filter]
                                  [--max-items]
                                  [--next-token]
                                  [--top]

Exemplos

Tópico da lista

az eventgrid namespace topic list -g rg --namespace-name name

Parâmetros Obrigatórios

--namespace-name

Nome do namespace.

--resource-group -g

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

Parâmetros Opcionais

--filter

A consulta usada para filtrar os resultados da pesquisa usando a sintaxe OData. A filtragem é permitida apenas na propriedade 'name' e com um número limitado de operações OData. Estas operações são: a função «contém», bem como as seguintes operações lógicas: not, e, ou, eq (para igual) e ne (para não igual). Nenhuma operação aritmética é suportada. Segue-se um exemplo de filtro válido: $filter=contains(namE, 'PATTERN') e name ne 'PATTERN-1'. O seguinte não é um exemplo de filtro válido: $filter=location eq 'westus'.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor do token de uma resposta truncada anteriormente.

--top

O número de resultados a serem retornados por página para a operação de lista. O intervalo válido para o parâmetro superior é de 1 a 100. Se não for especificado, o número padrão de resultados a serem retornados é de 20 itens por página.

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 namespace topic list-key

Pré-visualizar

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

Liste as duas chaves usadas para publicar em um tópico de namespace.

az eventgrid namespace topic list-key [--ids]
                                      [--namespace-name]
                                      [--resource-group]
                                      [--subscription]
                                      [--topic-name]

Exemplos

Chave de lista

az eventgrid namespace topic list-key -g rg --topic-name topic --namespace-name name

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--namespace-name

Nome do namespace.

--resource-group -g

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

--subscription

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

--topic-name

Nome do tópico.

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 namespace topic regenerate-key

Pré-visualizar

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

Regenere uma chave de acesso compartilhada para um tópico de namespace.

az eventgrid namespace topic regenerate-key --key-name
                                            [--ids]
                                            [--namespace-name]
                                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                            [--resource-group]
                                            [--subscription]
                                            [--topic-name]

Exemplos

Regenerar chave

az eventgrid namespace topic regenerate-key -g rg --topic-name topic --namespace-name name --key-name key1

Parâmetros Obrigatórios

--key-name

Nome da chave para regenerar key1 ou key2.

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--namespace-name

Nome do namespace.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--topic-name

Nome do tópico.

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 namespace topic show

Pré-visualizar

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

Mostrar um tópico de namespace.

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

Exemplos

Mostrar tópico

az eventgrid namespace topic show -g rg -n topic --namespace-name name

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --topic-name -n

Nome do tópico do namespace.

--namespace-name

Nome do namespace.

--resource-group -g

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

--subscription

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

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 namespace topic update

Pré-visualizar

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

Atualize um tópico de namespace.

az eventgrid namespace topic update [--add]
                                    [--event-retention-in-days]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--ids]
                                    [--input-schema {CloudEventSchemaV1_0}]
                                    [--name]
                                    [--namespace-name]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--publisher-type {Custom}]
                                    [--remove]
                                    [--resource-group]
                                    [--set]
                                    [--subscription]

Exemplos

Atualizar tópico

az eventgrid namespace topic create -g rg -n topic --namespace-name name --input-schema CloudEventSchemaV1_0

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 ou JSON string>.

--event-retention-in-days

Retenção de eventos para o tópico de namespace expresso em dias.

--force-string

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

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--input-schema

Isso determina o formato esperado para eventos de entrada publicados no tópico.

valores aceites: CloudEventSchemaV1_0
--name --topic-name -n

Nome do tópico do namespace.

--namespace-name

Nome do namespace.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--publisher-type

Tipo de editor do tópico namespace.

valores aceites: Custom
--remove

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

--resource-group -g

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

--set

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

--subscription

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

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 namespace topic wait

Pré-visualizar

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

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az eventgrid namespace topic wait [--created]
                                  [--custom]
                                  [--deleted]
                                  [--exists]
                                  [--ids]
                                  [--interval]
                                  [--name]
                                  [--namespace-name]
                                  [--resource-group]
                                  [--subscription]
                                  [--timeout]
                                  [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--name --topic-name -n

Nome do tópico do namespace.

--namespace-name

Nome do namespace.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
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.