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

  1. 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.
  2. Instal Google Cloud CLI.

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

  4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

    gcloud init
  5. 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.
    • 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.

  6. 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.

  7. Instal Google Cloud CLI.

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

  9. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

    gcloud init
  10. 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.
    • 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.

  11. 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.

  12. 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 --enabled menampilkan 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 adalah project, folder, dan organization. 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 untuk RESOURCE_TYPE.

Perhatikan hal berikut:

  • Anda harus menentukan salah satu flag berikut:

    • --available untuk mencantumkan layanan yang dapat diaktifkan untuk digunakan.
    • --enabled untuk 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.com
    
  • RESOURCE_TYPE: jenis resource yang ingin Anda aktifkan layanannya. Nilai yang valid adalah project, folder, dan organization. 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 untuk RESOURCE_TYPE.

Flag yang didukung:

  • --async untuk segera menampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.

  • --skip-dependency untuk 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-only untuk 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.services tidak kompatibel dengan aktivasi layanan hierarkis dan tidak boleh digunakan bersama. Sebagai gantinya, untuk mengontrol layanan mana yang dapat diaktifkan untuk resource, gunakan batasan constraints/gcp.restrictServiceUsage. Untuk mengetahui informasi selengkapnya, lihat Membatasi penggunaan resource.

    • Jika organisasi Anda sebelumnya telah menggunakan constraints/serviceuser.services dan Anda menerima error saat mencoba menggunakan aktivasi layanan hierarkis, hubungi Cloud Customer Care.
  • 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 perintah gcloud 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.com
    
  • RESOURCE_TYPE: jenis resource yang ingin Anda nonaktifkan layanannya. Nilai yang valid adalah project, folder, dan organization. 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 untuk RESOURCE_TYPE. Atau, hapus flag untuk menetapkan project saat ini sebagai default.

Flag yang didukung:

  • --async untuk segera menampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.

  • --bypass-api-usage-check untuk 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-check untuk mengabaikan pemeriksaan dependensi; layanan yang diaktifkan dan bergantung pada layanan yang Anda nonaktifkan akan tetap diaktifkan.
    • --disable-dependency-services untuk 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.

  • --force untuk 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-services semuanya lebih diprioritaskan daripada flag --force.

    Menggunakan flag --disable-dependency-services dan --bypass-api-usage-check sama dengan menggunakan flag --force. Layanan dan dependensinya dinonaktifkan tanpa memeriksa penggunaannya.

  • --validate-only untuk 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