Kebijakan PublishMessage

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

ikon kebijakan

Ringkasan

Kebijakan PublishMessage memungkinkan Anda memublikasikan informasi alur proxy API ke topik Google Cloud Pub/Sub. Pub/Sub Google memungkinkan layanan berkomunikasi secara asinkron, dengan latensi yang jauh lebih rendah. Untuk mengetahui informasi selengkapnya tentang Pub/Sub, lihat Apa yang dimaksud dengan Pub/Sub?. Informasi yang ingin Anda publikasikan ke topik Pub/Sub dapat berupa teks literal atau variabel alur. Anda juga dapat menentukan kombinasi teks literal dan variabel alur menggunakan template pesan.

Jika permintaan publikasi berhasil, Apigee akan menetapkan variabel alur publishmessage.message.id ke nilai yang ditampilkan oleh server Pub/Sub. Untuk mengetahui informasi selengkapnya, lihat Variabel alur.

Kebijakan ini adalah Kebijakan standar dan dapat di-deploy ke jenis lingkungan apa pun. Untuk mengetahui informasi tentang jenis kebijakan dan ketersediaan dengan setiap jenis lingkungan, lihat Jenis kebijakan.

Deployment autentikasi dan proxy

Untuk menjalankan kebijakan PublishMessage, Anda memerlukan token autentikasi. Namun, tidak ada elemen <Authentication> eksplisit dalam definisi kebijakan. Anda harus men-deploy proxy API untuk menggunakan autentikasi Google, yang menambahkan token autentikasi ke permintaan di balik layar. Untuk informasi tentang cara men-deploy proxy API yang menggunakan autentikasi Google, lihat Langkah-langkah deployment. Selain menggunakan autentikasi Google di proxy API, Anda harus men-deploy proxy API dengan akun layanan yang memiliki peran dengan izin pubsub.topics.publish. Untuk mengetahui informasi selengkapnya tentang peran Identity and Access Management (IAM) untuk Pub/Sub, lihat Izin dan peran.

<PublishMessage>

Menentukan kebijakan PublishMessage.

Nilai Default T/A
Wajib? Wajib
Jenis Jenis kompleks
Elemen Induk T/A
Elemen Turunan <CloudPubSub>
<DisplayName>
<Source>

Tabel berikut memberikan deskripsi umum elemen turunan <PublishMessage>:

Elemen Turunan Wajib? Deskripsi
<CloudPubSub> Wajib Elemen induk <Topic>. Elemen <Topic> menentukan topik Pub/Sub tempat Anda ingin memublikasikan pesan.
<DisplayName> Opsional Nama kustom untuk kebijakan.
<IgnoreUnresolvedVariables> Opsional Menentukan apakah pemrosesan berhenti jika Apigee menemukan variabel yang belum terselesaikan.
<Source> Wajib Menentukan pesan yang akan dipublikasikan.
Elemen turunan lainnya
<Topic> Wajib Menentukan topik Pub/Sub tempat Anda ingin memublikasikan pesan.

Elemen <PublishMessage> menggunakan sintaksis berikut:

Sintaks

<?xml version="1.0" encoding="UTF-8"?><PublishMessage continueOnError="[true|false]" enabled="[true|false]" name="Publish-Message-1">
    <DisplayName>DISPLAY_NAME</DisplayName>
    <Source>SOURCE_VALUE</Source>
    <CloudPubSub>
        <Topic>TOPIC_NAME</Topic>
    </CloudPubSub>
    <IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>
</PublishMessage>

Contoh

Contoh berikut menunjukkan definisi kebijakan <PublishMessage>:

<?xml version="1.0" encoding="UTF-8"?><PublishMessage continueOnError="false" enabled="true" name="Publish-Message-1">
    <DisplayName>Publish Message-1</DisplayName>
    <Source>{flow-variable-1}</Source>
    <CloudPubSub>
        <Topic>projects/{flow-variable-project-id}/topics/{flow-variable-topic-name}</Topic>
    </CloudPubSub>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</PublishMessage>

Elemen ini memiliki atribut berikut yang umum untuk semua kebijakan:

Atribut Default Wajib? Deskripsi
name T/A Wajib

Nama internal kebijakan. Nilai atribut name dapat berisi huruf, angka, spasi, tanda hubung, garis bawah, dan titik. Nilai ini tidak boleh melebihi 255 karakter.

Secara opsional, gunakan elemen <DisplayName> untuk memberi label pada kebijakan di editor proxy UI pengelolaan dengan nama bahasa alami yang berbeda.
continueOnError false Opsional Tetapkan ke false untuk menampilkan error saat kebijakan gagal. Perilaku ini wajar terjadi untuk sebagian besar kebijakan. Tetapkan ke true agar eksekusi alur berlanjut meskipun setelah kebijakan gagal. Lihat juga:
enabled benar Opsional Tetapkan ke true untuk menerapkan kebijakan. Tetapkan ke false untuk menonaktifkan kebijakan. Kebijakan tidak akan diterapkan meskipun tetap terlampir ke alur.
async   false Tidak digunakan lagi Atribut ini tidak digunakan lagi.

Referensi elemen turunan

Bagian ini menjelaskan elemen turunan <PublishMessage>.

<DisplayName>

Gunakan selain atribut name untuk memberi label kebijakan di editor proxy UI pengelolaan dengan nama yang berbeda dan lebih alami.

Elemen <DisplayName> bersifat umum untuk semua kebijakan.

Nilai Default T/A
Wajib? Opsional. Jika Anda menghilangkan <DisplayName>, nilai atribut name kebijakan akan digunakan.
Jenis String
Elemen Induk <PolicyElement>
Elemen Turunan Tidak ada

Elemen <DisplayName> menggunakan sintaksis berikut:

Sintaksis

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

Contoh

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

Elemen <DisplayName> tidak memiliki atribut atau elemen turunan.

<Source>

Menentukan pesan yang akan dipublikasikan.

Pesan dapat berupa teks literal, variabel alur, atau kombinasi keduanya dalam bentuk template pesan.

Nilai Default T/A
Wajib? Wajib
Jenis String
Elemen Induk <PublishMessage>
Elemen Turunan Tidak ada

Elemen <Source> menggunakan sintaksis berikut:

Sintaks

 <Source>SOURCE</Source>

Example-1

Contoh berikut menetapkan pesan sumber ke nilai variabel alur flow-var-1:

<Source>{flow-var-1}</Source>

Example-2

Contoh berikut menetapkan pesan sumber ke source-message-text-01:

<Source>source-message-text-01</Source>

<CloudPubSub>

Elemen induk <Topic>.

Anda hanya dapat memublikasikan ke satu topik Pub/Sub. Oleh karena itu, Anda hanya dapat memiliki satu elemen <Topic> dalam elemen <CloudPubSub>.

Nilai Default T/A
Wajib? Wajib
Jenis Jenis kompleks
Elemen Induk <PublishMessage>
Elemen Turunan <Topic>

Elemen <CloudPubSub> menggunakan sintaksis berikut:

Sintaks

<CloudPubSub>
  <Topic>TOPIC_NAME</Topic>
</CloudPubSub>

Contoh

Contoh berikut menunjukkan deklarasi elemen <CloudPubSub>:

<CloudPubSub>
  <Topic>projects/{request.header.project}/topics/{request.header.topic}</Topic>
</CloudPubSub>

<Topic>

Menentukan topik Pub/Sub tempat Anda ingin memublikasikan pesan <Source>.

Anda harus menentukan nama topik dalam format projects/project-id/topics/topic-name.

Nilai Default T/A
Wajib? Wajib
Jenis Jenis kompleks
Elemen Induk <CloudPubSub>
Elemen Turunan Tidak ada

Elemen <Topic> menggunakan sintaksis berikut:

Sintaks
<Topic>TOPIC_NAME</Topic>
Contoh

Contoh berikut menentukan topik Pub/Sub yang akan dipublikasikan:

<Topic>projects/project-id-marketing/topics/topic-name-test1</Topic>

Dalam contoh ini, project-id-marketing adalah Project ID Google Cloud Anda dan topic-name-test1 adalah topik tempat pesan <Source> harus dipublikasikan.

<IgnoreUnresolvedVariables>

Menentukan apakah pemrosesan berhenti jika Apigee menemukan variabel yang belum terselesaikan.

Nilai Default Salah
Wajib? Opsional
Jenis Boolean
Elemen Induk <PublishMessage>
Elemen Turunan Tidak ada

Tetapkan nilai ke true untuk mengabaikan variabel yang belum terselesaikan dan melanjutkan pemrosesan; jika tidak, false. Nilai default-nya adalah false.

Menetapkan <IgnoreUnresolvedVariables> ke true berbeda dengan menetapkan continueOnError <PublishMessage> ke true. Jika Anda menetapkan continueOnError ke true, Apigee akan mengabaikan semua error, bukan hanya error dalam variabel.

Elemen <IgnoreUnresolvedVariables> menggunakan sintaksis berikut:

Sintaks

<IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>

Contoh

Contoh berikut menetapkan <IgnoreUnresolvedVariables> ke true:

<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>

Variabel alur

Variabel flow adalah objek yang menyimpan data tertentu dan tersedia untuk Anda dalam konteks alur proxy API. Variabel ini menyimpan informasi seperti informasi payload, jalur URL, alamat IP, dan data dari eksekusi kebijakan. Untuk mengetahui informasi selengkapnya tentang variabel alur, lihat Menggunakan variabel alur.

Jika kebijakan PublishMessage berhasil dipublikasikan ke topik Pub/Sub, Apigee akan menetapkan variabel alur publishmessage.message.id ke messageId yang ditampilkan oleh server Pub/Sub. Variabel alur adalah jenis string, dan variabel ini tersedia untuk Anda mulai dari alur permintaan Proxy dan seterusnya. Berdasarkan persyaratan Anda, Anda dapat menggunakan variabel flow dalam kebijakan downstream lainnya. Namun, jika publikasi gagal, Apigee tidak menetapkan variabel publishmessage.message.id, dan mengakses variabel ini akan menyebabkan error.

Untuk mengetahui informasi selengkapnya tentang berbagai jenis variabel alur, lihat Referensi variabel alur.

Kode error

Bagian ini menjelaskan kode error dan pesan error yang ditampilkan serta variabel error yang ditetapkan oleh Apigee saat kebijakan ini memicu error. Informasi ini penting untuk diketahui jika Anda mengembangkan aturan error untuk menangani error. Untuk mempelajari lebih lanjut, lihat Yang perlu Anda ketahui tentang error kebijakan dan Menangani error.

Error runtime

Error ini dapat terjadi saat kebijakan dijalankan.

Kode kerusakan Status HTTP Penyebab
steps.publishmessage.PermissionDeniedError 500 Error ini terjadi saat akun layanan runtime tidak dapat meniru identitas akun layanan proxy atau akun layanan proxy tidak memiliki izin untuk memublikasikan ke topik.
steps.publishmessage.ExecutionError 500 Error ini terjadi jika terjadi error tak terduga saat memublikasikan pesan ke Pub/Sub. Anda dapat melihat detail error dalam pesan error.

Variabel error

Setiap kali ada error eksekusi dalam kebijakan, Apigee akan menghasilkan pesan error. Anda dapat melihat pesan error ini dalam respons error. Sering kali, pesan error yang dihasilkan sistem mungkin tidak relevan dalam konteks produk Anda. Anda mungkin ingin menyesuaikan pesan error berdasarkan jenis error untuk membuat pesan lebih bermakna.

Untuk menyesuaikan pesan error, Anda dapat menggunakan aturan error atau kebijakan RaiseFault. Untuk mengetahui informasi tentang perbedaan antara aturan error dan kebijakan RaiseFault, lihat FaultRules vs. kebijakan RaiseFault. Anda harus memeriksa kondisi menggunakan elemen Condition dalam aturan error dan kebijakan RaiseFault. Apigee menyediakan variabel error yang unik untuk setiap kebijakan dan nilai variabel error ditetapkan saat kebijakan memicu error runtime. Dengan menggunakan variabel ini, Anda dapat memeriksa kondisi error tertentu dan mengambil tindakan yang sesuai. Untuk mengetahui informasi selengkapnya tentang cara memeriksa kondisi error, lihat Mem-build kondisi.

Variabel Dari mana Contoh
fault.name fault.name dapat cocok dengan salah satu kesalahan yang tercantum dalam tabel Error runtime. Nama kerusakan adalah bagian terakhir dari kode kerusakan. fault.name Matches "UnresolvedVariable"
publishmessage.POLICY_NAME.failed POLICY_NAME adalah nama kebijakan yang ditentukan pengguna yang menampilkan error. publishmessage.publish-message-1.failed = true
Untuk mengetahui informasi selengkapnya tentang error kebijakan, lihat Yang perlu Anda ketahui tentang error kebijakan