Mencantumkan Service

Dokumen ini menjelaskan cara membuat daftar API dan layanan yang diaktifkan atau tersedia di project Google Cloud. Daftar API dan layanan yang tersedia atau diaktifkan dapat berisi layanan Google Cloud publik seperti Pub/Sub, dan API serta layanan apa pun yang dibagikan secara pribadi kepada Anda, seperti layanan yang dibuat menggunakan Cloud Endpoints. Untuk mengetahui informasi selengkapnya tentang perbedaan antara API dan layanan publik dan pribadi, lihat Layanan Publik dan Pribadi.

  • Untuk mendapatkan atau memantau layanan yang diaktifkan untuk organisasi, lihat Mencantumkan layanan yang diaktifkan di organisasi.
  • Untuk mencantumkan layanan dalam project, sebaiknya gunakan konsol Google Cloud atau Google Cloud CLI. Dokumen ini menjelaskan cara menggunakan kedua antarmuka tersebut.
  • Untuk memprogram terhadap Service Usage API, gunakan salah satu library klien yang kami sediakan.
  • Untuk bereksperimen dengan API, sebaiknya gunakan perintah curl. Anda tidak perlu menyiapkan lingkungan aplikasi lengkap; tetapi, ada beberapa penyiapan yang diperlukan.

Sebelum memulai

Untuk mencantumkan API dan layanan yang diaktifkan dan tersedia 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.

Mencantumkan layanan yang diaktifkan di organisasi

Untuk mencantumkan layanan yang diaktifkan di seluruh organisasi, gunakan Inventaris Aset Cloud, yang memungkinkan ekspor status semua project yang berada di bawah kontrol organisasi dalam satu panggilan RPC. Inventaris Aset Cloud juga dapat digunakan untuk memantau perubahan status. Untuk mengekspor semua layanan yang diaktifkan untuk organisasi tertentu, ikuti dokumen Inventaris Aset Cloud untuk Mencantumkan Aset.

Untuk mencantumkan API yang diaktifkan untuk organisasi, jalankan perintah berikut setelah Anda menetapkan ID project penagihan dan organisasi:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--organization='ORGANIZATION_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

Dengan menjalankan perintah sebelumnya, pengguna yang memiliki hak istimewa yang memadai dapat mencantumkan kumpulan layanan yang diaktifkan untuk semua project dalam organisasi.

Untuk bereksperimen dengan perintah Cloud Asset Inventory, terapkan perintah ini ke project tertentu. Misalnya, perintah berikut mencantumkan semua layanan yang diaktifkan untuk project tertentu:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--project='PROJECT_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

Mencantumkan layanan yang diaktifkan dalam project

Mencantumkan layanan yang diaktifkan menggunakan kuota dari metrik kuota serviceusage.googleapis.com/list_enabled_requests. Kuota default yang tersedia adalah 10 kueri per detik (QPS).

console

Untuk mencantumkan API dan layanan yang diaktifkan dalam project:

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

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

    Halaman APIs & Services akan muncul. Anda dapat menemukan daftar API yang diaktifkan di project Google Cloud dalam tabel di halaman ini.

gcloud

Untuk mencantumkan API dan layanan yang diaktifkan di project Anda saat ini, jalankan perintah berikut:

gcloud services list

Perintah ini menghasilkan output yang mirip dengan berikut ini:

NAME                                              TITLE
pubsub.googleapis.com             Google Cloud Pub/Sub API
bigquery.googleapis.com           BigQuery API
cloudtrace.googleapis.com         Stackdriver Trace API
servicemanagement.googleapis.com  Google Service Management API
monitoring.googleapis.com         Stackdriver Monitoring API
storage-api.googleapis.com        Google Cloud Storage JSON API
logging.googleapis.com            Stackdriver Logging API
clouddebugger.googleapis.com      Stackdriver Debugger API
...

curl

Untuk mencantumkan layanan yang diaktifkan, panggil metode services.list dengan filter state:ENABLED.

Untuk mencantumkan API dan layanan yang diaktifkan di project Anda, jalankan perintah berikut:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"

Mencantumkan layanan yang tersedia dalam project

Mencantumkan semua layanan yang tersedia menggunakan kuota dari kuota serviceusage.googleapis.com/list_available_requests. Kuota default yang tersedia adalah 1 QPS. Kumpulan layanan yang tersedia jarang berubah dan dapat di-cache untuk jangka waktu yang lama.

console

Untuk mencantumkan API dan layanan yang tersedia untuk Anda dalam project:

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

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

    Layar Library API akan muncul. Anda dapat menelusuri atau men-scroll API yang tersedia dari layar ini.

gcloud

Untuk mencantumkan API dan layanan yang tersedia untuk Anda di project saat ini, jalankan perintah berikut:

gcloud services list --available

Hasilnya mencakup layanan apa pun yang telah diaktifkan, serta layanan yang tersedia untuk diaktifkan untuk project saat ini. Perintah ini menghasilkan output yang mirip dengan berikut ini:

NAME                                              TITLE
places-backend.googleapis.com                  Google Places API Web Service
clouderrorreporting.googleapis.com             Stackdriver Error Reporting API
analyticsreporting.googleapis.com              Google Analytics Reporting API
youtube.googleapis.com                         YouTube Data API v3
adsense.googleapis.com                         AdSense Management API
sqladmin.googleapis.com                        Google Cloud SQL API
genomics.googleapis.com                        Genomics API
adexchangebuyer.googleapis.com                 Ad Exchange Buyer API II
...

curl

Untuk mencantumkan layanan yang tersedia, panggil metode services.list.

Untuk mencantumkan API dan layanan yang tersedia di project Anda, jalankan perintah berikut:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"

Hasilnya mencakup semua layanan publik, semua layanan yang izin servicemanagement.services.bind-nya dimiliki oleh pengguna panggilan, dan semua layanan yang telah diaktifkan di project.

Anda dapat mengecualikan layanan yang saat ini aktif di project dengan meneruskan filter=state:DISABLED ke panggilan sebelumnya.

Langkah berikutnya

Untuk mengetahui informasi tentang cara mengaktifkan atau menonaktifkan layanan di project Google Cloud, lihat Mengaktifkan dan Menonaktifkan Layanan.