az eventgrid event-subscription

Olay aboneliklerini yönetme.

Event Grid konusu, etki alanı, etki alanı konusu, Azure aboneliği, kaynak grubu veya olay bildirimlerini destekleyen diğer Azure kaynakları için olay aboneliklerini yönetin.

Komutlar

az eventgrid event-subscription create

Yeni bir olay aboneliği oluşturun.

az eventgrid event-subscription delete

Olay aboneliğini silme.

az eventgrid event-subscription list

Olay aboneliklerini listeleme.

az eventgrid event-subscription show

Olay aboneliğinin ayrıntılarını alın.

az eventgrid event-subscription update

Olay aboneliğini güncelleştirme.

az eventgrid event-subscription create

Yeni bir olay aboneliği oluşturun.

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]

Örnekler

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

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

Varsayılan filtreleri kullanarak Azure aboneliği aboneliği için yeni bir olay aboneliği oluşturun.

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

Varsayılan filtreleri kullanarak kaynak grubu için yeni bir olay aboneliği oluşturun.

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

Varsayılan filtreleri kullanarak depolama hesabı için yeni bir olay aboneliği oluşturun.

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

Gelişmiş filtreleri kullanarak depolama hesabı için yeni bir olay aboneliği oluşturun.

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

Bir Azure aboneliği için, konu ön eki belirten bir filtreyle yeni bir olay aboneliği oluşturun.

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

Bir kaynak grubu için, konu soneki belirten bir filtreyle yeni bir olay aboneliği oluşturun.

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

Varsayılan filtreleri ve hedef olarak EventHub'ı kullanarak Azure aboneliği için yeni bir olay aboneliği oluşturun.

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

Varsayılan filtreleri ve hedef olarak bir Azure Depolama kuyruğu kullanarak Azure aboneliği için yeni bir olay aboneliği oluşturun.

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

Varsayılan filtreleri kullanarak Azure aboneliği için yeni bir olay aboneliği ve hedef olarak bir Azure ServiceBusQueue oluşturun.

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

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

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

En fazla 10 teslim denemesi ve 2 saatlik Olay TTL'siyle (hangisi daha önce gerçekleşirse) bir çıkmaz hedefi ve özel yeniden deneme ilkesi ile depolama hesabı için yeni bir olay aboneliği oluşturun.

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

Bir etki alanı konusu için yeni bir olay aboneliği oluşturun.

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

Son kullanma tarihi olan yeni bir olay aboneliği (depolama hesabı için) oluşturun.

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 özellikli Web kancasını hedef olarak kullanarak Event Grid konusu için yeni bir olay aboneliği oluşturun.

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

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

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'ı hedef olarak sistem tarafından atanan MSI kimliğiyle ve MSI kimliğiyle çıkmaza neden olan eventhub kullanarak bir Event Grid konusu için yeni bir olay aboneliği oluşturma

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}

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

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

Hedef olarak sistem tarafından atanan MSI kimliğiyle StorageQueue kullanarak Event Grid konusu için yeni bir olay aboneliği oluşturma

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

Dizilerde gelişmiş filtrelemenin etkinleştirildiği bir Event Grid konusu için yeni bir olay aboneliği oluşturma

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

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

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

--deadletter-identity

Geçersiz hale gelen hedef kaynağın kimlik türü.

kabul edilen değerler: systemassigned
--deadletter-identity-endpoint

EventGrid'in bu olay aboneliği için teslim edilemeyen olayları geçersiz kılması gereken kimliğine sahip 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.

--delivery-identity

Teslim hedefi kaynağının kimlik türü (örneğin, depolama kuyruğu veya eventhub).

kabul edilen değerler: systemassigned
--delivery-identity-endpoint

EventGrid'in bu olay aboneliğiyle eşleşen olayları teslim etmesi gereken kimliğe sahip 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.

--delivery-identity-endpoint-type

Kaynak kimliğine sahip hedef uç noktanın türü.

kabul edilen değerler: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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ü.

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

--source-resource-id

Olay aboneliğinin oluşturulması gereken Azure kaynağının tam tanımlayıcısı.

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

az eventgrid event-subscription delete

Olay aboneliğini silme.

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

Örnekler

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

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

Event Grid etki alanı konusu için olay aboneliğini silin.

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

Event Grid etki alanı için olay aboneliğini silme.

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

Azure aboneliği için olay aboneliğini silme.

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

Kaynak grubu için olay aboneliğini silme.

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

Depolama hesabı için olay aboneliğini silme.

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

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

İsteğe Bağlı Parametreler

--source-resource-id

Olay aboneliğinin silinmesi gereken Azure kaynağının tam tanımlayıcısı.

az eventgrid event-subscription list

Olay aboneliklerini listeleme.

Event Grid hem bölgesel hem de genel olay aboneliklerini destekler: Bölgesel kaynaklardaki olay abonelikleri (Depolama hesapları veya Event Grid konuları gibi) bölgeseldir, genel kaynaklardaki olay abonelikleri ise (Azure aboneliği veya kaynak grubu gibi) geneldir. Bu nedenle, olay aboneliklerini birkaç farklı yolla listeleyebilirsiniz:

  1. Olay aboneliklerini listelemek istediğiniz kaynağın kaynak kimliğine göre listelemek için --source-resource-id parametresini belirtin. Başka parametre belirtilmemelidir.
  2. Konu türüne göre listelemek için (ör. depolama hesapları), --location (ör. "westus2") parametresiyle birlikte --topic-type parametresini belirtin. Genel konu türleri için ("Microsoft.Resources.Subscriptions" gibi) konum değerini "genel" olarak belirtin.
  3. Bir bölgedeki tüm olay aboneliklerini listelemek için (tüm konu türleri arasında), yalnızca --location parametresini belirtin.
  4. Yukarıdaki #2 ve #3 için yalnızca bir kaynak grubuna göre filtrelemek için --resource-group parametresini de belirtebilirsiniz.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Örnekler

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

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

Depolama hesabı için oluşturulan tüm olay aboneliklerini listeleyin.

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

Azure aboneliği için oluşturulan tüm olay aboneliklerini listeleyin.

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

Kaynak grubu için oluşturulan tüm olay aboneliklerini listeleyin.

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

Event Grid etki alanı için tüm olay aboneliklerini listeleyin.

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

Event Grid etki alanı konusu için tüm olay aboneliklerini listeleme.

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

westus2 içindeki tüm Depolama olayı aboneliklerini (seçili durumdaki Azure aboneliğinin altında) listeleyin.

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

westus2 içindeki tüm Depolama olayı aboneliklerini (verilen kaynak grubunun altında) listeleyin.

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

Tüm bölgesel veya genel olay aboneliklerini listeleyin (seçili durumdaki Azure aboneliğinin altında).

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

Belirtilen kaynak grubu altındaki tüm bölgesel veya genel olay aboneliklerini listeleyin.

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

Adı "XYZ" desenini içeren event Grid etki alanının tüm olay aboneliklerini listeleme

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

Event Grid etki alanı için "name1" adlı olay aboneliği dışındaki tüm olay aboneliklerini listeleme

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

İsteğe Bağlı Parametreler

--location -l

Konum. Değerleri: az account list-locations. varsayılan konumu kullanarak az configure --defaults location=<location>yapılandırabilirsiniz.

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

--resource-group -g

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

--source-resource-id

Olay aboneliğinin listelenmesi gereken Azure kaynağının tam tanımlayıcısı.

--topic-type-name

Olay aboneliklerinin listelenmiş olması gereken konu-türünün adı. Bu belirtildiğinde -- location değerini de belirtmeniz gerekir.

az eventgrid event-subscription show

Olay aboneliğinin ayrıntılarını alın.

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

Örnekler

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

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

Azure aboneliği için olay aboneliğinin ayrıntılarını gösterin.

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

Bir kaynak grubu için olay aboneliğinin ayrıntılarını gösterin.

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

Depolama hesabı için olay aboneliğinin ayrıntılarını gösterin.

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

Statik teslim özniteliği gizli dizileri dahil olmak üzere bir kaynak grubu için olay aboneliğinin ayrıntılarını gösterin.

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

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

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

Olay aboneliğinin gösterilmesi gereken Azure kaynağının tam tanımlayıcısı.

az eventgrid event-subscription update

Olay aboneliğini güncelleştirme.

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]

Örnekler

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

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

Bir Azure aboneliği için olay aboneliğini güncelleştirerek yeni bir konu sonu filtresi belirtin.

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

Yeni bir uç nokta ve yeni konu uç noktaları filtresi belirtmek üzere bir kaynak grubu için olay aboneliğini güncelleştirin.

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

Dahil edilen olay türlerinin yeni bir listesini belirtmek için depolama hesabı için olay aboneliğini güncelleştirin.

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

Bir depolama hesabı için olay aboneliğini, bir yeniden kullanıma hazır hedef içerecek şekilde güncelleştirin.

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

Gelişmiş filtreleri kullanarak depolama hesabı için olay aboneliğini güncelleştirin.

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

Depolama hesabı için olay aboneliğini, 5 dakika olarak ayarlanmış ileti ttl'sini içerecek şekilde güncelleştirin.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

Dizilerde gelişmiş filtreleme etkinleştirilmiş bir olay aboneliğini güncelleştirme

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

Gerekli Parametreler

--name -n

Olay aboneliğinin adı.

İsteğe Bağlı Parametreler

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string veya JSON dizesi>.

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

--deadletter-identity

Deadletter hedef kaynağının kimlik türü.

kabul edilen değerler: systemassigned
--deadletter-identity-endpoint

EventGrid'in bu olay aboneliği için teslim edilemeyen olayları yeniden işlemesi gereken kimliğine sahip 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.

--delivery-identity

Teslim hedefi kaynağının kimlik türü (depolama kuyruğu veya eventhub gibi).

kabul edilen değerler: systemassigned
--delivery-identity-endpoint

EventGrid'in bu olay aboneliğiyle eşleşen olayları teslim etmesi gereken kimliği olan 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.

--delivery-identity-endpoint-type

Kaynak kimliğine sahip hedef uç noktanın türü.

kabul edilen değerler: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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ü.

varsayılan değer: webhook
--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

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

--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list OR --remove propertyToRemove.

--set

Ayarlanacağı özellik yolunu ve değeri belirterek bir nesneyi güncelleştirin. Örnek: --set property1.property2=.

--source-resource-id

Olay aboneliğinin güncelleştirilmesi gereken Azure kaynağının tam tanımlayıcısı.

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