Ringkasan pemecahan masalah

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 kolom name 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.

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.

Langkah selanjutnya