Bagikan melalui

az batch task

  • Referensi

Mengelola tugas Batch.

Perintah

Nama Deskripsi Jenis Status
az batch task create

Membuat tugas Batch.

 Inti GA
az batch task delete

Menghapus Tugas dari Pekerjaan yang ditentukan.

 Inti GA
az batch task file

Mengelola file tugas Batch.

 Inti GA
az batch task file delete

Menghapus file Tugas yang ditentukan dari Simpul Komputasi tempat Tugas dijalankan.

 Inti GA
az batch task file download

Unduh konten file tugas Batch.

 Inti GA
az batch task file list

Mencantumkan file dalam direktori Tugas pada Simpul Komputasinya.

 Inti GA
az batch task file show

Mendapatkan properti file Tugas yang ditentukan.

 Inti GA
az batch task list

Mencantumkan semua Tugas yang terkait dengan Pekerjaan yang ditentukan.

 Inti GA
az batch task reactivate

Mengaktifkan kembali Tugas, memungkinkannya berjalan lagi meskipun jumlah percobaan kembali telah habis.

 Inti GA
az batch task reset

Mengatur ulang properti tugas Batch.

 Inti GA
az batch task show

Mendapatkan informasi tentang Tugas yang ditentukan.

 Inti GA
az batch task stop

Mengakhiri Tugas yang ditentukan.

 Inti GA
az batch task subtask

Mengelola informasi subtugas tugas Batch.

 Inti GA
az batch task subtask list

Mencantumkan semua subtugas yang terkait dengan Tugas multi-instans yang ditentukan.

 Inti GA

az batch task create

Edit

Membuat tugas Batch.

az batch task create --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--affinity-id]
                     [--application-package-references]
                     [--command-line]
                     [--environment-settings]
                     [--json-file]
                     [--max-task-retry-count]
                     [--max-wall-clock-time]
                     [--resource-files]
                     [--retention-time]
                     [--task-id]

Contoh

Buat tugas yang tidur selama 1 menit.

az batch task create --task-id task1 --job-id job1 --command-line "sleep 60"

Parameter yang Diperlukan

--job-id

ID pekerjaan yang berisi tugas.

Parameter Opsional

--account-endpoint

Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.

--account-key

Kunci akun Batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.

--account-name

Nama akun Batch. Hanya diperlukan Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.

--affinity-id

Diperlukan. Anda dapat meneruskan affinityId dari Node untuk menunjukkan bahwa Tugas ini perlu dijalankan pada Simpul Komputasi tersebut. Perhatikan bahwa ini hanya afinitas lunak. Jika Simpul Komputasi target sibuk atau tidak tersedia pada saat Tugas dijadwalkan, maka Tugas akan dijadwalkan di tempat lain.

--application-package-references

Daftar ID yang dipisahkan spasi yang menentukan paket aplikasi yang akan diinstal. ID aplikasi yang dipisahkan spasi dengan versi opsional dalam format 'id[#version]'.

--command-line

Baris perintah tugas. 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.

--environment-settings

Daftar pengaturan variabel lingkungan untuk tugas tersebut. Nilai yang dipisahkan spasi dalam format 'key=value'.

--json-file

File yang berisi tugas yang akan dibuat di JSON(diformat agar sesuai dengan isi permintaan REST API). Saat mengirimkan beberapa tugas, menerima array tugas atau TaskAddCollectionParamater. Jika parameter ini ditentukan, semua parameter lainnya diabaikan.

--max-task-retry-count

Jumlah maksimum kali Tugas dapat dicoba kembali. Layanan Batch mencoba kembali Tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan ulang untuk Tugas yang dapat dieksekusi karena kode keluar bukan nol. Layanan Batch akan mencoba 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 setelah upaya pertama. Jika jumlah percobaan kembali maksimum adalah -1, layanan Batch mencoba kembali Tugas tanpa batas, namun ini tidak disarankan untuk tugas mulai atau tugas apa pun. Nilai defaultnya adalah 0 (tidak ada percobaan ulang).

--max-wall-clock-time

Jika ini tidak ditentukan, tidak ada batas waktu berapa lama Tugas dapat berjalan.

--resource-files

Daftar file yang akan diunduh layanan Batch ke simpul komputasi sebelum menjalankan baris perintah. Referensi sumber daya yang dipisahkan ruang dalam format filename=httpurl, dengan httpurl menjadi url HTTP apa pun dengan akses publik atau url SAS dengan akses baca.

--retention-time

Defaultnya adalah 7 hari, yaitu direktori Tugas akan dipertahankan selama 7 hari kecuali Simpul Komputasi dihapus atau Pekerjaan dihapus.

--task-id

ID tugas.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az batch task delete

Edit

Menghapus Tugas dari Pekerjaan yang ditentukan.

Saat Tugas dihapus, semua file di direktorinya pada Simpul Komputasi tempat tugas dijalankan juga dihapus (terlepas dari waktu retensi). Untuk Tugas multi-instans, operasi hapus Tugas berlaku secara sinkron ke tugas utama; subtugas dan filenya kemudian dihapus secara asinkron di latar belakang.

az batch task delete --job-id
                     --task-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--yes]

Parameter yang Diperlukan

--job-id

ID Pekerjaan tempat menghapus Tugas. Diperlukan.

--task-id

ID Tugas yang akan dihapus. Diperlukan.

Parameter Opsional

--account-endpoint

Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.

--account-key

Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.

--account-name

Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.

--if-match

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.

--if-modified-since

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.

--if-none-match

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.

--if-unmodified-since

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.

--yes -y

Jangan meminta konfirmasi.

Nilai default: False
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az batch task list

Edit

Mencantumkan semua Tugas yang terkait dengan Pekerjaan yang ditentukan.

Untuk Tugas multi-instans, informasi seperti affinityId, executionInfo, dan nodeInfo merujuk ke Tugas utama. Gunakan DAFTAR SUBTUGAS API untuk mengambil informasi tentang subtugas.

az batch task list --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--select]

Parameter yang Diperlukan

--job-id

ID Pekerjaan. Diperlukan.

Parameter Opsional

--account-endpoint

Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.

--account-key

Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.

--account-name

Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.

--expand

Klausa $expand OData.

--filter

Klausa $filter OData. Untuk informasi selengkapnya tentang membuat filter ini, lihat https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--select

Klausa $select OData.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az batch task reactivate

Edit

Mengaktifkan kembali Tugas, memungkinkannya berjalan lagi meskipun jumlah percobaan kembali telah habis.

Aktivasi ulang membuat Tugas memenuhi syarat untuk dicoba lagi hingga jumlah percobaan kembali maksimumnya. Status Tugas diubah menjadi aktif. Karena Tugas tidak lagi dalam status selesai, kode keluar atau informasi kegagalan sebelumnya tidak lagi tersedia setelah aktivasi ulang. Setiap kali Tugas diaktifkan kembali, jumlah percobaan ulangnya diatur ulang ke 0. Aktivasi ulang akan gagal untuk Tugas yang tidak selesai atau yang sebelumnya berhasil diselesaikan (dengan kode keluar 0). Selain itu, ini akan gagal jika Pekerjaan telah selesai (atau mengakhiri atau menghapus).

az batch task reactivate --job-id
                         --task-id
                         [--account-endpoint]
                         [--account-key]
                         [--account-name]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]

Parameter yang Diperlukan

--job-id

ID Pekerjaan yang berisi Tugas. Diperlukan.

--task-id

ID Tugas yang akan diaktifkan kembali. Diperlukan.

Parameter Opsional

--account-endpoint

Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.

--account-key

Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.

--account-name

Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.

--if-match

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.

--if-modified-since

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.

--if-none-match

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.

--if-unmodified-since

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
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az batch task reset

Edit

Mengatur ulang properti tugas Batch.

az batch task reset --job-id
                    --task-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--json-file]
                    [--max-task-retry-count]
                    [--max-wall-clock-time]
                    [--retention-time]

Contoh

Atur jumlah coba lagi maks ke 3 dan atur ulang properti lain ke defaultnya

az batch task reset --task-id task1 --job-id job1 --max-task-retry-count 3

Parameter yang Diperlukan

--job-id

ID Pekerjaan yang berisi Tugas.

--task-id

ID Tugas yang akan diperbarui.

Parameter Opsional

--account-endpoint

Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.

--account-key

Kunci akun Batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.

--account-name

Nama akun Batch. Hanya diperlukan Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.

--if-match

Operasi akan dilakukan hanya jika ETag sumber daya saat ini sama persis dengan nilai yang ditentukan.

--if-modified-since

Operasi akan dilakukan hanya jika sumber daya telah dimodifikasi sejak tanda waktu yang ditentukan.

--if-none-match

Operasi tidak akan dilakukan hanya jika ETag sumber daya saat ini sama persis dengan nilai yang ditentukan.

--if-unmodified-since

Operasi tidak akan dilakukan hanya jika sumber daya telah dimodifikasi sejak tanda waktu yang ditentukan.

--json-file

File yang berisi spesifikasi parameter properti pembaruan kumpulan di JSON(diformat agar sesuai dengan isi permintaan REST API). Jika parameter ini ditentukan, semua 'Argumen Parameter Properti Pembaruan Kumpulan' diabaikan.

--max-task-retry-count

Jumlah maksimum kali Tugas dapat dicoba kembali. Layanan Batch mencoba kembali Tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan ulang untuk Tugas yang dapat dieksekusi karena kode keluar bukan nol. Layanan Batch akan mencoba 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 setelah upaya pertama. Jika jumlah percobaan kembali maksimum adalah -1, layanan Batch mencoba kembali Tugas tanpa batas, namun ini tidak disarankan untuk tugas mulai atau tugas apa pun. Nilai defaultnya adalah 0 (tidak ada percobaan ulang).

--max-wall-clock-time

Jika ini tidak ditentukan, tidak ada batas waktu berapa lama Tugas dapat berjalan. Format yang diharapkan adalah durasi ISO-8601.

--retention-time

Defaultnya adalah 7 hari, yaitu direktori Tugas akan dipertahankan selama 7 hari kecuali Simpul Komputasi dihapus atau Pekerjaan dihapus. Format yang diharapkan adalah durasi ISO-8601.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az batch task show

Edit

Mendapatkan informasi tentang Tugas yang ditentukan.

Untuk Tugas multi-instans, informasi seperti affinityId, executionInfo, dan nodeInfo merujuk ke Tugas utama. Gunakan DAFTAR SUBTUGAS API untuk mengambil informasi tentang subtugas.

az batch task show --job-id
                   --task-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--select]

Parameter yang Diperlukan

--job-id

ID Pekerjaan yang berisi Tugas. Diperlukan.

--task-id

ID Tugas untuk mendapatkan informasi tentang. Diperlukan.

Parameter Opsional

--account-endpoint

Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.

--account-key

Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.

--account-name

Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.

--expand

Klausa $expand OData.

--if-match

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.

--if-modified-since

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.

--if-none-match

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.

--if-unmodified-since

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.

--select

Klausa $select OData.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az batch task stop

Edit

Mengakhiri Tugas yang ditentukan.

Ketika Tugas telah dihentikan, tugas akan berpindah ke status selesai. Untuk Tugas multi-instans, operasi Hentikan Tugas berlaku secara sinkron ke tugas utama; subtugas kemudian dihentikan secara asinkron di latar belakang.

az batch task stop --job-id
                   --task-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]

Parameter yang Diperlukan

--job-id

ID Pekerjaan yang berisi Tugas. Diperlukan.

--task-id

ID Tugas yang akan dihentikan. Diperlukan.

Parameter Opsional

--account-endpoint

Titik akhir layanan batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ENDPOINT.

--account-key

Kunci akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCESS_KEY.

--account-name

Nama akun batch. Atau, diatur menurut variabel lingkungan: AZURE_BATCH_ACCOUNT.

--if-match

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.

--if-modified-since

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.

--if-none-match

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.

--if-unmodified-since

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
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

--output -o

Format output.

Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
Nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.