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


az eventgrid topic

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

Команды

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

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

Ядро ГА
az eventgrid topic delete

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

Ядро ГА
az eventgrid topic event-subscription

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

Ядро ГА
az eventgrid topic event-subscription create

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

Ядро ГА
az eventgrid topic event-subscription delete

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

Ядро ГА
az eventgrid topic event-subscription list

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

Ядро ГА
az eventgrid topic event-subscription show

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

Ядро ГА
az eventgrid topic event-subscription update

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

Ядро ГА
az eventgrid topic key

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

Ядро ГА
az eventgrid topic key list

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

Ядро ГА
az eventgrid topic key regenerate

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

Ядро ГА
az eventgrid topic list

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

Ядро ГА
az eventgrid topic show

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

Ядро ГА
az eventgrid topic update

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

Ядро ГА

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>.

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

--extended-location-name
Предварительный просмотр

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

--extended-location-type
Предварительный просмотр

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

Допустимые значения: 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.

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

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

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

Местоположение. Значения из: 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 ресурса.

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

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

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

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

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

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

--output -o

Формат вывода.

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

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

--subscription

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

--verbose

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

az eventgrid topic delete

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

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

Примеры

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

az eventgrid topic delete -g rg1 --name topic1

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

--ids

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

--name -n

Имя раздела.

--resource-group -g

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

--subscription

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

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

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

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

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

--output -o

Формат вывода.

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

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

--subscription

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

--verbose

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

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')"

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

--odata-query

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

--resource-group -g

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

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

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

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

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

--output -o

Формат вывода.

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

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

--subscription

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

--verbose

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

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

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

--ids

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

--name -n

Имя раздела.

--resource-group -g

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

--subscription

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

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

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

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

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

--output -o

Формат вывода.

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

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

--subscription

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

--verbose

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

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

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

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

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

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

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

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

--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

Имя раздела.

--public-network-access

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

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

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

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

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

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

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

--tags

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

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

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

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

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

--output -o

Формат вывода.

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

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

--subscription

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

--verbose

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