Status Batch dan Kode Kesalahan
Operasi REST API untuk layanan Batch mengembalikan kode status HTTP standar, seperti yang didefinisikan dalam Definisi Kode Status HTTP/1.1.
Operasi API juga dapat mengembalikan informasi kesalahan tambahan untuk memberi pengembang informasi lebih lanjut tentang kesalahan tersebut. Misalnya, respons kesalahan berikut menunjukkan bahwa parameter kueri yang ditentukan pada permintaan URI tidak valid, dan memberikan informasi tambahan tentang nama dan nilai parameter yang tidak valid dan alasan kesalahan.
{
"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"
}]
}
Bagian berikut ini menyediakan daftar kode kesalahan untuk layanan Batch:
Kode kesalahan REST API umum
Kode kesalahan yang tercantum dalam tabel berikut dapat dikembalikan oleh operasi pada layanan Batch.
| Kode kesalahan | Kode status HTTP | Pesan pengguna |
|---|---|---|
| ConditionNotMet | Tidak Diubah (304) | Kondisi yang ditentukan dalam header kondisi tidak terpenuhi untuk operasi baca. |
| MissingRequiredHeader | Permintaan Buruk (400) | Header HTTP yang diperlukan tidak ditentukan. |
| MissingRequiredProperty | Permintaan Buruk (400) | Properti yang diperlukan tidak ditentukan dalam isi permintaan. |
| UnsupportedHeader | Permintaan Buruk (400) | Salah satu header HTTP yang ditentukan dalam permintaan tidak didukung. |
| UnsupportedProperty | Permintaan Buruk (400) | Salah satu properti yang ditentukan dalam isi permintaan tidak didukung. |
| InvalidHeaderValue | Permintaan Buruk (400) | Nilai yang disediakan untuk salah satu header HTTP tidak dalam format yang benar. |
| InvalidPropertyValue | Permintaan Buruk (400) | Nilai yang disediakan untuk salah satu properti dalam isi permintaan tidak valid. |
| MissingRequiredQueryParameter | Permintaan Buruk (400) | Parameter kueri yang diperlukan tidak ditentukan untuk permintaan ini. |
| UnsupportedQueryParameter | Permintaan Buruk (400) | Salah satu parameter kueri yang ditentukan dalam permintaan URI tidak didukung. |
| InvalidQueryParameterValue | Permintaan Buruk (400) | Nilai yang tidak valid ditentukan untuk salah satu parameter kueri dalam URI permintaan. |
| OutOfRangeQueryParameterValue | Permintaan Buruk (400) | Parameter kueri yang ditentukan dalam permintaan URI berada di luar rentang yang diizinkan. |
| RequestUrlFailedToParse | Permintaan Buruk (400) | Url dalam permintaan tidak dapat diurai. |
| InvalidUri | Permintaan Buruk (400) | URI yang diminta tidak mewakili sumber daya apa pun di server. |
| InvalidHttpVerb | Permintaan Buruk (400) | Kata kerja HTTP yang ditentukan tidak dikenali oleh server. |
| EmptyMetadataKey | Permintaan Buruk (400) | Kunci untuk salah satu pasangan kunci-nilai metadata kosong. |
| InvalidRequestBody | Permintaan Buruk (400) | Isi Permintaan yang ditentukan tidak valid secara sintaksis. |
| OutOfRangeInput | Permintaan Buruk (400) | Salah satu input permintaan di luar jangkauan. |
| InvalidAuthenticationInfo | Permintaan Buruk (400) | Informasi autentikasi tidak disediakan dalam format yang benar. Verifikasi nilai header Otorisasi . |
| InvalidInput | Permintaan Buruk (400) | Salah satu input permintaan tidak valid. |
| InvalidMetadata | Permintaan Buruk (400) | Metadata yang ditentukan tidak valid. Ini termasuk karakter yang tidak diizinkan. |
| MetadataTooLarge | Permintaan Buruk (400) | Ukuran metadata yang ditentukan melebihi ukuran maksimum yang diizinkan. |
| MultipleConditionHeadersNotSupported | Permintaan Buruk (400) | Beberapa header kondisi tidak didukung. |
| AuthenticationFailed | Terlarang (403) | Server gagal mengautentikasi permintaan. Verifikasi bahwa nilai header Otorisasi dibentuk dengan benar dan menyertakan tanda tangan. |
| InsufficientAccountPermissions | Terlarang (403) | Akun yang diakses tidak memiliki izin yang memadai untuk menjalankan operasi ini. |
| AccountIsDisabled | Terlarang (403) | Akun yang ditentukan dinonaktifkan. |
| ResourceNotFound | Tidak Ditemukan(404) | Sumber daya yang ditentukan tidak ada. |
| Tidak didukungHttpVerb | Metode Tidak Diizinkan (405) | Sumber daya tidak mendukung kata kerja HTTP yang ditentukan. |
| MissingContentLengthHeader | Panjang Diperlukan (411) | Header Panjang Konten tidak ditentukan. |
| ConditionNotMet | Prasyarat Gagal (412) | Kondisi yang ditentukan dalam header kondisi tidak terpenuhi untuk operasi tulis. |
| RequestBodyTooLarge | Entitas Permintaan Terlalu Besar (413) | Ukuran isi permintaan melebihi ukuran maksimum yang diizinkan. |
| InvalidRange | Rentang yang Diminta Tidak Terpenuhi (416) | Rentang yang ditentukan tidak valid untuk ukuran sumber daya saat ini. |
| InternalError | Kesalahan Server Internal (500) | Server menemui kesalahan internal. Silakan coba lagi permintaannya. |
| OperationTimedOut | Kesalahan Server Internal (500) | Operasi tidak dapat diselesaikan dalam waktu yang diizinkan. |
| ServerBusy | Layanan Tidak Tersedia (503) | Server saat ini tidak dapat menerima permintaan. Silakan coba lagi permintaan Anda. |
Kode Kesalahan Layanan Batch
Kode kesalahan yang tercantum dalam tabel berikut dapat dikembalikan oleh operasi pada layanan Batch.
| Kode kesalahan | Kode status HTTP | Pesan pengguna |
|---|---|---|
| UnsupportedRequestVersion | BadRequest (400) | Versi permintaan yang ditentukan tidak didukung. |
| InvalidAutoScalingSettings | BadRequest (400) | Pengaturan penskalan otomatis yang ditentukan tidak valid. |
| AutoScalingFormulaSyntaxError | BadRequest (400) | Rumus penskalaan otomatis yang ditentukan memiliki kesalahan sintaks. |
| AutoScalingFormulaTooLong | BadRequest (400) | Rumus penskalaan otomatis yang ditentukan melebihi batas panjang. |
| OSVersionNotFound | BadRequest (400) | Versi OS yang ditentukan tidak ada. |
| OSVersionDisabled | BadRequest (400) | Versi OS yang ditentukan dinonaktifkan. |
| OSVersionExpired | BadRequest (400) | Versi OS yang ditentukan kedaluwarsa. |
| PoolVersionEqualsUpgradeVersion | BadRequest (400) | Kumpulan sudah dengan versi yang diberikan. |
| PoolNotEligibleForOSVersionUpgrade | BadRequest (400) | Kumpulan yang ditentukan tidak memenuhi syarat untuk peningkatan Versi OS. |
| PoolNotFound | NotFound (404) | Kumpulan yang ditentukan tidak ada. |
| NodeNotFound | NotFound (404) | Simpul yang ditentukan tidak ada. |
| JobScheduleNotFound | NotFound (404) | Jadwal pekerjaan yang ditentukan tidak ada. |
| JobNotFound | NotFound (404) | Pekerjaan yang ditentukan tidak ada. |
| TaskNotFound | NotFound (404) | Tugas yang ditentukan tidak ada. |
| FileNotFound | NotFound (404) | File yang ditentukan tidak ada. |
| NodeUserNotFound | NotFound (404) | Pengguna simpul yang ditentukan tidak ada. |
| CertificateNotFound | NotFound (404) | Sertifikat yang ditentukan tidak ada. |
| JobPreparationTaskNotRunOnNode | NotFound (404) | Tugas persiapan kerja tidak berjalan pada simpul yang ditentukan. |
| JobReleaseTaskNotRunOnNode | NotFound (404) | Tugas rilis pekerjaan tidak berjalan pada simpul yang ditentukan. |
| NodeAgentSKUNotFound | NotFound (404) | SKU Agen Simpul yang ditentukan tidak ada. |
| OperationInvalidForCurrentState | Konflik (409) | Operasi yang ditentukan tidak valid untuk status sumber daya saat ini. |
| PoolBeingDeleted | Konflik (409) | Kumpulan yang ditentukan telah ditandai untuk dihapus dan sedang diklaim kembali. |
| PoolBeingResized | Konflik (409) | Kumpulan yang ditentukan sedang diubah ukurannya |
| PoolBeingCreated | Konflik (409) | Kumpulan yang ditentukan sedang dibuat. |
| NodeBeingCreated | Konflik (409) | Simpul yang ditentukan sedang dibuat |
| NodeBeingStarted | Konflik (409) | Simpul yang ditentukan sedang dimulai |
| NodeBeingReimaged | Konflik (409) | Simpul yang ditentukan sedang digambut ulang |
| NodeBeingRebooted | Konflik (409) | Simpul yang ditentukan sedang di-boot ulang |
| NodeStateUnusable | Konflik (409) | Status simpul yang ditentukan tidak dapat digunakan |
| JobScheduleBeingTerminated | Konflik (409) | Jadwal pekerjaan yang ditentukan sedang dihentikan. |
| JobScheduleBeingDeleted | Konflik (409) | Jadwal pekerjaan yang ditentukan telah ditandai untuk penghapusan dan sedang diklaim kembali. |
| CertificateBeingDeleted | Konflik (409) | Sertifikat yang ditentukan telah ditandai untuk dihapus dan sedang dihapus. |
| PoolExists | Konflik (409) | Kumpulan yang ditentukan sudah ada. |
| JobScheduleExists | Konflik (409) | Jadwal pekerjaan yang ditentukan sudah ada. |
| NodeUserExists | Konflik (409) | Pengguna simpul yang ditentukan sudah ada. |
| JobExists | Konflik (409) | Pekerjaan yang ditentukan sudah ada. |
| NodeUserExists | Konflik (409) | Pengguna simpul yang ditentukan sudah ada. |
| CertificateExists | Konflik (409) | Sertifikat yang ditentukan sudah ada. |
| JobScheduleDisabled | Konflik (409) | Jadwal pekerjaan yang ditentukan dinonaktifkan. |
| JobScheduleCompleted | Konflik (409) | Jadwal pekerjaan yang ditentukan sudah dalam status selesai. |
| JobBeingTerminated | Konflik (409) | Pekerjaan yang ditentukan sedang dihentikan. |
| JobBeingDeleted | Konflik (409) | Pekerjaan yang ditentukan telah ditandai untuk dihapus dan sedang dikumpulkan sampah. |
| JobDisabled | Konflik (409) | Pekerjaan yang ditentukan dinonaktifkan. |
| JobCompleted | Konflik (409) | Pekerjaan yang ditentukan sudah dalam status selesai. |
| JobNotActive | Konflik (409) | Pekerjaan yang ditentukan tidak dalam status aktif. |
| TaskExists | Konflik (409) | Tugas yang ditentukan sudah ada. |
| TaskCompleted | Konflik (409) | Tugas yang ditentukan sudah dalam keadaan selesai. |
| TaskNotCompleted | Konflik (409) | Tugas yang ditentukan tidak dalam status selesai, dan operasi yang diminta hanya dapat dilakukan pada tugas yang selesai. |
| Tugas Terdidik | Konflik (409) | Tugas yang ditentukan telah berhasil diselesaikan, dan operasi yang diminta tidak dapat dilakukan pada tugas yang berhasil. |
| TaskFilesUnavailable | Konflik (409) | File tugas yang ditentukan tidak tersedia. |
| TaskFilesCleanedup | Konflik (409) | File tugas yang ditentukan dibersihkan. |
| ActiveJobAndScheduleQuotaReached | Konflik (409) | Pekerjaan aktif dan jadwal kuota untuk akun telah tercapai. |
| PoolQuotaReached | Konflik (409) | Kuota kumpulan untuk akun telah tercapai. |
| UpgradePoolVersionConflict | Konflik (409) | Kumpulan sudah memutakhirkan ke versi yang berbeda. |
| JobPreparationTaskNotSpecified | Konflik (409) | Pekerjaan yang ditentukan tidak memiliki tugas persiapan kerja. |
| JobReleaseTaskNotSpecified | Konflik (409) | Pekerjaan yang ditentukan tidak memiliki tugas pelepasan kerja. |
| TaskIdSameAsJobPreparationTask | Konflik (409) | Id tugas yang ditentukan sama dengan tugas persiapan kerja. |
| TaskIdSameAsJobReleaseTask | Konflik (409) | Id tugas yang ditentukan sama dengan tugas pelepasan kerja. |
| JobWithSameIdExists | Konflik (409) | Pekerjaan dengan id jadwal pekerjaan yang ditentukan ada. Jadwal pekerjaan dan pekerjaan tidak boleh memiliki id yang sama. |
| JobScheduleWithSameIdExists | Konflik (409) | Jadwal pekerjaan dengan id pekerjaan yang ditentukan ada. Jadwal pekerjaan dan pekerjaan tidak boleh memiliki id yang sama. |
| NodeAlreadyInTargetSchedulingState | Konflik (409) | Simpul yang ditentukan sudah dalam status penjadwalan target. |
| OperationNotValidOnNode | Konflik (409) | Operasi yang ditentukan tidak valid pada simpul. |
| OperationNotValidOnPool | Konflik (409) | Operasi yang ditentukan tidak valid pada kumpulan. |
| IOError | Terlarang (403) | Terjadi kesalahan I/O saat mengakses sumber daya yang ditentukan. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | Terlalu banyak permintaan Aktifkan Skala Otomatis Kumpulan dikeluarkan pada kumpulan. |
| ApplicationNotFound | Tidak Ditemukan(404) | Aplikasi yang ditentukan tidak ada. |
| InvalidApplicationPackageReferences | Konflik (409) | Satu atau beberapa referensi paket aplikasi tidak dapat dipenuhi. Ini terjadi jika id atau versi aplikasi tidak ada atau tidak aktif, atau jika referensi tidak menentukan versi dan tidak ada versi default yang dikonfigurasi. |
| TaskDependenciesNotSpecifiedOnJob | Permintaan Buruk (400) | Tugas ditentukan sebagai tergantung pada tugas lain, tetapi pekerjaan tidak menentukan bahwa tugas tersebut akan menggunakan dependensi tugas. |
| TaskDependencyListTooLong | Permintaan Buruk (400) | Tugas ditentukan sebagai tergantung pada tugas lain, tetapi daftar dependensi terlalu panjang untuk disimpan. Total panjang tersimpan dibatasi hingga 64000 karakter; panjang total id tugas harus sedikit kurang dari ini untuk memungkinkan overhead penyimpanan internal. Jika Anda mengalami kesalahan ini, pertimbangkan untuk menggunakan dependensi rentang tugas sebagai gantinya. |
| TaskDependencyRangesTooLong | Permintaan Buruk (400) | Tugas ditentukan sebagai tergantung pada beberapa rentang id tugas, dan daftar rentang terlalu panjang untuk disimpan. Perhatikan bahwa masalahnya bukan dengan ukuran rentang, tetapi dengan jumlah rentang. |
Kode Kesalahan Penjadwalan Pekerjaan/Tugas
Jika layanan Batch mengalami kesalahan saat memulai tugas pada simpul, maka akan menandai tugas sebagai selesai. Informasi kesalahan dikembalikan dalam failureInfo elemen dalam isi respons Daftar file yang terkait dengan tugas dan Dapatkan informasi tentang API tugas .
Demikian pula, jika layanan Batch mengalami kesalahan saat memulai pekerjaan, itu menandai pekerjaan sebagai selesai. Informasi kesalahan penjadwalan ini dikembalikan dalam schedulingError elemen dalam isi respons Dapatkan informasi tentang pekerjaan di API Batch .
Tabel berikut ini menyediakan daftar kategori untuk kesalahan penjadwalan tugas.
| Kategori | Deskripsi |
|---|---|
| UserError | Kesalahan dalam spesifikasi tugas yang disediakan oleh pengguna. |
| ServerError | Kesalahan yang ditemui oleh layanan Batch yang mencegahnya menjadwalkan tugas. |
Di bawah ini adalah contoh kesalahan pra-pemrosesan yang dikembalikan oleh layanan Batch.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
Tabel berikut ini menyediakan daftar kode kesalahan penjadwalan pekerjaan yang dapat dikembalikan oleh layanan Batch.
| Kode kesalahan | Kategori | Pesan pengguna |
|---|---|---|
| InvalidCertificatesInAutoPool | UserError | Referensi sertifikat yang ditentukan dalam spesifikasi kumpulan otomatis tidak valid. |
| AutoPoolCreationFailedWithQuotaReached | UserError | Kuota kumpulan untuk akun tercapai. |
| InvalidApplicationPackageReferencesInAutoPool | UserError | Satu atau beberapa paket aplikasi yang ditentukan untuk kumpulan tidak valid. |
| InvalidAutoScaleFormulaInAutoPool | UserError | Pengaturan penskalan otomatis yang ditentukan tidak valid. |
| InvalidAutoPoolSettings | UserError | Pengaturan autopool yang ditentukan tidak valid. |
| JobBeingTerminated | UserError | Tugas tidak dapat dimulai karena pekerjaan terkait sedang dihentikan. |
| Tidak dikenal | ServerError | Terjadi kesalahan penjadwalan yang tidak diketahui. |
Tabel berikut ini menyediakan daftar kode kesalahan penjadwalan tugas yang dapat dikembalikan oleh layanan Batch.
| Kode kesalahan | Kategori | Pesan pengguna |
|---|---|---|
| BlobNotFound | UserError | Salah satu Azure Blob yang ditentukan tidak ditemukan. |
| BlobAccessDenied | UserError | Akses untuk salah satu Azure Blob yang ditentukan ditolak. |
| BlobDownloadTimedOut | ServerError | Waktu habis yang ditemui saat mengunduh salah satu Azure Blob yang ditentukan. |
| BlobDownloadMiscError | ServerError | Kesalahan lain-lain terjadi saat mengunduh salah satu Azure Blob yang ditentukan. |
| ResourceDirectoryCreateFailed | ServerError | Kegagalan terjadi saat membuat direktori sumber daya untuk tugas tersebut. |
| ResourceFileCreateFailed | ServerError | Kegagalan terjadi saat membuat file sumber daya. |
| ResourceFileWriteFailed | ServerError | Kegagalan terjadi saat menulis file sumber daya. |
| CommandProgramNotFound | UserError | Program perintah yang ditentukan tidak ditemukan. |
| CommandLaunchFailed | UserError | Gagal meluncurkan baris perintah yang ditentukan. |
| TaskEnded | UserError | Tugas diakhuhi oleh permintaan pengguna. |
| MaxInternalRetryCountReached | UserError | Tugas yang ditentukan telah mencapai jumlah percobaan ulang internal maksimum. |
| TaskSchedulingConstraintFailed | UserError | Tugas tidak dapat dijadwalkan pada kumpulan yang terkait dengan pekerjaan |
| DiskFull | ServerError | Ruang disk pada simpul yang dipilih tidak cukup untuk menjalankan tugas. |
| Tidak dikenal | ServerError | Terjadi kesalahan penjadwalan yang tidak diketahui. |