Memecahkan masalah deployment konfigurasi Cloud Endpoints

Halaman ini menjelaskan cara memecahkan masalah error yang mungkin Anda alami saat men-deploy konfigurasi Cloud Endpoints. Pesan error yang Anda lihat berisi informasi khusus untuk project Anda. Misalnya, Anda mungkin melihat pesan error yang berisi project ID Anda. Di halaman ini, Anda akan melihat nilai placeholder seperti YOUR_PROJECT_ID.

Setelah setiap langkah, jalankan kembali perintah gcloud endpoints services deploy untuk melihat apakah error telah teratasi.

Tidak dapat mengonversi ke konfigurasi layanan

ERROR: (gcloud.endpoints.services.deploy) INVALID_ARGUMENT:
Cannot convert to service config. http: undefined field <unknown> on message <RequestType>

Periksa file .proto untuk menemukan kolom yang tidak cocok antara pesan buffering protokol dan pemetaan transcoding.

Misalnya, kode berikut dalam file .proto menghasilkan error ini. Opsi pemetaan di Unary menentukan kolom bernama undefined yang tidak ada dalam definisi pesan Request.

rpc Unary(Request) Response {
  option (google.api.http) { get : "/{undefined}" };
}

message Request {
  string defined = 1;
}

Tidak diizinkan untuk mendapatkan setelan project

ERROR: (gcloud.endpoints.services.deploy) PERMISSION_DENIED:
Not allowed to get project settings for project YOUR_PROJECT_ID

  1. Lakukan autentikasi dengan gcloud CLI lagi untuk mengonfirmasi bahwa Anda melakukan autentikasi dengan akun yang memiliki izin untuk mengakses project yang ditampilkan dalam pesan error: 
    gcloud auth login

    Tab browser baru akan terbuka dan Anda akan diminta untuk memilih akun.

  2. Pastikan ID project yang ditampilkan dalam pesan error sesuai dengan project Google Cloud yang menjadi tujuan deployment konfigurasi Endpoints: 
    gcloud projects list
  3. Pastikan gcloud CLI memiliki project ID yang benar yang ditetapkan sebagai project saat ini: 
    gcloud config set project YOUR_PROJECT_ID

Pemanggil tidak memiliki izin

ERROR: (gcloud.endpoints.services.deploy) PERMISSION_DENIED:
Caller does not have permission 'servicemanagement.services.create' on project YOUR_PROJECT_ID

Saat Anda pertama kali men-deploy konfigurasi Endpoint, Pengelolaan Layanan akan membuat layanan terkelola untuk API Anda. Untuk membuat layanan terkelola, setidaknya Anda harus memiliki peran Editor di tingkat project. Setelah Pengelolaan Layanan membuat layanan terkelola, izin minimum yang diperlukan untuk men-deploy ulang konfigurasi Endpoints adalah peran Service Config Editor (roles/servicemanagement.configEditor) di layanan. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses ke API.

Kepemilikan untuk nama domain tidak dapat diverifikasi

ERROR: (gcloud.endpoints.services.deploy) PERMISSION_DENIED:
Ownership for domain name YOUR_DOMAIN_NAME on project YOUR_PROJECT_ID cannot be verified

  • Jika memiliki domain kustom (misalnya, example.com) yang dikonfigurasi di kolom name pada file api_config.yaml, Anda harus memverifikasi nama domain sebelum dapat men-deploy konfigurasi layanan.
  • Jika Anda menggunakan domain cloud.goog, pastikan nilai untuk kolom name dalam format berikut, dan project ID sudah benar: 
    API_NAME.endpoints.YOUR_PROJECT_ID.cloud.goog

Memecahkan masalah error lainnya

Jika Anda menerima error yang tidak tercantum di sini, atau jika informasi tersebut tidak menyelesaikan masalah Anda, jalankan kembali perintah gcloud dengan flag untuk menampilkan informasi debug:

gcloud --verbosity=debug endpoints services deploy api_descriptor.pb api_config.yaml api_config_http.yaml

Langkah selanjutnya