az batch job
Mengelola pekerjaan Batch.
Perintah
Nama | Deskripsi | Jenis | Status |
---|---|---|---|
az batch job create |
Tambahkan pekerjaan ke akun Batch. |
Inti | GA |
az batch job delete |
Menghapus pekerjaan dari akun Batch. |
Inti | GA |
az batch job disable |
Nonaktifkan pekerjaan Batch. |
Inti | GA |
az batch job enable |
Aktifkan pekerjaan Batch. |
Inti | GA |
az batch job list |
Cantumkan semua pekerjaan atau jadwal pekerjaan di akun Batch. |
Inti | GA |
az batch job prep-release-status |
Lihat status tugas persiapan dan rilis pekerjaan Batch. |
Inti | GA |
az batch job prep-release-status list |
Mencantumkan status eksekusi Tugas Persiapan Pekerjaan dan Rilis Pekerjaan untuk Pekerjaan yang ditentukan di seluruh Simpul Komputasi tempat Pekerjaan telah berjalan. |
Inti | GA |
az batch job reset |
Perbarui properti pekerjaan Batch. Properti yang tidak ditentukan yang dapat diperbarui diatur ulang ke defaultnya. |
Inti | GA |
az batch job set |
Perbarui properti pekerjaan Batch. Memperbarui properti dalam subgrup akan mengatur ulang properti yang tidak ditentukan dari grup tersebut. |
Inti | GA |
az batch job show |
Mendapatkan informasi tentang pekerjaan Batch yang ditentukan. |
Inti | GA |
az batch job stop |
Hentikan pekerjaan Batch yang sedang berjalan. |
Inti | GA |
az batch job task-counts |
Lihat jumlah tugas dan slot dalam pekerjaan Batch dan statusnya. |
Inti | GA |
az batch job task-counts show |
Mendapatkan jumlah Tugas untuk Pekerjaan yang ditentukan. |
Inti | GA |
az batch job create
Tambahkan pekerjaan ke akun Batch.
az batch job create [--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--id]
[--job-manager-task-application-package-references]
[--job-manager-task-command-line]
[--job-manager-task-environment-settings]
[--job-manager-task-id]
[--job-manager-task-resource-files]
[--job-max-task-retry-count]
[--job-max-wall-clock-time]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--on-all-tasks-complete]
[--pool-id]
[--priority]
[--required-slots]
[--uses-task-dependencies]
Contoh
Buat pekerjaan baru yang terkait dengan kumpulan yang sudah ada.
az batch job create --id job1 --pool-id pool1
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Apakah Tugas dalam pekerjaan ini dapat didahulukan oleh pekerjaan prioritas tinggi lainnya. Jika nilai diatur ke True, pekerjaan prioritas tinggi lainnya yang dikirimkan ke sistem akan diutamakan dan akan dapat mengantrekan kembali tugas dari pekerjaan ini. Anda dapat memperbarui allowTaskPreemption pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan. True jika ada bendera.
String yang secara unik mengidentifikasi Pekerjaan dalam Akun. ID dapat berisi kombinasi karakter alfanumerik termasuk tanda hubung dan garis bawah, dan tidak boleh berisi lebih dari 64 karakter. ID ini mempertahankan huruf besar/kecil dan tidak peka huruf besar/kecil (artinya, Anda mungkin tidak memiliki dua ID dalam Akun yang hanya berbeda menurut kasus). Diperlukan.
Daftar Paket Aplikasi yang akan disebarkan layanan Batch ke Simpul Komputasi sebelum menjalankan baris perintah. Paket Aplikasi diunduh dan disebarkan ke direktori bersama, bukan direktori kerja Tugas. Oleh karena itu, jika Paket Aplikasi yang direferensikan sudah ada di Simpul Komputasi, dan sudah diperbarui, maka paket tersebut tidak diunduh ulang; salinan yang ada pada Simpul Komputasi digunakan. Jika Paket Aplikasi yang direferensikan tidak dapat diinstal, misalnya karena paket telah dihapus atau karena pengunduhan gagal, Tugas gagal. ID aplikasi yang dipisahkan spasi dengan versi opsional dalam format 'id[#version]'.
Baris perintah Tugas Manajer Pekerjaan. Baris perintah tidak berjalan di bawah shell, dan oleh karena itu tidak dapat memanfaatkan fitur shell seperti ekspansi variabel lingkungan. Jika Anda ingin memanfaatkan fitur tersebut, Anda harus memanggil shell di baris perintah, misalnya menggunakan "cmd /c MyCommand" di Windows atau "/bin/sh -c MyCommand" di Linux. Jika baris perintah mengacu pada jalur file, baris tersebut harus menggunakan jalur relatif (relatif terhadap direktori kerja Tugas), atau menggunakan variabel lingkungan yang disediakan Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Diperlukan.
Daftar pengaturan variabel lingkungan untuk Tugas Manajer Pekerjaan. Nilai yang dipisahkan spasi dalam format 'key=value'.
String yang secara unik mengidentifikasi Tugas Manajer Pekerjaan dalam Pekerjaan. ID dapat berisi kombinasi karakter alfanumerik termasuk tanda hubung dan garis bawah dan tidak boleh berisi lebih dari 64 karakter. Diperlukan.
Daftar file yang akan diunduh layanan Batch ke Simpul Komputasi sebelum menjalankan baris perintah. File yang tercantum di bawah elemen ini terletak di direktori kerja Tugas. Ada ukuran maksimum untuk daftar file sumber daya. Ketika ukuran maksimum terlampaui, permintaan akan gagal dan kode kesalahan respons akan menjadi RequestEntityTooLarge. Jika ini terjadi, kumpulan ResourceFiles harus dikurangi ukurannya. Ini dapat dicapai menggunakan file .zip, Paket Aplikasi, atau Kontainer Docker. Referensi sumber daya yang dipisahkan spasi dalam format filename=httpurl.
Jumlah maksimum setiap Tugas dapat dicoba kembali. Layanan Batch mencoba kembali Tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan ulang. Layanan Batch akan mencoba setiap Tugas sekali, dan kemudian dapat mencoba kembali hingga batas ini. Misalnya, jika jumlah coba lagi maksimum adalah 3, Batch mencoba Tugas hingga 4 kali (satu percobaan awal dan 3 percobaan ulang). Jika jumlah percobaan kembali maksimum adalah 0, layanan Batch tidak mencoba kembali Tugas. Jika jumlah percobaan kembali maksimum adalah -1, layanan Batch mencoba kembali Tugas tanpa batas. Nilai defaultnya adalah 0 (tidak ada percobaan ulang).
Waktu maksimum yang berlalu yang dapat dijalankan Pekerjaan, diukur sejak Pekerjaan dibuat. Jika Pekerjaan tidak selesai dalam batas waktu, layanan Batch mengakhirinya dan Tugas apa pun yang masih berjalan. Dalam hal ini, alasan penghentian adalah MaxWallClockTimeExpiry. Jika properti ini tidak ditentukan, tidak ada batas waktu berapa lama Pekerjaan dapat berjalan. Format yang diharapkan adalah durasi ISO-8601.
File yang berisi spesifikasi pekerjaan di JSON (diformat agar sesuai dengan isi REST API masing-masing). Jika parameter ini ditentukan, semua 'Argumen Pekerjaan' diabaikan.
Jumlah maksimum tugas yang dapat dijalankan secara paralel untuk pekerjaan tersebut. Nilai maxParallelTasks harus -1 atau lebih besar dari 0 jika ditentukan. Jika tidak ditentukan, nilai defaultnya adalah -1, yang berarti tidak ada batasan jumlah tugas yang dapat dijalankan sekaligus. Anda dapat memperbarui maxParallelTasks pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan.
Daftar pasangan nilai nama yang terkait dengan Pekerjaan sebagai metadata. Layanan Batch tidak menetapkan arti apa pun untuk metadata; hanya untuk penggunaan kode pengguna. Nilai yang dipisahkan spasi dalam format 'key=value'.
Tindakan yang harus diambil layanan Batch ketika semua Tugas dalam Pekerjaan dalam status selesai. Perhatikan bahwa jika Pekerjaan tidak berisi Tugas, maka semua Tugas dianggap selesai. Oleh karena itu, opsi ini paling umum digunakan dengan tugas Manajer Pekerjaan; jika Anda ingin menggunakan penghentian Pekerjaan otomatis tanpa Job Manager, Anda awalnya harus mengatur padaAllTasksComplete ke noaction dan memperbarui properti Pekerjaan untuk mengatur onAllTasksComplete ke terminatejob setelah Anda selesai menambahkan Tugas. Defaultnya adalah noaction. Nilai yang diketahui adalah: "noaction" dan "terminatejob".
ID Kumpulan yang ada. Semua Tugas Pekerjaan akan berjalan pada Kumpulan yang ditentukan. Anda harus memastikan bahwa Kumpulan yang dirujuk oleh properti ini ada. Jika Kumpulan tidak ada pada saat layanan Batch mencoba menjadwalkan Pekerjaan, tidak ada Tugas untuk Pekerjaan yang akan berjalan hingga Anda membuat Kumpulan dengan id tersebut. Perhatikan bahwa layanan Batch tidak akan menolak permintaan Pekerjaan; itu tidak akan menjalankan Tugas sampai Kumpulan ada. Anda harus menentukan ID Kumpulan atau spesifikasi Kumpulan otomatis, tetapi tidak keduanya.
Prioritas Pekerjaan. Nilai prioritas dapat berkisar dari -1000 hingga 1000, dengan -1000 menjadi prioritas terendah dan 1000 menjadi prioritas tertinggi. Nilai defaultnya adalah 0.
Jumlah slot penjadwalan yang perlu dijalankan Tugas. Defaultnya adalah 1. Tugas hanya dapat dijadwalkan untuk dijalankan pada simpul komputasi jika simpul memiliki slot penjadwalan gratis yang cukup tersedia. Untuk Tugas multi-instans, properti ini tidak didukung dan tidak boleh ditentukan.
Apakah Tugas dalam Pekerjaan dapat menentukan dependensi satu sama lain. Defaultnya adalah false. True jika ada bendera.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job delete
Menghapus pekerjaan dari akun Batch.
az batch job delete --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]
Contoh
Hapus pekerjaan menggunakan id pekerjaan tanpa meminta konfirmasi.
az batch job delete --job-id job1 --yes
Parameter yang Diperlukan
ID Pekerjaan yang akan dihapus. Diperlukan.
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Jangan meminta konfirmasi.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job disable
Nonaktifkan pekerjaan Batch.
az batch job disable --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--disable-tasks]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
Contoh
Nonaktifkan pekerjaan dan antre ulang tugas yang sedang berjalan.
az batch job disable --job-id job1 --disable-tasks requeue
Parameter yang Diperlukan
ID Pekerjaan yang akan dinonaktifkan. Diperlukan.
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Apa yang harus dilakukan dengan Tugas aktif yang terkait dengan Pekerjaan. Diperlukan. Nilai yang diketahui adalah: "requeue", "terminate", dan "wait".
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
File yang berisi spesifikasi konten di JSON (diformat agar sesuai dengan isi REST API masing-masing). Jika parameter ini ditentukan, semua 'Argumen Konten' diabaikan.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job enable
Aktifkan pekerjaan Batch.
az batch job enable --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Contoh
Aktifkan pekerjaan.
az batch job enable --job-id job1
Parameter yang Diperlukan
ID Pekerjaan yang akan diaktifkan. Diperlukan.
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job list
Cantumkan semua pekerjaan atau jadwal pekerjaan di akun Batch.
az batch job list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--job-schedule-id]
[--select]
Contoh
Mencantumkan semua pekerjaan dalam akun Batch
az batch job list
Mencantumkan semua jadwal pekerjaan di akun Batch
az batch job list --job-schedule-id jobschedule1
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun Batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun Batch. Hanya diperlukan Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Klausa $expand OData.
Klausa $filter OData. Untuk informasi selengkapnya tentang membuat filter ini, lihat https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
ID jadwal pekerjaan tempat Anda ingin mendapatkan daftar pekerjaan. Jika dihilangkan, mencantumkan semua pekerjaan di akun.
Klausa $select OData.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job reset
Perbarui properti pekerjaan Batch. Properti yang tidak ditentukan yang dapat diperbarui diatur ulang ke defaultnya.
az batch job reset --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--job-max-task-retry-count]
[--job-max-wall-clock-time]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--on-all-tasks-complete]
[--pool-id]
[--priority]
Contoh
Reset semua properti pekerjaan kecuali prioritas.
az batch job reset --job-id job1 --priority 100
Parameter yang Diperlukan
ID Pekerjaan yang propertinya ingin Anda perbarui. Diperlukan.
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Apakah Tugas dalam pekerjaan ini dapat didahulukan oleh pekerjaan prioritas tinggi lainnya. Jika nilai diatur ke True, pekerjaan prioritas tinggi lainnya yang dikirimkan ke sistem akan diutamakan dan akan dapat mengantrekan kembali tugas dari pekerjaan ini. Anda dapat memperbarui allowTaskPreemption pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan. True jika ada bendera.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Jumlah maksimum setiap Tugas dapat dicoba kembali. Layanan Batch mencoba kembali Tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan ulang. Layanan Batch akan mencoba setiap Tugas sekali, dan kemudian dapat mencoba kembali hingga batas ini. Misalnya, jika jumlah coba lagi maksimum adalah 3, Batch mencoba Tugas hingga 4 kali (satu percobaan awal dan 3 percobaan ulang). Jika jumlah percobaan kembali maksimum adalah 0, layanan Batch tidak mencoba kembali Tugas. Jika jumlah percobaan kembali maksimum adalah -1, layanan Batch mencoba kembali Tugas tanpa batas. Nilai defaultnya adalah 0 (tidak ada percobaan ulang).
Waktu maksimum yang berlalu yang dapat dijalankan Pekerjaan, diukur sejak Pekerjaan dibuat. Jika Pekerjaan tidak selesai dalam batas waktu, layanan Batch mengakhirinya dan Tugas apa pun yang masih berjalan. Dalam hal ini, alasan penghentian adalah MaxWallClockTimeExpiry. Jika properti ini tidak ditentukan, tidak ada batas waktu berapa lama Pekerjaan dapat berjalan. Format yang diharapkan adalah durasi ISO-8601.
File yang berisi spesifikasi pekerjaan di JSON (diformat agar sesuai dengan isi REST API masing-masing). Jika parameter ini ditentukan, semua 'Argumen Pekerjaan' diabaikan.
Jumlah maksimum tugas yang dapat dijalankan secara paralel untuk pekerjaan tersebut. Nilai maxParallelTasks harus -1 atau lebih besar dari 0 jika ditentukan. Jika tidak ditentukan, nilai defaultnya adalah -1, yang berarti tidak ada batasan jumlah tugas yang dapat dijalankan sekaligus. Anda dapat memperbarui maxParallelTasks pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan.
Daftar pasangan nilai nama yang terkait dengan Pekerjaan sebagai metadata. Layanan Batch tidak menetapkan arti apa pun untuk metadata; hanya untuk penggunaan kode pengguna. Nilai yang dipisahkan spasi dalam format 'key=value'.
Tindakan yang harus diambil layanan Batch ketika semua Tugas dalam Pekerjaan dalam status selesai. Defaultnya adalah noaction. Nilai yang diketahui adalah: "noaction" dan "terminatejob".
ID Kumpulan yang ada. Semua Tugas Pekerjaan akan berjalan pada Kumpulan yang ditentukan. Anda harus memastikan bahwa Kumpulan yang dirujuk oleh properti ini ada. Jika Kumpulan tidak ada pada saat layanan Batch mencoba menjadwalkan Pekerjaan, tidak ada Tugas untuk Pekerjaan yang akan berjalan hingga Anda membuat Kumpulan dengan id tersebut. Perhatikan bahwa layanan Batch tidak akan menolak permintaan Pekerjaan; itu tidak akan menjalankan Tugas sampai Kumpulan ada. Anda harus menentukan ID Kumpulan atau spesifikasi Kumpulan otomatis, tetapi tidak keduanya.
Prioritas Pekerjaan. Nilai prioritas dapat berkisar dari -1000 hingga 1000, dengan -1000 menjadi prioritas terendah dan 1000 menjadi prioritas tertinggi. Nilai defaultnya adalah 0.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job set
Perbarui properti pekerjaan Batch. Memperbarui properti dalam subgrup akan mengatur ulang properti yang tidak ditentukan dari grup tersebut.
az batch job set --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--job-max-task-retry-count]
[--job-max-wall-clock-time]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--on-all-tasks-complete]
[--pool-id]
[--priority]
Contoh
Perbarui prioritas pekerjaan.
az batch job set --job-id job1 --priority 100
Parameter yang Diperlukan
ID Pekerjaan yang propertinya ingin Anda perbarui. Diperlukan.
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Apakah Tugas dalam pekerjaan ini dapat didahulukan oleh pekerjaan prioritas tinggi lainnya. Jika nilai diatur ke True, pekerjaan prioritas tinggi lainnya yang dikirimkan ke sistem akan diutamakan dan akan dapat mengantrekan kembali tugas dari pekerjaan ini. Anda dapat memperbarui allowTaskPreemption pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan. True jika ada bendera.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Jumlah maksimum setiap Tugas dapat dicoba kembali. Layanan Batch mencoba kembali Tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan ulang. Layanan Batch akan mencoba setiap Tugas sekali, dan kemudian dapat mencoba kembali hingga batas ini. Misalnya, jika jumlah coba lagi maksimum adalah 3, Batch mencoba Tugas hingga 4 kali (satu percobaan awal dan 3 percobaan ulang). Jika jumlah percobaan kembali maksimum adalah 0, layanan Batch tidak mencoba kembali Tugas. Jika jumlah percobaan kembali maksimum adalah -1, layanan Batch mencoba kembali Tugas tanpa batas. Nilai defaultnya adalah 0 (tidak ada percobaan ulang).
Waktu maksimum yang berlalu yang dapat dijalankan Pekerjaan, diukur sejak Pekerjaan dibuat. Jika Pekerjaan tidak selesai dalam batas waktu, layanan Batch mengakhirinya dan Tugas apa pun yang masih berjalan. Dalam hal ini, alasan penghentian adalah MaxWallClockTimeExpiry. Jika properti ini tidak ditentukan, tidak ada batas waktu berapa lama Pekerjaan dapat berjalan. Format yang diharapkan adalah durasi ISO-8601.
File yang berisi spesifikasi pekerjaan di JSON (diformat agar sesuai dengan isi REST API masing-masing). Jika parameter ini ditentukan, semua 'Argumen Pekerjaan' diabaikan.
Jumlah maksimum tugas yang dapat dijalankan secara paralel untuk pekerjaan tersebut. Nilai maxParallelTasks harus -1 atau lebih besar dari 0 jika ditentukan. Jika tidak ditentukan, nilai defaultnya adalah -1, yang berarti tidak ada batasan jumlah tugas yang dapat dijalankan sekaligus. Anda dapat memperbarui maxParallelTasks pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan.
Daftar pasangan nilai nama yang terkait dengan Pekerjaan sebagai metadata. Jika dihilangkan, metadata Pekerjaan yang ada dibiarkan tidak berubah. Nilai yang dipisahkan spasi dalam format 'key=value'.
Tindakan yang harus diambil layanan Batch ketika semua Tugas dalam Pekerjaan dalam status selesai. Jika dihilangkan, perilaku penyelesaian dibiarkan tidak berubah. Anda tidak boleh mengubah nilai dari terminatejob ke noaction - yaitu, setelah Anda melibatkan penghentian Pekerjaan otomatis, Anda tidak dapat menonaktifkannya lagi. Jika Anda mencoba melakukan ini, permintaan gagal dengan respons kesalahan 'nilai properti yang tidak valid'; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk). Nilai yang diketahui adalah: "noaction" dan "terminatejob".
ID Kumpulan yang ada. Semua Tugas Pekerjaan akan berjalan pada Kumpulan yang ditentukan. Anda harus memastikan bahwa Kumpulan yang dirujuk oleh properti ini ada. Jika Kumpulan tidak ada pada saat layanan Batch mencoba menjadwalkan Pekerjaan, tidak ada Tugas untuk Pekerjaan yang akan berjalan hingga Anda membuat Kumpulan dengan id tersebut. Perhatikan bahwa layanan Batch tidak akan menolak permintaan Pekerjaan; itu tidak akan menjalankan Tugas sampai Kumpulan ada. Anda harus menentukan ID Kumpulan atau spesifikasi Kumpulan otomatis, tetapi tidak keduanya.
Prioritas Pekerjaan. Nilai prioritas dapat berkisar dari -1000 hingga 1000, dengan -1000 menjadi prioritas terendah dan 1000 menjadi prioritas tertinggi. Jika dihilangkan, prioritas Pekerjaan dibiarkan tidak berubah.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job show
Mendapatkan informasi tentang pekerjaan Batch yang ditentukan.
az batch job show --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]
Contoh
Menampilkan detail informasi tentang pekerjaan.
az batch job show --job-id job1
Parameter yang Diperlukan
ID Pekerjaan. Diperlukan.
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Klausa $expand OData.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Klausa $select OData.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az batch job stop
Hentikan pekerjaan Batch yang sedang berjalan.
Hentikan pekerjaan yang ditentukan, menandainya sebagai selesai. Ketika permintaan Hentikan Pekerjaan diterima, layanan Batch menetapkan pekerjaan ke status penghentian. Layanan Batch kemudian mengakhiri tugas yang sedang berjalan yang terkait dengan pekerjaan dan menjalankan tugas rilis pekerjaan yang diperlukan. Kemudian pekerjaan berpindah ke status selesai. Jika ada tugas dalam pekerjaan dalam status aktif, tugas tersebut akan tetap dalam status aktif. Setelah pekerjaan dihentikan, tugas baru tidak dapat ditambahkan dan tugas aktif yang tersisa tidak akan dijadwalkan.
az batch job stop --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--terminate-reason]
Contoh
Menghentikan pekerjaan dan memberikan alasan penghentian
az batch job stop --job-id job1 --terminate-reason "Completed workflow"
Parameter yang Diperlukan
ID Pekerjaan yang akan dihentikan. Diperlukan.
Parameter Opsional
Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.
Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.
Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien.
Tanda waktu yang menunjukkan waktu terakhir yang dimodifikasi dari sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan.
Alasan penghentian.
Teks yang ingin Anda munculkan sebagai TerminateReason pekerjaan. Defaultnya adalah 'UserTerminate'.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.