Mengaktifkan dan Menonaktifkan Layanan

Halaman ini menjelaskan cara mengaktifkan dan menonaktifkan layanan untuk project Google Cloud. Anda dapat menggunakan Service Usage 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 lebih lanjut tentang perbedaan antara API dan layanan publik dan pribadi, lihat Layanan Publik dan Pribadi.

Untuk sebagian besar kasus penggunaan operasional, cara paling sederhana untuk mengaktifkan dan menonaktifkan layanan adalah dengan menggunakan Konsol Google Cloud. Jika perlu membuat skrip, Anda juga dapat menggunakan Google Cloud CLI. Jika Anda perlu memprogram menggunakan 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 secara lengkap.

Sebelum memulai

Untuk mengaktifkan dan menonaktifkan API serta 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. Guna mempelajari persyaratan IAM untuk Penggunaan Layanan, lihat Kontrol Akses.
• Untuk menginstal Google Cloud CLI.
• Jika ingin menggunakan contoh curl dalam panduan ini, pastikan Anda mengikuti petunjuk untuk menyelesaikan penyiapan awal di bagian Memulai. Langkah-langkah ini termasuk menentukan gcurl, yang merupakan alias terautentikasi untuk perintah curl standar, dan menentukan variabel lingkungan PROJECT_NUMBER.

Mengaktifkan layanan

Mengaktifkan layanan akan 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 sebuah project:

1. Buka halaman API Library Google Cloud Console.
   Buka halaman API Library

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

   • Klik project Google Cloud di bagian Select a recent project.

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

     1. Klik Select project untuk membuka browser project Google Cloud.
     2. Cari project Anda lalu klik nama project Google Cloud.
     3. Klik Open 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 dalam project Anda 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 memeriksa status operasi menggunakan metode Penggunaan Layanan operations.get, 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 pengaktifan untuk setiap layanan API satu per satu, atau Anda dapat memberikan satu perintah pengaktifan 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 Layanan sebelum dapat mengaktifkannya. Beberapa API berada dalam mode pratinjau dan memerlukan pendaftaran dan pemberian izin khusus sebelum Anda dapat menggunakannya. API lain mungkin meminta informasi tambahan, seperti informasi kontak organisasi Anda dan nama aplikasi yang Anda kembangkan. Jika diminta informasi selengkapnya, informasi tersebut tidak akan dibagikan di 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 akan 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 suatu project kapan saja, meskipun biaya tertunda akan tetap dibebankan ke akun Anda, dan Anda akan ditagih untuk setiap penggunaan API yang dapat ditagih dalam 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 menghapus data pokok yang akan terus ditagih. Jika intent Anda adalah untuk berhenti menggunakan layanan dan menghentikan semua biaya mendatang, pastikan untuk menghapus semua data yang terkait dengan layanan sebelum menonaktifkan akses API layanan.

Catatan: Dalam 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 sebuah project:

1. Buka halaman API Dashboard Google Cloud Console.
   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 Select a recent project.

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

     1. Klik Select project untuk membuka browser project Google Cloud.
     2. Cari project Anda lalu klik nama project Google Cloud.
     3. Klik Open untuk membuka project.

3. Klik API yang ingin Anda nonaktifkan. 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 guna menonaktifkan layanan Pub/Sub API untuk project Anda 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 kuota serta batas yang berlaku untuk project Anda, lihat Mengelola Kuota Layanan.