Mengaktifkan dan menonaktifkan layanan

Halaman ini menjelaskan cara mengaktifkan dan menonaktifkan layanan untuk project Google Cloud . Anda dapat menggunakan Penggunaan Layanan untuk mengaktifkan atau menonaktifkan layanan yang tersedia untuk project Anda, termasuk Google Cloud layanan publik dan layanan pribadi yang dibuat menggunakan Cloud Endpoints. Untuk mengetahui informasi selengkapnya 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 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, Anda memerlukan:

• 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 penentuan gcurl, yang merupakan alias yang diautentikasi untuk perintah curl standar, dan penentuan variabel lingkungan PROJECT_NUMBER.

Mengaktifkan layanan

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

console

Untuk mengaktifkan API untuk project:

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

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

   • Klik Google Cloud project di bagian Pilih project terbaru.

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

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

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

4. Klik tombol Enable.

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 dan 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 Long Running Operation, 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 Service Usage, 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 mengeluarkan 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 Anda dapat mengaktifkannya. Beberapa API dalam mode pratinjau dan memerlukan pendaftaran khusus serta masuk daftar yang diizinkan sebelum Anda dapat menggunakannya. API lain mungkin meminta informasi tambahan, seperti informasi kontak organisasi Anda dan nama aplikasi yang Anda kembangkan. Jika informasi lebih lanjut diminta, informasi tersebut tidak akan dibagikan di luar Google; informasi tersebut digunakan untuk membantu Google memahami cara penggunaan API dan sebagai kontak sekunder jika kami perlu menghubungi Anda terkait penggunaan layanan ini oleh Anda.

Menonaktifkan layanan

Penonaktifan layanan menggunakan kuota dari metrik kuota serviceusage.googleapis.com/mutate_requests. Ketersediaan kuota default 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 dalam project Anda. Untuk mengetahui 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 berniat untuk berhenti menggunakan layanan dan menghentikan semua biaya di masa mendatang, pastikan untuk menghapus semua data yang terkait dengan layanan tersebut sebelum menonaktifkan akses API layanan.

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

Catatan: Di API v1, jika Anda mencoba menonaktifkan layanan yang bergantung pada 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 Google Cloud konsol Dasbor API.
   Buka halaman Dasbor API

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

   • Klik Google Cloud project di bagian Pilih project terbaru.

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

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

3. Klik API yang ingin Anda nonaktifkan. Jika Anda memerlukan bantuan untuk menemukan API, gunakan kotak Search for APIs & Services 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 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.