az eventgrid event-subscription

Olay aboneliklerini yönetme.

Bir olay konusu, Event Grid, 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 listele.

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
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--azure-active-directory-tenant-id]
                                       [--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 {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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]
                                       [--subscription]

Örnekler

Varsayılan filtreleri kullanarak bir konu başlığı Event Grid 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 bir 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 bir 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 kullanarak Azure aboneliği için yeni bir olay aboneliği ve hedef olarak azure Depolama 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 ve hedef olarak Azure ServiceBusQueue'yi 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 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'sinde (hangisi daha önce gerçekleşirse) teslimi başarısız olan hedef ve özel yeniden deneme ilkesine sahip bir 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

Sona erme 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"

Hedef olarak web kancası etkinleştirilmiş bir Event Grid için Azure Active Directory 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'Event Grid konu başlığı 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

Hedef olarak sistem tarafından atanan MSI Event Grid kimliği ve MSI kimliği ile deadletter ile Eventhub kullanarak bir konu başlığı için yeni bir olay aboneliği oluşturun

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 Event Grid hedef olarak Depolama bir konu başlığı için yeni bir olay aboneliği oluşturun

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 konu başlığı 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 etkin olduğu Event Grid konu başlığı 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

--advanced-filter

Gelişmiş filtre, belirli bir olay özelliğine göre olayların filtresini sağlar.

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

Uygulama Azure Active Directory veya Uri'yi teslim isteklerine taşıyıcı belirteç olarak dahil edilecek erişim belirteci almak için kullanabilir. Yalnızca hedef olarak web kancası için geçerlidir.

--azure-active-directory-tenant-id

Kiracı Azure Active Directory, teslim isteklerine taşıyıcı belirteç olarak dahil edilecek erişim belirteci almak için kiracı kimliğini alır. Yalnızca hedef olarak web kancası için geçerlidir.

--deadletter-endpoint

EventGrid'in bu olay aboneliği Depolama teslim edilemeyen olayları teslim edilemey bir 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ı teslim edilemeyen olaylara teslim edilmesi gereken kimliğine sahip azure Depolama blob kapsayıcı hedefinin Azure kaynak kimliği.

--delivery-attribute-mapping

Olaylar teslimi sırasında 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ürler için geçerlidir. Birden fazla bağımsız değişken kullanılarak birden çok öznitelik --delivery-attribute-mapping 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 etmek için kimliği olan uç nokta. Web kancası uç nokta 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 tekil bir değer beklemek yerine bir değer dizisine göre değerlendirilmesini sağlar.

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ç nokta 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 komut yürütülmeden önce hedef uç noktanın önceden oluşturulmuş ve kullanılabilir olması Event Grid 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 edilecek şema. Varsayılan olarak, olaylar yayımlandıkları şemada teslim edilir (ilgili konunun giriş şemasına göre).

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

Olay yaşam süresi (dakika olarak). 1 ile 1440 arasında bir sayı olması gerekir.

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

Olay aboneliğinin süresi dolacak tarih veya tarih saat (UTC'de (ö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.Depolama. 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 konu başlıkları için olay türleri müşteri tanımlıdır. Depolama Hesapları, IoT Hub gibi Azure olayları için'az eventgrid topic-type list-event-types' CLI komutunu kullanarak olay türlerini sorguabilirsiniz.

--labels

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

--max-delivery-attempts

En fazla teslim deneme sayısı. 1 ile 30 arasında bir sayı olması gerekir.

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

Toplu iş içinde en fazla olay sayısı. 1 ile 5000 arasında bir sayı olması gerekir.

--preferred-batch-size-in-kilobytes

Kilobayt olarak tercih edilen toplu iş boyutu. 1 ile 1024 arasında bir sayı olması gerekir.

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

Depolama ileti süresi saniyeler içinde canlı olur.

--source-resource-id

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

--subject-begins-with

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

--subject-case-sensitive

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

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

Olay aboneliğinin olaylarını son eke göre filtrelemek için isteğe bağlı bir dize. Joker karakterler desteklenmiyor.

--subscription

Aboneliğin adı veya kimliği. Varsayılan aboneliği kullanarak az account set -s NAME_OR_ID yapılandırabilirsiniz.

az eventgrid event-subscription delete

Olay aboneliğini silme.

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

Örnekler

Bir konu başlığı için olay Event Grid silin.

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

Bir etki alanı konusu için olay Event Grid silin.

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

Bir etki alanı için olay Event Grid silin.

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

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

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

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

--subscription

Aboneliğin adı veya kimliği. Varsayılan aboneliği kullanarak az account set -s NAME_OR_ID yapılandırabilirsiniz.

az eventgrid event-subscription list

Olay aboneliklerini listele.

Event Grid hem bölgesel hem de genel olay aboneliklerini destekler: Bölgesel kaynaklarda (Depolama hesapları veya Event Grid konuları gibi) olay abonelikleri bölgeselyken, genel kaynaklar (Azure aboneliği veya kaynak grubu gibi) üzerinde olay abonelikleri geneldir. Bu nedenle, olay aboneliklerini birkaç farklı şekilde listeleyebilirsiniz:

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

Örnekler

Bir konu başlığı için oluşturulan tüm olay Event Grid listele.

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

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

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

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

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

Bir etki alanının tüm olay aboneliklerini Event Grid listele.

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

Bir etki alanı konusu için tüm Event Grid aboneliklerini listele.

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

Westus2 Depolama de tüm olay aboneliklerini (seçili Azure aboneliği altında) listele.

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

westus2 Depolama olay aboneliklerini (verilen kaynak grubu altında) listele.

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

Tüm bölgesel veya genel olay aboneliklerini listele (o anda seçili olan 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 listele.

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

Adı "XYZ" desenini Event Grid etki alanının tüm olay aboneliklerini listele

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

"name1" adına sahip olay aboneliği Event Grid etki alanı için tüm olay aboneliklerini listele

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. Şu değerler: 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. Filtrelemeye şu anda yalnızca Name özelliği üzerinde izin verilir. Desteklenen işlemler şunlardır: CONTAINS, eq (eşittir), ne (eşit değildir için), AND, OR ve NOT.

--query-examples

Sizin için JMESPath dizesi önerin. Sonuçları görmek için sorgudan birini kopyalayıp --query parametresinin içine çift tırnak işareti içine yapıştırabilirsiniz. Bu anahtar sözcükleri temel alarak önerilerde yer ver vermemiz için bir veya daha fazla konumsal anahtar sözcük ekleyebilirsiniz.

--resource-group -g

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

--source-resource-id

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

--subscription

Aboneliğin adı veya kimliği. Varsayılan aboneliği kullanarak az account set -s NAME_OR_ID yapılandırabilirsiniz.

--topic-type-name

Olay aboneliklerinin listelenmiş olması gereken konu türü adı. Bu belirtilirse , --location da 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}]
                                     [--query-examples]
                                     [--source-resource-id]
                                     [--subscription]

Örnekler

Bir olay konusu için olay aboneliğinin Event Grid gösterir.

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

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

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

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

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

Herhangi bir statik teslim özniteliği gizli dizinin döndürülip döndürül gerek olmadığını belirtin. Bayrağı varsa True olur.

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

Tam uç nokta URL'sinin döndürülerek döndürül gerekip gerek olmadığını belirtmek için belirtin. Bayrağı varsa True olur.

kabul edilen değerler: false, true
--query-examples

Sizin için JMESPath dizesi önerin. Sonuçları görmek için sorgudan birini kopyalayıp --query parametresinin içine çift tırnak işareti içine yapıştırabilirsiniz. Bu anahtar sözcükleri temel alarak önerilerde yer ver vermemiz için bir veya daha fazla konumsal anahtar sözcük ekleyebilirsiniz.

--source-resource-id

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

--subscription

Aboneliğin adı veya kimliği. Varsayılan aboneliği kullanarak az account set -s NAME_OR_ID yapılandırabilirsiniz.

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 {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]
                                       [--subscription]

Örnekler

Yeni bir uç nokta belirtmek için Event Grid bir olay aboneliğini güncelleştirin.

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

Yeni bir konu sonu filtresi belirtmek için Azure aboneliğinin olay aboneliğini güncelleştirin.

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

Yeni bir uç nokta ve yeni bir konu sonu filtresi belirtmek için kaynak grubunun 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ının olay aboneliğini, bir deadletter hedefi 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 bir 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ının olay aboneliğini 5 dakika olarak ayarlanmış ileti ttl değerini 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 bir nesnesi ekleyin. Örnek: --add property.listProperty <key=value, string veya JSON string>.

--advanced-filter

Gelişmiş filtre, belirli bir olay özelliğine göre olayların filtresini sağlar.

--deadletter-endpoint

EventGrid'in bu olay aboneliği Depolama teslim edilemeyen olayları teslim edilemey bir 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ı teslim edilemeyen olaylara teslim edilmesi gereken kimliğine sahip azure Depolama blob kapsayıcı hedefinin Azure kaynak kimliği.

--delivery-attribute-mapping

Olaylar teslimi sırasında 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ürler için geçerlidir. Birden fazla bağımsız değişken kullanılarak birden çok öznitelik --delivery-attribute-mapping 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 etmek için kimliği olan uç nokta. Web kancası uç nokta 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 tekil bir değer beklemek yerine bir değer dizisine göre değerlendirilmesini sağlar.

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ç nokta 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 komut yürütülmeden önce hedef uç noktanın önceden oluşturulmuş ve kullanılabilir olması Event Grid 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
--force-string

'set' veya 'add' kullanırken JSON'a dönüştürmeyi deneme yerine dize değişmez değerlerini koru.

--included-event-types

Olay türlerinin boşlukla ayrılmış listesi (örneğin, Microsoft.Depolama. 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 konu başlıkları için olay türleri müşteri tanımlıdır. Depolama Hesapları, IoT Hub gibi Azure olayları için'az eventgrid topic-type list-event-types' CLI komutunu kullanarak olay türlerini sorguabilirsiniz.

--labels

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

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

Depolama ileti süresi saniyeler içinde canlı olur.

--remove

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

--set

Ayar için bir özellik yolu ve değer belirterek bir nesneyi güncelleştirin. Örnek: --set property1.property2=.

--source-resource-id

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

--subject-begins-with

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

--subject-ends-with

Olay aboneliğinin olaylarını son eke göre filtrelemek için isteğe bağlı bir dize. Joker karakterler desteklenmiyor.

--subscription

Aboneliğin adı veya kimliği. Varsayılan aboneliği kullanarak az account set -s NAME_OR_ID yapılandırabilirsiniz.