Mencantumkan layanan

Dokumen ini menjelaskan cara mencantumkan API dan layanan yang diaktifkan atau tersedia di project Google Cloud . Daftar API dan layanan yang tersedia atau diaktifkan dapat berisi Google Cloud layanan 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 dalam 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:

  • 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.

Mencantumkan layanan yang diaktifkan dalam organisasi

Untuk mencantumkan layanan yang diaktifkan di seluruh organisasi, gunakan Inventaris Aset Cloud, yang memungkinkan pengeksporan status semua project 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 dengan 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 yang tersedia secara default adalah 10 kueri per detik (QPS).

console

Untuk mencantumkan API dan layanan yang diaktifkan dalam sebuah project:

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

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

    Halaman APIs & Services 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 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. Ketersediaan kuota default adalah 1 QPS. Kumpulan layanan yang tersedia jarang berubah dan dapat di-cache dalam jangka waktu yang lama.

console

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

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

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

    Layar API Library 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 semua layanan 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 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, lihat Mengaktifkan dan Menonaktifkan Layanan.