Mencantumkan layanan

Dokumen ini menjelaskan cara mencantumkan API dan layanan yang diaktifkan atau tersedia di sebuah Google Cloud project. Daftar API dan layanan yang tersedia atau diaktifkan dapat berisi layanan publik Google Cloud seperti Pub/Sub, serta API dan 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 Google Cloud konsol atau Google Cloud CLI. Dokumen ini menjelaskan cara menggunakan kedua antarmuka tersebut.
  • Untuk memprogram 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; namun, ada beberapa penyiapan yang diperlukan.

Sebelum memulai

Untuk mencantumkan API dan layanan yang diaktifkan dan tersedia, Anda memerlukan:

  • Sebuah Google Cloud project. Untuk mempelajari cara membuat Google Cloud project, lihat Membuat dan Mengelola Project.
  • Izin Identity and Access Management yang benar. Untuk mempelajari tentang persyaratan IAM untuk Service Usage, 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 Memulai. Langkah-langkah ini mencakup penentuan gcurl, yang merupakan alias yang 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 Anda mengekspor status semua project yang berada di bawah kontrol organisasi dalam satu panggilan RPC call. 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 dengan hak istimewa yang memadai dapat mencantumkan kumpulan layanan yang diaktifkan untuk semua project dalam organisasi.

Untuk bereksperimen dengan perintah Inventaris Aset Cloud, 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 di 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 Google Cloud Dasbor API konsol.
    buka halaman Dasbor API

  2. Pilih Google Cloud project Anda dengan melakukan salah satu hal berikut:

    • Klikproject di bagian Pilih project terbaru. Google Cloud

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

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

    Halaman API &Layanan akan muncul. Anda dapat menemukan daftar API yang diaktifkan di project Google Cloud Anda 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 akan 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 di 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 konsol. Google Cloud
    Buka halaman Library API

  2. Pilih Google Cloud project Anda dengan melakukan salah satu hal berikut:

    • Klikproject di bagian Pilih project terbaru. Google Cloud

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

      1. Klik Pilih project untuk membuka Google Cloud project browser.
      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 Anda 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 akan 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 the services.list metode.

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 memiliki izin servicemanagement.services.bind untuk pengguna yang memanggil, 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 Google Cloud project Anda, lihat Mengaktifkan dan Menonaktifkan Layanan.