Azure Cosmos DB için HTTP Durum Kodları

  • Makale

Bu makalede REST işlemleri tarafından döndürülen HTTP durum kodları sağlanır.

Kod Açıklama
200 Tamam Aşağıdaki REST işlemlerinden biri başarılı oldu:

- GET bir kaynakta.
- PUT bir kaynakta.
- POST bir kaynakta.
- POST saklı yordamı yürütmek için saklı yordam kaynağında.
201 Oluşturuldu Kaynak oluşturmaya yönelik POST işlemi başarılı oldu.
204 İçerik yok DELETE işlemi başarılı.
400 Hatalı istek İstek gövdesindeki JSON, SQL veya JavaScript geçersiz.

Buna ek olarak, kaynağın gerekli özellikleri mevcut olmadığında veya KAYNAĞın gövdesinde POST veya PUT olarak ayarlanmadığında da 400 döndürülebilir.

400, bir GET işleminin tutarlı düzeyi hesap için bir kümeden daha güçlü bir tutarlılık tarafından geçersiz kılındığında da döndürülür.

x-ms-documentdb-partitionkey gerektiren bir istek bunu içermediğinde de 400 döndürülür.
401 Yetkisiz Üst bilgi istenen kaynak için geçersiz olduğunda Authorization 401 döndürülür.
403 Yasak Yetkilendirme belirtecinin süresi doldu.

Kaynak kotasına ulaşıldığında kaynak oluşturmak için bir POST işlem sırasında 403 kodu da döndürülür. Sağlanan depolama alanına ulaşmış bir koleksiyona belge eklemeye çalıştığınızda bu senaryoya örnek olarak verilmiştir.

Ayrıca saklı yordam, tetikleyici veya UDF yüksek kaynak kullanımı için işaretlendiğinde ve yürütülmesi engellendiğinde de 403 döndürülebilir.

Azure Cosmos DB hesabınızda yapılandırılmış güvenlik duvarı kuralları isteğinizi engellediğinde 403 yasak hatası döndürülür. İzin verilenler listesinin dışındaki makinelerden kaynaklanan tüm istekler 403 yanıtı alır.

403.3 – El ile yük devretme işlemi sırasında yazma istekleri için bu durum kodu döndürülür. Bu durum kodu, yazma isteklerini yeni bir yazma bölgesine iletmek için sürücüler tarafından yeniden yönlendirme kodu olarak kullanılır. Direct REST istemcisi geçerli yazma bölgesini belirlemek ve yazma isteğini bu uç noktaya iletmek için DatabaseAccount üzerinde GET işlemi gerçekleştirmelidir.
404 Bulunamadı İşlem, artık var olmayan bir kaynak üzerinde işlem yapmaya çalışır. Örneğin, kaynak zaten silinmiş olabilir.
408 İstek zaman aşımı İşlem ayrılan süre içinde tamamlanmadı. Saklı yordam, tetikleyici veya UDF (sorgu içinde) yürütmeyi en uzun yürütme süresi içinde tamamlamadığında bu kod döndürülür.
409 Çakışma PUT veya POST işlemindeki bir kaynak için sağlanan kimlik, mevcut bir kaynak tarafından alınmış. Bu sorunu çözmek için kaynakta başka bir kimlik kullanın. Bölümlenmiş koleksiyonlar için, aynı bölüm anahtarına sahip tüm belgelerde kimliğin benzersiz olması gerekir.
412 Önkoşul hatası İşlem, sunucudaki kullanılabilir sürümden farklı bir eTag, yani iyimser bir eşzamanlılık hatası belirtti. Kaynağın en son sürümünü okuyup istekteki eTag’i güncelleştirdikten sonra isteği yeniden deneyin.
413 Varlık çok büyük İstekteki belge boyutu, istek için izin verilen belge boyutunu aştı. İzin verilen en büyük belge boyutu 2 MB’tır.
423 Kilitli Devam eden başka bir ölçeklendirme işlemi olduğundan aktarım hızı ölçeklendirme işlemi gerçekleştirilemiyor.
424 Başarısız bağımlılık TransactionalBatch işleminin işlem kapsamında bir belge işlemi başarısız olduğunda, toplu işte yer alan diğer tüm işlemlerde bağımlılıklar başarısız olarak kabul edilir. Bu durum kodu, geçerli işlemin işlem kapsamındaki başka bir hata nedeniyle başarısız olduğunu belirtir.
429 Çok fazla istek var Koleksiyon sağlanan aktarım hızı sınırını aştı. Sunucunun belirttiği yeniden deneme süresinden sonra isteği yeniden deneyin. Daha fazla bilgi için bkz. istek birimleri.
449 Yeniden Dene İşlem geçici bir hatayla karşılaştı. Bu kod yalnızca yazma işlemlerinde oluşur. İşlemi yeniden denemek güvenlidir.
500 İç Sunucu Hatası İşlem beklenmeyen bir hizmet hatası nedeniyle başarısız oldu. Desteğe başvurun. Bkz. Azure desteği sorunu bildirme.
503 Hizmet Kullanılamıyor Hizmet kullanılamadığından işlem tamamlanamadı. Bu durum ağ bağlantısı veya hizmet kullanılabilirliği sorunları nedeniyle oluşabilir. İşlemi yeniden denemek güvenlidir. Sorun devam ederse, destek ekibine başvurun.

HTTP alt durum kodları

Azure Cosmos DB'de Customer-Managed Anahtarları (CMK) kullanırken herhangi bir hata varsa Azure Cosmos DB, yanıtta bir HTTP alt durum koduyla birlikte hata ayrıntılarını döndürür. Sorunun kök nedeninin hatalarını ayıklamak için bu alt durum kodunu kullanabilirsiniz. Şu anda Azure Cosmos DB aşağıdaki alt durum kodlarını destekler:

Sunucu tarafı sorunları için alt durum kodları

Aşağıdaki alt durum kodları, sunucu tarafı sorunları için Azure Cosmos DB tarafından desteklenir:

Alt durum kodu Açıklama
4000 (Azure AD belirteci alınamadı/erişemedi) Azure Cosmos DB, Azure Active Directory (Azure AD) erişim belirtecini alamıyorsa bu hata oluşur. Azure Cosmos DB'nin Key Vault erişebilmesi için bu belirteç gereklidir. Hata bir ağ sorunu veya veri merkezi sorunu nedeniyle oluşabilir ve bu kullanıcının eylem gerçekleştirebileceği bir sorun değildir. Sorunu çözmek için Azure Cosmos DB ekibine ulaşmak için bir destek isteği oluşturun.
4001 (Azure AD hizmet kullanılamıyor) bu hata, Azure AD hizmeti kapalıysa veya sorunlarla karşılanıyorsa oluşur. Mevcut kesinti olup olmadığını doğrulamak için Azure kesinti panosunu denetleyebilirsiniz. Bu kesintiler genellikle birkaç saat içinde çözülür. En iyisi Azure AD ekibine başvurarak gördüğünüz sorunu onlara bildirmenizdir. Azure AD ekibi herhangi bir sorun olmadığını bulursa çözüm için Azure Cosmos DB ekibine ulaşmak için bir destek isteği oluşturun.
4004 (Key Vault hizmet kullanılamıyor) Azure Cosmos DB Key Vault erişmeye çalışırsa ancak hizmet kullanılamıyorsa bu hata oluşur. Bunun nedeni ağ sorununun Key Vault ulaşması veya hizmetin kendisi kapalı olması olabilir. Mevcut kesinti olup olmadığını doğrulamak için Azure kesinti panosunu denetleyebilirsiniz. Bu kesintiler genellikle birkaç saat içinde çözülür. En iyisi, Key Vault ekibiyle iletişime geçerek gördüğünüz sorunu onlara bildirmektir. Key Vault ekibi herhangi bir sorun olmadığını bulursa çözüm için Azure Cosmos DB ekibine ulaşmak için bir destek isteği oluşturun.
4007 (İç sunucu hatası) Bu bir iç sunucu hatasıdır ve giriş baytları base64 biçiminde değilse oluşur.
4008 (Key Vault iç hizmet hataları) Azure Cosmos DB Key Vault erişemezse bu hata oluşur. Bunun nedeni bir ağ sorunu veya Key Vault hizmetinin kapalı olması olabilir. Mevcut kesinti olup olmadığını doğrulamak için Azure kesinti panosunu denetleyebilirsiniz. Bu kesintiler genellikle birkaç saat içinde çözülür. En iyisi, Key Vault ekibiyle iletişime geçerek gördüğünüz sorunu onlara bildirmektir. Key Vault ekibi herhangi bir sorun olmadığını bulursa çözüm için Azure Cosmos DB ekibine ulaşın.
1013 (Koleksiyon oluşturma işlemi devam ediyor) Koleksiyon oluştururken zaman aşımı özel durumuyla karşılaşırsanız, koleksiyonun başarıyla oluşturulup oluşturulmadığını doğrulamak için bir okuma işlemi yapın. Koleksiyon oluşturma işlemi başarılı olana kadar okuma işlemi bir özel durum oluşturur. Okuma işlemi, durum kodu 404 ve alt durum kodu 1013 olan bir özel durum oluşturursa, koleksiyon oluşturma işleminin devam etmekte olduğu anlamına gelir. 200 veya 201 durum kodlarını alıncaya kadar okuma işlemini yeniden deneyin; bu kodlar koleksiyonun başarıyla oluşturulduğunu size bildirir.

Son kullanıcı sorunları için alt durum kodları

Aşağıdaki alt durum kodları, son kullanıcının neden olduğu sorunlar için Azure Cosmos DB tarafından desteklenir:

Alt durum kodu Açıklama
4002 (Key Vault Azure AD izin vermez veya anahtar devre dışı bırakılır) Azure Cosmos DB kimliğini Key Vault erişim ilkelerinden kaldırdıysanız veya anahtarı devre dışı bırakmışsanız bu sorun oluşur. Bu sorun genellikle son kullanıcıdan kaynaklanır. Bu hata oluşursa Azure Cosmos DB'nin Key Vault erişimi olduğundan ve anahtarın etkinleştirildiğinden emin olun.
4003 (Anahtar bulunamadı) Anahtar Key Vault silinirse bu sorun oluşur. Bu sorun genellikle son kullanıcıdan kaynaklanır. Azure Cosmos DB'yi müşteri tarafından yönetilen anahtarlarla kullanmanın önkoşullarından biri, Key Vault geçici silme ve temizleme korumasının etkinleştirilmesidir. Bu, silinen anahtarı kurtarabileceğiniz ve Azure Cosmos DB'ye erişimi geri yükleyebileceğiniz anlamına gelir.
4005 (Anahtar sarmalanamıyor veya açılamıyor) Key Vault anahtarı sarmalayamıyor veya açamıyorsa bu hata oluşur. Bu sorun genellikle son kullanıcıdan kaynaklanır. Bu hatanın olası nedenlerinden biri, anahtarı döndürdüğünüz için Key Vault en son anahtarı kullanarak şifrelenmiş blobun kodunu çözememiş olmasıdır. Bu hatayı çözmek için yakın zamanda devre dışı bırakılan anahtarları etkinleştirin; yaklaşık bir saat içinde çözülecektir. Sorun 2 saatten uzun bir süre sonra çözülmezse, sorunu Azure Cosmos DB'ye geçirin.
4006 (Anahtar URL'si geçersiz) Anahtar sürümü Key Vault URL'sine eklediyseniz, sağlama sırasında bu hata oluşur. Bu hata genellikle son kullanıcıdan kaynaklanır. Bu hatayı düzeltmek için sürümü kaldırın ve yeniden deneyin. Örneğin, URL'yi biçiminde https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>kullandıysanız olarak güncelleştirin https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (Key Vault DNS adı çözümlenemiyor) Yanlış Key Vault adı kullandığınız için Key Vault DNS adı çözümlenemediğinde bu hata oluşur. Bu hataya son kullanıcı neden olur. Sorunu çözmek için Key Vault adını düzeltin ve yeniden deneyin.

Ayrıca bkz.