az eventgrid partner topic event-subscription

İş ortağı konusunun olay aboneliklerini yönetme.

Komutlar

az eventgrid partner topic event-subscription create

İş ortağı konusu için yeni bir olay aboneliği oluşturun.

az eventgrid partner topic event-subscription delete

İş ortağı konusunun olay aboneliğini silme.

az eventgrid partner topic event-subscription list

Belirli bir iş ortağı konusunun olay aboneliklerini listeleme.

az eventgrid partner topic event-subscription show

İş ortağı konusunun olay aboneliğinin ayrıntılarını alın.

az eventgrid partner topic event-subscription update

İş ortağı konusunun olay aboneliğini güncelleştirme.

az eventgrid partner topic event-subscription create

İş ortağı konusu için yeni bir olay aboneliği oluşturun.

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--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]

Örnekler

Varsayılan filtreleri kullanarak Event Grid iş ortağı konusu için yeni bir olay aboneliği oluşturun.

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

Konu ön eki belirten bir filtre ile event grid iş ortağı konusu için yeni bir olay aboneliği oluşturun.

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

Varsayılan filtreleri ve teslim şeması olarak CloudEvent V 1.0'ı kullanarak Event Grid iş ortağı konusu için yeni bir olay aboneliği oluşturun.

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

Bir Event Grid iş ortağıtopic için, en fazla 10 teslim denemesi için bir çıkmaz hedefi ve özel yeniden deneme ilkesi ve 2 saatlik (hangisi daha önce gerçekleşirse) Ve son kullanma tarihi olan bir Olay TTL'siyle yeni bir olay aboneliği oluşturun.

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 özellikli Web kancasını hedef olarak kullanarak Event Grid iş ortağı konusu için yeni bir olay aboneliği oluşturun.

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

Hedef olarak Azure İşlevi'ni kullanarak Event Grid iş ortağı konusu için yeni bir olay aboneliği oluşturun.

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

5 dakika içinde ileti ttl değeriyle hedef olarak Depolama Kuyruğu'nu kullanarak Event Grid iş ortağı konusu için yeni bir olay aboneliği oluşturma

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

Dizilerde gelişmiş filtreleme özelliği etkinleştirilmiş bir Event Grid iş ortağı konusu için yeni bir olay aboneliği oluşturma

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

--partner-topic-name

İş ortağı konusunun adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

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

Teslim isteklerine taşıyıcı belirteç olarak eklenecek erişim belirtecini almak için Azure Active Directory Kiracı Kimliği. Yalnızca hedef olarak web kancası için geçerlidir.

--advanced-filter

Gelişmiş filtre, olayların belirli bir olay özelliğine göre filtrelenmesine olanak tanır.

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

Teslim isteklerine taşıyıcı belirteç olarak eklenecek erişim belirtecini almak için Azure Active Directory Uygulama Kimliği veya Uri'si. Yalnızca hedef olarak web kancası için geçerlidir.

--deadletter-endpoint

EventGrid'in bu olay aboneliği için teslim edilemeyen olayları geçersiz kılması gereken bir Azure Depolama blob kapsayıcısı hedefinin Azure kaynak kimliği.

--delivery-attribute-mapping

Olayları teslim ederken HTTP üst bilgileri aracılığıyla ek bilgi göndermek için teslim özniteliği eşlemesi ekleyin. Bu öznitelik StorageQueue dışındaki tüm hedef türleri için geçerlidir. Birden fazla bağımsız değişken kullanılarak birden çok --delivery-attribute-mapping öznitelik belirtilebilir.

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

Gelişmiş filtrelerin tek bir değer beklemek yerine bir değer dizisine göre değerlendirilmesine izin verir.

kabul edilen değerler: false, true
--endpoint

EventGrid'in bu olay aboneliğiyle eşleşen olayları teslim etmesi gereken uç nokta. Web kancası uç noktası türü için bu, karşılık gelen web kancası URL'si olmalıdır. Diğer uç nokta türleri için bu, uç noktanın Azure kaynak tanımlayıcısı olmalıdır. Herhangi bir Event Grid komutu yürütülmeden önce hedef uç noktanın önceden oluşturulması ve kullanılabilir olması beklenir.

--endpoint-type

Hedef uç noktanın türü.

kabul edilen değerler: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
varsayılan değer: webhook
--event-delivery-schema

Bu olay aboneliği için olayların teslim edilmesi gereken şema. Varsayılan olarak, olaylar yayımlandıkları şemada (ilgili konunun giriş şemasına göre) teslim edilir.

kabul edilen değerler: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Etkinlik yaşam süresi (dakika cinsinden). 1 ile 1440 arasında bir sayı olmalıdır.

varsayılan değer: 1440
--expiration-date

Olay aboneliğinin süresinin dolacağı tarih veya tarih saat (UTC olarak, örneğin'2018-11-30T11:59:59+00:00' veya '2018-11-30'). Varsayılan olarak, olay aboneliği için süre sonu yoktur.

--included-event-types

Olay türlerinin boşlukla ayrılmış listesi (örneğin, Microsoft.Storage.BlobCreated ve Microsoft.Storage.BlobDeleted). Tüm varsayılan olay türlerine abone olmak için bu bağımsız değişken için herhangi bir değer belirtmeyin. Olay kılavuzu konuları için olay türleri müşteri tanımlıdır. Depolama Hesapları, IoT Hub vb. Azure olayları için bu 'az eventgrid topic-type list-event-types' CLI komutunu kullanarak olay türlerini sorgulayabilirsiniz.

--labels

Bu olay aboneliğiyle ilişkilendirilecek etiketlerin boşlukla ayrılmış listesi.

--max-delivery-attempts

En fazla teslimat denemesi sayısı. 1 ile 30 arasında bir sayı olmalıdır.

varsayılan değer: 30
--max-events-per-batch

Toplu iş içindeki en fazla olay sayısı. 1 ile 5000 arasında bir sayı olmalıdır.

--preferred-batch-size-in-kilobytes

Kilobayt cinsinden tercih edilen toplu iş boyutu. 1 ile 1024 arasında bir sayı olmalıdır.

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

Depolama kuyruğu iletinin yaşam süresi (saniye cinsinden).

--subject-begins-with

Bir olay aboneliğinin olaylarını ön eke göre filtrelemek için isteğe bağlı bir dize. Joker karakterler desteklenmez.

--subject-case-sensitive

Konu alanlarının büyük/küçük harfe duyarlı bir şekilde karşılaştırılıp karşılaştırılmayacağını belirtmek için belirtin. Bayrağı varsa True.

kabul edilen değerler: false, true
--subject-ends-with

Bir olay aboneliğine yönelik olayları son eke göre filtrelemek için isteğe bağlı bir dize. Joker karakterler desteklenmez.

az eventgrid partner topic event-subscription delete

İş ortağı konusunun olay aboneliğini silme.

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

Örnekler

Event Grid iş ortağı konusu için olay aboneliğini silme.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

--partner-topic-name

İş ortağı konusunun adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--yes -y

Onay isteminde bulunmayın.

az eventgrid partner topic event-subscription list

Belirli bir iş ortağı konusunun olay aboneliklerini listeleme.

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

Örnekler

Event Grid iş ortağı konusu için oluşturulan tüm olay aboneliklerini listeleyin.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Gerekli Parametreler

--partner-topic-name

İş ortağı konusunun adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--odata-query

Liste sonuçlarını filtrelemek için kullanılan OData sorgusu. Şu anda yalnızca Name özelliğinde filtrelemeye izin verilir. Desteklenen işlemler şunlardır: CONTAINS, eq (eşit için), ne (eşit değildir), AND, OR ve DEĞİl.

az eventgrid partner topic event-subscription show

İş ortağı konusunun olay aboneliğinin ayrıntılarını alın.

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

Örnekler

Event Grid iş ortağı konusu için olay aboneliğinin ayrıntılarını gösterin.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Event Grid iş ortağı konusu için olay aboneliğinin ayrıntılarını gösterme ve statik teslim özniteliği gizli dizilerini ekleme

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

--partner-topic-name

İş ortağı konusunun adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

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

Statik teslim özniteliği gizli dizilerinin döndürülmesi gerekip gerekmediğini belirtin. Bayrağı varsa True.

kabul edilen değerler: false, true
--include-full-endpoint-url

Tam uç nokta URL'sinin döndürülmesi gerekip gerekmediğini belirtmek için belirtin. Bayrağı varsa True.

kabul edilen değerler: false, true

az eventgrid partner topic event-subscription update

İş ortağı konusunun olay aboneliğini güncelleştirme.

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--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]

Örnekler

Event Grid iş ortağı konusunun olay aboneliğini güncelleştirerek yeni bir uç nokta belirtin.

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

Event Grid iş ortağı konusunun olay aboneliğini güncelleştirerek yeni konu uçları filtresi belirtin.

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

Yeni bir uç nokta ve eklenen olay türlerinin yeni bir listesini filtreleyip yeni konu uç noktalarını belirtmek için Event Grid iş ortağı konusunun olay aboneliğini güncelleştirin.

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

Azure Event Grid iş ortağı konusu için bir olay aboneliğini, bir çıkmaz hedefi içerecek şekilde güncelleştirin.

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

Gelişmiş filtreleri kullanarak bir Azure Event Grid iş ortağı konusu için olay aboneliğini güncelleştirin.

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

Hedef olarak Depolama Kuyruğu'nu kullanarak Event Grid iş ortağı konusu için olay aboneliğini güncelleştirme ve 5 dakika içinde ileti ttl'sini kullanma

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

Dizilerde gelişmiş filtreleme etkinken Event Grid iş ortağı konusu için olay aboneliğini güncelleştirme

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

--partner-topic-name

İş ortağı konusunun adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--advanced-filter

Gelişmiş filtre, belirli bir olay özelliğine göre olayların filtrelenmesine olanak tanır.

--deadletter-endpoint

EventGrid'in bu olay aboneliği için teslim edilemeyen olayları yeniden işlemesi gereken bir Azure Depolama blob kapsayıcı hedefinin Azure kaynak kimliği.

--delivery-attribute-mapping

Olayları teslim ederken HTTP üst bilgileri aracılığıyla ek bilgi göndermek için teslim özniteliği eşlemesi ekleyin. Bu öznitelik StorageQueue dışındaki tüm hedef türleri için geçerlidir. Birden fazla bağımsız değişken kullanılarak birden çok --delivery-attribute-mapping öznitelik belirtilebilir.

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

Gelişmiş filtrelerin tek bir değer beklemek yerine bir değer dizisine göre değerlendirilmesine izin verir.

kabul edilen değerler: false, true
--endpoint

EventGrid'in bu olay aboneliğiyle eşleşen olayları teslim etmesi gereken uç nokta. Web kancası uç noktası türü için bu, ilgili web kancası URL'si olmalıdır. Diğer uç nokta türleri için bu, uç noktanın Azure kaynak tanımlayıcısı olmalıdır. Herhangi bir Event Grid komutu yürütülmeden önce hedef uç noktanın önceden oluşturulması ve kullanılabilir olması beklenir.

--endpoint-type

Hedef uç noktanın türü.

kabul edilen değerler: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
varsayılan değer: webhook
--included-event-types

Olay türlerinin boşlukla ayrılmış listesi (örneğin, Microsoft.Storage.BlobCreated ve Microsoft.Storage.BlobDeleted). Tüm varsayılan olay türlerine abone olmak için bu bağımsız değişken için herhangi bir değer belirtmeyin. Olay kılavuzu konuları için olay türleri müşteri tanımlıdır. Depolama Hesapları, IoT Hub vb. Azure olayları için bu CLI komutunu kullanarak olay türlerini sorgulayabilirsiniz: 'az eventgrid topic-type list-event-types'.

--labels

Bu olay aboneliğiyle ilişkilendirilecek etiketlerin boşlukla ayrılmış listesi.

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

Depolama kuyruğu iletinin saniyeler içinde yaşam süresi.

--subject-begins-with

Bir olay aboneliğinin olaylarını ön eke göre filtrelemek için isteğe bağlı bir dize. Joker karakterler desteklenmez.

--subject-ends-with

Sonek temelinde bir olay aboneliği için olayları filtrelemek için isteğe bağlı bir dize. Joker karakterler desteklenmez.