Halaman ini memberikan informasi pemecahan masalah umum dan menyediakan link ke halaman lain untuk mendapatkan informasi tambahan.
Error saat men-deploy konfigurasi Cloud Endpoints
Jika Anda mendapatkan pesan error dari perintah gcloud endpoints services deploy
command, lihat
Pemecahan masalah deployment konfigurasi Endpoint
untuk mengetahui informasi tentang pemecahan masalah error.
Error saat men-deploy backend API
Deployment API dan Extensible Service Proxy (ESP) ke backendGoogle Cloud bergantung pada platform. Lihat panduan pemecahan masalah berikut untuk mengetahui informasi selengkapnya:
Error respons
Saat Anda mengirim permintaan ke API dan menerima respons error, lihat Memecahkan masalah error respons untuk mengetahui informasi tentang cara memecahkan masalah error.
Memeriksa layanan yang diperlukan
Memeriksa layanan yang diperlukan
Minimal, Endpoints dan ESP memerlukan 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 projectGoogle Cloud yang sudah ada dan layanan ini dinonaktifkan secara eksplisit di project tersebut.
Gunakan perintah berikut untuk mengonfirmasi bahwa layanan yang diperlukan sudah 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.comAktifkan 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 ENDPOINTS_SERVICE_NAME yang mungkin ditampilkan di kolom Nama layanan.
Untuk OpenAPI, ENDPOINTS_SERVICE_NAME adalah yang Anda tentukan di kolom
hostspesifikasi OpenAPI. Untuk gRPC, ENDPOINTS_SERVICE_NAME adalah yang Anda tentukan di kolomnamekonfigurasi gRPC Endpoints.
Untuk mengetahui informasi selengkapnya tentang perintah gcloud, lihat
layanan gcloud.
Memeriksa izin yang diperlukan
Instance yang menjalankan Extensible Service Proxy memerlukan izin untuk memanggil Service Management dan ServiceControl.
Untuk ESP yang di-deploy di Cloud Run, lihat tutorial Membangun image ESPv2 baru di Cloud Run untuk mengetahui detailnya.
Untuk ESP yang di-deploy di Compute Engine, lihat Memeriksa izin yang diperlukan dalam tutorial Compute Engine untuk mengetahui detailnya.
Untuk ESP yang di-deploy di GKE, lihat Memeriksa izin yang diperlukan dalam tutorial GKE untuk mengetahui detailnya.
Memeriksa informasi debug
Menjalankan Google Cloud CLI dengan verbositas debug akan membantu proses pen-debug-an.
gcloud --verbosity=debug COMMAND
Perintah ini membuat Google Cloud CLI mencetak log verbose error. Bergantung pada perintah yang dijalankan, output dapat mencakup informasi permintaan dan respons dari server.
Mengaktifkan layanan
Anda dapat memeriksa apakah layanan diaktifkan menggunakan gcloud.
gcloud services list
Untuk menampilkan konfigurasi layanan tertentu, gunakan perintah berikut:
gcloud endpoints services describe SERVICE_NAME
OAuth proxy gagal, tetapi permintaan berhasil
Pastikan ada bagian security yang memiliki definisi OAuth di dokumen OpenAPI Anda. Contoh file spesifikasi tersedia di
Contoh memulai di GitHub.