Jika panggilan API ApsaraMQ for MQTT berhasil, respons akan mengembalikan kode status HTTP 200. Jika panggilan gagal, respons mencakup kode status kesalahan HTTP, kode kesalahan, dan pesan deskriptif.
Contoh berikut menunjukkan format respons kesalahan:
{
"RequestId": "07AB2E7F-1EF8-4D08-A423-D58E3A26****",
"HostId": "onsmqtt.cn-hangzhou.aliyuncs.com",
"Code": "InstancePermissionCheckFailed",
"Message": "Terjadi kesalahan saat memvalidasi izin instans. Harap verifikasi akun yang membuat instans dan pengaturan izinnya."
}Gunakan tabel di bawah ini untuk mengidentifikasi penyebab kegagalan permintaan dan cara mengatasinya. Kode kesalahan dikelompokkan berdasarkan jenis resource.
Beberapa kode kesalahan, sepertiInternalErrordanInstancePermissionCheckFailed, muncul pada beberapa jenis resource. Penyebab dan solusinya tetap sama terlepas dari konteksnya.
Kesalahan token
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Penyebab | Solusi |
|---|---|---|---|---|
| 404 | ApiNotSupport | API yang ditentukan tidak didukung. | Operasi API tidak didukung. | Verifikasi nama operasi API dan periksa referensi API untuk operasi yang didukung. |
| 400 | ApplyTokenOverFlow | Anda telah mengajukan permintaan token terlalu sering. Silakan coba lagi nanti. | Permintaan token sedang mengalami pembatasan kecepatan. | Kurangi frekuensi permintaan token dan coba lagi setelah menunggu sebentar. |
| 400 | CheckAccountInfoFailed | Terjadi kesalahan saat memeriksa informasi akun menggunakan token STS. | Informasi akun dalam token Security Token Service (STS) tidak dapat diurai. | Periksa apakah token STS valid dan ulangi permintaan. |
| 400 | InstancePermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin instans. Harap verifikasi akun yang membuat instans dan pengaturan izinnya. | Akun saat ini tidak memiliki izin untuk mengakses instans ApsaraMQ for MQTT ini. | Verifikasi kepemilikan instans dan pastikan izin yang diperlukan telah diberikan dalam kebijakan otorisasi Anda. |
| 500 | InternalError | Terjadi kesalahan saat memproses permintaan Anda. Coba lagi nanti. | Terjadi kesalahan internal layanan. | Ulangi permintaan. Jika kesalahan tetap terjadi, hubungi dukungan Alibaba Cloud. |
| 400 | ParameterCheckFailed | Terjadi kesalahan saat memvalidasi parameter. Parameter mungkin tidak ada atau tidak valid. | Satu atau beberapa parameter yang diperlukan tidak ada atau berisi nilai yang tidak valid. | Periksa referensi API untuk parameter yang diperlukan dan rentang nilai yang valid, lalu perbaiki permintaan Anda. |
| 400 | PermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin resource. Harap periksa akun yang membuat instans, topik, dan GroupId, serta pengaturan izinnya. | Akun saat ini tidak memiliki izin yang diperlukan untuk instans, topik, atau group tersebut. | Tinjau kepemilikan dan kebijakan otorisasi untuk setiap resource yang terlibat dalam permintaan. |
| 500 | SystemOverFlow | Terjadi kesalahan saat memproses permintaan Anda. Silakan coba lagi. | Sistem sedang melakukan pengendalian aliran terhadap permintaan. | Kurangi laju permintaan Anda dan coba lagi setelah menunggu sebentar. |
| 400 | InvalidParameter.%s | Terjadi kesalahan saat memvalidasi parameter. Parameter mungkin tidak ada atau tidak valid. | Parameter yang ditunjukkan oleh %s tidak ada atau tidak valid. | Periksa parameter spesifik yang disebutkan dalam kode kesalahan dan berikan nilai yang valid. |
Kesalahan group
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Penyebab | Solusi |
|---|---|---|---|---|
| 500 | CreateGroupIdError | Gagal membuat GroupId. Coba lagi nanti. | Group tidak dapat dibuat. | Ulangi permintaan. Jika kesalahan tetap terjadi, hubungi dukungan Alibaba Cloud. |
| 400 | GroupIdAlreadyExsited | GroupId yang ditentukan sudah ada. | Group dengan ID ini sudah ada. | Gunakan ID group yang berbeda, atau gunakan group yang sudah ada jika sesuai kebutuhan Anda. |
| 400 | GroupIdAlreadyUsedByOtherUsers | GroupId saat ini digunakan oleh pengguna lain. Harap ganti dengan GroupId yang berbeda. | ID group ini digunakan oleh pengguna lain. | Pilih ID group yang berbeda. |
| 500 | InternalError | Terjadi kesalahan saat memproses permintaan Anda. Coba lagi nanti. | Terjadi kesalahan internal layanan. | Ulangi permintaan. Jika kesalahan tetap terjadi, hubungi dukungan Alibaba Cloud. |
| 400 | ParameterFieldCheckFailed | Gagal memvalidasi parameter. Parameter mungkin tidak ada atau tidak valid. | Satu atau beberapa parameter yang diperlukan tidak ada atau berisi nilai yang tidak valid. | Periksa referensi API untuk nama dan nilai parameter yang valid, lalu perbaiki permintaan Anda. |
| 400 | InstancePermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin instans. Harap verifikasi akun yang membuat instans dan pengaturan izinnya. | Akun saat ini tidak memiliki izin untuk mengakses instans ApsaraMQ for MQTT ini. | Verifikasi kepemilikan instans dan pastikan izin yang diperlukan telah diberikan dalam kebijakan otorisasi Anda. |
| 400 | InstanceNotFound | Gagal menemukan instans. instanceId mungkin tidak valid. | Tidak ada instans yang cocok dengan instanceId yang ditentukan. | Pastikan instans tersebut ada dan nilai instanceId dalam permintaan Anda benar. |
| 400 | PermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin resource. Harap periksa akun yang membuat instans, topik, dan GroupId, serta pengaturan izinnya. | Akun saat ini tidak memiliki izin yang diperlukan untuk instans, topik, atau group tersebut. | Tinjau kepemilikan dan kebijakan otorisasi untuk setiap resource yang terlibat dalam permintaan. |
Kesalahan topik
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Penyebab | Solusi |
|---|---|---|---|---|
| 400 | ParameterFieldCheckFailed | Gagal memvalidasi parameter. Parameter mungkin tidak ada atau tidak valid. | Satu atau beberapa parameter yang diperlukan tidak ada atau berisi nilai yang tidak valid. | Periksa referensi API untuk nama dan nilai parameter yang valid, lalu perbaiki permintaan Anda. |
| 400 | MqttTopicNumExceeded | Jumlah maksimum topik telah terlampaui. | Instans telah mencapai batas jumlah topik. | Hapus topik yang tidak digunakan untuk mengosongkan kuota. |
| 400 | MqttTopicExist | Topik yang ditentukan sudah ada. Harap periksa parameternya. | Topik dengan nama ini sudah ada di instans. | Gunakan nama topik yang berbeda, atau gunakan topik yang sudah ada jika sesuai kebutuhan Anda. |
| 400 | InstanceNotFound | Gagal menemukan instans. instanceId mungkin tidak valid. | Tidak ada instans yang cocok dengan instanceId yang ditentukan. | Pastikan instans tersebut ada dan nilai instanceId dalam permintaan Anda benar. |
| 400 | ResourcePermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin resource. Harap periksa akun yang membuat instans, topik, dan GroupId, serta pengaturan izinnya. | Akun saat ini tidak memiliki izin yang diperlukan untuk resource yang ditentukan. | Tinjau kepemilikan dan kebijakan otorisasi untuk instans, topik, dan group tersebut. |
| 400 | CreateMqttTopicFailed | Terjadi kesalahan saat membuat topik MQTT. Harap periksa parameternya dan coba lagi. | Topik tidak dapat dibuat pada instans ApsaraMQ for MQTT. | Pastikan semua nilai parameter valid, lalu coba lagi. |
| 400 | InstancePermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin instans. Harap verifikasi akun yang membuat instans dan pengaturan izinnya. | Akun saat ini tidak memiliki izin untuk mengakses instans ApsaraMQ for MQTT ini. | Verifikasi kepemilikan instans dan pastikan izin yang diperlukan telah diberikan dalam kebijakan otorisasi Anda. |
| 400 | PermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin resource. Harap periksa akun yang membuat instans, topik, dan GroupId, serta pengaturan izinnya. | Akun saat ini tidak memiliki izin yang diperlukan untuk instans, topik, atau group tersebut. | Tinjau kepemilikan dan kebijakan otorisasi untuk setiap resource yang terlibat dalam permintaan. |
Kesalahan aturan
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Penyebab | Solusi |
|---|---|---|---|---|
| 400 | ParameterFieldCheckFailed | Gagal memvalidasi parameter. Parameter mungkin tidak ada atau tidak valid. | Satu atau beberapa parameter yang diperlukan tidak ada atau berisi nilai yang tidak valid. | Periksa referensi API untuk nama dan nilai parameter yang valid, lalu perbaiki permintaan Anda. |
| 400 | InstancePermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin instans. Harap verifikasi akun yang membuat instans dan pengaturan izinnya. | Akun saat ini tidak memiliki izin untuk mengakses instans ApsaraMQ for MQTT ini. | Verifikasi kepemilikan instans dan pastikan izin yang diperlukan telah diberikan dalam kebijakan otorisasi Anda. |
| 400 | PermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin resource. Harap periksa akun yang membuat instans, topik, dan GroupId, serta pengaturan izinnya. | Akun saat ini tidak memiliki izin yang diperlukan untuk instans, topik, atau group tersebut. | Tinjau kepemilikan dan kebijakan otorisasi untuk setiap resource yang terlibat dalam permintaan. |
| 400 | ResourcePermissionCheckFailed | Terjadi kesalahan saat memvalidasi izin resource. Harap periksa akun yang membuat instans, topik, dan GroupId, serta pengaturan izinnya. | Akun saat ini tidak memiliki izin yang diperlukan untuk resource yang ditentukan. | Tinjau kepemilikan dan kebijakan otorisasi untuk instans, topik, dan group tersebut. |
| 400 | CreateMqttRuleFailed | Terjadi kesalahan saat membuat aturan MQTT. Harap periksa parameternya dan coba lagi. | Aturan tidak dapat dibuat pada instans ApsaraMQ for MQTT. | Pastikan semua nilai parameter valid, lalu coba lagi. |
| 400 | MqttRuleExist | Aturan MQTT yang ditentukan sudah ada. Harap periksa parameternya. | Aturan yang ditentukan sudah ada pada instans. | Gunakan konfigurasi aturan yang berbeda, atau gunakan aturan yang sudah ada jika sesuai kebutuhan Anda. |
| 400 | MqttRuleNumExceeded | Jumlah maksimum aturan telah terlampaui. | Instans telah mencapai batas jumlah aturan. | Hapus aturan yang tidak digunakan untuk mengosongkan kuota. |
| 400 | InstanceNotFound | Gagal menemukan instans. instanceId mungkin tidak valid. | Tidak ada instans yang cocok dengan instanceId yang ditentukan. | Pastikan instans tersebut ada dan nilai instanceId dalam permintaan Anda benar. |
Untuk daftar lengkap kode kesalahan ApsaraMQ for MQTT, lihat Service error codes.