Mengelola pengaktifan layanan
Aktivasi layanan hierarkis memungkinkan Anda mengelola pengaktifan layanan yang diwariskan melalui hierarki resource Google Cloud . Untuk mengetahui informasi selengkapnya, lihat ringkasan.
Dokumen ini menunjukkan cara menggunakan Google Cloud CLI untuk mengelola pengaktifan 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 izinresourcemanager.projects.create. Pelajari cara memberikan peran.
-
Buat project Google Cloud :
gcloud projects create PROJECT_ID
Ganti
PROJECT_IDdengan nama untuk Google Cloud project yang Anda buat. -
Pilih project Google Cloud yang Anda buat:
gcloud config set project PROJECT_ID
Ganti
PROJECT_IDdengan 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 izinresourcemanager.projects.create. Pelajari cara memberikan peran.
-
Buat project Google Cloud :
gcloud projects create PROJECT_ID
Ganti
PROJECT_IDdengan nama untuk Google Cloud project yang Anda buat. -
Pilih project Google Cloud yang Anda buat:
gcloud config set project PROJECT_ID
Ganti
PROJECT_IDdengan 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.
- 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 list --enabledmenampilkan daftar layanan yang diaktifkan 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 mengelola pengaktifan layanan,
minta administrator untuk memberi Anda
peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin) 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 mengelola pengaktifan layanan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengelola pengaktifan layanan:
-
Mencantumkan layanan:
-
serviceusage.effectivepolicy.get -
serviceusage.services.list -
serviceusage.services.get
-
-
Aktifkan layanan:
-
serviceusage.consumerpolicy.get -
serviceusage.consumerpolicy.update -
serviceusage.groups.listExpandedMembers
-
-
Menonaktifkan layanan:
-
serviceusage.consumerpolicy.get -
serviceusage.consumerpolicy.update -
serviceusage.consumerpolicy.analyze
-
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Mencantumkan layanan
Anda dapat mencantumkan Google API dan layanan Google yang diaktifkan atau tersedia untuk
project, folder, atau organisasi menggunakan
perintah gcloud beta services list.
Pengaktifan dan ketersediaan layanan dapat diwarisi dari ancestor resource. Layanan yang diaktifkan resource mencakup layanan yang diaktifkan pada resource itu sendiri dan diaktifkan pada semua ancestor resource.
gcloud beta services list --enabled \
--RESOURCE_TYPE=RESOURCE_ID
Ganti kode berikut:
RESOURCE_TYPE: jenis resource yang ingin Anda cantumkan untuk layanan. Nilai yang valid adalahproject,folder, danorganization. Anda dapat menghilangkan flag ini untuk menampilkan hasil project saat ini.RESOURCE_ID: project ID, ID folder, atau ID organisasi, bergantung pada nilai yang Anda gunakan untukRESOURCE_TYPE.
Perhatikan hal berikut:
Anda harus menentukan salah satu flag berikut:
--availableuntuk mencantumkan layanan yang dapat diaktifkan untuk digunakan.--enableduntuk mencantumkan layanan yang diaktifkan untuk digunakan.
Anda dapat menggunakan flag lain untuk memfilter dan membatasi layanan yang tercantum.
Mengaktifkan layanan
Anda dapat mengaktifkan satu atau beberapa layanan untuk project, folder, atau organisasi menggunakan perintah gcloud beta services enable.
Perintah ini mengupdate ConsumerPolicy di resource target. Untuk mengetahui informasi selengkapnya, lihat Mengelola kebijakan konsumen.
gcloud beta services enable SERVICE \
--RESOURCE_TYPE=RESOURCE_ID
Ganti kode berikut:
SERVICE: nama layanan yang ingin Anda aktifkan. Untuk mengaktifkan beberapa layanan, gunakan nama layanan yang dipisahkan spasi. Misalnya, perintah berikut mengaktifkan kunci API dan layanan BigQuery:gcloud beta services enable apikeys.googleapis.com bigquery.googleapis.comRESOURCE_TYPE: jenis resource yang ingin Anda aktifkan layanannya. Nilai yang valid adalahproject,folder, danorganization. Anda dapat menghilangkan flag ini untuk mengaktifkan layanan bagi project saat ini.RESOURCE_ID: project ID, ID folder, atau ID organisasi, bergantung pada nilai yang Anda gunakan untukRESOURCE_TYPE.
Flag yang didukung:
--asyncuntuk segera menampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.--skip-dependencyuntuk melewati pengaktifan dependensi layanan apa pun. Jika tidak, semua dependensi layanan akan diaktifkan secara default.Anda dapat memeriksa dependensi layanan. Untuk mengetahui informasi selengkapnya, lihat Mencantumkan dependensi layanan.
--validate-onlyuntuk memvalidasi pengaktifan tanpa benar-benar melakukan operasi.
Perhatikan hal berikut:
Jika Anda mencoba mengaktifkan layanan yang sudah diaktifkan, Anda akan menerima error yang menyatakan bahwa layanan sudah diaktifkan dan ada dalam kebijakan konsumen. (Jika layanan sudah diaktifkan, tetapi dependensinya belum, perintah akan berhasil.)
Batasan kebijakan organisasi
constraints/serviceuser.servicestidak kompatibel dengan aktivasi layanan hierarkis dan tidak boleh digunakan bersama. Sebagai gantinya, untuk mengontrol layanan mana yang dapat diaktifkan untuk resource, gunakan batasanconstraints/gcp.restrictServiceUsage. Untuk mengetahui informasi selengkapnya, lihat Membatasi penggunaan resource.- Jika organisasi Anda sebelumnya telah menggunakan
constraints/serviceuser.servicesdan Anda menerima error saat mencoba menggunakan aktivasi layanan hierarkis, hubungi Cloud Customer Care.
- Jika organisasi Anda sebelumnya telah menggunakan
Google Cloud membuat dan mengelola akun layanan untuk banyak layananGoogle Cloud . Akun layanan ini dikenal sebagai agen layanan. Jika Anda mengalami error
service account not found, Anda mungkin perlu membuat agen layanan menggunakan perintahgcloud beta services identity create.
Menonaktifkan layanan
Anda dapat menonaktifkan satu atau beberapa layanan untuk project, folder, atau organisasi menggunakan perintah gcloud beta services disable.
Perintah ini mengupdate ConsumerPolicy di resource target. Untuk mengetahui informasi selengkapnya, lihat Mengelola kebijakan konsumen.
gcloud beta services disable SERVICE \
--RESOURCE_TYPE=RESOURCE_ID
Ganti kode berikut:
SERVICE: nama layanan yang ingin Anda nonaktifkan. Untuk menonaktifkan beberapa layanan, gunakan nama layanan yang dipisahkan spasi. Misalnya:gcloud beta services disable apikeys.googleapis.com bigquery.googleapis.comRESOURCE_TYPE: jenis resource yang ingin Anda nonaktifkan layanannya. Nilai yang valid adalahproject,folder, danorganization. Anda dapat menghilangkan flag ini untuk menonaktifkan layanan untuk project saat ini.RESOURCE_ID: project ID, ID folder, atau ID organisasi, bergantung pada nilai yang Anda gunakan untukRESOURCE_TYPE. Atau, hapus flag untuk menetapkan project saat ini sebagai default.
Flag yang didukung:
--asyncuntuk segera menampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.--bypass-api-usage-checkuntuk mengabaikan pemeriksaan penggunaan. Jika tidak, sistem akan menampilkan error jika layanan yang ingin Anda nonaktifkan digunakan dalam 30 hari terakhir atau diaktifkan dalam 3 hari terakhir.Anda dapat menentukan salah satu flag berikut:
--bypass-dependency-service-checkuntuk mengabaikan pemeriksaan dependensi; layanan yang diaktifkan dan bergantung pada layanan yang Anda nonaktifkan akan tetap diaktifkan.--disable-dependency-servicesuntuk melanjutkan penonaktifan layanan dan layanan yang diaktifkan yang bergantung pada layanan yang Anda nonaktifkan.
Anda dapat memeriksa dependensi layanan. Untuk mengetahui informasi selengkapnya, lihat Mencantumkan dependensi layanan.
--forceuntuk melanjutkan meskipun ada layanan yang diaktifkan yang bergantung pada layanan, atau layanan tersebut digunakan dalam 30 hari terakhir, atau diaktifkan dalam 3 hari terakhir. Layanan dependen juga dinonaktifkan.Flag
--bypass-api-usage-check,--bypass-dependency-service-check, dan--disable-dependency-servicessemuanya lebih diprioritaskan daripada flag--force.Menggunakan flag
--disable-dependency-servicesdan--bypass-api-usage-checksama dengan menggunakan flag--force. Layanan dan dependensinya dinonaktifkan tanpa memeriksa penggunaannya.--validate-onlyuntuk memvalidasi penonaktifan tanpa benar-benar melakukan operasi.
Contoh
Mengaktifkan layanan
- Mengaktifkan layanan BigQuery tanpa dependensinya:
gcloud beta services enable bigquery.googleapis.com --skip-dependency
Output:
Operation [operations/ucpat.p39-581601899707-73a57d57-aa46-4d0b-a5ee-57034a42f2b3] complete. Result: { "@type":"type.googleapis.com/google.api.serviceusage.v2beta.ConsumerPolicy", "createTime":"2025-01-31T20:17:37.272343Z", "enableRules":[ { "services":[ "services/apikeys.googleapis.com", "services/compute.googleapis.com", "services/oslogin.googleapis.com", "services/serviceusage.googleapis.com", "services/bigquery.googleapis.com" ] } ], "etag":"W/\"W9nsVJK0V1m7ee7tM7pFDg==\"", "name":"projects/PROJECT_ID/consumerPolicies/default", "updateTime":"2025-09-11T23:05:22.758394Z" }
- Mengaktifkan layanan BigQuery dengan dependensinya:
gcloud beta services enable bigquery.googleapis.com
Output:
Operation [operations/ucpat.p39-581601899707-73192b0f-053c-46ee-911a-7eca6b8fe899] complete. Result: { "@type":"type.googleapis.com/google.api.serviceusage.v2beta.ConsumerPolicy", "createTime":"2025-01-31T20:17:37.272343Z", "enableRules":[ { "services":[ "services/apikeys.googleapis.com", "services/compute.googleapis.com", "services/oslogin.googleapis.com", "services/serviceusage.googleapis.com", "services/cloudresourcemanager.googleapis.com", "services/dataplex.googleapis.com", "services/bigquery.googleapis.com", "services/bigquerystorage.googleapis.com", "services/bigqueryconnection.googleapis.com", "services/analyticshub.googleapis.com", "services/bigquerymigration.googleapis.com", "services/dataform.googleapis.com", "services/bigquerydatapolicy.googleapis.com", "services/bigquerydatatransfer.googleapis.com", "services/bigqueryreservation.googleapis.com" ] } ], "etag":"W/\"FDXMAIdsBW7BrXjL7oP6FA==\"", "name":"projects/PROJECT_ID/consumerPolicies/default", "updateTime":"2025-09-12T19:44:23.675769Z" }
Menonaktifkan layanan
- Mencoba menonaktifkan layanan BigQuery dengan dependensi aktif:
gcloud beta services disable bigquery.googleapis.com
Pesan error:
ERROR: (gcloud.beta.services.disable) The services are depended on by the following active service(s) {"bigquery.googleapis.com": ["services/bigquerystorage.googleapis.com"]} . Please remove the active dependent services or provide the --disable-dependency-services flag to disable them, or --bypass-dependency-service-check to ignore this check.
- Mencoba menonaktifkan layanan BigQuery dengan penggunaan terbaru:
gcloud beta services disable bigquery.googleapis.com --disable-dependency-services
Pesan error:
ERROR: (gcloud.beta.services.disable) The operation "operations/ucpat.p39-581601899707-d35c2e2b-d2a3-47af-a1c0-033ed65df236" resulted in a failure "The services bigquery.googleapis.com,bigquerystorage.googleapis.com have usage in the last 30 days or were enabled in the past 3 days. Please specify force if you want to proceed with the destructive policy change.
- Menonaktifkan layanan BigQuery dan dependensinya serta
mengabaikan pemeriksaan penggunaan:
gcloud beta services disable bigquery.googleapis.com --disable-dependency-services --bypass-api-usage-check
Output:
Operation [operations/ucpat.p39-581601899707-5c02aa04-7ad7-4eb6-a6a1-dc68653bcdb4] complete. Result: { "@type":"type.googleapis.com/google.api.serviceusage.v2beta.ConsumerPolicy", "createTime":"2025-01-31T20:17:37.272343Z", "enableRules":[ { "services":[ "services/analyticshub.googleapis.com", "services/apikeys.googleapis.com", "services/bigqueryconnection.googleapis.com", "services/bigquerydatapolicy.googleapis.com", "services/bigquerydatatransfer.googleapis.com", "services/bigquerymigration.googleapis.com", "services/bigqueryreservation.googleapis.com", "services/cloudresourcemanager.googleapis.com", "services/compute.googleapis.com", "services/dataform.googleapis.com", "services/dataplex.googleapis.com", "services/oslogin.googleapis.com", "services/serviceusage.googleapis.com" ] } ], "etag":"W/\"TqbPaELDHlZQOj7As1P06g==\"", "name":"projects/PROJECT_ID/consumerPolicies/default", "updateTime":"2025-09-30T21:39:40.746125Z" }
Langkah berikutnya
- Untuk mengelola kebijakan, lihat Mengelola kebijakan konsumen.
- Untuk memeriksa dependensi layanan, lihat Mencantumkan dependensi layanan.