全部产品
Search

搜索本产品

    Object Storage Service：Tanggapan Kesalahan

    文档中心

    Object Storage Service：Tanggapan Kesalahan

    更新时间：Sep 27, 2025

    Ketika permintaan ke Object Storage Service (OSS) gagal, layanan mengembalikan tanggapan kesalahan yang mencakup kode status HTTP standar, kode kesalahan spesifik layanan (EC), dan badan XML terperinci. Topik ini menjelaskan struktur tanggapan kesalahan OSS serta strategi untuk memecahkan masalah umum.

    Proses pemecahan masalah mandiri

    Langkah 1: Identifikasi Informasi Kunci

    Tanggapan kesalahan biasanya berisi informasi penting untuk mendiagnosis masalah. Pertama, periksa bidang Message untuk deskripsi kesalahan. Kemudian, tinjau bidang-bidang kunci berikut untuk menyelesaikan masalah. Berikut adalah contoh tanggapan kesalahan:

    HTTP/1.1 400 Bad Request
Server: AliyunOSS
Date: Thu, 11 Aug 2019 01:44:54 GMT
Content-Type: application/xml
Content-Length: 322
Connection: keep-alive
x-oss-request-id: 57ABD896CCB80C366955****
x-oss-server-time: 0
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>MissingArgument</Code>
  <Message>Missing Some Required Arguments.</Message>
  <RequestId>57ABD896CCB80C366955****</RequestId>
  <HostId>oss-example.oss-cn-hangzhou.aliyuncs.com</HostId> 
  <EC>0016-00000502</EC> 
  <RecommendDoc>https://api.aliyun.com/troubleshoot?q=0016-00000502</RecommendDoc>
</Error>

    • RecommendDoc (Direkomendasikan): Tautan langsung ke panduan pemecahan masalah resmi untuk kesalahan tertentu.

    • EC: Kode kesalahan detail halus yang sesuai dengan penyebab spesifik dari kesalahan.

    • Kode Status HTTP (seperti 400 Bad Request): Status umum dari permintaan. Anda dapat menggunakan kode ini untuk menentukan sifat umum kesalahan (di sisi klien atau server).

    • RequestId (Diperlukan untuk Dukungan): ID unik dari permintaan. Anda harus menyediakan ID ini ketika menghubungi dukungan teknis.

    Langkah 2: Temukan Solusi

    Gunakan salah satu metode berikut untuk menemukan solusi:

    1. Akses Tautan RecommendDoc

      • Buka tautan RecommendDoc yang disediakan dalam tanggapan kesalahan.

    2. Periksa Daftar Kode Kesalahan EC

      • Jika tanggapan tidak berisi tautan RecommendDoc, cari EC dalam daftar kode kesalahan.

    Jika masalah tetap ada, hubungi dukungan teknis dengan informasi yang diperlukan.

    Untuk mempercepat pemecahan masalah, selalu sediakan ID permintaan lengkap saat menghubungi dukungan. Untuk informasi lebih lanjut, lihat Memperoleh ID Permintaan.

    Struktur tanggapan kesalahan

    Header tanggapan kesalahan

    Header respons

    Deskripsi

    x-oss-ec

    Kode kesalahan detail halus spesifik OSS. Setiap kondisi kesalahan dipetakan ke EC unik. Berbeda dengan elemen Code serbaguna, EC mengidentifikasi penyebab kesalahan dengan lebih tepat, membantu Anda menemukan solusi lebih cepat.

    Penting

    Bidang EC hanya untuk tujuan diagnostik. Nilainya dapat berubah tanpa pemberitahuan, dan kompatibilitas mundur tidak dijamin. Jangan bangun logika aplikasi yang bergantung pada nilai EC tertentu.

    x-oss-request-id

    ID unik dari permintaan. Sediakan ID ini saat menghubungi dukungan teknis.

    Contoh Header Respons

    HTTP/1.1 403 Forbidden
Server: AliyunOSS
Date: Wed, 09 Nov 2022 08:45:46 GMT
Content-Type: application/xml
Content-Length: 471
Connection: keep-alive
x-oss-request-id: 636B68BA80DA8539399F****
x-oss-server-time: 0
x-oss-ec: 0003-00000001

    Untuk informasi lebih lanjut, lihat Header Respons Umum.

    Badan tanggapan kesalahan

    Elemen

    Deskripsi

    Code

    Kode kesalahan serbaguna yang ditentukan oleh OSS.

    Message

    Deskripsi rinci tentang kesalahan.

    RequestId

    ID unik dari permintaan. Sediakan ID permintaan ini saat Anda menghubungi dukungan teknis untuk memecahkan masalah dan menyelesaikan masalah.

    HostId

    Mengidentifikasi kluster OSS yang menangani permintaan, yang sesuai dengan host yang ditentukan dalam permintaan.

    EC

    Kode kesalahan detail halus, yang sama dengan x-oss-ec dalam header respons.

    RecommendDoc

    Tautan ke panduan pemecahan masalah interaktif di OpenAPI Explorer untuk kesalahan tertentu. Mengikuti tautan ini adalah langkah pertama yang direkomendasikan untuk pemecahan masalah.

    Contoh badan respons

    <?xml version="1.0" ?>
<Error xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
  <Code>MalformedXML</Code>
  <Message>The XML you provided was not well-formed or did not validate against our published schema.</Message>
  <RequestId>57ABD896CCB80C366955****</RequestId>
  <HostId>oss-cn-hangzhou.aliyuncs.com</HostId>
  <EC>0031-00000001</EC>
  <RecommendDoc>https://api.aliyun.com/troubleshoot?q=0031-00000001</RecommendDoc>
</Error>

    Referensi