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 Anda 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, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memvalidasi pesan skema dan mengelolanya:

  • Membuat skema: pubsub.schemas.create
  • Melampirkan 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
  • Mengembalikan skema: pubsub.schemas.rollback
  • Memvalidasi pesan: pubsub.schemas.validate
  • Mendapatkan kebijakan IAM untuk skema: pubsub.schemas.getIamPolicy
  • Mengonfigurasi 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 principal seperti pengguna, grup, domain, atau akun layanan. Anda dapat membuat skema dalam 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 Google Cloud konsol, buka halaman Pub/Sub schemas.

    Buka Skema

    Daftar skema akan ditampilkan.

  2. Klik Schema ID skema yang ada.

    Halaman Schema details untuk skema akan terbuka.

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

  4. Di bagian Details, klik Test message.

  5. Di jendela Test message, pilih jenis Message encoding.

  6. Di isi Message, masukkan pesan pengujian.

  7. Klik Test.

gcloud

  1. Di konsol, aktifkan Cloud Shell. Google Cloud

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan prompt 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 pada 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 untuk 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 berikutnya