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

az eventgrid system-topic event-subscription

  • Ссылка

Примечание.

Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Подробнее о расширениях.

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

Команды

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

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

 Основные сведения Общедоступная версия
az eventgrid system-topic event-subscription create (eventgrid Расширение)

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

 Расширение "Предварительная версия"
az eventgrid system-topic event-subscription delete

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

 Основные сведения Общедоступная версия
az eventgrid system-topic event-subscription delete (eventgrid Расширение)

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

 Расширение "Предварительная версия"
az eventgrid system-topic event-subscription list

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

 Основные сведения Общедоступная версия
az eventgrid system-topic event-subscription list (eventgrid Расширение)

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

 Расширение "Предварительная версия"
az eventgrid system-topic event-subscription show

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

 Основные сведения Общедоступная версия
az eventgrid system-topic event-subscription show (eventgrid Расширение)

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

 Расширение "Предварительная версия"
az eventgrid system-topic event-subscription update

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

 Основные сведения Общедоступная версия
az eventgrid system-topic event-subscription update (eventgrid Расширение)

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

 Расширение "Предварительная версия"

az eventgrid system-topic event-subscription create

Изменить

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

az eventgrid system-topic event-subscription create --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--aad-tenant-id]
                                                    [--advanced-filter]
                                                    [--azure-active-directory-application-id-or-uri]
                                                    [--deadletter-endpoint]
                                                    [--delivery-attribute-mapping]
                                                    [--enable-advanced-filtering-on-arrays {false, true}]
                                                    [--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]
                                                    [--qttl]
                                                    [--subject-begins-with]
                                                    [--subject-case-sensitive {false, true}]
                                                    [--subject-ends-with]

Примеры

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

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid system-topic event-subscription create --name es4 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Создайте новую подписку на события для системного раздела Сетки событий, используя фильтры по умолчанию и CloudEvent V 1.0 в качестве схемы доставки.

az eventgrid system-topic event-subscription create -n es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Создайте новую подписку на событие для системного раздела сетки событий с назначением недоставки и настраиваемой политикой повторных попыток не более 10 попыток доставки и сроком действия события в 2 часа (в зависимости от того, что происходит раньше) и датой окончания срока действия.

az eventgrid system-topic event-subscription create --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 --expiration-date "2022-10-31"

Создайте новую подписку на события для системного раздела сетки событий, используя веб-перехватчик с поддержкой Azure Active Directory в качестве назначения.

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Создайте новую подписку на события для системного раздела Сетки событий, используя функцию Azure в качестве назначения.

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Создание новой подписки на событие для системного раздела Сетки событий с помощью очереди служба хранилища в качестве назначения с ttl 5 мин

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Создайте новую подписку на события для системного раздела Сетки событий и включите расширенную фильтрацию по массивам

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
    --enable-advanced-filtering-on-arrays true

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

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

Идентификатор клиента Azure Active Directory для получения маркера доступа, который будет включен в качестве маркера носителя в запросах на доставку. Применимо только для веб-перехватчика в качестве назначения.

--advanced-filter

Расширенный фильтр позволяет фильтровать события на основе определенного свойства события.

Использование: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png png 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 NumberNotNotInRange 100,110 200 210 300 310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThanThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Multiple advanced filters можно указать с помощью нескольких --advanced-filter аргументов.

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

Идентификатор приложения Azure Active Directory или URI для получения маркера доступа, который будет включен в качестве маркера носителя в запросах на доставку. Применимо только для веб-перехватчика в качестве назначения.

--deadletter-endpoint

Идентификатор ресурса Azure для назначения контейнера больших двоичных объектов служба хранилища Azure, в котором EventGrid должна быть недоставленной событиями для этой подписки.

Пример: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft. служба хранилища/storageAccounts/sa1/blobServices/default/containerName.

--delivery-attribute-mapping

Добавьте сопоставление атрибутов доставки для отправки дополнительных сведений через заголовки HTTP при доставке событий. Этот атрибут действителен для всех типов назначения, кроме служба хранилища Queue. Несколько атрибутов можно указать с помощью нескольких --delivery-attribute-mapping аргументов.

Использование: --delivery-attribute-mapping атрибут-name атрибут-type атрибут-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 true Dynamic Attribute Mapping: --delivery-attribute-mapping: --delivery-attribute-mapping somename-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--enable-advanced-filtering-on-arrays --enable-af-arr

Позволяет вычислять расширенные фильтры по массиву значений вместо ожидания сингулярного значения.

Допустимые значения: false, true
--endpoint

Конечная точка, в которой EventGrid должна доставлять события, соответствующие этой подписке на события. Для типа конечной точки веб-перехватчика это должен быть соответствующий URL-адрес веб-перехватчика. Для других типов конечных точек это должен быть идентификатор ресурса Azure конечной точки. Ожидается, что конечная точка назначения уже создана и доступна для использования перед выполнением любой команды Сетки событий.

--endpoint-type

Тип конечной точки назначения.

Допустимые значения: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Default value: webhook
--event-delivery-schema

Схема, в которой должны быть доставлены события для этой подписки на события. По умолчанию события будут доставлены в той же схеме, в которой они публикуются (на основе входной схемы соответствующего раздела).

Допустимые значения: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Время жизни события (в минутах). Должно быть число от 1 до 1440.

Default value: 1440
--expiration-date

Дата или дата (в формате UTC, например "2018-11-30T11:59:59+00:00" или "2018-11-30"), после чего срок действия подписки на событие истекает. По умолчанию срок действия подписки на события отсутствует.

--included-event-types

Разделенный пробелом список типов событий (например, Microsoft.служба хранилища. BlobCreated и Майкрософт. служба хранилища. BlobDeleted). Чтобы подписаться на все типы событий по умолчанию, не указывайте значение для этого аргумента. Для разделов сетки событий типы событий определяются клиентом. Для событий Azure, например служба хранилища Учетные записи, Центр Интернета вещей и т. д., можно запросить типы событий с помощью этой команды CLI "az eventgrid topic-type list-event-types".

--labels

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

--max-delivery-attempts

Максимальное количество попыток доставки. Должно быть число от 1 до 30.

Default value: 30
--max-events-per-batch

Максимальное количество событий в пакете. Это значение должно быть в диапазоне от 1 до 5000.

--preferred-batch-size-in-kilobytes

Предпочтительный размер пакета в килобайтах. Это значение должно быть в диапазоне от 1 до 1024.

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

служба хранилища время ожидания сообщения очереди в секундах.

--subject-begins-with

Необязательная строка для фильтрации событий для подписки на события на основе префикса. Подстановочные знаки не поддерживаются.

--subject-case-sensitive

Укажите, следует ли сравнивать поля субъекта с учетом регистра. Значение True, если флаг присутствует.

Допустимые значения: false, true
Default value: False
--subject-ends-with

Необязательная строка для фильтрации событий для подписки на события на основе суффикса. Подстановочные знаки не поддерживаются.

Глобальные параметры
--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 system-topic event-subscription create (eventgrid Расширение)

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

Команда az eventgrid находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az eventgrid system-topic event-subscription create --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--advanced-filter]
                                                    [--azure-active-directory-application-id-or-uri]
                                                    [--azure-active-directory-tenant-id]
                                                    [--deadletter-endpoint]
                                                    [--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]
                                                    [--subject-begins-with]
                                                    [--subject-case-sensitive {false, true}]
                                                    [--subject-ends-with]

Примеры

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

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid system-topic event-subscription create --name es4 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Создайте новую подписку на события для системного раздела Сетки событий, используя фильтры по умолчанию и CloudEvent V 1.0 в качестве схемы доставки.

az eventgrid system-topic event-subscription create -n es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Создайте новую подписку на событие для системного раздела сетки событий с назначением недоставки и настраиваемой политикой повторных попыток не более 10 попыток доставки и сроком действия события в 2 часа (в зависимости от того, что происходит раньше) и датой окончания срока действия.

az eventgrid system-topic event-subscription create --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 --expiration-date "2022-10-31"

Создайте новую подписку на события для системного раздела сетки событий, используя веб-перехватчик с поддержкой Azure Active Directory в качестве назначения.

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Создайте новую подписку на события для системного раздела Сетки событий, используя функцию Azure в качестве назначения.

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

--advanced-filter

Расширенный фильтр позволяет фильтровать события на основе определенного свойства события.

Использование: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: -advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png png: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 Несколько расширенных фильтров можно указать с помощью нескольких --advanced-filter аргументов.

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

Идентификатор приложения Azure Active Directory или URI для получения маркера доступа, который будет включен в качестве маркера носителя в запросах на доставку. Применимо только для веб-перехватчика в качестве назначения.

--azure-active-directory-tenant-id

Идентификатор клиента Azure Active Directory для получения маркера доступа, который будет включен в качестве маркера носителя в запросах на доставку. Применимо только для веб-перехватчика в качестве назначения.

--deadletter-endpoint

Идентификатор ресурса Azure для назначения контейнера больших двоичных объектов служба хранилища Azure, в котором EventGrid должна быть недоставленной событиями для этой подписки.

Пример: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft. служба хранилища/storageAccounts/sa1/blobServices/default/containerName.

--endpoint

Конечная точка, в которой EventGrid должна доставлять события, соответствующие этой подписке на события. Для типа конечной точки веб-перехватчика это должен быть соответствующий URL-адрес веб-перехватчика. Для других типов конечных точек это должен быть идентификатор ресурса Azure конечной точки.

--endpoint-type

Тип конечной точки назначения.

Допустимые значения: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Default value: webhook
--event-delivery-schema

Схема, в которой должны быть доставлены события для этой подписки на события. По умолчанию события будут доставлены в той же схеме, в которой они публикуются (на основе входной схемы соответствующего раздела).

Допустимые значения: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Время жизни события (в минутах). Должно быть число от 1 до 1440.

Default value: 1440
--expiration-date

Дата или дата (в формате UTC, например "2018-11-30T11:59:59+00:00" или "2018-11-30"), после чего срок действия подписки на событие истекает. По умолчанию срок действия подписки на события отсутствует.

--included-event-types

Разделенный пробелом список типов событий. Пример: Майкрософт. служба хранилища. Корпорация Майкрософт blobCreated. служба хранилища. BlobDeleted. Чтобы подписаться на все типы событий по умолчанию, не указывайте значение для этого аргумента.

--labels

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

--max-delivery-attempts

Максимальное количество попыток доставки. Должно быть число от 1 до 30.

Default value: 30
--max-events-per-batch

Максимальное количество событий в пакете. Это значение должно быть в диапазоне от 1 до 5000.

--preferred-batch-size-in-kilobytes

Предпочтительный размер пакета в килобайтах. Это значение должно быть в диапазоне от 1 до 1024.

--subject-begins-with

Необязательная строка для фильтрации событий для подписки на события на основе префикса. Подстановочные знаки не поддерживаются.

--subject-case-sensitive

Укажите, следует ли сравнивать поля субъекта с учетом регистра. Значение True, если флаг присутствует.

Допустимые значения: false, true
Default value: False
--subject-ends-with

Необязательная строка для фильтрации событий для подписки на события на основе суффикса. Подстановочные знаки не поддерживаются.

Глобальные параметры
--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 system-topic event-subscription delete

Изменить

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

az eventgrid system-topic event-subscription delete --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--yes]

Примеры

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

az eventgrid system-topic event-subscription delete --name es1 \
    -g rg1 --system-topic-name systemtopic1 \

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

--yes -y

Не запрашивать подтверждение.

Default value: False
Глобальные параметры
--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 system-topic event-subscription delete (eventgrid Расширение)

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

Команда az eventgrid находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az eventgrid system-topic event-subscription delete --name
                                                    --resource-group
                                                    --system-topic-name

Примеры

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

az eventgrid system-topic event-subscription delete --name es1 \
    -g rg1 --system-topic-name systemtopic1 \

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-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 system-topic event-subscription list

Изменить

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

az eventgrid system-topic event-subscription list --resource-group
                                                  --system-topic-name
                                                  [--odata-query]

Примеры

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

az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1

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

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

--odata-query

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

Глобальные параметры
--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 system-topic event-subscription list (eventgrid Расширение)

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

Команда az eventgrid находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az eventgrid system-topic event-subscription list --resource-group
                                                  --system-topic-name
                                                  [--odata-query]

Примеры

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

az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1

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

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

--odata-query

Запрос, используемый для фильтрации результатов с помощью синтаксиса OData.

Глобальные параметры
--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 system-topic event-subscription show

Изменить

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

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

Примеры

Отображение сведений о подписке на события для системного раздела сетки событий.

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1

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

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1 --include-attrib-secret

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

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

Укажите, следует ли возвращать какие-либо секреты атрибута статической доставки. Значение True, если флаг присутствует.

Допустимые значения: false, true
Default value: False
--include-full-endpoint-url

Укажите, следует ли возвращать полный URL-адрес конечной точки. Значение True, если флаг присутствует.

Допустимые значения: false, true
Default value: False
Глобальные параметры
--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 system-topic event-subscription show (eventgrid Расширение)

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

Команда az eventgrid находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az eventgrid system-topic event-subscription show --name
                                                  --resource-group
                                                  --system-topic-name
                                                  [--include-full-endpoint-url {false, true}]

Примеры

Отображение сведений о подписке на события для системного раздела сетки событий.

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

--include-full-endpoint-url

Укажите, следует ли возвращать полный URL-адрес конечной точки. Значение True, если флаг присутствует.

Допустимые значения: false, true
Default value: False
Глобальные параметры
--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 system-topic event-subscription update

Изменить

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

az eventgrid system-topic event-subscription update --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--advanced-filter]
                                                    [--deadletter-endpoint]
                                                    [--delivery-attribute-mapping]
                                                    [--enable-advanced-filtering-on-arrays {false, true}]
                                                    [--endpoint]
                                                    [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                    [--included-event-types]
                                                    [--labels]
                                                    [--qttl]
                                                    [--subject-begins-with]
                                                    [--subject-ends-with]

Примеры

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

az eventgrid system-topic event-subscription update --name es1 \
    -g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --subject-ends-with .jpg

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

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

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

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

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

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --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

Обновление подписки на событие для системного раздела Сетки событий с служба хранилища очередью в качестве назначения с ttl 5 мин

az eventgrid system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --storage-queue-msg-ttl 300

Обновление подписки на событие для системного раздела Сетки событий с расширенным фильтрацией по массивам

az eventgrid system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --enable-advanced-filtering-on-arrays true

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

--advanced-filter

Расширенный фильтр позволяет фильтровать события на основе определенного свойства события.

Использование: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png png 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 NumberNotNotInRange 100,110 200 210 300 310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThanThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Multiple advanced filters можно указать с помощью нескольких --advanced-filter аргументов.

--deadletter-endpoint

Идентификатор ресурса Azure для назначения контейнера больших двоичных объектов служба хранилища Azure, в котором EventGrid должна быть недоставленной событиями для этой подписки.

--delivery-attribute-mapping

Добавьте сопоставление атрибутов доставки для отправки дополнительных сведений через заголовки HTTP при доставке событий. Этот атрибут действителен для всех типов назначения, кроме служба хранилища Queue. Несколько атрибутов можно указать с помощью нескольких --delivery-attribute-mapping аргументов.

Использование: --delivery-attribute-mapping атрибут-name атрибут-type атрибут-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 true Dynamic Attribute Mapping: --delivery-attribute-mapping: --delivery-attribute-mapping somename-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--enable-advanced-filtering-on-arrays --enable-af-arr

Позволяет вычислять расширенные фильтры по массиву значений вместо ожидания сингулярного значения.

Допустимые значения: false, true
--endpoint

Конечная точка, в которой EventGrid должна доставлять события, соответствующие этой подписке на события. Для типа конечной точки веб-перехватчика это должен быть соответствующий URL-адрес веб-перехватчика. Для других типов конечных точек это должен быть идентификатор ресурса Azure конечной точки. Ожидается, что конечная точка назначения уже создана и доступна для использования перед выполнением любой команды Сетки событий.

--endpoint-type

Тип конечной точки назначения.

Допустимые значения: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Default value: webhook
--included-event-types

Разделенный пробелом список типов событий (например, Microsoft.служба хранилища. BlobCreated и Майкрософт. служба хранилища. BlobDeleted). Чтобы подписаться на все типы событий по умолчанию, не указывайте значение для этого аргумента. Для разделов сетки событий типы событий определяются клиентом. Для событий Azure, например служба хранилища Учетные записи, Центр Интернета вещей и т. д., можно запросить типы событий с помощью этой команды CLI "az eventgrid topic-type list-event-types".

--labels

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

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

служба хранилища время ожидания сообщения очереди в секундах.

--subject-begins-with

Необязательная строка для фильтрации событий для подписки на события на основе префикса. Подстановочные знаки не поддерживаются.

--subject-ends-with

Необязательная строка для фильтрации событий для подписки на события на основе суффикса. Подстановочные знаки не поддерживаются.

Глобальные параметры
--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 system-topic event-subscription update (eventgrid Расширение)

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

Команда az eventgrid находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az eventgrid system-topic event-subscription update --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--advanced-filter]
                                                    [--deadletter-endpoint]
                                                    [--endpoint]
                                                    [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                    [--included-event-types]
                                                    [--labels]
                                                    [--subject-begins-with]
                                                    [--subject-ends-with]

Примеры

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

az eventgrid system-topic event-subscription update --name es1 \
    -g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --subject-ends-with .jpg

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

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

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

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

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

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --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

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

--name -n

Имя подписки на события.

--resource-group -g

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

--system-topic-name

Имя системного раздела.

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

--advanced-filter

Расширенный фильтр позволяет фильтровать события на основе определенного свойства события.

Использование: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: -advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png png: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 Несколько расширенных фильтров можно указать с помощью нескольких --advanced-filter аргументов.

--deadletter-endpoint

Идентификатор ресурса Azure для назначения контейнера больших двоичных объектов служба хранилища Azure, в котором EventGrid должна быть недоставленной событиями для этой подписки.

--endpoint

Конечная точка, в которой EventGrid должна доставлять события, соответствующие этой подписке на события. Для типа конечной точки веб-перехватчика это должен быть соответствующий URL-адрес веб-перехватчика. Для других типов конечных точек это должен быть идентификатор ресурса Azure конечной точки.

--endpoint-type

Тип конечной точки назначения.

Допустимые значения: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Default value: webhook
--included-event-types

Разделенный пробелом список типов событий. Пример: Майкрософт. служба хранилища. Корпорация Майкрософт blobCreated. служба хранилища. BlobDeleted. Чтобы подписаться на все типы событий по умолчанию, не указывайте значение для этого аргумента.

--labels

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

--subject-begins-with

Необязательная строка для фильтрации событий для подписки на события на основе префикса. Подстановочные знаки не поддерживаются.

--subject-ends-with

Необязательная строка для фильтрации событий для подписки на события на основе суффикса. Подстановочные знаки не поддерживаются.

Глобальные параметры
--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.