Dokumen ini menunjukkan cara menyelesaikan masalah terkait operasi pembuatan API instance massal.
Error operasi
Saat Anda menggunakan API instance massal untuk membuat VM, permintaan create
akan menampilkan HTTP 200 OK
dengan status RUNNING
jika permintaan berhasil dimulai. Jika permintaan tidak berhasil dimulai, API akan menampilkan salah satu respons di bawah ini.
Tidak valid
Jika kolom respons API berikut ada saat Anda membuat VM, permintaan API Anda tidak akan ditulis dengan benar, atau menggunakan properti yang tidak didukung oleh API massal.
Kolom respons API:
HTTP 400
"reason": "invalid"
Untuk menyelesaikan masalah ini, lakukan tindakan berikut:
- Lihat kolom
message
dalam respons untuk menentukan properti mana dalam permintaan yang menyebabkan error. - Perbarui properti yang menyebabkan error.
- Coba lagi permintaan tersebut.
- Jika permintaan gagal lagi, coba gunakan API Explorer untuk memvalidasi permintaan. Untuk informasi selengkapnya, lihat Memvalidasi permintaan API.
Kuota melampaui batas
Jika kolom respons API berikut ada saat membuat VM, berarti Anda telah mencapai batas kuota untuk sebuah resource. Untuk mengetahui informasi selengkapnya tentang kuota, lihat Kuota resource.
Kolom respons API:
HTTP 403
"reason": "quotaExceeded"
- Lihat kolom `message` untuk mengidentifikasi kuota resource yang terlampaui oleh permintaan.
- Lakukan salah satu tindakan berikut:
- Coba lagi permintaan dengan jumlah VM yang lebih kecil
- Meminta penambahan kuota
Batas kapasitas terlampaui
Jika kolom respons API berikut ada saat membuat VM, berarti Anda telah mencapai batas 20 permintaan per detik atau Anda memiliki lebih dari 10 operasi massal yang berjalan secara bersamaan.
Kolom respons API:
HTTP 403
"reason": "rateLimitExceeded"
Untuk mengatasi masalah ini, tunggu hingga beberapa permintaan selesai, lalu coba lagi permintaan Anda.
Kapasitas tidak mencukupi
Jika kolom respons API berikut ada saat Anda membuat VM, kapasitas di region atau zona tempat Anda mencoba membuat VM tidak memadai.
Kolom respons API:
HTTP 503
"reason": "insufficientCapacity"
- Membuat VM di region yang berbeda
- Buat VM di zona yang berbeda jika menggunakan endpoint zona
- Mencoba konfigurasi VM yang berbeda
- Coba lagi permintaan Anda nanti
Error status permintaan
Saat Anda menggunakan API instance massal untuk membuat VM, permintaan create
akan menampilkan HTTP 200 OK
dengan status RUNNING
jika permintaan berhasil dimulai.
Namun, permintaan mungkin gagal sebelum selesai. Anda dapat memeriksa status permintaan Anda untuk memastikan permintaan berhasil diselesaikan. Jika permintaan tidak berhasil diselesaikan, Anda akan melihat salah satu status permintaan berikut.
Kuota melampaui batas
Jika kolom respons API berikut ada saat Anda melakukan polling operasi, permintaan Anda akan gagal karena Anda telah mencapai batas kuota untuk satu resource. Untuk mengetahui informasi selengkapnya tentang kuota, lihat Kuota resource.
Kolom respons API:
"status": "done"
"httpErrorMessage": "FORBIDDEN"
"code"": "QUOTA_EXCEEDED"
Untuk menyelesaikan masalah ini, lakukan tindakan berikut:
- Lihat kolom `message` untuk mengidentifikasi kuota resource yang terlampaui oleh permintaan.
- Lakukan salah satu tindakan berikut:
- Coba lagi permintaan dengan jumlah VM yang lebih kecil
- Meminta penambahan kuota
Resource sudah ada
Jika kolom respons API berikut ada saat Anda melakukan polling operasi, permintaan Anda akan gagal karena mencoba membuat resource yang sudah ada.
Kolom respons API:
code: RESOURCE_ALREADY_EXISTS
httpErrorMessage: CONFLICT
status: DONE
Untuk menyelesaikan masalah ini, lakukan tindakan berikut:
- Lihat kolom
message
untuk mengidentifikasi nama resource yang sudah ada. - Coba lagi permintaan Anda menggunakan
namePattern
yang berbeda. Untuk mengetahui informasi selengkapnya, baca bagian Membuat beberapa VM di satu region.
Kapasitas tidak mencukupi
Jika kolom respons API berikut ada saat Anda melakukan polling operasi, permintaan Anda akan gagal karena kapasitas region atau zona (jika menggunakan endpoint zona) tempat Anda mencoba membuat VM tidak memadai.
Kolom respons API:
"status": "DONE"
"httpErrorMessage": "SERVICE UNAVAILABLE"
"code": "ZONE_RESOURCE_POOL_EXHAUSTED"
Untuk menyelesaikan masalah ini, lakukan salah satu tindakan berikut:
- Membuat VM di region yang berbeda
- Buat VM di zona yang berbeda jika menggunakan endpoint zona
- Mencoba konfigurasi VM yang berbeda
- Coba lagi permintaan Anda nanti
Apa langkah selanjutnya?
- Untuk mempelajari lebih lanjut cara menggunakan API instance massal, baca artikel Menggunakan API instance massal.