az eventgrid event-subscription

  • Referensi

Catatan

Grup perintah ini memiliki perintah yang ditentukan di Azure CLI dan setidaknya satu ekstensi. Instal setiap ekstensi untuk mendapatkan manfaat dari kemampuannya yang diperluas. Pelajari lebih lanjut tentang ekstensi.

Mengelola langganan peristiwa.

Mengelola langganan peristiwa untuk topik Event Grid, domain, topik domain, langganan Azure, grup sumber daya, atau untuk sumber daya Azure lainnya yang mendukung pemberitahuan peristiwa.

Perintah

Nama Deskripsi Jenis Status
az eventgrid event-subscription create

Buat langganan peristiwa baru.

 Inti GA
az eventgrid event-subscription create (eventgrid extension)

Buat langganan peristiwa baru.

 Ekstensi Pratinjau
az eventgrid event-subscription delete

Menghapus langganan peristiwa.

 Inti GA
az eventgrid event-subscription delete (eventgrid extension)

Menghapus langganan peristiwa.

 Ekstensi Pratinjau
az eventgrid event-subscription list

Mencantumkan langganan peristiwa.

 Inti GA
az eventgrid event-subscription list (eventgrid extension)

Mencantumkan langganan peristiwa.

 Ekstensi Pratinjau
az eventgrid event-subscription show

Dapatkan detail langganan peristiwa.

 Inti GA
az eventgrid event-subscription show (eventgrid extension)

Dapatkan detail langganan peristiwa.

 Ekstensi Pratinjau
az eventgrid event-subscription update

Memperbarui langganan peristiwa.

 Inti GA
az eventgrid event-subscription update (eventgrid extension)

Memperbarui langganan peristiwa.

 Ekstensi Pratinjau

az eventgrid event-subscription create

Edit

Buat langganan peristiwa baru.

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]

Contoh

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan filter default.

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

Buat langganan peristiwa baru untuk langganan Azure, menggunakan filter default.

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

Buat langganan peristiwa baru untuk grup sumber daya, menggunakan filter default.

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

Buat langganan peristiwa baru untuk akun penyimpanan, menggunakan filter default.

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

Buat langganan peristiwa baru untuk akun penyimpanan, menggunakan filter tingkat lanjut.

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

Buat langganan peristiwa baru untuk langganan Azure, dengan filter yang menentukan awalan subjek.

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

Buat langganan peristiwa baru untuk grup sumber daya, dengan filter yang menentukan akhiran subjek.

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

Buat langganan peristiwa baru untuk langganan Azure, menggunakan filter default, dan EventHub sebagai tujuan.

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

Buat langganan peristiwa baru untuk langganan Azure, menggunakan filter default, dan antrean Azure Storage sebagai tujuan.

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

Buat langganan peristiwa baru untuk langganan Azure, menggunakan filter default, dan Azure ServiceBusQueue sebagai tujuan.

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

Buat langganan peristiwa baru untuk domain Event Grid, menggunakan filter default, dan CloudEvent V 1.0 sebagai skema pengiriman.

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

Buat langganan peristiwa baru untuk akun penyimpanan, dengan tujuan deadletter dan kebijakan coba lagi kustom dari maksimum 10 upaya pengiriman dan Event TTL 2 jam (mana pun yang terjadi sebelumnya).

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

Buat langganan peristiwa baru untuk topik domain.

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

Buat langganan peristiwa baru (untuk akun penyimpanan) dengan tanggal kedaluwarsa.

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"

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan Webhook yang diaktifkan Azure Active Directory sebagai tujuan .

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

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan Azure Function sebagai tujuan.

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

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan Eventhub dengan identitas MSI yang ditetapkan sistem sebagai tujuan dan dengan deadletter dengan identitas MSI

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}

Membuat langganan peristiwa baru untuk topik Event Grid menggunakan Antrean Penyimpanan sebagai tujuan dengan pesan ttl pada 5 menit

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

Membuat langganan peristiwa baru untuk topik Event Grid menggunakan StorageQueue dengan identitas MSI yang ditetapkan sistem sebagai tujuan

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

Membuat langganan peristiwa baru untuk topik Event Grid dengan pemfilteran tingkat lanjut diaktifkan pada array

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

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

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

Id Penyewa Azure Active Directory untuk mendapatkan token akses yang akan disertakan sebagai token pembawa dalam permintaan pengiriman. Hanya berlaku untuk webhook sebagai tujuan.

--advanced-filter

Filter tingkat lanjut memungkinkan pemfilteran peristiwa berdasarkan properti peristiwa tertentu.

Penggunaan: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. String Warna Dalam String Kuning Oranye Merah BiruNotIn: --advanced-filter data. String WarnaNotIn Biru Merah Oranye String KuningContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWithth: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Beberapa filter tingkat lanjut dapat ditentukan dengan menggunakan lebih dari satu --advanced-filter argumen.

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

Id Aplikasi Azure Active Directory atau Uri untuk mendapatkan token akses yang akan disertakan sebagai token pembawa dalam permintaan pengiriman. Hanya berlaku untuk webhook sebagai tujuan.

--deadletter-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

Contoh: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity
Pratinjau

Jenis identitas sumber daya tujuan deadletter.

nilai yang diterima: systemassigned
--deadletter-identity-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage dengan identitas di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

--delivery-attribute-mapping

Tambahkan pemetaan atribut pengiriman untuk mengirim informasi tambahan melalui header HTTP saat mengirimkan peristiwa. Atribut ini valid untuk semua jenis tujuan kecuali StorageQueue. Beberapa atribut dapat ditentukan dengan menggunakan lebih dari satu --delivery-attribute-mapping argumen.

Penggunaan: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Pemetaan Atribut Statis: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-map memetakan somename statis somevalue false Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Pratinjau

Jenis identitas sumber daya tujuan pengiriman (misalnya, antrean penyimpanan, atau eventhub).

nilai yang diterima: systemassigned
--delivery-identity-endpoint
Pratinjau

Titik akhir dengan identitas tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir.

--delivery-identity-endpoint-type
Pratinjau

Jenis titik akhir tujuan dengan identitas sumber daya.

nilai yang diterima: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Memungkinkan filter tingkat lanjut dievaluasi terhadap array nilai alih-alih mengharapkan nilai tunggal.

nilai yang diterima: false, true
--endpoint

Titik akhir tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir. Diharapkan titik akhir tujuan sudah dibuat dan tersedia untuk digunakan sebelum menjalankan perintah Event Grid apa pun.

--endpoint-type

Jenis titik akhir tujuan.

nilai default: webhook
--event-delivery-schema

Skema di mana peristiwa harus dikirimkan untuk langganan peristiwa ini. Secara default, peristiwa akan dikirimkan dalam skema yang sama di mana peristiwa tersebut diterbitkan (berdasarkan skema input topik yang sesuai).

nilai yang diterima: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Waktu acara untuk ditayangkan (dalam menit). Harus berupa angka antara 1 dan 1440.

nilai default: 1440
--expiration-date

Tanggal atau tanggalwaktu (dalam UTC, misalnya '2018-11-30T11:59:59+00:00' atau '2018-11-30') setelah langganan peristiwa akan kedaluwarsa. Secara default, tidak ada kedaluwarsa untuk langganan peristiwa.

--included-event-types

Daftar jenis peristiwa yang dipisahkan spasi (misalnya, Microsoft.Storage.BlobCreated dan Microsoft.Storage.BlobDeleted). Untuk berlangganan semua jenis peristiwa default, jangan tentukan nilai apa pun untuk argumen ini. Untuk topik event grid, jenis peristiwa ditentukan pelanggan. Untuk peristiwa Azure, misalnya, Akun Penyimpanan, IoT Hub, dll., Anda dapat mengkueri jenis peristiwa mereka menggunakan perintah CLI ini 'az eventgrid topic-type list-event-type'.

--labels

Daftar label yang dipisahkan spasi untuk dikaitkan dengan langganan peristiwa ini.

--max-delivery-attempts

Jumlah maksimum upaya pengiriman. Harus berupa angka antara 1 dan 30.

nilai default: 30
--max-events-per-batch

Jumlah maksimum peristiwa dalam batch. Harus berupa angka antara 1 hingga 5000.

--preferred-batch-size-in-kilobytes

Ukuran batch pilihan dalam kilobyte. Harus berupa angka antara 1 hingga 1024.

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

Waktu pesan antrean penyimpanan untuk hidup dalam hitung detik.

--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat tempat langganan peristiwa perlu dibuat.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan awalan. Karakter kartubebas tidak didukung.

--subject-case-sensitive

Tentukan untuk menunjukkan apakah bidang subjek harus dibandingkan dengan cara peka huruf besar/kecil. True jika ada bendera.

nilai yang diterima: false, true
nilai default: False
--subject-ends-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan akhiran. Karakter kartubebas tidak didukung.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription create (eventgrid extension)

Pratinjau

Grup perintah 'az eventgrid' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Buat langganan peristiwa baru.

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-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Contoh

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan filter default.

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

Buat langganan peristiwa baru untuk langganan langganan Azure, menggunakan filter default.

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

Buat langganan peristiwa baru untuk grup sumber daya, menggunakan filter default.

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

Buat langganan peristiwa baru untuk akun penyimpanan, menggunakan filter default.

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

Buat langganan peristiwa baru untuk akun penyimpanan, menggunakan filter tingkat lanjut.

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

Buat langganan peristiwa baru untuk langganan Azure, dengan filter yang menentukan awalan subjek.

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

Buat langganan peristiwa baru untuk grup sumber daya, dengan filter yang menentukan akhiran subjek.

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

Buat langganan peristiwa baru untuk langganan Azure, menggunakan filter default, dan EventHub sebagai tujuan.

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

Buat langganan peristiwa baru untuk langganan Azure, menggunakan filter default, dan antrean Azure Storage sebagai tujuan.

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

Buat langganan peristiwa baru untuk langganan Azure, menggunakan filter default, dan Azure ServiceBusQueue sebagai tujuan.

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

Buat langganan peristiwa baru untuk domain Event Grid, menggunakan filter default, dan CloudEvent V 1.0 sebagai skema pengiriman.

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

Buat langganan peristiwa baru untuk akun penyimpanan, dengan tujuan deadletter dan kebijakan coba lagi kustom dari maksimum 10 upaya pengiriman dan Event TTL 2 jam (mana pun yang terjadi sebelumnya).

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

Buat langganan peristiwa baru untuk topik domain.

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

Buat langganan peristiwa baru (untuk akun penyimpanan) dengan tanggal kedaluwarsa.

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"

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan Webhook yang diaktifkan Azure Active Directory sebagai tujuan .

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

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan Azure Function sebagai tujuan.

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

Buat langganan peristiwa baru untuk topik Event Grid, menggunakan Eventhub dengan identitas MSI yang ditetapkan sistem sebagai tujuan dan dengan deadletter dengan identitas MSI

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}

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

--advanced-filter

Filter tingkat lanjut memungkinkan pemfilteran peristiwa berdasarkan properti peristiwa tertentu.

Penggunaan: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. String Warna Dalam String Kuning Oranye Merah BiruNotIn: --advanced-filter data. String WarnaNotIn Merah Merah Oranye Kuning StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true Beberapa filter tingkat lanjut dapat ditentukan dengan menggunakan lebih dari satu --advanced-filter argumen.

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

Id Aplikasi Azure Active Directory atau Uri untuk mendapatkan token akses yang akan disertakan sebagai token pembawa dalam permintaan pengiriman. Hanya berlaku untuk webhook sebagai tujuan.

--azure-active-directory-tenant-id

Id Penyewa Azure Active Directory untuk mendapatkan token akses yang akan disertakan sebagai token pembawa dalam permintaan pengiriman. Hanya berlaku untuk webhook sebagai tujuan.

--deadletter-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

Contoh: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity

Jenis identitas sumber daya tujuan deadletter.

nilai yang diterima: systemassigned
--deadletter-identity-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage dengan identitas di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

--delivery-identity

Jenis identitas sumber daya tujuan pengiriman (misalnya, antrean penyimpanan, atau eventhub).

nilai yang diterima: systemassigned
--delivery-identity-endpoint

Titik akhir dengan identitas tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir.

--delivery-identity-endpoint-type

Jenis titik akhir tujuan dengan identitas sumber daya.

nilai yang diterima: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Titik akhir tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir.

--endpoint-type

Jenis titik akhir tujuan.

nilai yang diterima: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
nilai default: webhook
--event-delivery-schema

Skema di mana peristiwa harus dikirimkan untuk langganan peristiwa ini. Secara default, peristiwa akan dikirimkan dalam skema yang sama di mana peristiwa tersebut diterbitkan (berdasarkan skema input topik yang sesuai).

nilai yang diterima: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Waktu acara untuk ditayangkan (dalam menit). Harus berupa angka antara 1 dan 1440.

nilai default: 1440
--expiration-date

Tanggal atau tanggalwaktu (dalam UTC, misalnya '2018-11-30T11:59:59+00:00' atau '2018-11-30') setelah langganan peristiwa akan kedaluwarsa. Secara default, tidak ada kedaluwarsa untuk langganan peristiwa.

--included-event-types

Daftar jenis peristiwa yang dipisahkan spasi. Contoh: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Untuk berlangganan semua jenis peristiwa default, jangan tentukan nilai apa pun untuk argumen ini.

--labels

Daftar label yang dipisahkan spasi untuk dikaitkan dengan langganan peristiwa ini.

--max-delivery-attempts

Jumlah maksimum upaya pengiriman. Harus berupa angka antara 1 dan 30.

nilai default: 30
--max-events-per-batch

Jumlah maksimum peristiwa dalam batch. Harus berupa angka antara 1 hingga 5000.

--preferred-batch-size-in-kilobytes

Ukuran batch pilihan dalam kilobyte. Harus berupa angka antara 1 hingga 1024.

--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat tempat langganan peristiwa perlu dibuat.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan awalan. Karakter kartubebas tidak didukung.

--subject-case-sensitive

Tentukan untuk menunjukkan apakah bidang subjek harus dibandingkan dengan cara peka huruf besar/kecil. True jika ada bendera.

nilai yang diterima: false, true
nilai default: False
--subject-ends-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan akhiran. Karakter kartubebas tidak didukung.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription delete

Edit

Menghapus langganan peristiwa.

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

Contoh

Menghapus langganan peristiwa untuk topik Event Grid.

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

Menghapus langganan peristiwa untuk topik domain Event Grid.

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

Menghapus langganan peristiwa untuk domain Event Grid.

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

Menghapus langganan peristiwa untuk langganan Azure.

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

Menghapus langganan peristiwa untuk grup sumber daya.

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

Menghapus langganan peristiwa untuk akun penyimpanan.

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

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu dihapus.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription delete (eventgrid extension)

Pratinjau

Grup perintah 'az eventgrid' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Menghapus langganan peristiwa.

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

Contoh

Menghapus langganan peristiwa untuk topik Event Grid.

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

Menghapus langganan peristiwa untuk topik domain Event Grid.

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

Menghapus langganan peristiwa untuk domain Event Grid.

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

Menghapus langganan peristiwa untuk langganan Azure.

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

Menghapus langganan peristiwa untuk grup sumber daya.

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

Menghapus langganan peristiwa untuk akun penyimpanan.

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

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu dihapus.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription list

Edit

Mencantumkan langganan peristiwa.

Event Grid mendukung langganan acara regional dan global: Langganan peristiwa pada sumber daya regional (seperti akun Penyimpanan atau topik Event Grid) bersifat regional, sementara langganan peristiwa pada sumber daya global (seperti langganan Azure atau grup sumber daya) bersifat global. Oleh karena itu, Anda dapat mencantumkan langganan peristiwa dengan beberapa cara berbeda:

  1. Untuk mencantumkan menurut ID sumber daya sumber daya yang langganan peristiwanya ingin Anda cantumkan, tentukan parameter --source-resource-id. Tidak ada parameter lain yang harus ditentukan.
  2. Untuk mencantumkan menurut jenis topik (misalnya akun penyimpanan), tentukan parameter --topic-type bersama dengan parameter --location (misalnya, "westus2"). Untuk jenis topik global (misalnya" Microsoft.Resources.Subscriptions"), tentukan nilai lokasi sebagai "global".
  3. Untuk mencantumkan semua langganan peristiwa di suatu wilayah (di semua jenis topik), tentukan hanya parameter --location.
  4. Untuk #2 dan #3 di atas, untuk memfilter hanya menurut grup sumber daya, Anda juga dapat menentukan parameter --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Contoh

Mencantumkan semua langganan peristiwa yang dibuat untuk topik Event Grid.

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

Mencantumkan semua langganan peristiwa yang dibuat untuk akun penyimpanan.

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

Mencantumkan semua langganan peristiwa yang dibuat untuk langganan Azure.

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

Mencantumkan semua langganan peristiwa yang dibuat untuk grup sumber daya.

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

Mencantumkan semua langganan peristiwa untuk domain Event Grid.

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

Mencantumkan semua langganan peristiwa untuk topik domain Event Grid.

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

Cantumkan semua langganan peristiwa Penyimpanan (di bawah langganan Azure yang saat ini dipilih) di westus2.

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

Mencantumkan semua langganan peristiwa Penyimpanan (di bawah grup sumber daya tertentu) di westus2.

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

Cantumkan semua langganan peristiwa regional atau global (di bawah langganan Azure yang saat ini dipilih).

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

Cantumkan semua langganan peristiwa regional atau global di bawah grup sumber daya tertentu.

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

Mencantumkan semua langganan peristiwa untuk domain Event Grid yang namanya berisi pola "XYZ"

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

Mencantumkan semua langganan peristiwa untuk domain Event Grid kecuali langganan peristiwa dengan nama "name1"

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

Parameter Opsional

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--odata-query

Kueri OData yang digunakan untuk memfilter hasil daftar. Pemfilteran saat ini hanya diperbolehkan pada properti Nama. Operasi yang didukung meliputi: CONTAINS, eq (untuk sama), ne (untuk tidak sama), AND, OR dan NOT.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu dicantumkan.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nama jenis topik yang langganan peristiwanya perlu dicantumkan. Ketika ini ditentukan, Anda juga harus menentukan --location.

Contoh 1: Mencantumkan semua langganan peristiwa Penyimpanan di WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Contoh 2: Mencantumkan semua langganan peristiwa pada langganan Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription list (eventgrid extension)

Pratinjau

Grup perintah 'az eventgrid' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Mencantumkan langganan peristiwa.

Event Grid mendukung langganan acara regional dan global: Langganan peristiwa pada sumber daya regional (seperti akun Penyimpanan atau topik Event Grid) bersifat regional, sementara langganan peristiwa pada sumber daya global (seperti langganan Azure atau grup sumber daya) bersifat global. Oleh karena itu, Anda dapat mencantumkan langganan peristiwa dengan beberapa cara berbeda:

  1. Untuk mencantumkan menurut ID sumber daya sumber daya yang langganan peristiwanya ingin Anda cantumkan, tentukan parameter --source-resource-id. Tidak ada parameter lain yang harus ditentukan.
  2. Untuk mencantumkan menurut jenis topik (misalnya akun penyimpanan), tentukan parameter --topic-type bersama dengan parameter --location (misalnya, "westus2"). Untuk jenis topik global (misalnya" Microsoft.Resources.Subscriptions"), tentukan nilai lokasi sebagai "global".
  3. Untuk mencantumkan semua langganan peristiwa di suatu wilayah (di semua jenis topik), tentukan hanya parameter --location.
  4. Untuk #2 dan #3 di atas, untuk memfilter hanya menurut grup sumber daya, Anda juga dapat menentukan parameter --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Contoh

Mencantumkan semua langganan peristiwa yang dibuat untuk topik Event Grid.

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

Mencantumkan semua langganan peristiwa yang dibuat untuk akun penyimpanan.

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

Mencantumkan semua langganan peristiwa yang dibuat untuk langganan Azure.

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

Mencantumkan semua langganan peristiwa yang dibuat untuk grup sumber daya.

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

Mencantumkan semua langganan peristiwa untuk domain Event Grid.

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

Mencantumkan semua langganan peristiwa untuk topik domain Event Grid.

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

Cantumkan semua langganan peristiwa Penyimpanan (di bawah langganan Azure yang saat ini dipilih) di westus2.

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

Mencantumkan semua langganan peristiwa Penyimpanan (di bawah grup sumber daya tertentu) di westus2.

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

Cantumkan semua langganan peristiwa regional atau global (di bawah langganan Azure yang saat ini dipilih).

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

Cantumkan semua langganan peristiwa regional atau global di bawah grup sumber daya tertentu.

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

Mencantumkan semua langganan peristiwa untuk domain Event Grid yang namanya berisi pola "XYZ"

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

Mencantumkan semua langganan peristiwa untuk domain Event Grid kecuali langganan peristiwa dengan nama "name1"

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

Parameter Opsional

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--odata-query

Kueri yang digunakan untuk memfilter hasil menggunakan sintaks OData.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu dicantumkan.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nama jenis topik yang langganan peristiwanya perlu dicantumkan. Ketika ini ditentukan, Anda juga harus menentukan --location.

Contoh 1: Mencantumkan semua langganan peristiwa Penyimpanan di WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Contoh 2: Mencantumkan semua langganan peristiwa pada langganan Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription show

Edit

Dapatkan detail langganan peristiwa.

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

Contoh

Menampilkan detail langganan peristiwa untuk topik Event Grid.

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

Memperlihatkan detail langganan peristiwa untuk langganan Azure.

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

Memperlihatkan detail langganan peristiwa untuk grup sumber daya.

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

Memperlihatkan detail langganan peristiwa untuk akun penyimpanan.

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

Tampilkan detail langganan peristiwa untuk grup sumber daya termasuk rahasia atribut pengiriman statis apa pun.

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

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

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

Menunjukkan apakah ada rahasia atribut pengiriman statis yang harus dikembalikan. True jika ada bendera.

nilai yang diterima: false, true
nilai default: False
--include-full-endpoint-url

Tentukan untuk menunjukkan apakah URL titik akhir lengkap harus dikembalikan. True jika ada bendera.

nilai yang diterima: false, true
nilai default: False
--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu ditampilkan.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription show (eventgrid extension)

Pratinjau

Grup perintah 'az eventgrid' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Dapatkan detail langganan peristiwa.

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

Contoh

Menampilkan detail langganan peristiwa untuk topik Event Grid.

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

Memperlihatkan detail langganan peristiwa untuk langganan Azure.

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

Memperlihatkan detail langganan peristiwa untuk grup sumber daya.

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

Memperlihatkan detail langganan peristiwa untuk akun penyimpanan.

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

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

--include-full-endpoint-url

Tentukan untuk menunjukkan apakah URL titik akhir lengkap harus dikembalikan. True jika ada bendera.

nilai yang diterima: false, true
nilai default: False
--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu ditampilkan.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription update

Edit

Memperbarui langganan peristiwa.

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]

Contoh

Perbarui langganan peristiwa untuk topik Event Grid untuk menentukan titik akhir baru.

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

Perbarui langganan peristiwa untuk langganan Azure untuk menentukan subjek baru dengan filter.

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

Perbarui langganan peristiwa untuk grup sumber daya untuk menentukan titik akhir baru dan filter akhir subjek baru.

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

Perbarui langganan peristiwa untuk akun penyimpanan untuk menentukan daftar baru jenis peristiwa yang disertakan.

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

Perbarui langganan peristiwa untuk akun penyimpanan, untuk menyertakan tujuan deadletter.

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

Perbarui langganan peristiwa untuk akun penyimpanan, menggunakan filter tingkat lanjut.

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

Perbarui langganan peristiwa untuk akun penyimpanan untuk menyertakan ttl pesan yang diatur ke 5 menit.

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

Memperbarui langganan peristiwa dengan pemfilteran tingkat lanjut diaktifkan pada array

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

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>.

nilai default: []
--advanced-filter

Filter tingkat lanjut memungkinkan pemfilteran peristiwa berdasarkan properti peristiwa tertentu.

Penggunaan: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. String Warna Dalam String Kuning Oranye Merah BiruNotIn: --advanced-filter data. String WarnaNotIn Biru Merah Oranye String KuningContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWithth: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Beberapa filter tingkat lanjut dapat ditentukan dengan menggunakan lebih dari satu --advanced-filter argumen.

--deadletter-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

--deadletter-identity
Pratinjau

Jenis identitas sumber daya tujuan deadletter.

nilai yang diterima: systemassigned
--deadletter-identity-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage dengan identitas di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

--delivery-attribute-mapping

Tambahkan pemetaan atribut pengiriman untuk mengirim informasi tambahan melalui header HTTP saat mengirimkan peristiwa. Atribut ini valid untuk semua jenis tujuan kecuali StorageQueue. Beberapa atribut dapat ditentukan dengan menggunakan lebih dari satu --delivery-attribute-mapping argumen.

Penggunaan: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Pemetaan Atribut Statis: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-map memetakan somename statis somevalue false Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Pratinjau

Jenis identitas sumber daya tujuan pengiriman (misalnya, antrean penyimpanan, atau eventhub).

nilai yang diterima: systemassigned
--delivery-identity-endpoint
Pratinjau

Titik akhir dengan identitas tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir.

--delivery-identity-endpoint-type
Pratinjau

Jenis titik akhir tujuan dengan identitas sumber daya.

nilai yang diterima: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Memungkinkan filter tingkat lanjut dievaluasi terhadap array nilai alih-alih mengharapkan nilai tunggal.

nilai yang diterima: false, true
--endpoint

Titik akhir tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir. Diharapkan titik akhir tujuan sudah dibuat dan tersedia untuk digunakan sebelum menjalankan perintah Event Grid apa pun.

--endpoint-type

Jenis titik akhir tujuan.

nilai default: webhook
--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

nilai default: False
--included-event-types

Daftar jenis peristiwa yang dipisahkan spasi (misalnya, Microsoft.Storage.BlobCreated dan Microsoft.Storage.BlobDeleted). Untuk berlangganan semua jenis peristiwa default, jangan tentukan nilai apa pun untuk argumen ini. Untuk topik event grid, jenis peristiwa ditentukan pelanggan. Untuk peristiwa Azure, misalnya, Akun Penyimpanan, IoT Hub, dll., Anda dapat mengkueri jenis peristiwa mereka menggunakan perintah CLI ini 'az eventgrid topic-type list-event-type'.

--labels

Daftar label yang dipisahkan spasi untuk dikaitkan dengan langganan peristiwa ini.

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

Waktu pesan antrean penyimpanan untuk hidup dalam hitung detik.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> ATAU --remove propertyToRemove.

nilai default: []
--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>.

nilai default: []
--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu diperbarui.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan awalan. Karakter kartubebas tidak didukung.

--subject-ends-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan akhiran. Karakter kartubebas tidak didukung.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az eventgrid event-subscription update (eventgrid extension)

Pratinjau

Grup perintah 'az eventgrid' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Memperbarui langganan peristiwa.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Contoh

Perbarui langganan peristiwa untuk topik Event Grid untuk menentukan titik akhir baru.

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

Perbarui langganan peristiwa untuk langganan Azure untuk menentukan subjek baru dengan filter.

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

Perbarui langganan peristiwa untuk grup sumber daya untuk menentukan titik akhir baru dan filter akhir subjek baru.

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

Perbarui langganan peristiwa untuk akun penyimpanan untuk menentukan daftar baru jenis peristiwa yang disertakan.

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

Perbarui langganan peristiwa untuk akun penyimpanan, untuk menyertakan tujuan deadletter.

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

Perbarui langganan peristiwa untuk akun penyimpanan, menggunakan filter tingkat lanjut.

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

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

Parameter Opsional

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>.

nilai default: []
--advanced-filter

Filter tingkat lanjut memungkinkan pemfilteran peristiwa berdasarkan properti peristiwa tertentu.

Penggunaan: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. String Warna Dalam String Kuning Oranye Merah BiruNotIn: --advanced-filter data. String WarnaNotIn Merah Merah Oranye Kuning StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true Beberapa filter tingkat lanjut dapat ditentukan dengan menggunakan lebih dari satu --advanced-filter argumen.

--deadletter-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

--deadletter-identity

Jenis identitas sumber daya tujuan deadletter.

nilai yang diterima: systemassigned
--deadletter-identity-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage dengan identitas di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.

--delivery-identity

Jenis identitas sumber daya tujuan pengiriman (misalnya, antrean penyimpanan, atau eventhub).

nilai yang diterima: systemassigned
--delivery-identity-endpoint

Titik akhir dengan identitas tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir.

--delivery-identity-endpoint-type

Jenis titik akhir tujuan dengan identitas sumber daya.

nilai yang diterima: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Titik akhir tempat EventGrid harus mengirimkan peristiwa yang cocok dengan langganan peristiwa ini. Untuk jenis titik akhir webhook, ini harus menjadi URL webhook yang sesuai. Untuk jenis titik akhir lainnya, ini harus menjadi pengidentifikasi sumber daya Azure dari titik akhir.

--endpoint-type

Jenis titik akhir tujuan.

nilai yang diterima: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
nilai default: webhook
--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

nilai default: False
--included-event-types

Daftar jenis peristiwa yang dipisahkan spasi. Contoh: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Untuk berlangganan semua jenis peristiwa default, jangan tentukan nilai apa pun untuk argumen ini.

--labels

Daftar label yang dipisahkan spasi untuk dikaitkan dengan langganan peristiwa ini.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> ATAU --remove propertyToRemove.

nilai default: []
--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>.

nilai default: []
--source-resource-id

Pengidentifikasi sumber daya Azure yang sepenuhnya memenuhi syarat yang langganan peristiwanya perlu diperbarui.

Penggunaan: --source-resource-id Azure-Resource-ID Untuk langganan Azure: --source-resource-id /subscriptions/{SubID} Untuk grup sumber daya: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Untuk topik EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Untuk akun penyimpanan: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 Untuk domain EventGrid: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Untuk topik domain EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan awalan. Karakter kartubebas tidak didukung.

--subject-ends-with

String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan akhiran. Karakter kartubebas tidak didukung.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.