az eventgrid event-subscription

Referensi

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

az eventgrid event-subscription create	Buat langganan peristiwa baru.
az eventgrid event-subscription delete	Menghapus langganan peristiwa.
az eventgrid event-subscription list	Mencantumkan langganan peristiwa.
az eventgrid event-subscription show	Dapatkan detail langganan peristiwa.
az eventgrid event-subscription update	Memperbarui langganan peristiwa.

az eventgrid event-subscription create

Edit

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

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 maksimum 10 upaya pengiriman dan TTL Peristiwa 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 Storage 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

--advanced-filter

Filter tingkat lanjut memungkinkan pemfilteran peristiwa berdasarkan properti peristiwa tertentu.

--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 terkirim 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 terkirim untuk langganan peristiwa ini.

--delivery-attribute-mapping

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

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

--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 kejadian 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 bahwa titik akhir tujuan sudah dibuat dan tersedia untuk digunakan sebelum menjalankan perintah Event Grid apa pun.

--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 kejadian ini. Secara default, peristiwa akan dikirimkan dalam skema yang sama tempat peristiwa diterbitkan (berdasarkan skema input topik yang sesuai).

nilai yang diterima: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Waktu acara aktif (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 itu 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 Storage, IoT Hub, dll., Anda dapat mengkueri jenis peristiwanya menggunakan perintah CLI ini 'az eventgrid topic-type list-event-type'.

--labels

Daftar label yang dipisahkan spasi untuk dikaitkan dengan langganan kejadian 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

Storage waktu pesan antrean untuk hidup dalam hitung detik.

--source-resource-id

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

--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 yang peka huruf besar/kecil. Benar jika bendera ada.

nilai yang diterima: false, true

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

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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.

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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 Storage 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:

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.
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".
Untuk mencantumkan semua langganan peristiwa di suatu wilayah (di semua jenis topik), tentukan hanya parameter --location.
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 Storage (di bawah langganan Azure yang saat ini dipilih) di westus2.

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

Cantumkan semua langganan peristiwa Storage (di bawah grup sumber daya yang diberikan) 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

Mencantumkan 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 equal), ne (untuk not equal), 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.

--topic-type-name

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

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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

Menampilkan 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

Menampilkan 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 bendera ada.

nilai yang diterima: false, true

--include-full-endpoint-url

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

nilai yang diterima: false, true

--source-resource-id

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

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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 {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]

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 filter subjek-dengan subjek baru.

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 dengan 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, atau JSON string>.

--advanced-filter

Filter tingkat lanjut memungkinkan pemfilteran peristiwa berdasarkan properti peristiwa tertentu.

--deadletter-endpoint

ID sumber daya Azure dari tujuan kontainer blob Azure Storage di mana EventGrid harus mematikan peristiwa yang tidak terkirim 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 terkirim untuk langganan peristiwa ini.

--delivery-attribute-mapping

--delivery-identity

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

nilai yang diterima: systemassigned

--delivery-identity-endpoint

Titik akhir dengan identitas di mana 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

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

--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 Storage, 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 kejadian ini.

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

Storage waktu pesan antrean untuk hidup dalam hitung detik.

--remove

Hapus properti atau elemen dari daftar. Contoh: --remove property.list OR --remove propertyToRemove.

--set

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

--source-resource-id

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

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

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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

Perintah

az eventgrid event-subscription create

Contoh

Parameter yang Diperlukan

Parameter Opsional

az eventgrid event-subscription delete

Contoh

Parameter yang Diperlukan

Parameter Opsional

az eventgrid event-subscription list

Contoh

Parameter Opsional

az eventgrid event-subscription show

Contoh

Parameter yang Diperlukan

Parameter Opsional

az eventgrid event-subscription update

Contoh

Parameter yang Diperlukan

Parameter Opsional

Saran dan Komentar