Mencantumkan subjek

Anda dapat mencantumkan subjek dalam registry skema atau konteks tertentu dalam project Anda.

Dokumen ini menunjukkan cara mencantumkan subjek menggunakan konsolGoogle Cloud atau Managed Kafka API.

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mencantumkan subjek, minta administrator untuk memberi Anda peran IAM Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) di pendaftaran skema atau konteks 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 mencantumkan subjek. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mencantumkan subjek:

  • Berikan izin berikut pada registry atau konteks skema induk: managedkafka.googleapis.com/subjects.list

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

Untuk mengetahui informasi selengkapnya tentang peran bawaan, lihat Peran bawaan Managed Service for Apache Kafka.

Mencantumkan subjek dalam registry skema

Untuk mencantumkan semua subjek dalam registry atau konteks skema tertentu dalam project Anda, ikuti langkah-langkah berikut.

Konsol

  1. Di konsol Google Cloud , buka halaman Schema registries.

    Buka Schema registry

  2. Klik nama schema registry yang detailnya ingin Anda lihat.

  3. Di halaman Schema registry details, subjek dicantumkan di bagian Subjects in this schema registry.

  4. Opsional: Untuk memfilter mata pelajaran yang ditampilkan, klik Filter. Anda dapat memfilter berdasarkan properti berikut:

    • Nama
    • Konteks
    • Dihapus sementara (Ya/Tidak)

  5. Opsional: Untuk menampilkan atau menyembunyikan kolom, klik Opsi tampilan kolom, lalu pilih kolom yang ingin Anda lihat atau sembunyikan.

REST

Permintaan harus diautentikasi dengan token akses di header Authorization. Untuk mendapatkan token akses untuk Kredensial Default Aplikasi saat ini: gcloud auth application-default print-access-token.

Untuk mencantumkan subjek langsung di bawah registry skema, buat permintaan GET ke URI tertentu menggunakan metode projects.locations.schemaRegistries.schemas.subjects.list untuk konteks default.

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects
Authorization: Bearer $(gcloud auth application-default print-access-token)

Untuk mencantumkan subjek dalam konteks di registry skema, buat permintaan GET ke URI tertentu menggunakan metode projects.locations.schemaRegistries.contexts.schemas.subjects.list:

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/contexts/CONTEXT_ID/subjects?subjectPrefix=SUBJECT_PREFIX
Authorization: Bearer $(gcloud auth application-default print-access-token)

Ganti kode berikut:

  • PROJECT_ID (wajib): project ID Google Cloud Anda.

  • LOCATION (wajib): Google Cloud region tempat registry skema berada.

  • REGISTRY_ID (wajib): ID registry skema Anda.

  • CONTEXT_ID (opsional): ID konteks (jika mencantumkan subjek dalam konteks).

  • SUBJECT_PREFIX (opsional): konteks untuk memfilter subjek, dalam format :.{context}:. Jika tidak disetel, semua subjek dalam registri akan ditampilkan. Jika disetel ke string kosong, mencantumkan subjek dalam konteks default.

Jika permintaan berhasil, API akan menampilkan kode status 200 OK. Isi respons berisi array JSON nama subjek.

Berikut adalah contoh respons yang berhasil dari subjek dalam array JSON untuk konteks default:

[
  "orders-topic-key",
  "orders-topic-value",
  "user-profile-event"
]

Subjek dalam konteks non-default ditampilkan dalam format :.context:subject.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi metode projects.locations.schemaRegistries.contexts.schemas.subjects/list.

Langkah berikutnya

Apache Kafka® adalah merek dagang terdaftar milik The Apache Software Foundation atau afiliasinya di Amerika Serikat dan/atau negara lain.