Mencantumkan semua 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.

Anda dapat mencantumkan registry skema dalam project Anda. Dokumen ini menunjukkan cara mencantumkan registry skema menggunakan Google Cloud konsol, Google Cloud CLI, atau Managed Kafka API.

Peran dan izin yang diperlukan

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

Izin yang diperlukan

Izin berikut diperlukan untuk mencantumkan registry skema:

• Berikan izin berikut di lokasi induk: managedkafka.schemaRegistries.list

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

Peran tingkat yang lebih tinggi seperti Managed Kafka Schema Registry Editor (roles/managedkafka.schemaRegistryEditor) dan Managed Kafka Schema Registry Admin (roles/managedkafka.schemaRegistryAdmin) juga memungkinkan Anda mencantumkan registry skema.

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

Mencantumkan registri skema Anda

Untuk mencantumkan semua registry skema dalam project Anda, ikuti langkah-langkah berikut.

Konsol

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

   Buka schema registry

   Halaman ini menampilkan daftar registry skema di project Anda. Daftar mencakup kolom untuk properti berikut:

   • Nama: ID unik untuk schema registry.
   • Region: Google Cloud region tempat schema registry dihosting.

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. Jalankan perintah gcloud beta managed-kafka schema-registries list:

gcloud beta managed-kafka schema-registries list \
    --location=LOCATION \

Ganti kode berikut:

• LOCATION (wajib): Google Cloud region tempat pendaftaran skema akan dicantumkan.

Misalnya, untuk mencantumkan semua registry skema di lokasi us-central1, jalankan perintah berikut:

gcloud beta managed-kafka schema-registries list --location=us-central1

Contoh output:

NAME             LOCATION
sr_docs      us-central1
sr_docs23    us-central1
sr23wert     us-central1

REST

Untuk mencantumkan registry skema, gunakan metode projects.locations.schemaRegistries.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID Google Cloud Anda
• LOCATION: lokasi tempat Anda ingin mendapatkan daftar registry skema; misalnya, us-central1

Metode HTTP dan URL:

GET https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "schemaRegistries": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID",
      "contexts": [
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/.",
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/CONTEXT_NAME"
      ]
    }
}

Objek JSON yang ditampilkan mencakup daftar registry skema yang ditemukan di lokasi yang ditentukan. Jika parameter kueri view adalah SCHEMA_REGISTRY_VIEW_FULL, respons juga menyertakan konteks yang terkait dengan setiap registry skema.

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