Mencantumkan dependensi layanan

Pratinjau — Aktivasi layanan hierarkis

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

Aktivasi layanan hierarkis memungkinkan Anda mengelola pengaktifan layanan yang diwariskan melalui hierarki resource Google Cloud . Untuk mengetahui informasi selengkapnya, lihat ringkasan.

Banyak layanan Google Cloud memerlukan layanan lain agar dapat berfungsi. Saat Anda mengaktifkan layanan menggunakan aktivasi layanan hierarkis, dependensi yang diperlukan akan otomatis ditambahkan ke ConsumerPolicy. Grup dependensi layanan berisi layanan yang diandalkan ini, yang dapat Anda cantumkan untuk lebih memahami dan mengelolanya.

Dokumen ini menunjukkan cara menggunakan Google Cloud CLI untuk mencantumkan dependensi layanan untuk project, folder, dan organisasi.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Instal Google Cloud CLI.

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

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih project Google Cloud .

Peran yang diperlukan untuk memilih atau membuat project

• Memilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project apa pun yang perannya telah diberikan kepada Anda.
• Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang akan menghapus semua resource yang terkait dengan project ini.

• Buat project Google Cloud :

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

Instal Google Cloud CLI.

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

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih project Google Cloud .

Peran yang diperlukan untuk memilih atau membuat project

• Memilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project apa pun yang perannya telah diberikan kepada Anda.
• Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang akan menghapus semua resource yang terkait dengan project ini.

• Buat project Google Cloud :

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

1. Jika Anda tidak menunjukkan resource Google Cloud yang ingin dikelola, perintah dalam dokumen ini akan ditetapkan secara default ke project saat ini. Misalnya, gcloud beta services groups list-members bigquery.googleapis.com dependencies mencantumkan anggota untuk project saat ini.

   Anda dapat mengambil project ID saat ini:

   gcloud config list --format='text(core.project)'

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mencantumkan dependensi layanan, minta administrator untuk memberi Anda peran IAM Service Usage Viewer (roles/serviceusage.serviceUsageViewer) di resource target 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 dependensi layanan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mencantumkan dependensi layanan:

• Cantumkan daftar anggota grup dependensi: serviceusage.groups.listMembers
• Mencantumkan anggota grup dependensi yang diperluas: serviceusage.groups.listExpandedMembers

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

Mencantumkan anggota grup dependensi

Anda dapat mencantumkan anggota langsung grup dependensi layanan untuk project, folder, atau organisasi menggunakan perintah gcloud beta services groups list-members:

gcloud beta services groups list-members SERVICE GROUP \
    --RESOURCE_TYPE=RESOURCE_ID

Ganti kode berikut:

• SERVICE: nama layanan yang ingin Anda cantumkan anggotanya.

• GROUP: nama grup dependensi layanan yang ingin Anda cantumkan anggotanya. Grup utama yang didukung adalah dependencies.

• RESOURCE_TYPE: jenis resource yang ingin Anda cantumkan anggotanya. Nilai yang valid adalah project, folder, dan organization. Anda dapat menghilangkan flag ini sepenuhnya untuk menampilkan hasil project saat ini.

• RESOURCE_ID: project ID, ID folder, atau ID organisasi, bergantung pada nilai yang Anda gunakan untuk RESOURCE_TYPE.

Anda dapat menggunakan flag lain untuk memfilter dan membatasi anggota yang tercantum.

Mencantumkan anggota grup dependensi yang diperluas

Anda dapat mencantumkan anggota yang diperluas dari grup dependensi layanan untuk project, folder, atau organisasi menggunakan perintah gcloud beta services groups list-expanded-members.

Perintah ini menampilkan daftar semua dependensi yang disatukan, termasuk dependensi dalam grup bertingkat, untuk memberikan daftar lengkap dan gabungan dari semua dependensi layanan.

gcloud beta services groups list-expanded-members SERVICE GROUP \
    --RESOURCE_TYPE=RESOURCE_ID

Ganti kode berikut:

• SERVICE: nama layanan yang ingin Anda cantumkan anggotanya.

• GROUP: nama grup dependensi layanan yang ingin Anda cantumkan anggotanya. Grup utama yang didukung adalah dependencies.

• RESOURCE_TYPE: jenis resource yang ingin Anda cantumkan anggotanya. Nilai yang valid adalah project, folder, dan organization. Anda dapat menghilangkan flag ini sepenuhnya untuk menampilkan hasil project saat ini.

• RESOURCE_ID: project ID, ID folder, atau ID organisasi, bergantung pada nilai yang Anda gunakan untuk RESOURCE_TYPE.

Anda dapat menggunakan flag lain untuk memfilter dan membatasi anggota yang tercantum.

Contoh

Mencantumkan anggota grup dependensi langsung

• Mencantumkan dependensi langsung layanan BigQuery untuk project saat ini:

  gcloud beta services groups list-members bigquery.googleapis.com dependencies

  Output:

  NAME: services/analyticshub.googleapis.com
  REASON: BigQuery depends on this group to allow users to exchange data and analytics assets.
  
  NAME: services/bigquery.googleapis.com
  REASON: The service representing BigQuery which owns this dependency group and depends on the other members of this group.
  
  NAME: services/bigqueryconnection.googleapis.com
  REASON: BigQuery depends on this group to allow users to manage connections to external data sources.
  
  NAME: services/bigquerydatapolicy.googleapis.com
  REASON: BigQuery depends on this group to allow users to manage their data policies.
  
  ...

• Mencoba mencantumkan dependensi layanan kunci API tanpa grup dependensi layanan yang sesuai:

  gcloud beta services groups list-members apikeys.googleapis.com dependencies --project=test-project

  Output:

  Listed 0 items.

Mencantumkan anggota grup dependensi yang diperluas

• Mencantumkan dependensi yang diperluas dari layanan BigQuery untuk project saat ini:

  gcloud beta services groups list-expanded-members bigquery.googleapis.com dependencies

  Output:

  services/analyticshub.googleapis.com
  services/bigquery.googleapis.com
  services/bigqueryconnection.googleapis.com
  services/bigquerydatapolicy.googleapis.com
  services/bigquerydatatransfer.googleapis.com
  services/bigquerymigration.googleapis.com
  services/bigqueryreservation.googleapis.com
  services/bigquerystorage.googleapis.com
  services/cloudresourcemanager.googleapis.com
  services/dataform.googleapis.com
  services/dataplex.googleapis.com

Langkah berikutnya

• Untuk mengaktifkan dan menonaktifkan layanan, lihat Mengelola pengaktifan layanan.
• Untuk mengelola kebijakan, lihat Mengelola kebijakan konsumen.