Memvalidasi pesan untuk skema

Dokumen ini menunjukkan cara memvalidasi skema untuk topik Pub/Sub.

Anda dapat memvalidasi bahwa pesan mematuhi skema tertentu, sebelum atau setelah membuat resource skema. Langkah ini memastikan bahwa pesan yang ingin Anda kirim melalui topik yang terkait dengan skema benar-benar cocok sebelum menerapkan skema.

Sebelum memulai

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang diperlukan guna memvalidasi pesan skema dan mengelolanya, minta administrator untuk memberi Anda peran IAM Pub/Sub Editor (roles/pubsub.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk memvalidasi pesan skema dan mengelolanya. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memvalidasi pesan skema dan mengelolanya:

  • Membuat skema: pubsub.schemas.create
  • Lampirkan skema ke topik: pubsub.schemas.attach
  • Meng-commit revisi skema: pubsub.schemas.commit
  • Menghapus skema atau revisi skema: pubsub.schemas.delete
  • Mendapatkan skema atau revisi skema: pubsub.schemas.get
  • Mencantumkan skema: pubsub.schemas.list
  • Mencantumkan revisi skema: pubsub.schemas.listRevisions
  • Melakukan rollback skema: pubsub.schemas.rollback
  • Memvalidasi pesan: pubsub.schemas.validate
  • Dapatkan kebijakan IAM untuk skema: pubsub.schemas.getIamPolicy
  • Konfigurasikan kebijakan IAM untuk skema: pubsub.schemas.setIamPolicy

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Anda dapat memberikan peran dan izin kepada akun utama seperti pengguna, grup, domain, atau akun layanan. Anda dapat membuat skema di satu project dan melampirkannya ke topik yang berada di project lain. Pastikan Anda memiliki izin yang diperlukan untuk setiap project.

Memvalidasi pesan untuk skema

Konsol

  1. Di konsol Google Cloud, buka halaman Pub/Sub schemas.

    Buka Skema

    Daftar skema akan ditampilkan.

  2. Klik ID Skema dari skema yang ada.

    Halaman Detail skema untuk skema akan terbuka.

  3. Di bagian Revisi, klik revisi yang ingin Anda validasi pesannya.

  4. Di bagian Details, klik Test message.

  5. Di jendela Pesan pengujian, pilih jenis Encoding pesan.

  6. Di isi Pesan, masukkan pesan pengujian.

  7. Klik Uji.

gcloud

  1. Di konsol Google Cloud, aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

  2. Untuk memvalidasi pesan terhadap skema, gunakan perintah gcloud pubsub schemas validate-message.

    gcloud pubsub schemas validate-message --message=MESSAGE \
    --message-encoding=MESSAGE_ENCODING \
    (--schema-name=SCHEMA_NAME | \
    --type=TYPE \
    (--definition=DEFINITION | \
    --definition-file=DEFINITION_FILE))

    Ganti kode berikut:

    • MESSAGE: pesan yang akan divalidasi terhadap skema

    • MESSAGE_ENCODING: encoding pesan. Tentukan salah satu nilai berikut: binary atau json.

    • SCHEMA_NAME: nama atau jalur lengkap skema yang ada.

    • TYPE: jenis skema inline. Tentukan salah satu nilai berikut: avro atau protocol-buffer.

    • DEFINITION: definisi skema inline.

    • DEFINITION_FILE: file yang berisi definisi skema.

Langkah selanjutnya