HTTP status codes | Alibaba Cloud - OpenAPI Explorer - Alibaba Cloud Dokümantasyon Merkezi

HTTP durum kodları IETF tarafından RFC 9110'da tanımlanır ve IANA'ya kaydedilir. Alibaba Cloud OpenAPI genel olarak bu standardı takip eder.

Alibaba Cloud OpenAPI'de durum kodu kuralları

Alibaba Cloud OpenAPI, bu konuda açıklanan HTTP durum kodu standardını genel olarak takip eder: 2xx başarılı bir çağrıyı, 4xx geçersiz parametre, kimlik doğrulama hatası, yetersiz izin veya aşılmış kota gibi arayan taraf kaynaklı bir sorunu ve 5xx sunucu tarafı sorunlarını belirtir. Başarısız çağrılar genellikle daha ayrıntılı tanılama için Code ve Message alanlarının yanı sıra çağrıyı benzersiz şekilde tanımlayan bir RequestId da döndürür.

Not

Bir durum kodunun tam anlamsal yapısı ve tetikleme koşulları bulut hizmetine göre değişebilir. Bir OpenAPI işlemi çağırdığınızda söz konusu hizmetin güncel API referansına bakın.

Yapı ve sınıflar

Durum kodu, bir isteğin sonucunu ve yanıtın anlamsal yapısını açıklayan üç basamaklı bir tamsayıdır. Geçerli değerler 100 ile 599 arasında değişir. İlk basamak yanıt sınıfını belirler; son iki basamağın kategorizasyon açısından bir rolü yoktur.

Sınıf	Anlam
1xx (Bilgilendirici)	İstek alındı ve işleme devam ediliyor. Bunlar ara yanıtlardır: tek bir istek, tam olarak bir nihai yanıttan önce sıfır veya daha fazla 1xx yanıtı üretebilir.
2xx (Başarılı)	İstek başarıyla alındı, anlaşıldı ve kabul edildi.
3xx (Yönlendirme)	İsteği tamamlamak için istemci tarafından ek eylem gerekir.
4xx (İstemci Hatası)	İstek hatalı sözdizimine sahiptir veya yerine getirilemez. Hata genellikle arayan taraftadır.
5xx (Sunucu Hatası)	Sunucu görünüşte geçerli olan bir isteği yerine getiremedi. Hata sunucudadır.

Kayıtlı durum kodları

Aşağıdaki tablolar her kodun standart anlamını ve onu tanımlayan belirtimi listeler.

1xx bilgilendirici

1xx yanıtı başlık bölümünün sonunda sonlanır ve içerik veya trailer taşıyamaz. HTTP/1,0 herhangi bir 1xx kodu tanımlamadığından sunucu HTTP/1,0 istemcisine 1xx yanıtı göndermemelidir.

Kod	Standart ad	Anlam	Tanımlandığı yer
100	Continue	İsteğin ilk kısmı alındı ve henüz reddedilmedi; sunucu istek içeriğini kabul etmeye hazırdır. Gövdeyi göndermeye devam edin ve bu ara yanıtı yok sayın.	RFC 9110
101	Switching Protocols	Sunucu Upgrade başlığı aracılığıyla istenen protokol değişikliğini kabul eder ve kendi Upgrade başlığında etkili olacak protokollerin adlarını belirtir.	RFC 9110
102	Processing	WebDAV uzantısı tarafından tanımlanmıştır ve artık kullanımdan kaldırılmıştır. Yeni tasarımlarda bundan kaçının.	RFC 2518
103	Early Hints	Nihai yanıttan önce seçili başlıkları (genellikle Link) döndürerek istemcinin kaynakları önceden yüklemeye başlamasını sağlar.	RFC 8297

2xx başarılı

Kod	Standart ad	Anlam	Tanımlandığı yer
200	OK	İstek başarılı oldu. Yanıt içeriği yönteme bağlıdır: GET hedef kaynağın temsilini döndürür, POST eylemin durumunu veya sonuçlarını döndürür, PUT ve DELETE eylemin durumunu döndürür, OPTIONS ise iletişim seçeneklerini döndürür.	RFC 9110
201	Created	İstek yerine getirildi ve bir veya daha fazla yeni kaynak oluşturuldu. Birincil kaynak Location başlığıyla veya Location başlığı gönderilmediğinde hedef URI ile tanımlanır.	RFC 9110
202	Accepted	İstek işlenmek üzere kabul edildi ancak işleme tamamlanmadı ve nihayetinde reddedilebilir. HTTP, eşzamansız bir işlemden durum kodunu yeniden göndermek için bir olanak sağlamadığından yanıt genellikle sorgulanabilen bir durum kaynağına işaret eder.	RFC 9110
203	Non-Authoritative Information	İstek başarılı oldu ancak dönüştürücü bir proxy içeriği değiştirdi; bu nedenle içerik, köken sunucunun 200 yanıtında döndüreceğinden farklıdır.	RFC 9110
204	No Content	İstek yerine getirildi ve yanıt gövdesinde gönderilecek ek içerik yok. Meta veriler yine de yanıt başlıklarında iletilebilir.	RFC 9110
205	Reset Content	İstek yerine getirildi ve istemci isteğe neden olan belge görünümünü sıfırlamalıdır; örneğin bir formu temizleyerek.	RFC 9110
206	Partial Content	Sunucu bir aralık isteğini yerine getirdi ve hedef kaynağın bir veya daha fazla parçasını döndürdü. Bu durum genellikle sürdürülebilir aktarımlarda ve büyük dosyaların parçalı indirmelerinde görülür.	RFC 9110
207	Multi-Status	WebDAV uzantısı tarafından tanımlanmıştır. Gövde her alt işlem için ayrı bir durum taşır.	RFC 4918
208	Already Reported	WebDAV bağlama uzantısı tarafından tanımlanmıştır. Tek bir yanıt içinde aynı kaynağın tekrar tekrar listelenmesini önler.	RFC 5842
226	IM Used	Sunucu hedef kaynağa bir veya daha fazla delta kodlaması uyguladı ve tam kaynak yerine deltayı döndürdü.	RFC 3229

3xx yönlendirme

301, 302, 307 ve 308 kodları kaynağı başka bir URI'ye yerleştirir. Taşımanın kalıcı olup olmadığı ve istek yönteminin değişip değişemeyeceği konusunda farklılık gösterirler. Tarihsel nedenlerle 301 ve 302'yi işleyen istemciler POST'u GET olarak yeniden yazabilir. Yöntemin korunması gerektiğinde bunun yerine 308 ve 307 kullanın.

Kod	Standart ad	Anlam	Tanımlandığı yer
300	Multiple Choices	Hedef kaynağın birden fazla temsili vardır ve istemci veya kullanıcı bunlardan birini seçmelidir.	RFC 9110
301	Moved Permanently	Hedef kaynağa yeni bir kalıcı URI atandı ve gelecekteki başvurular bunu kullanmalıdır. Sunucu yeni URI'yi Location başlığında göndermelidir.	RFC 9110
302	Found	Hedef kaynak geçici olarak farklı bir URI'de bulunur. Yönlendirme değişebileceğinden gelecekteki istekler için özgün URI'yi kullanmaya devam edin.	RFC 9110
303	See Other	Sunucu istemciyi isteği dolaylı olarak yanıtlamak için başka bir kaynağa yönlendirir. Location başlığındaki URI'ye karşı bir GET veya HEAD isteği yayınlayın ve bu sonucu yanıt olarak sunun. Yeni URI hedef URI ile eşdeğer değildir.	RFC 9110
304	Not Modified	Koşullu GET veya HEAD üzerindeki bir ön koşul yanlış olarak değerlendirildi; bu, istemcinin zaten geçerli bir temsile sahip olduğu anlamına gelir. Sunucu yeniden iletimi atlar ve istemci önbelleğe alınmış kopyasını kullanabilir. Yanıt içerik taşıyamaz.	RFC 9110
305	Use Proxy	Kullanımdan kaldırıldı. Yeni uygulamalarda kullanmayın.	RFC 9110
306	(Unused)	Belirtimin önceki bir sürümünde tanımlanmış, artık kullanılmamakta ve ayrılmıştır.	RFC 9110
307	Temporary Redirect	Hedef kaynak geçici olarak farklı bir URI'de bulunur ve istemci yönlendirmeyi otomatik olarak izlerken istek yöntemini değiştirmemelidir.	RFC 9110
308	Permanent Redirect	301 ile aynı anlamsal yapıyı taşır ancak istemcinin istek yöntemini korumasını gerektirir. Eş kodlarından daha sonra, 2014'te tanımlandığı için bazı eski uygulamalar bunu tanımayabilir.	RFC 9110

4xx istemci hatası

HEAD'e yanıt verirken hariç olmak üzere sunucu hatayı yanıt gövdesinde açıklamalı ve durumun geçici mi yoksa kalıcı mı olduğunu belirtmelidir. Bu kodlar herhangi bir istek yöntemi için geçerlidir.

Kod	Standart ad	Anlam	Tanımlandığı yer
400	Bad Request	Sunucu algılanan bir istemci hatası (örneğin hatalı sözdizimi, geçersiz mesaj çerçeveleme veya yanıltıcı yönlendirme) nedeniyle isteği işlemez.	RFC 9110
401	Unauthorized	İstek hedef kaynak için geçerli kimlik doğrulama kimlik bilgilerini içermiyor. Sunucu geçerli bir meydan okumayı adlandıran bir WWW-Authenticate başlığı göndermelidir. Kimlik bilgileri sağlanmışsa bunlar reddedilmiştir.	RFC 9110
402	Payment Required	Gelecekteki kullanım için ayrılmıştır.	RFC 9110
403	Forbidden	Sunucu isteği anladı ancak yerine getirmeyi reddediyor. Kimlik bilgileri sağlandıysa sunucu bunları yetersiz görür ve istemci aynı kimlik bilgileriyle otomatik olarak yeniden denememelidir.	RFC 9110
404	Not Found	Köken sunucu hedef kaynağın güncel bir temsilini bulamadı veya var olduğunu ifşa etmek istemedi.	RFC 9110
405	Method Not Allowed	Hedef kaynak istek yöntemini desteklemiyor. Sunucu desteklenen yöntemleri listeleyen bir Allow başlığı göndermelidir.	RFC 9110
406	Not Acceptable	Hedef kaynağın istekteki içerik anlaşması başlıklarını karşılayan hiçbir temsili yok.	RFC 9110
407	Proxy Authentication Required	401'e benzer ancak istemci köken sunucu yerine proxy ile kimlik doğrulaması yapmalıdır.	RFC 9110
408	Request Timeout	Sunucu beklemeye hazır olduğu süre içinde eksiksiz bir istek almadı.	RFC 9110
409	Conflict	İstek hedef kaynağın mevcut durumuyla çakışıyor.	RFC 9110
410	Gone	Hedef kaynak artık köken sunucuda mevcut değil ve durum muhtemelen kalıcıdır.	RFC 9110
411	Length Required	Sunucu istekte bir Content-Length başlığı gerektirir.	RFC 9110
412	Precondition Failed	İstek başlıklarındaki bir veya daha fazla ön koşul sunucuda yanlış olarak değerlendirildi.	RFC 9110
413	Content Too Large	İstek gövdesi sunucunun işlemeye istekli veya yetenekli olduğundan daha büyüktür.	RFC 9110
414	URI Too Long	İstek hedef URI'si sunucunun yorumlamak istediğinden daha uzundur.	RFC 9110
415	Unsupported Media Type	Hedef kaynak istek gövdesinin içerik biçimini desteklemiyor.	RFC 9110
416	Range Not Satisfiable	Range başlığındaki aralıklar kaynağın mevcut yayılımıyla örtüşmüyor veya aralık kümesi başka şekilde geçersiz.	RFC 9110
417	Expectation Failed	Expect başlığındaki beklenti sunucu tarafından karşılanamadı.	RFC 9110
418	(Unused)	Daha önce resmi olmayan bir protokol taslağı tarafından kullanılmıştı. Ayrılmıştır ve yeni anlamsal yapılar atanamaz.	RFC 9110
421	Misdirected Request	İstek hedef URI için yetkili bir yanıt üretemeyen bir sunucuya yönlendirildi.	RFC 9110
422	Unprocessable Content	İstek gövdesinin medya türü ve sözdizimi anlaşıldı ancak içerdiği anlamsal talimatlar işlenemiyor.	RFC 9110
423	Locked	WebDAV uzantısı tarafından tanımlanmıştır. Hedef kaynak kilitlidir.	RFC 4918
424	Failed Dependency	WebDAV uzantısı tarafından tanımlanmıştır. Bu isteğin bağlı olduğu bir eylem başarısız oldu.	RFC 4918
425	Too Early	Sunucu TLS erken verilerinde yeniden oynatılan bir isteği işlemek istemiyor. El sıkışma tamamlandıktan sonra yeniden deneyin.	RFC 8470
426	Upgrade Required	Sunucu mevcut protokol üzerinden isteği reddeder ancak istemci yükseltme yaptıktan sonra kabul edebilir. Yanıt bir Upgrade başlığı içermelidir.	RFC 9110
428	Precondition Required	Sunucu isteğin koşullu olmasını gerektirir; bu, eşzamanlı güncellemelerin birbirinin üzerine yazmasını önler.	RFC 6585
429	Too Many Requests	İstemci belirli bir dönemde hız sınırının izin verdiğinden daha fazla istek gönderdi. Yanıt önerilen bekleme süresiyle birlikte bir Retry-After başlığı taşıyabilir.	RFC 6585
431	Request Header Fields Too Large	Tek bir başlık alanı veya başlık bölümünün tamamı sunucunun işleyeceği boyutu aşıyor.	RFC 6585
451	Unavailable For Legal Reasons	Sunucu yasal bir talebe yanıt olarak kaynağa erişimi reddediyor.	RFC 7725

5xx sunucu hatası

Kod	Standart ad	Anlam	Tanımlandığı yer
500	Internal Server Error	Sunucu isteği yerine getirmesini engelleyen beklenmedik bir durumla karşılaştı.	RFC 9110
501	Not Implemented	Sunucu isteği yerine getirmek için gereken işlevselliği desteklemiyor; genellikle yöntemi tanımadığı için.	RFC 9110
502	Bad Gateway	Ağ geçidi veya proxy olarak çalışan bir sunucu yukarı akış sunucusundan geçersiz bir yanıt aldı.	RFC 9110
503	Service Unavailable	Sunucu geçici aşırı yük veya planlı bakım nedeniyle isteği işleyemiyor. Durum geçicidir ve yanıt bir Retry-After başlığı taşıyabilir.	RFC 9110
504	Gateway Timeout	Ağ geçidi veya proxy olarak çalışan bir sunucu yukarı akış sunucusundan zamanında yanıt almadı.	RFC 9110
505	HTTP Version Not Supported	Sunucu istekte kullanılan ana HTTP sürümünü desteklemiyor veya desteklemeyi reddediyor.	RFC 9110
506	Variant Also Negotiates	Şeffaf içerik anlaşması uzantısı tarafından tanımlanmıştır. Sunucudaki dahili bir yapılandırma hatasını belirtir.	RFC 2295
507	Insufficient Storage	WebDAV uzantısı tarafından tanımlanmıştır. Sunucu isteği tamamlamak için yeterli depolama ayıramıyor.	RFC 4918
508	Loop Detected	WebDAV bağlama uzantısı tarafından tanımlanmıştır. Sunucu isteği işlerken sonsuz bir döngü algıladı.	RFC 5842
510	Not Extended	Orijinal tanım kullanımdan kaldırıldı. Kod kayıtlı durumda kalır ancak anlamsal yapısı artık geçerli değildir.	RFC 2774
511	Network Authentication Required	İstemci ağ erişimi elde etmek için kimlik doğrulaması yapmalıdır; örneğin genel bir Wi-Fi ağının captive portalında.	RFC 6585

OpenAPI Explorer:HTTP status codes