Mengaktifkan dan Menonaktifkan Service

Halaman ini menjelaskan cara mengaktifkan dan menonaktifkan layanan untuk project Google Cloud. Anda dapat menggunakan Penggunaan Layanan untuk mengaktifkan atau menonaktifkan layanan apa pun yang tersedia untuk project Anda, termasuk layanan Google Cloud publik dan layanan pribadi yang dibuat menggunakan Cloud Endpoints. Untuk informasi selengkapnya tentang perbedaan antara API dan layanan publik dan pribadi, lihat Layanan Publik dan Pribadi.

Untuk sebagian besar kasus penggunaan operasional, cara termudah untuk mengaktifkan dan menonaktifkan layanan adalah menggunakan konsol Google Cloud. Jika perlu membuat skrip, Anda juga dapat menggunakan Google Cloud CLI. Jika Anda perlu memprogram terhadap Service Usage API, sebaiknya gunakan salah satu library klien yang kami sediakan. Untuk bereksperimen dengan API, Anda dapat mengikuti petunjuk alternatif dalam panduan ini dan menggunakan perintah curl untuk menguji API tanpa menyiapkan lingkungan pengembangan aplikasi lengkap.

Sebelum memulai

Untuk mengaktifkan dan menonaktifkan API dan layanan yang Anda perlukan:

• Project Google Cloud. Untuk mempelajari cara membuat project Google Cloud, lihat Membuat dan Mengelola Project.
• Izin Identity and Access Management yang benar. Untuk mempelajari persyaratan IAM untuk Service Usage, lihat Kontrol Akses.
• Untuk menginstal Google Cloud CLI.
• Jika Anda ingin menggunakan contoh curl dalam panduan ini, pastikan Anda mengikuti petunjuk untuk menyelesaikan penyiapan awal di Memulai. Langkah-langkah ini mencakup menentukan gcurl, yang merupakan alias diautentikasi untuk perintah curl standar, dan menentukan variabel lingkungan PROJECT_NUMBER.

Mengaktifkan layanan

Mengaktifkan layanan menggunakan kuota dari metrik kuota serviceusage.googleapis.com/mutate_requests. Kuota default yang tersedia adalah 2 kueri per detik (QPS).

console

Untuk mengaktifkan API untuk project:

1. Buka halaman Library API di konsol Google Cloud.
   Buka halaman Library API

2. Pilih project Google Cloud tempat Anda ingin mengaktifkan API dengan melakukan salah satu tindakan berikut:

   • Klik project Google Cloud di bagian Pilih project terbaru.

   • Gunakan browser project Google Cloud dengan melakukan langkah-langkah berikut:

     1. Klik Pilih project untuk membuka browser project Google Cloud.
     2. Temukan project Anda, lalu klik nama project Google Cloud.
     3. Klik Buka untuk membuka project.

3. Klik API yang ingin Anda aktifkan. Jika Anda memerlukan bantuan untuk menemukan API, gunakan kotak Telusuri API & Layanan di dekat bagian atas halaman. Halaman yang menjelaskan API akan muncul.

4. Klik tombol Aktifkan.

gcloud

Jalankan perintah berikut untuk mengaktifkan layanan Pub/Sub API di project saat ini:

gcloud services enable pubsub.googleapis.com

Perintah ini menghasilkan output yang mirip dengan berikut ini:

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Anda dapat menggunakan perintah berikut untuk mendapatkan detail operasi:

gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687

curl

Anda dapat mengaktifkan satu layanan menggunakan metode services.enable. Anda dapat mengaktifkan antara 2 hingga 20 layanan dalam satu operasi menggunakan metode services.batchEnable.

Mengaktifkan satu layanan

Perintah berikut mengaktifkan layanan Pub/Sub API di project Anda:

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable"

Metode services.enable menampilkan resource Operasi yang Berjalan Lama, yang mewakili pekerjaan yang sedang berlangsung di server. Setiap operasi memiliki nama resource yang unik. Misalnya, berikut adalah operasi dengan nama operations/acf.2e2fcfce-8327-4984-9040-a67777082687:

{
  "name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}

Untuk melakukan polling status operasi menggunakan metode operations.get Penggunaan Layanan, teruskan nama operasi ke API:

OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

Mengaktifkan beberapa layanan sekaligus

Jika ingin mengaktifkan beberapa layanan API di project, Anda dapat mengeluarkan perintah enable untuk setiap layanan API satu per satu, atau Anda dapat mengeluarkan satu perintah enable batch dan menentukan beberapa API. Misalnya, untuk mengaktifkan layanan Pub/Sub dan Dataflow API di project Anda:

gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services:batchEnable"

Seperti services.enable, services.batchEnable menampilkan resource operasi, yang dapat Anda polling menggunakan name-nya.

Catatan: Proses untuk mengaktifkan API dapat bervariasi. Beberapa API meminta Anda untuk menyetujui Persyaratan Layanannya sebelum dapat mengaktifkannya. Beberapa API berada dalam mode pratinjau dan memerlukan pendaftaran dan daftar yang diizinkan khusus sebelum Anda dapat menggunakannya. API lainnya mungkin meminta informasi tambahan, seperti informasi kontak organisasi Anda dan nama aplikasi yang Anda kembangkan. Jika informasi lain diminta, informasi tersebut tidak akan dibagikan ke luar Google; informasi tersebut digunakan untuk membantu Google memahami cara API digunakan dan sebagai kontak sekunder jika kami perlu menghubungi Anda terkait penggunaan layanan oleh Anda.

Menonaktifkan layanan

Menonaktifkan layanan menggunakan kuota dari metrik kuota serviceusage.googleapis.com/mutate_requests. Kuota default yang tersedia adalah 2 kueri per detik (QPS).

Anda dapat menonaktifkan API untuk project kapan saja, meskipun biaya yang tertunda akan tetap ditagih ke akun Anda dan Anda akan ditagih untuk penggunaan API yang dapat ditagih di project Anda. Untuk informasi selengkapnya, lihat API dan Penagihan.

Banyak layanan seperti Cloud Storage dan BigQuery mengenakan biaya untuk menyimpan data. Menonaktifkan akses API layanan tidak akan menghapus data pokok yang akan terus ditagih. Jika Anda ingin berhenti menggunakan layanan dan menghentikan semua tagihan mendatang, pastikan untuk menghapus semua data yang terkait dengan layanan sebelum menonaktifkan akses API layanan.

Jika Anda menonaktifkan GKE API, cluster apa pun yang berjalan di project akan ditangguhkan. Setelah 30 hari, cluster yang ditangguhkan akan dihapus. Untuk mengaktifkan kembali cluster yang ditangguhkan, aktifkan GKE API. Mungkin diperlukan waktu hingga 24 jam agar cluster diaktifkan kembali.

Catatan: Di API v1, jika Anda mencoba menonaktifkan layanan yang menjadi dependensi layanan lain yang diaktifkan, panggilan akan gagal. Panggilan API untuk menonaktifkan layanan akan menghasilkan pesan error. Untuk menonaktifkan layanan yang ditentukan dan semua layanan yang bergantung padanya, tetapkan parameter disable_dependent_services pada permintaan services.disable ke true.

console

Untuk menonaktifkan API untuk project:

1. Buka halaman Dasbor API di konsol Google Cloud.
   Buka halaman Dasbor API

2. Pilih project Google Cloud tempat Anda ingin menonaktifkan API dengan melakukan salah satu tindakan berikut:

   • Klik project Google Cloud di bagian Pilih project terbaru.

   • Gunakan browser project Google Cloud dengan melakukan langkah-langkah berikut:

     1. Klik Pilih project untuk membuka browser project Google Cloud.
     2. Temukan project Anda, lalu klik nama project Google Cloud.
     3. Klik Buka untuk membuka project.

3. Klik API yang ingin dinonaktifkan. Jika Anda memerlukan bantuan untuk menemukan API, gunakan kotak Telusuri API & Layanan di dekat bagian atas halaman. Halaman yang menjelaskan API akan muncul.

4. Klik Disable API.

gcloud

Jalankan perintah berikut untuk menonaktifkan layanan Pub/Sub API untuk project saat ini:

gcloud services disable pubsub.googleapis.com

Perintah ini menghasilkan output yang mirip dengan berikut ini:

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

Anda dapat menggunakan perintah berikut untuk mendapatkan detail operasi:

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

Perintah berikut menonaktifkan layanan Pub/Sub API di project Anda:

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable"

Seperti services.enable, services.disable menampilkan resource operasi, yang dapat Anda polling menggunakan name-nya.

Langkah berikutnya

Untuk mempelajari cara melihat dan mengelola metrik dan batas kuota yang berlaku untuk project Anda, lihat Mengelola Kuota Layanan.