Menyiapkan Cloud Endpoints OpenAPI untuk fungsi Cloud Run dengan ESPv2

Menyiapkan Cloud Endpoints OpenAPI untuk fungsi Cloud Run dengan ESPv2

Halaman ini menunjukkan cara menyiapkan Cloud Endpoints di fungsi Cloud Run. Endpoint menggunakan Extensible Service Proxy V2 (ESPv2) sebagai API gateway. Untuk menyediakan pengelolaan API bagi fungsi Cloud Run, Anda men-deploy penampung ESPv2 bawaan ke Cloud Run. Kemudian, Anda mengamankan fungsi menggunakan IAM fungsi Cloud Run sehingga ESPv2 dapat memanggilnya.

Dengan penyiapan ini, ESPv2 mencegat semua permintaan ke fungsi Anda dan melakukan pemeriksaan yang diperlukan (seperti autentikasi) sebelum memanggil fungsi. Saat fungsi merespons, ESPv2 akan mengumpulkan dan melaporkan telemetri, seperti yang ditunjukkan pada gambar di bawah. Anda dapat melihat metrik untuk fungsi di halaman Endpoints > Services di Konsol Google Cloud.

Untuk ringkasan Cloud Endpoints, lihat Tentang Endpoints dan Arsitektur Endpoints.

Catatan: Endpoint untuk fungsi Cloud Run hanya didukung untuk fungsi Cloud Run HTTP. Fungsi Cloud Run latar belakang tidak didukung.

Bermigrasi ke ESPv2

Rilis Cloud Endpoints sebelumnya mendukung penggunaan Extensible Service Proxy (ESP) dengan Cloud Functions. Jika Anda memiliki API yang ada dan ingin memigrasikannya ke ESPv2, lihat Bermigrasi ke Extensible Service Proxy V2 untuk mengetahui informasi selengkapnya.

Daftar Tugas

Gunakan daftar tugas berikut saat Anda mengerjakan tutorial ini. Semua tugas diperlukan untuk menyelesaikan tutorial ini.

1. Buat project Google Cloud, dan jika Anda belum men-deploy fungsi Cloud Run Anda sendiri, deploy fungsi backend contoh. Lihat Sebelum memulai.
2. Menyiapkan nama host Cloud Run untuk layanan ESPv2. Lihat Menyimpan nama host Cloud Run.
3. Buat dokumen OpenAPI yang menjelaskan API Anda, dan konfigurasikan rute ke fungsi Cloud Run Anda. Lihat Mengonfigurasi Endpoint.
4. Deploy dokumen OpenAPI untuk membuat layanan terkelola. Lihat Men-deploy konfigurasi Endpoint.
5. Build image Docker ESPv2 baru dengan konfigurasi layanan Endpoints Anda. Lihat Mem-build image ESPv2 baru.
6. Deploy container ESPv2 ke Cloud Run. Kemudian, berikan izin Identity and Access Management (IAM) kepada ESPv2 untuk memanggil layanan Anda. Lihat Men-deploy penampung ESPv2.
7. Panggil fungsi. Lihat Mengirim permintaan ke API.
8. Melacak aktivitas ke fungsi Anda. Lihat Melacak aktivitas API.
9. Hindari tagihan pada akun Google Cloud Anda. Lihat Pembersihan.

Biaya

Dalam dokumen ini, Anda menggunakan komponen Google Cloud yang dapat ditagih berikut:

• Cloud Run functions
• Cloud Run
• Endpoints

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga. Pengguna baru Google Cloud mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.

Sebelum memulai

Sebelum menggunakan Endpoints untuk fungsi Cloud Run, sebaiknya Anda:

• Buat project Google Cloud baru untuk digunakan saat Anda men-deploy penampung ESPv2 ke Cloud Run.

• Buat project baru atau pilih project yang sudah ada untuk fungsi Cloud Run Anda.

Untuk menyiapkannya:

1. Di konsol Google Cloud, buka halaman Manage resources dan buat project.

   Buka halaman Kelola resource

2. Pastikan penagihan diaktifkan untuk project Anda.

   Pelajari cara mengaktifkan penagihan

3. Catat project ID karena diperlukan nanti. Di bagian lain halaman ini, project ID ini disebut sebagai ESP_PROJECT_ID.

4. Catat nomor project karena diperlukan nanti. Di bagian lain halaman ini, nomor project ini disebut sebagai ESP_PROJECT_NUMBER.

5. Download dan instal Google Cloud CLI.

   Mendownload gcloud CLI

6. Jika Anda belum men-deploy fungsi Cloud Run backend Anda sendiri, ikuti langkah-langkah dalam Panduan Memulai: Menggunakan Google Cloud CLI untuk memilih atau membuat project Google Cloud dan men-deploy fungsi contoh. Catat region dan project ID tempat fungsi Anda di-deploy. Di bagian lain halaman ini, project ID ini disebut sebagai FUNCTIONS_PROJECT_ID.

Menyimpan nama host Cloud Run

Anda harus mencadangkan nama host Cloud Run untuk layanan ESPv2 agar dapat mengonfigurasi dokumen OpenAPI atau konfigurasi layanan gRPC. Untuk memesan nama host, Anda akan men-deploy container contoh ke Cloud Run. Kemudian, Anda akan men-deploy penampung ESPv2 ke layanan Cloud Run yang sama.

Catatan: Setiap layanan Cloud Run ESPv2 hanya dapat dikaitkan dengan satu dokumen OpenAPI atau konfigurasi layanan gRPC. Menyiapkan nama host Cloud Run baru untuk setiap dokumen.

1. Pastikan gcloud CLI diberi otorisasi untuk mengakses data dan layanan Anda.
   1. Log in.

      gcloud auth login

   2. Di tab browser baru yang terbuka, pilih akun yang memiliki peran Editor atau Pemilik di project Google Cloud yang Anda buat untuk men-deploy ESPv2 ke Cloud Run.
2. Tetapkan region.

   gcloud config set run/region us-central1

3. Deploy image contoh gcr.io/cloudrun/hello ke Cloud Run. Ganti CLOUD_RUN_SERVICE_NAME dengan nama yang ingin Anda gunakan untuk layanan.

   gcloud run deploy CLOUD_RUN_SERVICE_NAME \
       --image="gcr.io/cloudrun/hello" \
       --allow-unauthenticated \
       --platform managed \
       --project=ESP_PROJECT_ID
   

   Setelah berhasil diselesaikan, perintah akan menampilkan pesan yang mirip dengan berikut:

   Service [CLOUD_RUN_SERVICE_NAME] revision [CLOUD_RUN_SERVICE_NAME-REVISION_NUM] has been deployed and is serving traffic at CLOUD_RUN_SERVICE_URL

   Misalnya, jika Anda menetapkan CLOUD_RUN_SERVICE_NAME ke gateway:

   Service [gateway] revision [gateway-00001] has been deployed and is serving traffic at https://gateway-12345-uc.a.run.app

   Dalam contoh ini, https://gateway-12345-uc.a.run.app adalah CLOUD_RUN_SERVICE_URL dan gateway-12345-uc.a.run.app adalah CLOUD_RUN_HOSTNAME.

4. Catat CLOUD_RUN_SERVICE_NAME dan CLOUD_RUN_HOSTNAME. Kemudian, Anda akan men-deploy ESPv2 ke layanan Cloud Run CLOUD_RUN_SERVICE_NAME. Anda menentukan CLOUD_RUN_HOSTNAME di kolom host pada dokumen OpenAPI.

Mengonfigurasi Endpoint

Anda harus memiliki dokumen OpenAPI berdasarkan Spesifikasi OpenAPI v2.0 yang menjelaskan platform fungsi Anda dan persyaratan autentikasi apa pun. Anda juga perlu menambahkan kolom khusus Google yang berisi URL untuk setiap fungsi sehingga ESPv2 memiliki informasi yang diperlukan untuk memanggil fungsi. Jika Anda baru menggunakan OpenAPI, lihat ringkasan OpenAPI untuk mengetahui informasi selengkapnya

1. Buat file teks bernama openapi-functions.yaml. (Untuk kemudahan, halaman ini merujuk ke dokumen OpenAPI dengan nama file tersebut, tetapi Anda dapat memberi nama lain jika mau.)
2. Setiap fungsi Anda harus dicantumkan di bagian paths dalam file openapi-functions.yaml. Contoh:

   swagger: '2.0'
   info:
     title: Cloud Endpoints + GCF
     description: Sample API on Cloud Endpoints with a Google Cloud Functions backend
     version: 1.0.0
   host: HOST
   schemes:
     - https
   produces:
     - application/json
   paths:
     /hello:
       get:
         summary: Greet a user
         operationId: hello
         x-google-backend:
           address: https://REGION-FUNCTIONS_PROJECT_ID.cloudfunctions.net/FUNCTIONS_NAME
           protocol: h2
         responses:
           '200':
             description: A successful response
             schema:
               type: string

   Indentasi penting untuk format yaml. Misalnya, kolom host harus berada di tingkat yang sama dengan info.
3. Di kolom address di bagian x-google-backend, ganti REGION dengan region Google Cloud tempat fungsi Anda berada, FUNCTIONS_PROJECT_ID dengan project ID Google Cloud Anda, dan FUNCTIONS_NAME dengan nama fungsi Anda. Contoh:

   x-google-backend:
     address: https://us-central1-myproject.cloudfunctions.net/helloGET

   Jika Anda ingin mengamankan fungsi Cloud Run dengan hanya mengizinkan ESPv2 untuk memanggilnya, pastikan kolom address menyertakan nama fungsi jika jwt_audience tidak ditentukan. Contoh:

   x-google-backend:
     address: https://REGION-FUNCTIONS_PROJECT_ID.cloudfunctions.net/FUNCTIONS_NAME
     path_translation: CONSTANT_ADDRESS

   Jika jwt_audience ditentukan, nilainya juga harus menyertakan nama fungsi. Contoh:

   x-google-backend:
     address: https://REGION-FUNCTIONS_PROJECT_ID.cloudfunctions.net
     jwt_audience: https://REGION-FUNCTIONS_PROJECT_ID.cloudfunctions.net/FUNCTIONS_NAME
     path_translation: APPEND_PATH_TO_ADDRESS

   ESPv2 membuat token ID saat memanggil fungsi Cloud Run untuk autentikasi. Token ID harus memiliki audience yang tepat yang menentukan host fungsi dan nama fungsi. ESPv2 menetapkan audience untuk token ID menggunakan nilai di kolom jwt_audience jika ditentukan, jika tidak, ESPv2 akan menggunakan kolom address.

4. Di kolom host, tentukan CLOUD_RUN_HOSTNAME, bagian nama host URL yang dicadangkan di atas dalam Mencadangkan nama host Cloud Run. Jangan sertakan ID protokol, https://. Contoh:

   swagger: '2.0'
     info:
       title: Cloud Endpoints + GCF
       description: Sample API on Cloud Endpoints with a Google Cloud Functions backend
       version: 1.0.0
     host: gateway-12345-uc.a.run.app

5. Perhatikan nilai properti title dalam file openapi-functions.yaml:

   title: Cloud Endpoints + GCF

   Nilai properti title menjadi nama layanan Endpoints setelah Anda men-deploy konfigurasi.

6. Simpan dokumen OpenAPI Anda.

Untuk mengetahui informasi tentang kolom dalam dokumen OpenAPI yang diperlukan Endpoints, lihat Mengonfigurasi Endpoints.

Men-deploy konfigurasi Endpoint

Untuk men-deploy konfigurasi Endpoint, Anda menggunakan perintah gcloud endpoints services deploy. Perintah ini menggunakan Pengelolaan Layanan untuk membuat layanan terkelola.

Untuk men-deploy konfigurasi Endpoint:

1. Pastikan Anda berada di direktori yang berisi dokumen OpenAPI.

2. Upload konfigurasi dan buat layanan terkelola.

   gcloud endpoints services deploy openapi-functions.yaml \
       --project ESP_PROJECT_ID

   Tindakan ini akan membuat layanan Endpoints baru dengan nama yang Anda tentukan di kolom host file openapi-functions.yaml. Layanan dikonfigurasi sesuai dengan dokumen OpenAPI Anda.

   Saat membuat dan mengonfigurasi layanan, Manajemen Layanan akan menampilkan informasi ke terminal. Setelah deployment selesai, pesan yang mirip dengan berikut akan ditampilkan:

   Service Configuration [CONFIG_ID] uploaded for service [CLOUD_RUN_HOSTNAME]

   CONFIG_ID adalah ID konfigurasi layanan Endpoints unik yang dibuat oleh deployment. Contoh:

   Service Configuration [2019-02-01r0] uploaded for service [gateway-12345-uc.a.run.app]

   ID konfigurasi layanan terdiri dari stempel tanggal yang diikuti dengan nomor revisi. Jika Anda men-deploy openapi-functions.yaml lagi pada hari yang sama, nomor revisi akan bertambah di ID konfigurasi layanan. Anda dapat melihat konfigurasi layanan dan histori deployment di halaman Endpoints > Services di Konsol Google Cloud.

   Jika Anda menerima pesan error, lihat Memecahkan masalah deployment konfigurasi Endpoints.

Memeriksa layanan yang diperlukan

Setidaknya, Endpoint dan ESP mewajibkan layanan Google berikut diaktifkan:

Nama	Judul
servicemanagement.googleapis.com	Service Management API
servicecontrol.googleapis.com	Service Control API

Dalam sebagian besar kasus, perintah gcloud endpoints services deploy mengaktifkan layanan yang diperlukan ini. Namun, perintah gcloud berhasil diselesaikan, tetapi tidak mengaktifkan layanan yang diperlukan dalam situasi berikut:

• Jika Anda menggunakan aplikasi pihak ketiga seperti Terraform, dan Anda tidak menyertakan layanan ini.

• Anda men-deploy konfigurasi Endpoints ke project Google Cloud yang ada, tempat layanan ini dinonaktifkan secara eksplisit.

Gunakan perintah berikut untuk mengonfirmasi bahwa layanan yang diperlukan telah diaktifkan:

gcloud services list

Jika Anda tidak melihat layanan yang diperlukan tercantum, aktifkan layanan tersebut:

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com

Aktifkan juga layanan Endpoints Anda:

gcloud services enable ENDPOINTS_SERVICE_NAME

Untuk menentukan ENDPOINTS_SERVICE_NAME, Anda dapat:

• Setelah men-deploy konfigurasi Endpoints, buka halaman Endpoints di Konsol Cloud. Daftar kemungkinan ENDPOINTS_SERVICE_NAME ditampilkan di kolom Nama layanan.

• Untuk OpenAPI, ENDPOINTS_SERVICE_NAME adalah yang Anda tentukan di kolom host pada spesifikasi OpenAPI. Untuk gRPC, ENDPOINTS_SERVICE_NAME adalah yang Anda tentukan di kolom name pada konfigurasi Endpoint gRPC.

Untuk informasi selengkapnya tentang perintah gcloud, lihat layanan gcloud.

Mem-build image ESPv2 baru

Build konfigurasi layanan Endpoints ke dalam image Docker ESPv2 baru. Nanti, Anda akan men-deploy image ini ke layanan Cloud Run yang direservasi.

Catatan:

Langkah ini wajib dilakukan.

Konfigurasi layanan harus dibuat ke dalam image docker baru karena Cloud Run adalah layanan skala ke nol. Artinya, jika tidak ada traffic, semua instance akan dihapus. Saat traffic meningkat, instance baru akan dibuat sesuai permintaan. Jenis pembuatan instance layanan ini juga disebut cold start. Lihat dokumentasi Konkurensi Cloud Run untuk mengetahui informasi selengkapnya.

Jika image docker tidak memiliki konfigurasi layanan yang terintegrasi, Cloud Run harus melakukan dua panggilan API ke Google ServiceManagement saat cold start. Panggilan ini mengurangi kuota Google ServiceManagement API Anda.

Dengan mem-build konfigurasi layanan ke dalam image docker ESPv2, Anda akan menghapus dua panggilan API dan menghindari dampak pada jumlah kuota untuk layanan Google ServiceManagement. Langkah ini juga mempercepat pembuatan instance layanan baru dan mengurangi latensi untuk permintaan yang menunggu instance baru.

Anda harus menjalankan ulang seluruh langkah ini dan men-deploy ulang penampung baru:

• Setiap kali Anda mengubah dan men-deploy ulang konfigurasi layanan Endpoints. Jika tidak, perubahan pada konfigurasi layanan tidak akan diterapkan ke ESPv2.
• Saat ESPv2 versi baru dirilis. Jika tidak, ESPv2 versi lama akan tetap di-deploy.

Untuk mem-build konfigurasi layanan ke dalam image docker ESPv2 baru:

1. Download skrip ini ke komputer lokal tempat gcloud CLI diinstal.

   Catatan:

   Skrip ini memerlukan bash. Jika tidak menggunakan macOS/Linux, Anda dapat menjalankannya di Cloud Shell, Compute Engine, atau Windows Subsystem for Linux.

2. Jalankan skrip dengan perintah berikut:

   chmod +x gcloud_build_image
   
   ./gcloud_build_image -s CLOUD_RUN_HOSTNAME \
       -c CONFIG_ID -p ESP_PROJECT_ID

   Untuk CLOUD_RUN_HOSTNAME, tentukan nama host URL yang Anda pesan di atas di Memesan nama host Cloud Run. Jangan sertakan ID protokol, https://.

   Contoh:

   chmod +x gcloud_build_image
   
   ./gcloud_build_image -s gateway-12345-uc.a.run.app \
       -c 2019-02-01r0 -p your-project-id

3. Skrip menggunakan perintah gcloud untuk mendownload konfigurasi layanan, mem-build konfigurasi layanan menjadi image ESPv2 baru, dan mengupload image baru ke registry penampung project Anda. Skrip secara otomatis menggunakan rilis ESPv2 terbaru, yang ditunjukkan dengan ESP_VERSION dalam nama image output. Gambar output diupload ke:

   gcr.io/ESP_PROJECT_ID/endpoints-runtime-serverless:ESP_VERSION-CLOUD_RUN_HOSTNAME-CONFIG_ID

   Contoh:

   gcr.io/your-project-id/endpoints-runtime-serverless:2.14.0-gateway-12345-uc.a.run.app-2019-02-01r0"

   Catatan:

   Teruskan flag -z ke skrip untuk membuat image di lokasi registry yang berbeda.

   Misalnya, untuk mendorong image ESPv2 yang dihasilkan ke pusat data Uni Eropa, teruskan -z eu ke skrip.

Men-deploy container ESPv2

1. Deploy layanan Cloud Run ESPv2 dengan image baru yang Anda build di atas. Ganti CLOUD_RUN_SERVICE_NAME dengan nama layanan Cloud Run yang sama dengan yang Anda gunakan saat awalnya memesan nama host di atas dalam Memesan nama host Cloud Run:

   gcloud run deploy CLOUD_RUN_SERVICE_NAME \
     --image="gcr.io/ESP_PROJECT_ID/endpoints-runtime-serverless:ESP_VERSION-CLOUD_RUN_HOSTNAME-CONFIG_ID" \
     --allow-unauthenticated \
     --platform managed \
     --project=ESP_PROJECT_ID

   Catatan:

   Jika Anda ingin ESPv2 mengelola akses, gunakan tanda --allow-unauthenticated untuk memastikan ESPv2 memverifikasi token JWT. Jika flag tidak digunakan, token JWT akan dicegat dan diverifikasi oleh server IAM kontrol akses Cloud Run <a=" docs="" managing-access"="" run="" securing="">. Karena IAM dan ESPv2 menggunakan header Otorisasi yang sama, keduanya tidak berfungsi bersama. Pastikan hanya menggunakan salah satunya. Sebaiknya gunakan IAM, bukan ESPv2, untuk mengelola akses.</a=">

2. Jika ingin mengonfigurasi Endpoints untuk menggunakan opsi startup ESPv2 tambahan, seperti mengaktifkan CORS, Anda dapat meneruskan argumen dalam variabel lingkungan ESPv2_ARGS:

   gcloud run deploy CLOUD_RUN_SERVICE_NAME \
     --image="gcr.io/ESP_PROJECT_ID/endpoints-runtime-serverless:ESP_VERSION-CLOUD_RUN_HOSTNAME-CONFIG_ID" \
     --set-env-vars=ESPv2_ARGS=--cors_preset=basic \
     --allow-unauthenticated \
     --platform managed \
     --project ESP_PROJECT_ID

   Untuk informasi selengkapnya dan contoh tentang cara menetapkan variabel lingkungan ESPv2_ARGS, termasuk daftar opsi yang tersedia dan informasi tentang cara menentukan beberapa opsi, lihat Flag Extensible Service Proxy V2 Beta.

3. Berikan izin ESPv2 untuk memanggil Pengelolaan Layanan dan Kontrol Layanan.

Catatan:

Langkah ini tidak diperlukan jika instance Cloud Run ESPv2 di-deploy tanpa menggunakan flag --service-account

• Di konsol Google Cloud, buka halaman Cloud Run.

Buka halaman Cloud Run

• Anda dapat melihat instance Cloud Run yang di-deploy dan akun layanan yang terkait dengannya.
• Berikan izin yang diperlukan ke akun layanan:

gcloud projects add-iam-policy-binding PROJECT_NAME \
   --member "serviceAccount:SERVICE_ACCOUNT" \
   --role roles/servicemanagement.serviceController

Untuk mengetahui informasi selengkapnya, lihat Apa yang dimaksud dengan peran dan izin?

4. Berikan izin ESPv2 untuk memanggil fungsi Anda. Jalankan perintah berikut untuk setiap fungsi. Dalam perintah berikut:

   Catatan:

   Langkah ini tidak diperlukan jika layanan Cloud Run ESPv2 di-deploy tanpa menggunakan flag --service-account dan layanan backend BACKEND_SERVICE_NAME di-deploy di project ESP_PROJECT_NUMBER.

   • Ganti FUNCTION_NAME dengan nama fungsi Anda dan FUNCTION_REGION dengan region tempat fungsi di-deploy. Jika Anda menggunakan fungsi yang dibuat di Panduan Memulai: Menggunakan Google Cloud CLI, gunakan helloGET sebagai namanya.
   • Ganti ESP_PROJECT_NUMBER dengan nomor project yang Anda buat untuk ESPv2. Salah satu cara untuk menemukannya adalah dengan membuka halaman IAM di Konsol Google Cloud dan menemukan Default compute service account, yang merupakan akun layanan yang digunakan dalam flag member.

   gcloud functions add-iam-policy-binding FUNCTION_NAME \
      --region FUNCTION_REGION \
      --member "serviceAccount:ESP_PROJECT_NUMBER-compute@" \
      --role "roles/cloudfunctions.invoker" \
      --project FUNCTIONS_PROJECT_ID
   

Untuk mengetahui informasi selengkapnya, lihat Mengelola Akses melalui IAM.

Mengirim permintaan ke API

Bagian ini menunjukkan cara mengirim permintaan ke API Anda.

1. Buat variabel lingkungan untuk nama layanan Endpoints Anda. Ini adalah nama yang Anda tentukan di kolom host dalam dokumen OpenAPI Anda. Misalnya:

   • Linux atau macOS:

     export ENDPOINTS_HOST=gateway-12345-uc.a.run.app

   • Windows PowerShell:

     $Env: ENDPOINTS_HOST="gateway-12345-uc.a.run.app"

Linux atau Mac OS

Gunakan curl untuk mengirim permintaan HTTP menggunakan variabel lingkungan ENDPOINTS_HOST yang Anda tetapkan di langkah sebelumnya.

curl --request GET \
   --header "content-type:application/json" \
   "https://${ENDPOINTS_HOST}/hello"

PowerShell

Gunakan Invoke-WebRequest untuk mengirim permintaan HTTP menggunakan variabel lingkungan ENDPOINTS_HOST yang Anda tetapkan pada langkah sebelumnya.

(Invoke-WebRequest -Method GET `
    -Headers @{"content-type"="application/json"} `
    -URI "https://$Env:ENDPOINTS_HOST/hello").Content

Pada contoh sebelumnya, dua baris pertama diakhiri dengan tanda petik terbalik. Saat Anda menempelkan contoh ke PowerShell, pastikan tidak ada spasi setelah tanda petik terbalik. Untuk informasi tentang opsi yang digunakan dalam contoh permintaan, lihat Invoke-WebRequest dalam dokumentasi Microsoft.

Aplikasi pihak ketiga

Anda dapat menggunakan aplikasi pihak ketiga seperti permintaan ekstensi browser Chrome Postman.

• Pilih GET sebagai kata kerja HTTP.
• Untuk header, pilih kunci content-type dan nilai application/json.

• Gunakan URL sebenarnya, bukan variabel lingkungan, misalnya:

  https://gateway-12345-uc.a.run.app/hello
  

Jika Anda tidak mendapatkan respons yang berhasil, lihat Memecahkan Masalah Error Respons.

Anda baru saja men-deploy dan menguji API di Endpoint.

Catatan: Jika Anda ingin memberi tahu kami apa yang Anda sukai tentang tutorial ini, jangan ragu untuk memberikan masukan di bagian bawah halaman ini. Masukan Anda membantu kami meningkatkan kualitas tutorial ini.
Jika Anda mendapatkan error, bergabunglah ke grup Google google-cloud-endpoints dan beri tahu kami masalahnya. Grup ini menerima respons dari pengguna Endpoints lainnya dan dari engineer Google, yang memantau grup.

Melacak aktivitas API

1. Lihat grafik aktivitas untuk API Anda di halaman Endpoints > Service di Konsol Google Cloud.

   Melihat grafik aktivitas Endpoint

   Mungkin perlu waktu beberapa saat agar permintaan ditampilkan dalam grafik.

2. Lihat log permintaan untuk API Anda di halaman Logs Explorer. Melihat log permintaan Endpoints

Membuat portal developer untuk API

Anda dapat menggunakan Cloud Endpoints Portal untuk membuat portal developer, situs yang dapat Anda gunakan untuk berinteraksi dengan API contoh. Untuk mempelajari lebih lanjut, lihat Ringkasan Cloud Endpoints Portal.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Lihat Menghapus API dan instance API untuk mengetahui informasi tentang cara menghentikan layanan yang digunakan oleh tutorial ini.

Langkah selanjutnya

• Pelajari Cloud Run lebih lanjut
• Pelajari lebih lanjut cara men-deploy konfigurasi Endpoint
• Membagikan API Anda kepada developer lain
• Pelajari autentikasi
• Pelajari opsi dukungan komunitas