Melihat detail registry skema

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dokumen ini menunjukkan cara melihat detail resource registry skema dalam Managed Service untuk Apache Kafka. Anda dapat melihat detail seperti konfigurasi, konteks terkait, dan subjeknya.

Anda tidak dapat menggunakan API klien Apache Kafka open source untuk melihat detail resource registry skema Managed Service for Apache Kafka tertentu ini.

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang diperlukan guna melihat registry skema, minta administrator untuk memberi Anda peran IAM Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) pada instance registry skema. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat registry skema. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat registry skema:

• Berikan izin ini pada resource schema registry: managedkafka.schemaRegistries.get

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

Untuk mengetahui informasi selengkapnya tentang peran standar yang tersedia untuk Managed Service for Apache Kafka, lihat dokumentasi Kontrol akses.

Melihat detail registry skema

Untuk mengambil konfigurasi dan detail registry skema tertentu, ikuti langkah-langkah berikut:

Konsol

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

   Buka schema registry

   Daftar registry skema di project Anda akan ditampilkan.

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

   Halaman Schema registry details akan terbuka. Informasi yang ditampilkan di halaman ini dijelaskan di bagian Detail halaman schema registry.

gcloud

1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

   gcloud init

   Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

2. Untuk mengambil konfigurasi dan detail registry skema tertentu, jalankan perintah gcloud beta managed-kafka schema-registries describe:

gcloud beta managed-kafka schema-registries describe SCHEMA_REGISTRY_ID \
    --location=LOCATION \

Ganti kode berikut:

• SCHEMA_REGISTRY_ID (wajib): ID registry skema yang ingin Anda deskripsikan.
• LOCATION (wajib): region Google Cloud tempat schema registry berada.

Misalnya, perintah berikut mendapatkan detail registry skema bernama test_SR yang berada di region us-central1:

gcloud beta managed-kafka schema-registries describe test_SR \
    --location=us-central1

Perintah akan menampilkan output yang mirip dengan berikut ini:

Describing schema registry: projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR
name: projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR
mode: READWRITE
config:
  - compatibility: BACKWARD
contexts:
  - projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR/contexts/.
  - projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR/contexts/user-record

REST

• Untuk mengambil detail instance registry skema tertentu menggunakan REST API, buat permintaan GET ke URI berikut:

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

Ganti kode berikut:

• PROJECT_ID (wajib): Google Cloud project ID Anda.
• LOCATION (wajib): region tempat schema registry berada.
• SCHEMA_REGISTRY_ID (wajib): ID unik dari registry skema yang ingin Anda lihat.

Jika permintaan berhasil, API akan menampilkan kode status 200 OK. Isi respons berisi objek JSON yang merepresentasikan detail registri skema yang diminta.

Misalnya, berikut adalah respons terhadap perintah untuk mendapatkan detail registry skema bernama gcloud_test yang berada di region us-central1:

{
  "name": "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test",
  "contexts": [
    "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test/contexts/default",
    "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test/contexts/."
  ]
}

Untuk mengetahui informasi selengkapnya, lihat dokumentasi REST API.

Detail halaman registry skema

Saat Anda melihat registry skema di konsol Google Cloud , halaman Detail registry skema menampilkan informasi berikut untuk registry yang dipilih:

• Region: Google Cloud region tempat registry berada.
• URL pendaftaran skema: URL endpoint untuk pendaftaran skema. Formatnya adalah https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID.

  Misalnya—https://managedkafka.googleapis.com/v1main/projects/managed-kafka-project/locations/us-central1/schemaRegistries/testschemaregistry

• Mode skema: mode operasional yang dapat Anda tetapkan di tingkat registri skema dan tingkat subjek individual. Setelan ini mengontrol apakah modifikasi dapat dilakukan.
• Jenis kompatibilitas: konfigurasi tingkat registry untuk setelan kompatibilitas default yang diterapkan untuk subjek atau versi skema baru dalam registry ini (kecuali diganti di tingkat subjek atau konteks). Nilai umum mencakup BACKWARD, FORWARD, FULL, atau NONE.
• Subjek dalam registry skema ini: daftar nama subjek yang terkait dengan registry. Jika konteks tersedia, Anda juga dapat melihat konteks untuk setiap subjek.

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