az eventgrid event-subscription

Примечание.

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

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

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

Команды

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

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

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

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

Расширение Предварительный просмотр
az eventgrid event-subscription delete

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

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

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

Расширение Предварительный просмотр
az eventgrid event-subscription list

Вывод списка подписок на события.

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

Вывод списка подписок на события.

Расширение Предварительный просмотр
az eventgrid event-subscription show

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

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

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

Расширение Предварительный просмотр
az eventgrid event-subscription update

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

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

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

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

az eventgrid event-subscription create

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

az eventgrid event-subscription create --name
                                       [--aad-tenant-id]
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Примеры

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

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

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

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

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

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

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

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --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 event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Создайте новую подписку на события для раздела "Сетка событий", используя Eventhub с удостоверением MSI, назначенным системой в качестве назначения, и с недоставленным идентификатором MSI

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

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

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

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

az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

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

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

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

--name -n

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

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

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

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

Тип удостоверения целевого ресурса недоставки.

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

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

Тип удостоверения целевого ресурса доставки (например, очередь хранилища или концентратор событий).

Допустимые значения: systemassigned
--delivery-identity-endpoint
Предварительный просмотр

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

--delivery-identity-endpoint-type
Предварительный просмотр

Тип конечной точки назначения с удостоверением ресурса.

Допустимые значения: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

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

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

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

--endpoint-type

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

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

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

--source-resource-id

Полный идентификатор ресурса Azure, для которого должна быть создана подписка на события.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

--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 event-subscription create (eventgrid Расширение)

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

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

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

az eventgrid event-subscription create --name
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--azure-active-directory-tenant-id]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Примеры

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

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

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

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

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

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

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

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --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 event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Создайте новую подписку на события для раздела "Сетка событий", используя Eventhub с удостоверением MSI, назначенным системой в качестве назначения, и с недоставленным идентификатором MSI

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

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

--name -n

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

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

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

--deadletter-identity

Тип удостоверения целевого ресурса недоставки.

Допустимые значения: systemassigned
--deadletter-identity-endpoint

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

--delivery-identity

Тип удостоверения целевого ресурса доставки (например, очередь хранилища или концентратор событий).

Допустимые значения: systemassigned
--delivery-identity-endpoint

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

--delivery-identity-endpoint-type

Тип конечной точки назначения с удостоверением ресурса.

Допустимые значения: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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.

--source-resource-id

Полный идентификатор ресурса Azure, для которого должна быть создана подписка на события.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

--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 event-subscription delete

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

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Примеры

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

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

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

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Удалите подписку на события для домена сетки событий.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Удалите подписку на события для подписки Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

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

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Удаление подписки на события для учетной записи хранения.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

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

--name -n

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

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

--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна быть удалена.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

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

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

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

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

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Примеры

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

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

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

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Удалите подписку на события для домена сетки событий.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Удалите подписку на события для подписки Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

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

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Удаление подписки на события для учетной записи хранения.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

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

--name -n

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

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

--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна быть удалена.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

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

Вывод списка подписок на события.

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

  1. Чтобы получить список по идентификатору ресурса, подписка на события которого требуется перечислить, укажите параметр --source-resource-id. Другие параметры не должны быть указаны.
  2. Чтобы получить список по типу раздела (например, учетным записям хранения), укажите параметр --topic-type вместе с параметром --location (например, westus2). Для глобальных типов разделов (например, "Microsoft.Resources.Subscriptions"), укажите значение расположения как "глобальное".
  3. Чтобы перечислить все подписки на события в регионе (во всех типах разделов), укажите только параметр --location.
  4. Для параметров #2 и #3 выше для фильтрации только по группе ресурсов можно дополнительно указать параметр --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Примеры

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Вывод списка всех подписок на события для домена сетки событий.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Список всех служба хранилища подписок на события (в рамках выбранной подписки Azure) в westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Список всех подписок на события служба хранилища (в указанной группе ресурсов) в westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Перечислите все региональные или глобальные подписки на события (в выбранной в настоящее время подписке Azure).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

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

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Вывод списка всех подписок на события для домена сетки событий, кроме подписки на событие с именем "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

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

--location -l

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

--odata-query

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

--resource-group -g

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

--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна быть указана.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

--topic-type-name

Имя типа раздела, подписка на события которого должна быть указана. Если это указано, необходимо также указать --location.

Пример 1. Вывод списка всех подписок на события служба хранилища в WestUS2 --resource-group TestRG --topic-type-name Microsoft.служба хранилища. служба хранилища Accounts --location westus2 Example 2: вывод списка всех подписок на события в подписках Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

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

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

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

Вывод списка подписок на события.

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

  1. Чтобы получить список по идентификатору ресурса, подписка на события которого требуется перечислить, укажите параметр --source-resource-id. Другие параметры не должны быть указаны.
  2. Чтобы получить список по типу раздела (например, учетным записям хранения), укажите параметр --topic-type вместе с параметром --location (например, westus2). Для глобальных типов разделов (например, "Microsoft.Resources.Subscriptions"), укажите значение расположения как "глобальное".
  3. Чтобы перечислить все подписки на события в регионе (во всех типах разделов), укажите только параметр --location.
  4. Для параметров #2 и #3 выше для фильтрации только по группе ресурсов можно дополнительно указать параметр --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Примеры

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Вывод списка всех подписок на события для домена сетки событий.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Список всех служба хранилища подписок на события (в рамках выбранной подписки Azure) в westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Список всех подписок на события служба хранилища (в указанной группе ресурсов) в westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Перечислите все региональные или глобальные подписки на события (в выбранной в настоящее время подписке Azure).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

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

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Вывод списка всех подписок на события для домена сетки событий, кроме подписки на событие с именем "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

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

--location -l

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

--odata-query

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

--resource-group -g

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

--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна быть указана.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

--topic-type-name

Имя типа раздела, подписка на события которого должна быть указана. Если это указано, необходимо также указать --location.

Пример 1. Вывод списка всех подписок на события служба хранилища в WestUS2 --resource-group TestRG --topic-type-name Microsoft.служба хранилища. служба хранилища Accounts --location westus2 Example 2: вывод списка всех подписок на события в подписках Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

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

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

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

Примеры

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

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

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

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

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

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

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

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

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

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
    --include-static-delivery-attribute-secret

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

--name -n

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

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

--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
--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна отображаться.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

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

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

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

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

az eventgrid event-subscription show --name
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Примеры

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

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

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

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

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

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

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

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

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

--name -n

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

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

--include-full-endpoint-url

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

Допустимые значения: false, true
Default value: False
--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна отображаться.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

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

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

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Примеры

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

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

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

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

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

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

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

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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 event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

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

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --enable-advanced-filtering-on-arrays true

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

--name -n

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

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

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--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 должна быть недоставленной событиями для этой подписки.

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

Тип удостоверения целевого ресурса недоставки.

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

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

Тип удостоверения целевого ресурса доставки (например, очередь хранилища или концентратор событий).

Допустимые значения: systemassigned
--delivery-identity-endpoint
Предварительный просмотр

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

--delivery-identity-endpoint-type
Предварительный просмотр

Тип конечной точки назначения с удостоверением ресурса.

Допустимые значения: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

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

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

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

--endpoint-type

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

Default value: webhook
--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Default value: False
--included-event-types

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

--labels

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

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

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

--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Default value: []
--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна быть обновлена.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

--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 event-subscription update (eventgrid Расширение)

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

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

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

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Примеры

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

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

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

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

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

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

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

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

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

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

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--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 должна быть недоставленной событиями для этой подписки.

--deadletter-identity

Тип удостоверения целевого ресурса недоставки.

Допустимые значения: systemassigned
--deadletter-identity-endpoint

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

--delivery-identity

Тип удостоверения целевого ресурса доставки (например, очередь хранилища или концентратор событий).

Допустимые значения: systemassigned
--delivery-identity-endpoint

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

--delivery-identity-endpoint-type

Тип конечной точки назначения с удостоверением ресурса.

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

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

--endpoint-type

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

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

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Default value: False
--included-event-types

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

--labels

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

--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Default value: []
--source-resource-id

Полный идентификатор ресурса Azure, подписка на события которого должна быть обновлена.

Использование: --source-resource-id Azure-Resource-ID для подписки Azure: --source-resource-id /subscriptions/{SubID} Для группы ресурсов: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 для раздела EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.служба хранилища/storageaccounts/sa1 Для домена EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domain/d1/topics/t1.

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