az eventgrid system-topic event-subscription

Mengelola langganan peristiwa topik sistem.

Perintah

az eventgrid system-topic event-subscription create	Buat langganan peristiwa baru untuk topik sistem.
az eventgrid system-topic event-subscription delete	Menghapus langganan peristiwa topik sistem.
az eventgrid system-topic event-subscription list	Mencantumkan langganan peristiwa dari topik sistem tertentu.
az eventgrid system-topic event-subscription show	Dapatkan detail langganan peristiwa dari topik sistem.
az eventgrid system-topic event-subscription update	Memperbarui langganan peristiwa topik sistem.

az eventgrid system-topic event-subscription create

Buat langganan peristiwa baru untuk topik sistem.

az eventgrid system-topic event-subscription create --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--advanced-filter]
                                                    [--azure-active-directory-application-id-or-uri]
                                                    [--azure-active-directory-tenant-id]
                                                    [--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]
                                                    [--preferred-batch-size-in-kilobytes]
                                                    [--qttl]
                                                    [--subject-begins-with]
                                                    [--subject-case-sensitive {false, true}]
                                                    [--subject-ends-with]

Contoh

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

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Buat langganan peristiwa baru untuk topik sistem Event Grid, dengan filter yang menentukan awalan subjek.

az eventgrid system-topic event-subscription create --name es4 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

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

az eventgrid system-topic event-subscription create -n es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Buat langganan peristiwa baru untuk topik sistem Event Grid, dengan tujuan deadletter dan kebijakan percobaan kembali kustom maksimum 10 upaya pengiriman dan TTL Peristiwa 2 jam (mana pun yang terjadi sebelumnya) dan tanggal kedaluwarsa.

az eventgrid system-topic event-subscription create --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 sistem Event Grid, menggunakan Webhook yang diaktifkan Azure Active Directory sebagai tujuan .

az eventgrid system-topic event-subscription create --name es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 sistem Event Grid, menggunakan Azure Function sebagai tujuan.

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Membuat langganan peristiwa baru untuk topik sistem Event Grid menggunakan antrean Storage sebagai tujuan dengan ttl 5 menit

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 sistem Event Grid dan mengaktifkan pemfilteran tingkat lanjut pada array

az eventgrid system-topic event-subscription create -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
    --enable-advanced-filtering-on-arrays true

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

--resource-group -g

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

--system-topic-name

Nama topik sistem.

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.

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

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

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

Menghapus langganan peristiwa topik sistem.

az eventgrid system-topic event-subscription delete --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--yes]

Contoh

Menghapus langganan peristiwa untuk topik sistem Event Grid.

az eventgrid system-topic event-subscription delete --name es1 \
    -g rg1 --system-topic-name systemtopic1 \

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

--resource-group -g

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

--system-topic-name

Nama topik sistem.

Parameter Opsional

--yes -y

Jangan meminta konfirmasi.

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

Mencantumkan langganan peristiwa dari topik sistem tertentu.

az eventgrid system-topic event-subscription list --resource-group
                                                  --system-topic-name
                                                  [--odata-query]

Contoh

Mencantumkan semua langganan peristiwa yang dibuat untuk topik sistem Event Grid.

az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1

Parameter yang Diperlukan

--resource-group -g

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

--system-topic-name

Nama topik sistem.

Parameter Opsional

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

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

Dapatkan detail langganan peristiwa dari topik sistem.

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

Contoh

Menampilkan detail langganan peristiwa untuk topik sistem Event Grid.

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1

Tampilkan detail langganan peristiwa untuk topik sistem Event Grid termasuk rahasia atribut pengiriman statis apa pun.

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1 --include-attrib-secret

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

--resource-group -g

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

--system-topic-name

Nama topik sistem.

Parameter Opsional

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

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

nilai yang diterima: false, true

--include-full-endpoint-url

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

nilai yang diterima: false, true

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

Memperbarui langganan peristiwa topik sistem.

az eventgrid system-topic event-subscription update --name
                                                    --resource-group
                                                    --system-topic-name
                                                    [--advanced-filter]
                                                    [--deadletter-endpoint]
                                                    [--delivery-attribute-mapping]
                                                    [--enable-advanced-filtering-on-arrays {false, true}]
                                                    [--endpoint]
                                                    [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                    [--included-event-types]
                                                    [--labels]
                                                    [--qttl]
                                                    [--subject-begins-with]
                                                    [--subject-ends-with]

Contoh

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

az eventgrid system-topic event-subscription update --name es1 \
    -g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Perbarui langganan peristiwa untuk topik sistem Event Grid untuk menentukan filter subject-ends-with baru.

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --subject-ends-with .jpg

Perbarui langganan peristiwa untuk topik sistem Event Grid untuk menentukan titik akhir baru dan subjek baru-berakhir-dengan memfilter daftar baru jenis peristiwa yang disertakan.

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 sistem Azure Event Grid, untuk menyertakan tujuan deadletter.

az eventgrid system-topic event-subscription update --name es2 \
    -g rg1 --system-topic-name systemtopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Perbarui langganan peristiwa untuk topik sistem Azure Event Grid, menggunakan filter tingkat lanjut.

az eventgrid system-topic event-subscription update --name es3 \
    -g rg1 --system-topic-name systemtopic1 \
    --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 sistem Event Grid dengan antrean Storage sebagai tujuan dengan ttl 5 menit

az eventgrid system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --storage-queue-msg-ttl 300

Memperbarui langganan peristiwa untuk topik sistem Event Grid dengan pemfilteran tingkat lanjut pada array diaktifkan

az eventgrid system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --enable-advanced-filtering-on-arrays true

Parameter yang Diperlukan

--name -n

Nama langganan kejadian.

--resource-group -g

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

--system-topic-name

Nama topik sistem.

Parameter Opsional

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

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

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

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