az eventgrid partner topic event-subscription

Başvuru

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

Düzenle

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

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--azure-active-directory-application-id-or-uri]
                                                     [--azure-active-directory-tenant-id]
                                                     [--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 bir 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

Son kullanma hedefi ve en fazla 10 teslim denemesi içeren özel yeniden deneme ilkesi ve 2 saatlik (hangisi daha önce gerçekleşirse) ve son kullanma tarihi olan bir Olay TTL'siyle event Grid iş ortağıtopic için 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"

Hedef olarak etkinleştirilmiş Azure Active Directory Web kancasını 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 ttl iletisiyle hedef olarak Depolama Kuyruğu 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ı. 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.

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

Teslim isteklerine taşıyıcı belirteç olarak dahil edilecek 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.

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

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

--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 (örneğin, Microsoft.Depolama) boşlukla ayrılmış listesi. BlobCreated ve Microsoft. Depolama. 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 (az eventgrid topic-type list-event-types' 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

Saniyeler içinde yaşamak için kuyruk iletisi süresini Depolama.

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

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

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az eventgrid partner topic event-subscription delete

Düzenle

İş 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ı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--yes -y

Onay istemde bulunmayın.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az eventgrid partner topic event-subscription list

Düzenle

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ı. varsayılan grubu kullanarak 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, VEYA ve NOT.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az eventgrid partner topic event-subscription show

Düzenle

İş 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ı. varsayılan grubu kullanarak 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ülip döndürülmeyeceğini belirtmek için belirtin. Bayrağı varsa true.

kabul edilen değerler: false, true

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az eventgrid partner topic event-subscription update

Düzenle

İş 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 bir konu sonu 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 listesini filtreleyip yeni bir konu sonu 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

Bir Azure Event Grid iş ortağı konusu için olay aboneliğini, bir kilitlenme 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

5 dakika içinde ttl iletisiyle hedef olarak Depolama Kuyruğu kullanarak 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 \
    --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

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

--included-event-types

Olay türlerinin (örneğin, Microsoft.Depolama) boşlukla ayrılmış listesi. BlobCreated ve Microsoft. Depolama. 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.

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

İletinin saniye cinsinden yaşam süresini Depolama.

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

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

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.