Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:Error responses

Son Güncelleme:Oct 01, 2026

Bir OSS isteği başarısız olduğunda hizmet; HTTP durum kodu, hizmete özel bir hata kodu (EC) ve sorunu açıklayan bir XML gövdesi içeren bir hata yanıtı döndürür.

Kendi kendine sorun giderme süreci

1. Adım: Anahtar bilgileri bulun

Tipik bir hata yanıtı, sorunu teşhis etmek için gereken alanları içerir. Önce Message alanını kontrol edin, ardından aşağıdaki alanları inceleyin. Örnek:

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.alibabacloud.com/troubleshoot?q=0016-00000502</RecommendDoc>
</Error>
  • RecommendDoc (önerilen): Belirli hatayla ilgili resmi sorun giderme kılavuzuna doğrudan bağlantı.

  • EC: Hatanın belirli bir nedenine karşılık gelen ayrıntılı hata kodu.

  • HTTP status code (örneğin 400 Bad Request): Hatanın istemci kaynaklı mı yoksa sunucu kaynaklı mı olduğunu gösterir.

  • RequestId (destek için gerekli): İsteğin benzersiz kimliği. Teknik destekle iletişime geçtiğinizde bu kimliği sağlamanız gerekir.

2. Adım: Çözümü bulun

Çözüm bulmak için aşağıdaki yöntemlerden birini kullanın:

  1. RecommendDoc bağlantısına erişin

    • Hata yanıtında sağlanan RecommendDoc bağlantısına gidin.

  2. EC hata kodu listesini kontrol edin

    • Yanıt bir RecommendDoc bağlantısı içermiyorsa hata kodu listesinde EC değerini arayın.

Sorun devam ederse gerekli bilgilerle teknik destekle iletişime geçin.

Sorun gidermeyi hızlandırmak için destek ekibiyle iletişime geçtiğinizde her zaman tam istek kimliğini sağlayın. Daha fazla bilgi için bkz. İstek kimliği alma.

Hata yanıtı yapısı

Hata yanıtı üstbilgileri

Yanıt üstbilgisi

Açıklama

x-oss-ec

Her hata durumu için benzersiz olan ayrıntılı hata kodu. Genel amaçlı Code öğesinden daha hassastır ve kök nedenleri daha hızlı belirlemenize yardımcı olur.

Önemli

EC alanı yalnızca tanılama amaçlıdır. Değeri önceden haber verilmeksizin değişebilir ve geriye dönük uyumluluk garanti edilmez. Belirli EC değerlerine dayanan uygulama mantığı oluşturmayın.

x-oss-request-id

İsteğin benzersiz kimliği. Teknik destekle iletişime geçtiğinizde bu kimliği sağlayın.

Yanıt üstbilgileri örneği

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

Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Hata yanıtı gövdesi


Öğe


Açıklama


Code


OSS tarafından tanımlanan genel amaçlı hata kodu.


Message


Hatanın ayrıntılı açıklaması.


RequestId


İsteğin benzersiz kimliği. Teknik destekle iletişime geçtiğinizde bu kimliği sağlayın.


HostId


EC


Yanıt üstbilgisindeki x-oss-ec ile aynı olan ayrıntılı hata kodu.


RecommendDoc


OpenAPI Explorer'daki etkileşimli sorun giderme kılavuzuna bağlantı. İlk sorun giderme adımı olarak önerilir.

Yanıt gövdesi örneği

<?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.alibabacloud.com/troubleshoot?q=0031-00000001</RecommendDoc>
</Error>

Başvurular