Aracılığıyla paylaş


Toplu İş Durumu ve Hata Kodları

Batch hizmeti için REST API işlemleri, HTTP/1.1 Durum Kodu Tanımlarında tanımlandığı gibi standart HTTP durum kodları döndürür.

API işlemleri, geliştiriciye hata hakkında daha fazla bilgi sağlamak için ek hata bilgileri de döndürebilir. Örneğin, aşağıdaki hata yanıtı istek URI'sinde belirtilen sorgu parametresinin geçersiz olduğunu gösterir ve geçersiz parametrenin adı ve değeri ile hatanın nedeni hakkında ek bilgi sağlar.

{
  "code": "InvalidQueryParameterValue",
  "message": {
      "lang": "en-us",
      "value": "Value for one of the query parameters specified in the request URI is invalid"
  },
  "values": [{
      "key": "QueryParameterName",
      "value": "state"
  }, {
      "key": "QueryParameterValue",
      "value": "deleted"
  }, {
      "key": "Reason",
      "value": "invalid state"
  }]
}

Aşağıdaki bölümlerde Batch hizmeti için hata kodlarının listeleri sağlanır:

Ortak REST API Hata Kodları

Aşağıdaki tabloda listelenen hata kodları Batch hizmetindeki bir işlem tarafından döndürülebilir.

Hata kodu HTTP durum kodu Kullanıcı iletisi
ConditionNotMet Değiştirilmedi (304) Koşullu üst bilgilerde belirtilen koşul okuma işlemi için karşılanmadı.
MissingRequiredHeader Hatalı İstek (400) Gerekli bir HTTP üst bilgisi belirtilmedi.
MissingRequiredProperty Hatalı İstek (400) İstek gövdesinde gerekli bir özellik belirtilmedi.
UnsupportedHeader Hatalı İstek (400) İstekte belirtilen HTTP üst bilgilerinden biri desteklenmiyor.
UnsupportedProperty Hatalı İstek (400) İstek gövdesinde belirtilen özelliklerden biri desteklenmiyor.
InvalidHeaderValue Hatalı İstek (400) HTTP üst bilgilerinden biri için sağlanan değer doğru biçimde değildi.
InvalidPropertyValue Hatalı İstek (400) İstek gövdesindeki özelliklerden biri için sağlanan değer geçersiz.
MissingRequiredQueryParameter Hatalı İstek (400) Bu istek için gerekli bir sorgu parametresi belirtilmedi.
UnsupportedQueryParameter Hatalı İstek (400) İstek URI'sinde belirtilen sorgu parametrelerinden biri desteklenmiyor.
InvalidQueryParameterValue Hatalı İstek (400) İstek URI'sindeki sorgu parametrelerinden biri için geçersiz bir değer belirtildi.
OutOfRangeQueryParameterValue Hatalı İstek (400) İstek URI'sinde belirtilen sorgu parametresi izin verilen aralığın dışında.
RequestUrlFailedToParse Hatalı İstek (400) İstekteki URL ayrıştırılamadı.
InvalidUri Hatalı İstek (400) İstenen URI sunucudaki herhangi bir kaynağı temsil etmiyor.
GeçersizHttpVerb Hatalı İstek (400) Belirtilen HTTP fiili sunucu tarafından tanınmadı.
EmptyMetadataKey Hatalı İstek (400) Meta veri anahtar-değer çiftlerinden birinin anahtarı boş.
InvalidRequestBody Hatalı İstek (400) Belirtilen İstek Gövdesi, bozulmadan geçerli değil.
OutOfRangeInput Hatalı İstek (400) İstek girişlerinden biri aralık dışında.
InvalidAuthenticationInfo Hatalı İstek (400) Kimlik doğrulama bilgileri doğru biçimde sağlanmadı. Yetkilendirme üst bilgisinin değerini doğrulayın.
InvalidInput Hatalı İstek (400) İstek girişlerinden biri geçerli değil.
InvalidMetadata Hatalı İstek (400) Belirtilen meta veriler geçersiz. İzin verilmeyen karakterler içerir.
MetadataTooLarge Hatalı İstek (400) Belirtilen meta verilerin boyutu izin verilen en büyük boyutu aşıyor.
MultipleConditionHeadersNotSupported Hatalı İstek (400) Birden çok koşul üst bilgisi desteklenmez.
AuthenticationFailed Yasak (403) Sunucu isteğin kimliğini doğrulayamadı. Yetkilendirme üst bilgisi değerinin doğru oluşturulduğunu ve imzayı içerdiğini doğrulayın.
InsufficientAccountPermissions Yasak (403) Erişilen hesabın bu işlemi yürütmek için yeterli izinleri yok.
AccountIsDisabled Yasak (403) Belirtilen hesap devre dışı bırakıldı.
ResourceNotFound Bulunamadı (404) Belirtilen kaynak yok.
DesteklenmeyenHttpVerb Yönteme İzin Verilmiyor (405) Kaynak belirtilen HTTP fiilini desteklemiyor.
MissingContentLengthHeader Uzunluk Gerekli (411) content-length üst bilgisi belirtilmedi.
ConditionNotMet Önkoşul Başarısız Oldu (412) Koşullu üst bilgilerde belirtilen koşul yazma işlemi için karşılanmadı.
RequestBodyTooLarge İstek Varlığı Çok Büyük (413) İstek gövdesinin boyutu izin verilen boyut üst sınırını aşıyor.
InvalidRange İstenen Aralık Satisfiable Değil (416) Belirtilen aralık, kaynağın geçerli boyutu için geçersiz.
InternalError İç Sunucu Hatası (500) Sunucu bir iç hatayla karşılaştı. Lütfen isteği yeniden deneyin.
OperationTimedOut İç Sunucu Hatası (500) İşlem izin verilen süre içinde tamamlanamadı.
ServerBusy Hizmet Kullanılamıyor (503) Sunucu şu anda istekleri alamıyor. Lütfen isteğinizi yeniden deneyin.

Batch Hizmeti Hata Kodları

Aşağıdaki tabloda listelenen hata kodları Batch hizmetindeki bir işlem tarafından döndürülebilir.

Hata kodu HTTP durum kodu Kullanıcı iletisi
UnsupportedRequestVersion BadRequest (400) Belirtilen istek sürümü desteklenmiyor.
InvalidAutoScalingSettings BadRequest (400) Belirtilen otomatik ölçeklendirme ayarları geçerli değil.
AutoScalingFormulaSyntaxError BadRequest (400) Belirtilen otomatik ölçeklendirme formülünde söz dizimi hatası var.
AutoScalingFormulaTooLong BadRequest (400) Belirtilen otomatik ölçeklendirme formülü uzunluk sınırını aşıyor.
OSVersionNotFound BadRequest (400) Belirtilen işletim sistemi sürümü yok.
OSVersionDisabled BadRequest (400) Belirtilen işletim sistemi sürümü devre dışı bırakıldı.
OSVersionExpired BadRequest (400) Belirtilen işletim sistemi sürümünün süresi doldu.
PoolVersionEqualsUpgradeVersion BadRequest (400) Havuz zaten verilen sürümle birlikte.
PoolNotEligibleForOSVersionUpgrade BadRequest (400) Belirtilen havuz işletim sistemi sürümü yükseltmesi için uygun değil.
PoolNotFound NotFound (404) Belirtilen havuz yok.
NodeNotFound NotFound (404) Belirtilen düğüm yok.
JobScheduleNotFound NotFound (404) Belirtilen iş zamanlaması yok.
JobNotFound NotFound (404) Belirtilen iş yok.
TaskNotFound NotFound (404) Belirtilen görev yok.
FileNotFound NotFound (404) Belirtilen dosya yok.
NodeUserNotFound NotFound (404) Belirtilen düğüm kullanıcısı yok.
CertificateNotFound NotFound (404) Belirtilen sertifika yok.
JobPreparationTaskNotRunOnNode NotFound (404) İş hazırlama görevi belirtilen düğümde çalışmadı.
JobReleaseTaskNotRunOnNode NotFound (404) İş bırakma görevi belirtilen düğümde çalışmadı.
NodeAgentsKUNotFound NotFound (404) Belirtilen Düğüm Aracısı SKU'su yok.
OperationInvalidForCurrentState Çakışma (409) Belirtilen işlem kaynağın geçerli durumu için geçerli değil.
PoolBeingDeleted Çakışma (409) Belirtilen havuz silinmek üzere işaretlendi ve geri kazanılıyor.
PoolBeingResized Çakışma (409) Belirtilen havuz yeniden boyutlandırılıyor
PoolBeingCreated Çakışma (409) Belirtilen havuz oluşturuluyor.
NodeBeingCreated Çakışma (409) Belirtilen düğüm oluşturuluyor
NodeBeingStarted Çakışma (409) Belirtilen düğüm başlatılıyor
NodeBeingReimaged Çakışma (409) Belirtilen düğüm yeniden oluşturuluyor
NodeBeingRebooted Çakışma (409) Belirtilen düğüm yeniden başlatılıyor
NodeStateUnusable Çakışma (409) Belirtilen düğümün durumu kullanılamıyor
JobScheduleBeingTerminated Çakışma (409) Belirtilen iş zamanlaması sonlandırılıyor.
JobScheduleBeingDeleted Çakışma (409) Belirtilen iş zamanlaması silinmek üzere işaretlendi ve geri kazanılıyor.
CertificateBeingDeleted Çakışma (409) Belirtilen sertifika silinmek üzere işaretlendi ve siliniyor.
PoolExists Çakışma (409) Belirtilen havuz zaten var.
JobScheduleExists Çakışma (409) Belirtilen iş zamanlaması zaten var.
NodeUserExists Çakışma (409) Belirtilen düğüm kullanıcısı zaten var.
JobExists Çakışma (409) Belirtilen iş zaten var.
NodeUserExists Çakışma (409) Belirtilen düğüm kullanıcısı zaten var.
CertificateExists Çakışma (409) Belirtilen sertifika zaten var.
JobScheduleDisabled Çakışma (409) Belirtilen iş zamanlaması devre dışı bırakıldı.
JobScheduleCompleted Çakışma (409) Belirtilen iş zamanlaması zaten tamamlanmış durumda.
JobBeingTerminated Çakışma (409) Belirtilen iş sonlandırılıyor.
JobBeingDeleted Çakışma (409) Belirtilen iş silinmek üzere işaretlendi ve çöp toplanıyor.
JobDisabled Çakışma (409) Belirtilen iş devre dışı bırakıldı.
İş Tamamlanmadı Çakışma (409) Belirtilen iş zaten tamamlanmış durumda.
JobNotActive Çakışma (409) Belirtilen iş etkin durumda değil.
TaskExists Çakışma (409) Belirtilen görev zaten var.
Görev Tamamlandı Çakışma (409) Belirtilen görev zaten tamamlanmış durumda.
TaskNotCompleted Çakışma (409) Belirtilen görev tamamlanmış durumda değil ve istenen işlem yalnızca tamamlanmış görevlerde gerçekleştirilebilir.
TaskSucceeded Çakışma (409) Belirtilen görev zaten başarıyla tamamlandı ve istenen işlem başarılı görevlerde gerçekleştirilemiyor.
TaskFilesUnavailable Çakışma (409) Belirtilen görevin dosyaları kullanılamıyor.
TaskFilesCleanedup Çakışma (409) Belirtilen görevin dosyaları temizlenir.
ActiveJobAndScheduleQuotaReached Çakışma (409) Hesap için etkin iş ve zamanlama kotası ulaşıldı.
PoolQuotaReached Çakışma (409) Hesap için havuz kotası ulaşıldı.
UpgradePoolVersionConflict Çakışma (409) Havuz zaten farklı bir sürüme yükseltiliyor.
JobPreparationTaskNotSpecified Çakışma (409) Belirtilen işin iş hazırlama görevi yok.
JobReleaseTaskNotSpecified Çakışma (409) Belirtilen işin iş bırakma görevi yok.
TaskIdSameAsJobPreparationTask Çakışma (409) Belirtilen görev kimliği, iş hazırlama göreviyle aynı.
TaskIdSameAsJobReleaseTask Çakışma (409) Belirtilen görev kimliği, iş bırakma göreviyle aynı.
JobWithSameIdExists Çakışma (409) Belirtilen iş zamanlama kimliğine sahip bir iş var. İş ve iş zamanlaması aynı kimliğe sahip olamaz.
JobScheduleWithSameIdExists Çakışma (409) Belirtilen iş kimliğine sahip bir iş zamanlaması var. İş ve iş zamanlaması aynı kimliğe sahip olamaz.
NodeAlreadyInTargetSchedulingState Çakışma (409) Belirtilen düğüm zaten hedef zamanlama durumunda.
OperationNotValidOnNode Çakışma (409) Belirtilen işlem düğümde geçerli değil.
OperationNotValidOnPool Çakışma (409) Belirtilen işlem havuzda geçerli değil.
GÇHata Yasak (403) Belirtilen kaynağa erişilirken G/Ç hatası oluştu.
TooManyEnableAutoScaleRequests ServiceUnavailable (503) Havuzda çok fazla Havuz Otomatik Ölçeklendirmeyi Etkinleştir isteği verildi.
ApplicationNotFound Bulunamadı (404) Belirtilen uygulama yok.
InvalidApplicationPackageReferences Çakışma (409) Bir veya daha fazla uygulama paketi başvurusu karşılanamadı. Uygulama kimliği veya sürümü yoksa veya etkin değilse ya da başvuru bir sürüm belirtmediyse ve varsayılan bir sürüm yapılandırılmadıysa bu durum oluşur.
TaskDependenciesNotSpecifiedOnJob Hatalı İstek (400) Diğer görevlere bağlı olarak bir görev belirtildi, ancak iş görev bağımlılıklarını kullanacağını belirtmedi.
TaskDependencyListTooLong Hatalı İstek (400) Diğer görevlere bağlı olarak bir görev belirtildi, ancak bağımlılık listesi depolanamayacak kadar uzundu. Toplam depolanmış uzunluk 64000 karakterle sınırlıdır; İç depolama ek yüküne izin vermek için görev kimliklerinin toplam uzunluğu bundan biraz daha az olmalıdır. Bu hatayla karşılaşırsanız, bunun yerine görev aralığı bağımlılıklarını kullanmayı göz önünde bulundurun.
TaskDependencyRangesTooLong Hatalı İstek (400) Birden çok görev kimliği aralığına bağlı olarak bir görev belirtildi ve aralık listesi depolanamayacak kadar uzundu. Sorunun aralıkların boyutuyla değil, aralık sayısıyla ilgili olduğunu unutmayın.

İş/Görev Zamanlama Hata Kodları

Batch hizmeti bir düğümde görev başlatırken hatayla karşılaşırsa, görevi tamamlandı olarak işaretler. Hata bilgileri, Bir görevle ilişkili dosyaları listeleme ve Görev API'lerihakkında bilgi alma'nın yanıt gövdesindeki bir öğe içinde failureInfo döndürülür.

Benzer şekilde, Batch hizmeti işi başlatırken bir hatayla karşılaşırsa, işi tamamlandı olarak işaretler. Bu zamanlama hatası bilgileri, Batch API'lerindeki bir schedulingErroriş hakkında bilgi al'ın yanıt gövdesindeki bir öğe içinde döndürülür.

Aşağıdaki tabloda, görev zamanlama hatalarına yönelik kategorilerin listesi sağlanır.

Kategori Açıklama
UserError Kullanıcı tarafından sağlanan görev belirtimindeki hatalar.
ServerError Batch hizmetinin görevi zamanlamasını engelleyen hatalarla karşılaşıldı.

Batch hizmeti tarafından döndürülen örnek bir ön işleme hatası aşağıda verilmiştir.

{
  "preProcessingError": {
    "category": "UserError",
    "code": "BlobNotFound",
    "message": "The specified blob does not exist.",
    "values": {
      "name": "FilePath",
      "value": "myfile.txt"
    }
  }
}

Aşağıdaki tabloda Batch hizmeti tarafından döndürülebilecek iş zamanlama hata kodlarının listesi sağlanır.

Hata kodu Category Kullanıcı iletisi
InvalidCertificatesInAutoPool UserError Otomatik havuz belirtiminde belirtilen sertifika başvuruları geçerli değil.
AutoPoolCreationFailedWithQuotaReached UserError Hesabın havuz kotası aşıldı.
InvalidApplicationPackageReferencesInAutoPool UserError Havuz için belirtilen bir veya daha fazla uygulama paketi geçersiz.
InvalidAutoScaleFormulaInAutoPool UserError Belirtilen otomatik ölçeklendirme ayarları geçerli değil.
InvalidAutoPoolSettings UserError Belirtilen otomatik havuz ayarları geçerli değil.
JobBeingTerminated UserError İlişkili iş sonlandırıldığı için görev başlatılamıyor.
Bilinmiyor ServerError Bilinmeyen bir zamanlama hatası oluştu.

Aşağıdaki tablo, Batch hizmeti tarafından döndürülebilecek görev zamanlama hata kodlarının listesini sağlar.

Hata kodu Category Kullanıcı iletisi
BlobNotFound UserError Belirtilen Azure Bloblarından biri bulunamadı.
BlobAccessDenied UserError Belirtilen Azure Bloblarından birine erişim reddedildi.
BlobDownloadTimedOut ServerError Belirtilen Azure Bloblarından birini indirirken zaman aşımıyla karşılaşıldı.
BlobDownloadMiscError ServerError Belirtilen Azure Bloblarından biri indirilirken çeşitli hatalarla karşılaşıldı.
ResourceDirectoryCreateFailed ServerError Görev için kaynak dizini oluşturulurken hatayla karşılaşıldı.
ResourceFileCreateFailed ServerError Kaynak dosyası oluşturulurken hatayla karşılaşıldı.
ResourceFileWriteFailed ServerError Kaynak dosyası yazılırken hatayla karşılaşıldı.
CommandProgramNotFound UserError Belirtilen komut programı bulunamadı.
CommandLaunchFailed UserError Belirtilen komut satırı başlatılamadı.
Görev Uçta UserError Görev kullanıcı isteği tarafından sonlandırıldı.
MaxInternalRetryCountReached UserError Belirtilen görev iç yeniden deneme sayısı üst sınırına ulaştı.
TaskSchedulingConstraintFailed UserError Görev, işle ilişkili havuzda zamanlanamaz
DiskFull ServerError Görevi çalıştırmak için seçilen düğümde yeterli disk alanı yok.
Bilinmiyor ServerError Bilinmeyen bir zamanlama hatası oluştu.