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 schedulingError
iş 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. |