Mencantumkan versi subjek

Anda dapat mencantumkan versi subjek dalam registry skema tertentu di project Anda.

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

Peran dan izin yang diperlukan

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

Izin yang diperlukan

Izin berikut diperlukan untuk mencantumkan versi subjek:

  • Berikan izin berikut pada subjek induk: managedkafka.versions.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 versi skema dalam subjek

Untuk mencantumkan semua versi subjek dalam registry 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 tempat subjek Anda berada.

  3. Di bagian Subjek dalam registry skema ini, klik nama subjek.

  4. Di halaman Subject details, versi skema tercantum di bagian All Versions.

  5. Opsional: Untuk melihat definisi skema untuk suatu versi, centang kotak untuk ID versi. Definisi skema ditampilkan di bagian Definisi.

  6. Opsional: Untuk melihat perbedaan antara dua versi skema untuk subjek ini, lakukan langkah-langkah berikut:

    1. Di bagian Semua versi, pilih versi yang akan dibandingkan.
    2. Di area Definisi, klik Lihat perbedaan.

    Kedua definisi skema ditampilkan berdampingan, dengan penambahan, penghapusan, dan perubahan yang ditandai.

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 versi subjek, buat permintaan GET ke metode projects.locations.schemaRegistries.subjects.versions.list.

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

Ganti kode berikut:

  • PROJECT_ID: Google Cloud project ID Anda.
  • LOCATION: region Google Cloud tempat registry skema berada.
  • REGISTRY_ID: ID registry skema Anda.
  • SUBJECT_ID: ID subjek.

Contoh:

GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Atau dengan konteks:

GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/contexts/test_context/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Dengan:

  • test-project adalah Google Cloud project ID Anda.
  • us-central1 adalah Google Cloud region tempat registry skema berada.
  • test_registry adalah ID registry skema Anda.
  • test_context adalah ID konteks.
  • test_subject adalah ID subjek.

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

Berikut adalah contoh respons yang berhasil:

{
  "versions": [
    {
      "name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/1",
      "revisionId": "1a2b3c4d",
      "schemaId": "S12345",
      "createTime": "2024-07-15T12:00:00Z",
      "revisionCreateTime": "2024-07-15T12:00:00Z"
    },
    {
      "name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/2",
      "revisionId": "5e6f7g8h",
      "schemaId": "S67890",
      "createTime": "2024-07-16T14:30:00Z",
      "revisionCreateTime": "2024-07-16T14:30:00Z"
    }
  ]
}

Untuk mengetahui informasi selengkapnya, lihat dokumentasi metode projects.locations.schemaRegistries.subjects.versions.list.

Langkah berikutnya

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