Поделиться через

az eventgrid topic

Управление разделами "Сетка событий Azure".

Команды

Имя Описание Тип Состояние
az eventgrid topic create

Создайте раздел.

 Core GA
az eventgrid topic delete

Удаление раздела.

 Core GA
az eventgrid topic event-subscription

Управление подписками на события раздела.

 Core GA
az eventgrid topic event-subscription create

Создайте новую подписку на события для раздела.

 Core GA
az eventgrid topic event-subscription delete

Удаление подписки на событие раздела.

 Core GA
az eventgrid topic event-subscription list

Вывод списка подписок на события определенного раздела.

 Core GA
az eventgrid topic event-subscription show

Получение сведений о подписке на событие раздела.

 Core GA
az eventgrid topic event-subscription update

Обновите подписку на событие раздела.

 Core GA
az eventgrid topic key

Управление ключами общего доступа раздела.

 Core GA
az eventgrid topic key list

Вывод списка ключей общего доступа раздела.

 Core GA
az eventgrid topic key regenerate

Повторно создайте общий ключ доступа раздела.

 Core GA
az eventgrid topic list

Список доступных разделов.

 Core GA
az eventgrid topic show

Получение сведений о разделе.

 Core GA
az eventgrid topic update

Обновление раздела.

 Core GA

az eventgrid topic create

Изменить

Создайте раздел.

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]

Примеры

Создайте новый раздел.

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

Создайте новый раздел с пользовательскими сопоставлениями входных данных.

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

Создайте новый раздел, который принимает события, опубликованные в схеме CloudEvents версии 1.0.

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

Создание нового раздела, позволяющего использовать определенные правила для входящего IP-адреса с помощью SKU уровня "Базовый" и назначенного системой удостоверения

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

Создайте новый раздел в Azure.

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

Создайте новый раздел в Azure.

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

Создайте новый раздел в AzureArc, предназначенный для пользовательского расположения.

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

Обязательные параметры

--name -n

Имя раздела.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

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
Предварительный просмотр

Имя расширенного расположения, если kind==azurearc.

Свойство Значение
Parameter group: Azure Arc Arguments
--extended-location-type
Предварительный просмотр

Тип расширенного расположения, если kind==azurearc.

Свойство Значение
Parameter group: Azure Arc Arguments
Допустимые значения: customlocation
--identity
Предварительный просмотр Не рекомендуется

Аргумент "identity" устарел и будет удален в будущем выпуске.

Тип управляемого удостоверения для ресурса. В будущем будет устарело и заменено удостоверением --mi-system-assigned-identity.

Свойство Значение
Допустимые значения: noidentity, systemassigned
--inbound-ip-rules

Список правил входящего IP-адреса.

Список правил входящего IP-адреса, указывающих IP-адрес в нотации CIDR, например 10.0.0.0/8, а также соответствующее действие для выполнения на основе соответствия или отсутствия соответствия IpMask. Возможные значения: allow.

--input-mapping-default-values

Если входная схема указана как customeventschema, этот параметр можно использовать для указания сопоставлений входных данных на основе значений по умолчанию. Этот параметр можно использовать, если настраиваемая схема не включает поле, соответствующее одному из трех полей, поддерживаемых этим параметром. Укажите разделенные пробелами сопоставления в формате key=value. Допустимые имена ключей: subject, eventtype, dataversion. Соответствующие имена значений должны указывать значения по умолчанию, используемые для сопоставления, и они будут использоваться только в том случае, если опубликованное событие не имеет допустимого сопоставления для определенного поля.

--input-mapping-fields

Если входная схема указана как customeventschema, этот параметр используется для указания сопоставлений входных данных на основе имен полей. Укажите разделенные пробелами сопоставления в формате key=value. Допустимые имена ключей: "id", "topic", "eventtime", "subject", "eventtype", "dataversion". Соответствующие имена значений должны указывать имена полей в пользовательской схеме ввода. Если сопоставление для идентификатора или события не указано, сетка событий автоматически создаст значение по умолчанию для этих двух полей.

--input-schema

Схема, в которой будут опубликованы входящие события в этом разделе или домене. Если в качестве значения этого параметра указывается customeventschema, необходимо также указать значения по крайней мере для одного из --input_mapping_default_values / --input_mapping_fields.

Свойство Значение
Default value: eventgridschema
Допустимые значения: cloudeventschemav1_0, customeventschema, eventgridschema
--kind
Предварительный просмотр

Тип ресурса раздела.

Свойство Значение
Default value: Azure
Допустимые значения: azure, azurearc
--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--mi-system-assigned

Наличие этого парама указывает, что будет использоваться управляемое удостоверение SystemAssigned.

--mi-user-assigned
Предварительный просмотр

Добавьте удостоверения, назначенные пользователем, если identityType является пользователем или смешанным. Этот атрибут действителен для всех типов назначения, кроме StorageQueue. Несколько атрибутов можно указать с помощью нескольких --mi-user-assigned аргументов.

--public-network-access

Это определяет, разрешен ли трафик через общедоступную сеть. По умолчанию она включена. Можно дополнительно ограничить определенные IP-адреса, настроив его.

Свойство Значение
Допустимые значения: disabled, enabled
--sku
Предварительный просмотр

Имя SKU ресурса.

Свойство Значение
Default value: Basic
Допустимые значения: basic, premium
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az eventgrid topic delete

Изменить

Удаление раздела.

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

Примеры

Удаление раздела.

az eventgrid topic delete -g rg1 --name topic1

Необязательные параметры

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Parameter group: Resource Id Arguments
--name -n

Имя раздела.

Свойство Значение
Parameter group: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Parameter group: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Parameter group: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az eventgrid topic list

Изменить

Список доступных разделов.

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

Примеры

Список всех разделов в текущей подписке Azure.

az eventgrid topic list

Список всех разделов в группе ресурсов.

az eventgrid topic list -g rg1

Список всех разделов в группе ресурсов, имя которой содержит шаблон XYZ.

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

Список всех разделов в группе ресурсов, кроме домена с именем "name1"

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

Необязательные параметры

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

--odata-query

Запрос OData, используемый для фильтрации результатов списка. Фильтрация в настоящее время разрешена только в свойстве Name. Поддерживаемые операции включают: CONTAINS, eq (for equal), ne (for not equal), AND, OR и NOT.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az eventgrid topic show

Изменить

Получение сведений о разделе.

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

Примеры

Отображение сведений о разделе.

az eventgrid topic show -g rg1 -n topic1

Отображение сведений о разделе на основе идентификатора ресурса.

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

Необязательные параметры

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Parameter group: Resource Id Arguments
--name -n

Имя раздела.

Свойство Значение
Parameter group: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Parameter group: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Parameter group: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az eventgrid topic update

Изменить

Обновление раздела.

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]

Примеры

Обновите свойства существующего раздела с новыми сведениями об идентификаторе, удостоверении и доступе к общедоступной сети.

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

Необязательные параметры

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

--identity
Предварительный просмотр Не рекомендуется

Аргумент "identity" устарел и будет удален в будущем выпуске.

Тип управляемого удостоверения для ресурса. В будущем будет устарело и заменено удостоверением --mi-system-assigned-identity.

Свойство Значение
Допустимые значения: noidentity, systemassigned
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Parameter group: Resource Id Arguments
--inbound-ip-rules

Список правил входящего IP-адреса, указывающих IP-адрес в нотации CIDR, например 10.0.0.0/8, а также соответствующее действие для выполнения на основе соответствия или отсутствия соответствия IpMask. Возможные значения: allow.

--mi-system-assigned

Наличие этого парама указывает, что будет использоваться управляемое удостоверение SystemAssigned.

--mi-user-assigned
Предварительный просмотр

Добавьте удостоверения, назначенные пользователем, если identityType является пользователем или смешанным. Этот атрибут действителен для всех типов назначения, кроме StorageQueue. Несколько атрибутов можно указать с помощью нескольких --mi-user-assigned аргументов.

--name -n

Имя раздела.

Свойство Значение
Parameter group: Resource Id Arguments
--public-network-access

Это определяет, разрешен ли трафик через общедоступную сеть. По умолчанию она включена. Можно дополнительно ограничить определенные IP-адреса, настроив его.

Свойство Значение
Допустимые значения: disabled, enabled
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Parameter group: Resource Id Arguments
--sku
Предварительный просмотр

Имя SKU ресурса.

Свойство Значение
Допустимые значения: basic, premium
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Parameter group: Resource Id Arguments
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False