az eventgrid topic event-subscription
Mengelola langganan peristiwa topik.
Perintah
Nama | Deskripsi | Jenis | Status |
---|---|---|---|
az eventgrid topic event-subscription create |
Buat langganan peristiwa baru untuk topik. |
Inti | GA |
az eventgrid topic event-subscription delete |
Menghapus langganan peristiwa topik. |
Inti | GA |
az eventgrid topic event-subscription list |
Mencantumkan langganan peristiwa dari topik tertentu. |
Inti | GA |
az eventgrid topic event-subscription show |
Dapatkan detail langganan peristiwa topik. |
Inti | GA |
az eventgrid topic event-subscription update |
Memperbarui langganan peristiwa topik. |
Inti | GA |
az eventgrid topic event-subscription create
Buat langganan peristiwa baru untuk topik.
az eventgrid topic event-subscription create --name
--resource-group
--topic-name
[--aad-app-id]
[--aad-tenant-id]
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--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]
[--pref-batch-size-kb]
[--qttl]
[--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 topic event-subscription create --name es1 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Buat langganan peristiwa baru untuk topik Event Grid, dengan filter yang menentukan awalan subjek.
az eventgrid topic event-subscription create --name es4 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Buat langganan peristiwa baru untuk topik Event Grid, menggunakan filter default, dan CloudEvent V 1.0 sebagai skema pengiriman.
az eventgrid topic event-subscription create -n es2 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Buat langganan peristiwa baru untuk topik Event Grid, dengan tujuan deadletter dan kebijakan coba lagi kustom dari maksimum 10 upaya pengiriman dan Event TTL 2 jam (mana pun yang terjadi sebelumnya) dan tanggal kedaluwarsa.
az eventgrid topic event-subscription create --name es2 \
-g rg1 --topic-name topic1 \
--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 --expiration-date "2022-10-31"
Buat langganan peristiwa baru untuk topik Event Grid, menggunakan Webhook yang diaktifkan Azure Active Directory sebagai tujuan.
az eventgrid topic event-subscription create --name es1 \
-g rg1 --topic-name 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 topic event-subscription create -n es1 \
-g rg1 --topic-name topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Membuat langganan peristiwa baru untuk topik Event Grid menggunakan Antrean Penyimpanan sebagai tujuan dengan ttl 5 menit
az eventgrid topic event-subscription create -n es1 \
-g rg1 --topic-name 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 dan mengaktifkan pemfilteran tingkat lanjut pada array
az eventgrid topic event-subscription create -n es1 \
-g rg1 --topic-name topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays true
Parameter yang Diperlukan
Nama langganan kejadian.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama topik.
Parameter Opsional
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.
Id Penyewa Azure Active Directory untuk mendapatkan token akses yang akan disertakan sebagai token pembawa dalam permintaan pengiriman. Hanya berlaku untuk webhook sebagai tujuan.
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.
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.
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.
Memungkinkan filter tingkat lanjut dievaluasi terhadap array nilai alih-alih mengharapkan nilai tunggal.
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.
Jenis titik akhir tujuan.
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).
Waktu acara untuk ditayangkan (dalam menit). Harus berupa angka antara 1 dan 1440.
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.
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'.
Daftar label yang dipisahkan spasi untuk dikaitkan dengan langganan peristiwa ini.
Jumlah maksimum upaya pengiriman. Harus berupa angka antara 1 dan 30.
Jumlah maksimum peristiwa dalam batch. Harus berupa angka antara 1 hingga 5000.
Ukuran batch pilihan dalam kilobyte. Harus berupa angka antara 1 hingga 1024.
Waktu pesan antrean penyimpanan untuk hidup dalam hitung detik.
String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan awalan. Karakter kartubebas tidak didukung.
Tentukan untuk menunjukkan apakah bidang subjek harus dibandingkan dengan cara peka huruf besar/kecil. True jika ada bendera.
String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan akhiran. Karakter kartubebas tidak didukung.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.
az eventgrid topic event-subscription delete
Menghapus langganan peristiwa topik.
az eventgrid topic event-subscription delete --name
--resource-group
--topic-name
[--yes]
Contoh
Menghapus langganan peristiwa untuk topik Event Grid.
az eventgrid topic event-subscription delete --name es1 \
-g rg1 --topic-name topic1 \
Parameter yang Diperlukan
Nama langganan kejadian.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama topik.
Parameter Opsional
Jangan meminta konfirmasi.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.
az eventgrid topic event-subscription list
Mencantumkan langganan peristiwa dari topik tertentu.
az eventgrid topic event-subscription list --resource-group
--topic-name
[--odata-query]
Contoh
Mencantumkan semua langganan peristiwa yang dibuat untuk topik Event Grid.
az eventgrid topic event-subscription list -g rg1 --topic-name topic1
Parameter yang Diperlukan
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama topik.
Parameter Opsional
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.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.
az eventgrid topic event-subscription show
Dapatkan detail langganan peristiwa topik.
az eventgrid topic event-subscription show --name
--resource-group
--topic-name
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
Contoh
Menampilkan detail langganan peristiwa untuk topik Event Grid.
az eventgrid topic event-subscription show --name es1 \
-g rg1 --topic-name topic1
Tampilkan detail langganan peristiwa untuk topik Event Grid menyertakan rahasia atribut pengiriman statis apa pun.
az eventgrid topic event-subscription show --name es1 \
-g rg1 --topic-name topic1 --include-attrib-secret
Parameter yang Diperlukan
Nama langganan kejadian.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama topik.
Parameter Opsional
Tentukan untuk menunjukkan apakah URL titik akhir lengkap harus dikembalikan. True jika ada bendera.
Menunjukkan apakah ada rahasia atribut pengiriman statis yang harus dikembalikan. True jika ada bendera.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.
az eventgrid topic event-subscription update
Memperbarui langganan peristiwa topik.
az eventgrid topic event-subscription update --name
--resource-group
--topic-name
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--included-event-types]
[--labels]
[--qttl]
[--subject-begins-with]
[--subject-ends-with]
[--update-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
Contoh
Perbarui langganan peristiwa untuk topik Event Grid untuk menentukan titik akhir baru.
az eventgrid topic event-subscription update --name es1 \
-g rg1 --topic-name topic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Perbarui langganan peristiwa untuk topik Event Grid untuk menentukan filter subjek-ends-with baru.
az eventgrid topic event-subscription update --name es2 \
-g rg1 --topic-name topic1 \
--subject-ends-with .jpg
Perbarui langganan peristiwa untuk topik Event Grid untuk menentukan titik akhir baru dan subjek-akhir baru-dengan memfilter daftar baru jenis peristiwa yang disertakan.
az eventgrid topic event-subscription update --name es3 \
-g rg1 --topic-name topic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
Perbarui langganan peristiwa untuk topik Azure Event Grid, untuk menyertakan tujuan deadletter.
az eventgrid topic event-subscription update --name es2 \
-g rg1 --topic-name topic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Perbarui langganan peristiwa untuk topik Azure Event Grid, menggunakan filter tingkat lanjut.
az eventgrid topic event-subscription update --name es3 \
-g rg1 --topic-name topic1 \
--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
Memperbarui langganan peristiwa untuk topik Event Grid dengan Antrean Penyimpanan sebagai tujuan dengan ttl 5 menit
az eventgrid topic event-subscription update -n es1 \
-g rg1 --topic-name topic1 \
--storage-queue-msg-ttl 300
Memperbarui langganan peristiwa untuk topik Event Grid dengan pemfilteran tingkat lanjut pada array diaktifkan
az eventgrid topic event-subscription update -n es1 \
-g rg1 --topic-name topic1 \
--enable-advanced-filtering-on-arrays true
Parameter yang Diperlukan
Nama langganan kejadian.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama topik.
Parameter Opsional
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.
ID sumber daya Azure dari tujuan kontainer blob Azure Storage di mana EventGrid harus mematikan peristiwa yang tidak dapat diteruskan untuk langganan peristiwa ini.
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.
Memungkinkan filter tingkat lanjut dievaluasi terhadap array nilai alih-alih mengharapkan nilai tunggal.
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.
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'.
Daftar label yang dipisahkan spasi untuk dikaitkan dengan langganan peristiwa ini.
Waktu pesan antrean penyimpanan untuk hidup dalam hitung detik.
String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan awalan. Karakter kartubebas tidak didukung.
String opsional untuk memfilter peristiwa untuk langganan peristiwa berdasarkan akhiran. Karakter kartubebas tidak didukung.
Jenis titik akhir tujuan.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.