az eventgrid topic

Administración de temas de Azure Event Grid.

Comandos

Nombre	Description	Tipo	Estado
az eventgrid topic create	Crear un tema.	Core	GA
az eventgrid topic delete	Eliminar un tema.	Core	GA
az eventgrid topic event-subscription	Administrar suscripciones de eventos del tema.	Core	GA
az eventgrid topic event-subscription create	Cree una nueva suscripción de eventos para un tema.	Core	GA
az eventgrid topic event-subscription delete	Elimina una suscripción de eventos de un tema.	Core	GA
az eventgrid topic event-subscription list	Enumerar suscripciones de eventos de un tema específico.	Core	GA
az eventgrid topic event-subscription show	Obtenga los detalles de una suscripción de eventos de un tema.	Core	GA
az eventgrid topic event-subscription update	Actualizar una suscripción de eventos de un tema.	Core	GA
az eventgrid topic key	Administrar claves de acceso compartido de un tema.	Core	GA
az eventgrid topic key list	Enumerar las claves de acceso compartido de un tema.	Core	GA
az eventgrid topic key regenerate	Vuelva a generar una clave de acceso compartido de un tema.	Core	GA
az eventgrid topic list	Enumerar los temas disponibles.	Core	GA
az eventgrid topic show	Obtenga los detalles de un tema.	Core	GA
az eventgrid topic update	Actualizar un tema.	Core	GA

az eventgrid topic create

Crear un tema.

az eventgrid topic create --name
                          --resource-group
                          [--extended-location-name]
                          [--extended-location-type {customlocation}]
                          [--identity {noidentity, systemassigned}]
                          [--inbound-ip-rules]
                          [--input-mapping-default-values]
                          [--input-mapping-fields]
                          [--input-schema {cloudeventschemav1_0, customeventschema, eventgridschema}]
                          [--kind {azure, azurearc}]
                          [--location]
                          [--mi-system-assigned]
                          [--mi-user-assigned]
                          [--public-network-access {disabled, enabled}]
                          [--sku {basic, premium}]
                          [--tags]

Ejemplos

Cree un tema nuevo.

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

Cree un tema con asignaciones de entrada personalizadas.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema customeventschema --input-mapping-fields topic=myTopicField eventType=myEventTypeField --input-mapping-default-values subject=DefaultSubject dataVersion=1.0

Cree un tema que acepte eventos publicados en el esquema CloudEvents V1.0.

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

Creación de un tema que permita reglas ip de entrada específicas con SKU básica y identidad asignada por el sistema

az eventgrid topic create -g rg1 --name topic1 -l westus2 --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --sku Basic --identity systemassigned

Cree un tema en Azure.

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

Cree un tema en Azure.

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

Cree un tema en AzureArc destinado a una ubicación personalizada.

az eventgrid topic create -g rg1 --name topic1 -l eastus2euap --kind azurearc --extended-location-name /subscriptions/<subid>/resourcegroups/<rgname>/providers/microsoft.extendedlocation/customlocations/<cust-loc-name> --extended-location-type customlocation --input-schema CloudEventSchemaV1_0

Parámetros requeridos

--name -n

Nombre del tema.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--extended-location-name

Vista previa

Nombre de ubicación extendida si kind==azurearc.

Propiedad	Valor
Parameter group:	Azure Arc Arguments

--extended-location-type

Vista previa

Tipo de ubicación extendida si kind==azurearc.

Propiedad	Valor
Parameter group:	Azure Arc Arguments
Valores aceptados:	customlocation

--identity

Vista previa Obsoleto

El argumento 'identity' está en desuso y se quitará en una versión futura.

Tipo de identidad administrada para el recurso. Quedará en desuso y se reemplazará por --mi-system-assigned-identity en el futuro.

Propiedad	Valor
Valores aceptados:	noidentity, systemassigned

--inbound-ip-rules

Lista de reglas ip de entrada.

Lista de reglas IP de entrada que especifican la dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8 junto con la acción correspondiente para realizar en función de la coincidencia o ninguna coincidencia de IpMask. Entre los valores posibles se incluyen: Permitir.

--input-mapping-default-values

Cuando se especifica input-schema como customeventschema, este parámetro se puede usar para especificar asignaciones de entrada basadas en valores predeterminados. Puede usar este parámetro cuando el esquema personalizado no incluya un campo que corresponda a uno de los tres campos admitidos por este parámetro. Especifique asignaciones separadas por espacios en formato 'key=value'. Los nombres de clave permitidos son 'subject', 'eventtype', 'dataversion'. Los nombres de valor correspondientes deben especificar los valores predeterminados que se usarán para la asignación y solo se usarán cuando el evento publicado no tenga una asignación válida para un campo determinado.

--input-mapping-fields

Cuando se especifica input-schema como customeventschema, este parámetro se usa para especificar asignaciones de entrada basadas en nombres de campo. Especifique asignaciones separadas por espacios en formato 'key=value'. Los nombres de clave permitidos son 'id', 'topic', 'eventtime', 'subject', 'eventtype', 'dataversion'. Los nombres de valor correspondientes deben especificar los nombres de los campos del esquema de entrada personalizado. Si no se proporciona una asignación para "id" o "eventtime", Event Grid generará automáticamente un valor predeterminado para estos dos campos.

--input-schema

Esquema en el que los eventos entrantes se publicarán en este tema o dominio. Si especifica customeventschema como valor para este parámetro, también debe proporcionar valores para al menos uno de --input_mapping_default_values / --input_mapping_fields.

Propiedad	Valor
Valor predeterminado:	eventgridschema
Valores aceptados:	cloudeventschemav1_0, customeventschema, eventgridschema

--kind

Vista previa

Tipo de recurso de tema.

Propiedad	Valor
Valor predeterminado:	Azure
Valores aceptados:	azure, azurearc

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--mi-system-assigned

La presencia de este parámetro indica que se usará la identidad administrada SystemAssigned.

--mi-user-assigned

Vista previa

Agregue identidades asignadas por el usuario cuando identityType sea usuario o mixto. Este atributo es válido para todos los tipos de destino, excepto StorageQueue. Se pueden especificar varios atributos mediante más de un argumento --mi-user-assigned.

--public-network-access

Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. Puede restringir aún más a direcciones IP específicas mediante la configuración.

Propiedad	Valor
Valores aceptados:	disabled, enabled

--sku

Vista previa

Nombre de Sku del recurso.

Propiedad	Valor
Valor predeterminado:	Basic
Valores aceptados:	basic, premium

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az eventgrid topic delete

Eliminar un tema.

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

Ejemplos

Eliminar un tema.

az eventgrid topic delete -g rg1 --name topic1

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Parameter group:	Resource Id Arguments

--name -n

Nombre del tema.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Parameter group:	Resource Id Arguments

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az eventgrid topic list

Enumerar los temas disponibles.

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

Ejemplos

Enumere todos los temas de la suscripción actual de Azure.

az eventgrid topic list

Enumere todos los temas de un grupo de recursos.

az eventgrid topic list -g rg1

Enumerar todos los temas de un grupo de recursos cuyo nombre contiene el patrón "XYZ"

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

Enumerar todos los temas de un grupo de recursos excepto el dominio con el nombre "name1"

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--odata-query

Consulta OData que se usa para filtrar los resultados de la lista. El filtrado solo se permite en la propiedad Name. Las operaciones admitidas incluyen: CONTAINS, eq (para igual), ne (para no igual), AND, OR y NOT.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az eventgrid topic show

Obtenga los detalles de un tema.

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

Ejemplos

Muestra los detalles de un tema.

az eventgrid topic show -g rg1 -n topic1

Mostrar los detalles de un tema basado en el identificador de recurso.

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Parameter group:	Resource Id Arguments

--name -n

Nombre del tema.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Parameter group:	Resource Id Arguments

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az eventgrid topic update

Actualizar un tema.

az eventgrid topic update [--identity {noidentity, systemassigned}]
                          [--ids]
                          [--inbound-ip-rules]
                          [--mi-system-assigned]
                          [--mi-user-assigned]
                          [--name]
                          [--public-network-access {disabled, enabled}]
                          [--resource-group]
                          [--sku {basic, premium}]
                          [--subscription]
                          [--tags]

Ejemplos

Actualice las propiedades de un tema existente con la nueva SKU, la identidad y la información de acceso a la red pública.

az eventgrid topic update -g rg1 --name topic1 --sku Premium --identity systemassigned --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --tags Dept=IT --sku basic

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--identity

Vista previa Obsoleto

El argumento 'identity' está en desuso y se quitará en una versión futura.

Tipo de identidad administrada para el recurso. Quedará en desuso y se reemplazará por --mi-system-assigned-identity en el futuro.

Propiedad	Valor
Valores aceptados:	noidentity, systemassigned

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Parameter group:	Resource Id Arguments

--inbound-ip-rules

Lista de reglas IP de entrada que especifican la dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8 junto con la acción correspondiente para realizar en función de la coincidencia o ninguna coincidencia de IpMask. Entre los valores posibles se incluyen: Permitir.

--mi-system-assigned

La presencia de este parámetro indica que se usará la identidad administrada SystemAssigned.

--mi-user-assigned

Vista previa

Agregue identidades asignadas por el usuario cuando identityType sea usuario o mixto. Este atributo es válido para todos los tipos de destino, excepto StorageQueue. Se pueden especificar varios atributos mediante más de un argumento --mi-user-assigned.

--name -n

Nombre del tema.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--public-network-access

Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. Puede restringir aún más a direcciones IP específicas mediante la configuración.

Propiedad	Valor
Valores aceptados:	disabled, enabled

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--sku

Vista previa

Nombre de Sku del recurso.

Propiedad	Valor
Valores aceptados:	basic, premium

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False