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

Peran yang telah ditetapkan 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:

  • Buat skema: pubsub.schemas.create
  • Lampirkan skema ke topik: pubsub.schemas.attach
  • Commit revisi skema: pubsub.schemas.commit
  • Hapus skema atau revisi skema: pubsub.schemas.delete
  • Mendapatkan skema atau revisi skema: pubsub.schemas.get
  • Skema daftar: pubsub.schemas.list
  • Mencantumkan revisi skema: pubsub.schemas.listRevisions
  • Melakukan rollback skema: pubsub.schemas.rollback
  • Validasi pesan: pubsub.schemas.validate
  • Mendapatkan kebijakan IAM untuk skema: pubsub.schemas.getIamPolicy
  • Konfigurasi kebijakan IAM untuk skema: pubsub.schemas.setIamPolicy

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

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

Memvalidasi pesan untuk skema

Konsol

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

    Buka Schemas

    Daftar skema ditampilkan.

  2. Klik Schema ID dari skema yang sudah ada.

    Halaman Detail skema untuk skema akan terbuka.

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

  4. Di bagian Details, klik Test message.

  5. Di jendela Test message, pilih jenis Encoding pesan.

  6. Dalam isi Message, 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 berdasarkan skema, gunakan perintah gcloud pubsub pelajar validation-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 memvalidasi terhadap skema

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

    • SCHEMA_NAME: nama atau jalur lengkap dari skema yang ada.

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

    • DEFINITION: definisi skema inline.

    • DEFINITION_FILE: file yang berisi definisi skema.

Langkah selanjutnya