az eventgrid event-subscription

Başvuru

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

Düzenle

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]

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

Konu ön eki belirten bir filtreyle azure aboneliği için 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 kullanarak Azure aboneliği için yeni bir olay aboneliği ve hedef olarak bir Azure Depolama kuyruğu 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 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

Bir depolama hesabı için en fazla 10 teslim denemesi ve olay TTL'sinin (hangisi daha önce gerçekleşirse) çıkmaz hedefi ve özel yeniden deneme ilkesi ile 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

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"

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

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

--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ı geçersiz kılması 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ü.

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.

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

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

Düzenle

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

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

Düzenle

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:

Olay aboneliklerini listelemek istediğiniz kaynağın kaynak kimliğine göre listelemek için --source-resource-id parametresini belirtin. Başka parametre belirtilmemelidir.
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.
Bir bölgedeki tüm olay aboneliklerini listelemek için (tüm konu türleri arasında), yalnızca --location parametresini belirtin.
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'deki 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'deki 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ı için 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, OR ve DEĞİl.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu 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.

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

Düzenle

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}

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ülmesi gerekip gerekmediğ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ı.

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

Düzenle

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]

Örnekler

Yeni bir uç nokta belirtmek için Event Grid konusu için 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 konu uçları filtresi belirtmek için Azure aboneliği için 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 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

Eklenen 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 bir olay aboneliğini, bir kilitlenme 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 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 string>.

--advanced-filter

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

--deadletter-endpoint

EventGrid'in bu olay aboneliği için teslim edilemeyen olayları geçersiz kılması gereken bir Azure Depolama blob kapsayıcı 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ı hedefinin Azure kaynak kimliği.

--delivery-attribute-mapping

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

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ürmeye çalışmak yerine dize değişmez değerlerini koruyun.

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

--remove

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

--set

Ayarlanacağı özellik yolunu ve değerini 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

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.