Mengaktifkan dan menonaktifkan layanan

Anda dapat menggunakan Penggunaan Layanan untuk mengaktifkan atau menonaktifkan layanan yang tersedia untuk project Google Cloud Anda. Hal ini mencakup Google Cloud layanan publik dan layanan pribadi yang dibuat dengan Cloud Endpoints. Untuk mempelajari lebih lanjut perbedaan antara layanan publik dan pribadi, lihat Layanan publik dan pribadi.

Sebagian besar pengguna dapat mengaktifkan dan menonaktifkan layanan dengan konsol Google Cloud . Untuk skrip, gunakan Google Cloud CLI. Untuk mengakses Service Usage API secara terprogram, sebaiknya gunakan library klien. Untuk mencoba API, Anda dapat mengirim permintaan tanpa menyiapkan lingkungan pengembangan lengkap.

Untuk mengetahui batas kuota Penggunaan Layanan, lihat Kuota dan batas. Anda mungkin ingin membatasi penggunaan yang dapat ditagih. Bergantung pada API, Anda dapat secara eksplisit membatasi permintaan.

Sebelum memulai

Sebelum mengaktifkan dan menonaktifkan layanan, Anda harus menyiapkan project dan lingkunganGoogle Cloud untuk Penggunaan Layanan.

Konsol

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

gcloud

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 Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (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 menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  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.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Aktifkan Service Usage API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

gcloud services enable serviceusage.googleapis.com

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 Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (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 menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  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.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Aktifkan Service Usage API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

gcloud services enable serviceusage.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengaktifkan dan menonaktifkan layanan, minta administrator Anda untuk memberi Anda peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mengaktifkan layanan

Proses untuk mengaktifkan layanan dapat bervariasi. Beberapa API meminta Anda untuk menyetujui Persyaratan Layanan terlebih dahulu, atau dalam pratinjau dan memerlukan persetujuan sebelum Anda dapat menggunakannya. API lain mungkin meminta informasi tambahan, seperti detail kontak organisasi Anda dan nama aplikasi Anda. Setiap informasi yang diminta akan tetap dirahasiakan di dalam Google. Kami menggunakannya untuk memahami penggunaan API dan menghubungi Anda jika diperlukan.

Konsol

1. Di konsol Google Cloud , buka halaman APIs & Services > API Library.

   Buka Library API

2. Pilih project terbaru atau gunakan pemilih resource di toolbar konsol untuk memilih project Google Cloud tempat Anda ingin mengaktifkan API.

3. Klik API yang ingin Anda aktifkan atau telusuri menggunakan kotak Search for APIs & Services.

4. Klik Enable.

gcloud

Perintah gcloud services enable mengaktifkan layanan dengan nama yang ditentukan untuk project saat ini.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

• SERVICE: nama layanan yang ingin Anda aktifkan.

Jalankan perintah gcloud services enable:

Linux, macOS, atau Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

Anda akan melihat respons seperti berikut:

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Untuk mengaktifkan beberapa layanan, gunakan nama layanan yang dipisahkan dengan spasi—misalnya, perintah berikut mengaktifkan layanan BigQuery dan Pub/Sub:

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

Untuk mengambil detail operasi, gunakan perintah gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Ganti OPERATION_ID dengan ID operasi yang Anda terima sebagai respons atas permintaan asli Anda.

REST API

Mengaktifkan satu layanan

Untuk mengaktifkan satu layanan, gunakan metode services.enable.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda.
• SERVICE: nama layanan yang ingin Anda aktifkan.

Untuk mengirim permintaan Anda, luaskan 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 POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

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 POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

Jika berhasil, isi respons berisi instance Operation yang baru dibuat:

{
  "name": "operations/OPERATION_ID"
}

Mengaktifkan beberapa layanan

Untuk mengaktifkan hingga 20 layanan dalam satu operasi, gunakan metode services.batchEnable.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda.
• SERVICE1: nama layanan yang ingin Anda aktifkan.
• SERVICE2: nama layanan lain yang ingin Anda aktifkan.

Meminta isi JSON:

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

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.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

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.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

Jika berhasil, isi respons berisi instance Operation yang baru dibuat:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

Menonaktifkan layanan

Anda dapat menonaktifkan API untuk project kapan saja. Namun, Anda tetap akan ditagih untuk biaya yang masih dalam proses dan penggunaan API yang dapat ditagih dalam project Anda. Untuk mengetahui informasi selengkapnya, lihat panduan Memulai untuk Cloud API.

Banyak layanan, seperti Cloud Storage dan BigQuery, mengenakan biaya untuk penyimpanan data. Menonaktifkan API layanan tidak akan menghapus data Anda, dan Anda akan terus ditagih untuk layanan tersebut. Untuk menghentikan tagihan di masa mendatang dan menghentikan penggunaan layanan, hapus semua data terkait sebelum menonaktifkan API-nya.

Jika Anda menonaktifkan Google Kubernetes Engine API, cluster yang berjalan di project akan ditangguhkan. Setelah 30 hari, cluster yang ditangguhkan ini akan dihapus. Untuk mengaktifkan kembali cluster Anda, aktifkan kembali GKE API. Diperlukan waktu hingga 24 jam agar cluster diaktifkan kembali. Untuk mengetahui informasi selengkapnya, lihat Siklus proses cluster.

Catatan: Jika Anda mencoba menonaktifkan layanan yang bergantung pada layanan lain yang diaktifkan, permintaan akan gagal dan menampilkan error. Untuk menonaktifkan layanan yang ditentukan dan semua layanan yang bergantung padanya, tetapkan parameter disableDependentServices dalam permintaan services.disable ke true.

Konsol

1. Di konsol Google Cloud , buka halaman APIs & Services > API Library.

   Buka Library API

2. Pilih project terbaru atau gunakan pemilih resource di toolbar konsol untuk memilih project Google Cloud tempat Anda ingin menonaktifkan API.

3. Klik API yang ingin Anda nonaktifkan atau telusuri menggunakan kotak Search for APIs & Services.

4. Klik Disable API.

gcloud

Perintah gcloud services disable menonaktifkan layanan dengan nama yang ditentukan untuk project saat ini.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

• SERVICE: nama layanan yang ingin Anda nonaktifkan.

Jalankan perintah gcloud services disable:

Linux, macOS, atau Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

Anda akan melihat respons seperti berikut:

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Untuk menonaktifkan beberapa layanan, gunakan nama layanan yang dipisahkan dengan spasi—misalnya, perintah berikut menonaktifkan layanan BigQuery dan Pub/Sub:

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

Untuk mengambil detail operasi, gunakan perintah gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Ganti OPERATION_ID dengan ID operasi yang Anda terima sebagai respons atas permintaan asli Anda.

REST API

Untuk menonaktifkan layanan, gunakan metode services.disable.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda.
• SERVICE: nama layanan yang ingin Anda nonaktifkan.

Untuk mengirim permintaan Anda, luaskan 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 POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

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 POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

Jika berhasil, isi respons berisi instance Operation yang baru dibuat:

{
  "name": "operations/OPERATION_ID"
}

Memeriksa status operasi yang berjalan lama

Menggunakan metode aktifkan atau nonaktifkan akan menampilkan operasi (LRO) yang berjalan lama. LRO melacak status permintaan dan menunjukkan apakah perubahan pada layanan sudah selesai.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

OPERATION_ID: ID operasi. Anda menerima ID ini sebagai respons atas permintaan asli Anda.

Untuk mengirim permintaan Anda, luaskan 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://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

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://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

Saat kolom done ditetapkan ke true, operasi akan selesai.