Halaman ini memberikan informasi pemecahan masalah umum dan menyediakan link ke halaman lain untuk informasi tambahan.
Error saat men-deploy konfigurasi Cloud Endpoints
Jika Anda mendapatkan pesan error dari perintah gcloud endpoints services deploy
, lihat Memecahkan masalah deployment konfigurasi Endpoints untuk mengetahui informasi tentang pemecahan masalah error.
Error saat men-deploy backend API
Deployment API dan Extensible Service Proxy (ESP) Anda ke backend Google 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
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 kolomname
pada konfigurasi Endpoint gRPC.
Untuk informasi selengkapnya tentang perintah gcloud
, lihat
layanan gcloud
.
Memeriksa izin yang diperlukan
Instance yang menjalankan Extensible Service Proxy memerlukan izin untuk memanggil Pengelolaan Layanan dan ServiceControl.
Untuk ESP yang di-deploy di Cloud Run, lihat Mem-build image ESPv2 baru di tutorial Cloud Run untuk mengetahui detailnya.
Untuk ESP yang di-deploy di Compute Engine, lihat Tutorial memeriksa izin yang diperlukan di 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 panjang debug membantu proses debug.
gcloud --verbosity=debug COMMAND
Perintah ini membuat Google Cloud CLI mencetak log panjang error. Bergantung pada perintah yang dijalankan, output dapat menyertakan 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 dalam
dokument OpenAPI Anda. Contoh file spesifikasi tersedia di
Contoh memulai di GitHub.