Task - Add Collection

Referensi

Layanan:: Batch Service

Versi API:: 2024-07-01.20.0

Menambahkan kumpulan Tugas ke Pekerjaan yang ditentukan.
Perhatikan bahwa setiap Tugas harus memiliki ID unik. Layanan Batch mungkin tidak mengembalikan hasil untuk setiap Tugas dalam urutan yang sama tugas yang dikirimkan dalam permintaan ini. Jika waktu server habis atau koneksi ditutup selama permintaan, permintaan mungkin telah diproses sebagian atau sepenuhnya, atau tidak sama sekali. Dalam kasus seperti itu, pengguna harus menerbitkan ulang permintaan. Perhatikan bahwa terserah pengguna untuk menangani kegagalan dengan benar saat mengeluarkan kembali permintaan. Misalnya, Anda harus menggunakan ID Tugas yang sama selama coba lagi sehingga jika operasi sebelumnya berhasil, coba lagi tidak akan membuat Tugas tambahan secara tiba-tiba. Jika respons berisi Tugas apa pun yang gagal ditambahkan, klien dapat mencoba kembali permintaan. Dalam coba lagi, paling efisien untuk mengirim ulang hanya Tugas yang gagal ditambahkan, dan untuk menghilangkan Tugas yang berhasil ditambahkan pada upaya pertama. Masa pakai maksimum Tugas dari penambahan hingga penyelesaian adalah 180 hari. Jika Tugas belum selesai dalam waktu 180 hari setelah ditambahkan, tugas tersebut akan dihentikan oleh layanan Batch dan dibiarkan dalam keadaan apa pun itu pada saat itu.

POST {batchUrl}/jobs/{jobId}/addtaskcollection?api-version=2024-07-01.20.0

Dengan parameter opsional:

POST {batchUrl}/jobs/{jobId}/addtaskcollection?timeout={timeout}&api-version=2024-07-01.20.0

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
batchUrl	path	True	string	URL dasar untuk semua permintaan layanan Azure Batch.
jobId	path	True	string	ID Pekerjaan tempat kumpulan Tugas akan ditambahkan.
api-version	query	True	string	Versi API Klien.
timeout	query		integer int32	Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 2 menit. Jika nilainya lebih besar dari 120, default akan digunakan sebagai gantinya.

Header Permintaan

Media Types: "application/json; odata=minimalmetadata"

Nama	Jenis	Deskripsi
client-request-id	string uuid	Identitas permintaan yang dihasilkan penelepon, dalam bentuk GUID tanpa dekorasi seperti kurung kurawal, misalnya 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Apakah server harus mengembalikan client-request-id dalam respons.
ocp-date	string date-time-rfc1123	Waktu permintaan dikeluarkan. Pustaka klien biasanya mengatur ini ke waktu jam sistem saat ini; atur secara eksplisit jika Anda memanggil REST API secara langsung.

Isi Permintaan

Media Types: "application/json; odata=minimalmetadata"

Nama	Diperlukan	Jenis	Deskripsi
value	True	TaskAddParameter[]	Kumpulan Tugas yang akan ditambahkan. Jumlah maksimum Tugas adalah 100. Ukuran total yang diserialisasikan dari koleksi ini harus kurang dari 1MB. Jika lebih besar dari 1MB (misalnya jika setiap Tugas memiliki 100 file sumber daya atau variabel lingkungan), permintaan akan gagal dengan kode 'RequestBodyTooLarge' dan harus dicoba lagi dengan lebih sedikit Tugas.

Respons

Nama	Jenis	Deskripsi
200 OK	TaskAddCollectionResult	Respons yang berisi hasil operasi tambahkan Kumpulan tugas. Header client-request-id: string request-id: string
Other Status Codes	BatchError	Kesalahan tak terduga

Nama

Jenis

Deskripsi

200 OK

TaskAddCollectionResult

Respons yang berisi hasil operasi tambahkan Kumpulan tugas.

Header

client-request-id: string
request-id: string

Other Status Codes

BatchError

Kesalahan tak terduga

Keamanan

azure_auth

Alur kode autentikasi Microsoft Entra OAuth 2.0

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	Meniru akun pengguna Anda

Authorization

Jenis: apiKey
Dalam: header

Contoh

Add a basic collection of tasks

Add a complex collection of tasks

Add a basic collection of tasks

Permintaan sampel

HTTP

POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2024-07-01.20.0



{
  "value": [
    {
      "id": "simple1",
      "commandLine": "cmd /c dir /s"
    },
    {
      "id": "simple2",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "status": "success",
      "taskId": "simple1",
      "eTag": "0x8D3D623CD661246",
      "lastModified": "2016-09-06T07:02:44.7589958Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple1"
    },
    {
      "status": "success",
      "taskId": "simple2",
      "eTag": "0x8D3D623CD7072CC",
      "lastModified": "2016-09-06T07:02:44.8270028Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple2"
    }
  ]
}

Add a complex collection of tasks

Permintaan sampel

HTTP

POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2024-07-01.20.0



{
  "value": [
    {
      "id": "complex1",
      "commandLine": "cmd /c dir /s",
      "resourceFiles": [
        {
          "autoStorageContainerName": "containerName",
          "filePath": "data"
        }
      ],
      "environmentSettings": [
        {
          "name": "env1",
          "value": "value1"
        },
        {
          "name": "env2",
          "value": "value2"
        }
      ],
      "affinityInfo": {
        "affinityId": "affinityId"
      },
      "constraints": {
        "maxWallClockTime": "P1D",
        "retentionTime": "P2D",
        "maxTaskRetryCount": 5
      },
      "requiredSlots": 2,
      "multiInstanceSettings": {
        "numberOfInstances": 3,
        "coordinationCommandLine": "cmd /c echo coordinating",
        "commonResourceFiles": [
          {
            "httpUrl": "https://common.blob.core.windows.net/",
            "filePath": "common.exe"
          }
        ]
      }
    },
    {
      "id": "simple3",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "taskId": "simple3",
      "status": "success",
      "eTag": "0x8D3D623CE295629",
      "lastModified": "2016-09-06T07:02:46.0386857Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple3"
    },
    {
      "taskId": "complex1",
      "status": "success",
      "eTag": "0x8D3D623CE29A412",
      "lastModified": "2016-09-06T07:02:46.0406802Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/complex1"
    }
  ]
}

Definisi

Nama	Deskripsi
AccessScope	Sumber daya Batch tempat token memberikan akses.
AffinityInformation	Petunjuk lokalitas yang dapat digunakan oleh layanan Batch untuk memilih Simpul Komputasi tempat memulai Tugas.
ApplicationPackageReference	Referensi ke Paket yang akan disebarkan ke Simpul Komputasi.
AuthenticationTokenSettings	Pengaturan untuk token autentikasi yang dapat digunakan Tugas untuk melakukan operasi layanan Batch.
AutoUserScope	Cakupan untuk pengguna otomatis
AutoUserSpecification	Menentukan parameter untuk pengguna otomatis yang menjalankan Tugas pada layanan Batch.
BatchError	Respons kesalahan diterima dari layanan Azure Batch.
BatchErrorDetail	Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
ComputeNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.
ContainerHostBatchBindMountEntry	Entri jalur dan mode pemasangan yang ingin Anda pasang ke dalam kontainer tugas.
ContainerHostDataPath	Jalur yang akan dipasang ke kontainer tugas kontainer.
ContainerRegistry	Registri kontainer privat.
ContainerWorkingDirectory	Lokasi direktori kerja Tugas kontainer.
DependencyAction	Tindakan yang dilakukan layanan Batch pada Tugas yang bergantung pada Tugas ini.
ElevationLevel	Tingkat elevasi pengguna.
EnvironmentSetting	Variabel lingkungan yang akan diatur pada proses Tugas.
ErrorMessage	Pesan kesalahan diterima dalam respons kesalahan Azure Batch.
ExitCodeMapping	Bagaimana layanan Batch harus merespons jika Tugas keluar dengan kode keluar tertentu.
ExitCodeRangeMapping	Berbagai kode keluar dan bagaimana layanan Batch harus merespons kode keluar dalam rentang tersebut.
ExitConditions	Menentukan bagaimana layanan Batch harus merespons ketika Tugas selesai.
ExitOptions	Menentukan bagaimana layanan Batch merespons kondisi keluar tertentu.
HttpHeader	Pasangan nama-nilai header HTTP
JobAction	Tindakan yang harus diambil pada Pekerjaan yang berisi Tugas, jika Tugas selesai dengan kondisi keluar yang diberikan dan properti OnTaskFailed Pekerjaan adalah 'performExitOptionsJobAction'.
MultiInstanceSettings	Pengaturan yang menentukan cara menjalankan Tugas multi-instans.
OutputFile	Spesifikasi untuk mengunggah file dari Simpul Komputasi Azure Batch ke lokasi lain setelah layanan Batch selesai menjalankan proses Tugas.
OutputFileBlobContainerDestination	Menentukan tujuan unggahan file dalam kontainer penyimpanan blob Azure.
OutputFileDestination	Tujuan tempat file harus diunggah.
OutputFileUploadCondition	Kondisi di mana file output Tugas atau sekumpulan file harus diunggah.
OutputFileUploadOptions	Detail tentang operasi pengunggahan file output, termasuk dalam kondisi apa untuk melakukan unggahan.
ResourceFile	Satu file atau beberapa file yang akan diunduh ke Simpul Komputasi.
TaskAddCollectionParameter	Kumpulan Tugas Azure Batch untuk ditambahkan.
TaskAddCollectionResult	Hasil penambahan kumpulan Tugas ke Pekerjaan.
TaskAddParameter	Tugas Azure Batch untuk ditambahkan.
TaskAddResult	Hasil untuk satu Tugas ditambahkan sebagai bagian dari operasi tambahkan kumpulan Tugas.
TaskAddStatus	Status permintaan tambahkan Tugas.
TaskConstraints	Batasan eksekusi untuk diterapkan ke Tugas.
TaskContainerSettings	Pengaturan kontainer untuk Tugas.
TaskDependencies	Menentukan dependensi Tugas apa pun. Tugas apa pun yang ditentukan secara eksplisit atau dalam rentang dependensi harus diselesaikan sebelum Tugas dependan akan dijadwalkan.
TaskIdRange	Rentang ID Tugas yang bisa diandalkan tugas. Semua Tugas dengan ID dalam rentang harus berhasil diselesaikan sebelum Tugas dependen dapat dijadwalkan.
UserIdentity	Definisi identitas pengguna tempat Tugas dijalankan.

AccessScope

Sumber daya Batch tempat token memberikan akses.

Nama	Jenis	Deskripsi
job	string	Memberikan akses untuk melakukan semua operasi pada Pekerjaan yang berisi Tugas.

AffinityInformation

Petunjuk lokalitas yang dapat digunakan oleh layanan Batch untuk memilih Simpul Komputasi tempat memulai Tugas.

Nama	Jenis	Deskripsi
affinityId	string	String buram yang mewakili lokasi Simpul Komputasi atau Tugas yang telah berjalan sebelumnya. 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.

ApplicationPackageReference

Referensi ke Paket yang akan disebarkan ke Simpul Komputasi.

Nama	Jenis	Deskripsi
applicationId	string	ID aplikasi yang akan disebarkan. Saat membuat kumpulan, ID aplikasi paket harus sepenuhnya memenuhi syarat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Versi aplikasi yang akan disebarkan. Jika dihilangkan, versi default disebarkan. Jika ini dihilangkan pada Kumpulan, dan tidak ada versi default yang ditentukan untuk aplikasi ini, permintaan gagal dengan kode kesalahan InvalidApplicationPackageReferences dan kode status HTTP 409. Jika ini dihilangkan pada Tugas, dan tidak ada versi default yang ditentukan untuk aplikasi ini, Tugas gagal dengan kesalahan pra-pemrosesan.

AuthenticationTokenSettings

Pengaturan untuk token autentikasi yang dapat digunakan Tugas untuk melakukan operasi layanan Batch.

Nama	Jenis	Deskripsi
access	AccessScope[]	Sumber daya Batch tempat token memberikan akses. Token autentikasi memberikan akses ke serangkaian operasi layanan Batch terbatas. Saat ini satu-satunya nilai yang didukung untuk properti akses adalah 'pekerjaan', yang memberikan akses ke semua operasi yang terkait dengan Pekerjaan yang berisi Tugas.

AutoUserScope

Cakupan untuk pengguna otomatis

Nama	Jenis	Deskripsi
pool	string	Menentukan bahwa Tugas berjalan sebagai Akun pengguna otomatis umum yang dibuat pada setiap Simpul Komputasi dalam Kumpulan.
task	string	Menentukan bahwa layanan harus membuat pengguna baru untuk Tugas.

AutoUserSpecification

Menentukan parameter untuk pengguna otomatis yang menjalankan Tugas pada layanan Batch.

Nama	Jenis	Deskripsi
elevationLevel	ElevationLevel	Tingkat elevasi pengguna otomatis. Nilai defaultnya adalah nonAdmin.
scope	AutoUserScope	Cakupan untuk pengguna otomatis Nilai defaultnya adalah kumpulan. Jika kumpulan menjalankan Windows, nilai Tugas harus ditentukan jika isolasi yang lebih ketat antar tugas diperlukan. Misalnya, jika tugas memutasi registri dengan cara yang dapat memengaruhi tugas lain, atau jika sertifikat telah ditentukan pada kumpulan yang seharusnya tidak dapat diakses oleh tugas normal tetapi harus dapat diakses oleh StartTasks.

BatchError

Respons kesalahan diterima dari layanan Azure Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
message	ErrorMessage	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
values	BatchErrorDetail[]	Kumpulan pasangan kunci-nilai yang berisi detail tambahan tentang kesalahan.

BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
key	string	Pengidentifikasi yang menentukan arti properti Nilai.
value	string	Informasi tambahan yang disertakan dengan respons kesalahan.

ComputeNodeIdentityReference

Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.

Nama	Jenis	Deskripsi
resourceId	string	Id sumber daya ARM dari identitas yang ditetapkan pengguna.

ContainerHostBatchBindMountEntry

Entri jalur dan mode pemasangan yang ingin Anda pasang ke dalam kontainer tugas.

Nama	Jenis	Deskripsi
isReadOnly	boolean	Pasang jalur sumber ini sebagai mode baca-saja atau tidak. Nilai defaultnya adalah false (mode baca/tulis). Untuk Linux, jika Anda memasang jalur ini sebagai mode baca/tulis, ini tidak berarti bahwa semua pengguna dalam kontainer memiliki akses baca/tulis untuk jalur, itu tergantung pada akses di VM host. Jika jalur ini dipasang baca-saja, semua pengguna dalam kontainer tidak akan dapat mengubah jalur.
source	ContainerHostDataPath	Jalur yang dipasang ke pelanggan kontainer dapat memilih.

ContainerHostDataPath

Jalur yang akan dipasang ke kontainer tugas kontainer.

Nama	Jenis	Deskripsi
Applications	string	Jalur aplikasi.
JobPrep	string	Jalur tugas persiapan pekerjaan.
Shared	string	Jalur untuk tugas multi-instans untuk berbagi file mereka.
Startup	string	Jalur untuk memulai tugas.
Task	string	Jalur tugas.
VfsMounts	string	Jalur berisi semua sistem file virtual dipasang pada simpul ini.

ContainerRegistry

Registri kontainer privat.

Nama	Jenis	Deskripsi
identityReference	ComputeNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Container Registry alih-alih nama pengguna dan kata sandi. Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.
password	string	Kata sandi untuk masuk ke server registri.
registryServer	string	URL registri. Jika dihilangkan, defaultnya adalah "docker.io".
username	string	Nama pengguna untuk masuk ke server registri.

ContainerWorkingDirectory

Lokasi direktori kerja Tugas kontainer.

Nama	Jenis	Deskripsi
containerImageDefault	string	Gunakan direktori kerja yang ditentukan dalam Gambar kontainer. Waspadalah bahwa direktori ini tidak akan berisi File Sumber Daya yang diunduh oleh Batch.
taskWorkingDirectory	string	Gunakan direktori kerja Tugas layanan Batch standar, yang akan berisi File Sumber Daya Tugas yang diisi oleh Batch.

DependencyAction

Tindakan yang dilakukan layanan Batch pada Tugas yang bergantung pada Tugas ini.

Nama	Jenis	Deskripsi
block	string	Memblokir tugas yang menunggu tugas ini, mencegahnya dijadwalkan.
satisfy	string	Memuaskan tugas yang menunggu tugas ini; setelah semua dependensi terpenuhi, tugas akan dijadwalkan untuk dijalankan.

ElevationLevel

Tingkat elevasi pengguna.

Nama	Jenis	Deskripsi
admin	string	Pengguna adalah pengguna dengan akses yang ditinggikan dan beroperasi dengan izin Administrator penuh.
nonadmin	string	Pengguna adalah pengguna standar tanpa akses yang ditingkatkan.

EnvironmentSetting

Variabel lingkungan yang akan diatur pada proses Tugas.

Nama	Jenis	Deskripsi
name	string	Nama variabel lingkungan.
value	string	Nilai variabel lingkungan.

ErrorMessage

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
lang	string	Kode bahasa pesan kesalahan
value	string	Teks pesan.

ExitCodeMapping

Bagaimana layanan Batch harus merespons jika Tugas keluar dengan kode keluar tertentu.

Nama	Jenis	Deskripsi
code	integer	Kode keluar proses.
exitOptions	ExitOptions	Bagaimana layanan Batch harus merespons jika Tugas keluar dengan kode keluar ini.

ExitCodeRangeMapping

Berbagai kode keluar dan bagaimana layanan Batch harus merespons kode keluar dalam rentang tersebut.

Nama	Jenis	Deskripsi
end	integer	Kode keluar terakhir dalam rentang.
exitOptions	ExitOptions	Bagaimana layanan Batch harus merespons jika Tugas keluar dengan kode keluar dalam rentang mulai ke ujung (inklusif).
start	integer	Kode keluar pertama dalam rentang.

ExitConditions

Menentukan bagaimana layanan Batch harus merespons ketika Tugas selesai.

Nama	Jenis	Deskripsi
default	ExitOptions	Bagaimana layanan Batch harus merespons jika Tugas gagal dengan kondisi keluar yang tidak tercakup oleh salah satu properti lainnya. Nilai ini digunakan jika Tugas keluar dengan kode keluar bukan nol yang tidak tercantum dalam koleksi exitCodes atau exitCodeRanges, dengan kesalahan pra-pemrosesan jika properti preProcessingError tidak ada, atau dengan kesalahan pengunggahan file jika properti fileUploadError tidak ada. Jika Anda menginginkan perilaku non-default pada kode keluar 0, Anda harus mencantumkannya secara eksplisit menggunakan koleksi exitCodes atau exitCodeRanges.
exitCodeRanges	ExitCodeRangeMapping[]	Daftar rentang kode keluar Tugas dan bagaimana layanan Batch harus meresponsnya.
exitCodes	ExitCodeMapping[]	Daftar kode keluar Tugas individual dan bagaimana layanan Batch harus meresponsnya.
fileUploadError	ExitOptions	Bagaimana layanan Batch harus merespons jika terjadi kesalahan unggahan file. Jika Tugas keluar dengan kode keluar yang ditentukan melalui exitCodes atau exitCodeRanges, lalu mengalami kesalahan pengunggahan file, tindakan yang ditentukan oleh kode keluar lebih diutamakan.
preProcessingError	ExitOptions	Bagaimana layanan Batch harus merespons jika Tugas gagal dimulai karena kesalahan.

ExitOptions

Menentukan bagaimana layanan Batch merespons kondisi keluar tertentu.

Nama	Jenis	Deskripsi
dependencyAction	DependencyAction	Tindakan yang dilakukan layanan Batch pada Tugas yang bergantung pada Tugas ini. Nilai yang mungkin 'memuaskan' (memungkinkan tugas dependen untuk maju) dan 'blokir' (tugas dependen terus menunggu). Batch belum mendukung pembatalan tugas dependen.
jobAction	JobAction	Tindakan yang harus diambil pada Pekerjaan yang berisi Tugas, jika Tugas selesai dengan kondisi keluar yang diberikan dan properti OnTaskFailed Pekerjaan adalah 'performExitOptionsJobAction'. Defaultnya tidak ada untuk kode keluar 0 dan dihentikan untuk semua kondisi keluar lainnya. Jika properti OnTaskFailed Pekerjaan adalah noaction, maka menentukan properti ini mengembalikan kesalahan dan permintaan tambahkan Tugas gagal dengan kesalahan nilai properti yang tidak valid; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

HttpHeader

Pasangan nama-nilai header HTTP

Nama	Jenis	Deskripsi
name	string	Nama header yang tidak peka huruf besar/kecil yang akan digunakan saat mengunggah file output
value	string	Nilai header yang akan digunakan saat mengunggah file output

JobAction

Tindakan yang harus diambil pada Pekerjaan yang berisi Tugas, jika Tugas selesai dengan kondisi keluar yang diberikan dan properti OnTaskFailed Pekerjaan adalah 'performExitOptionsJobAction'.

Nama	Jenis	Deskripsi
disable	string	Nonaktifkan Pekerjaan. Ini setara dengan memanggil Api Pekerjaan nonaktifkan, dengan nilai disableTasks antrean ulang.
none	string	Jangan ambil tindakan.
terminate	string	Hentikan Pekerjaan. TerminateReason dalam Job's executionInfo diatur ke "TaskFailed".

MultiInstanceSettings

Pengaturan yang menentukan cara menjalankan Tugas multi-instans.

Nama	Jenis	Deskripsi
commonResourceFiles	ResourceFile[]	Daftar file yang akan diunduh layanan Batch sebelum menjalankan baris perintah koordinasi. Perbedaan antara file sumber daya umum dan file sumber daya Tugas adalah bahwa file sumber daya umum diunduh untuk semua subtugas termasuk yang utama, sedangkan file sumber daya Tugas hanya diunduh untuk file utama. Perhatikan juga bahwa file sumber daya ini tidak diunduh ke direktori kerja Tugas, tetapi sebaliknya diunduh ke direktori akar Tugas (satu direktori di atas direktori kerja). 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.
coordinationCommandLine	string	Baris perintah yang akan dijalankan pada semua Simpul Komputasi untuk memungkinkannya berkoordinasi saat primer menjalankan perintah Tugas utama. Baris perintah koordinasi umum meluncurkan layanan latar belakang dan memverifikasi bahwa layanan siap untuk memproses pesan antar-simpul.
numberOfInstances	integer	Jumlah Simpul Komputasi yang diperlukan oleh Tugas. Jika dihilangkan, defaultnya adalah 1.

OutputFile

Spesifikasi untuk mengunggah file dari Simpul Komputasi Azure Batch ke lokasi lain setelah layanan Batch selesai menjalankan proses Tugas.

Nama	Jenis	Deskripsi
destination	OutputFileDestination	Tujuan untuk file output.
filePattern	string	Pola yang menunjukkan file mana yang akan diunggah. Jalur relatif dan absolut didukung. Jalur relatif relatif terhadap direktori kerja Tugas. Wildcard berikut didukung: * cocok dengan 0 karakter atau lebih (misalnya pola abc* akan cocok dengan abc atau abcdef), ** cocok dengan direktori apa pun, ? cocok dengan satu karakter, [abc] cocok dengan satu karakter dalam tanda kurung siku, dan [a-c] cocok dengan satu karakter dalam rentang. Tanda kurung dapat menyertakan negasi untuk mencocokkan karakter apa pun yang tidak ditentukan (misalnya [!abc] cocok dengan karakter apa pun tetapi a, b, atau c). Jika nama file dimulai dengan "." itu diabaikan secara default tetapi dapat dicocokkan dengan menentukannya secara eksplisit (misalnya .gif tidak akan cocok dengan .a.gif, tetapi ..gif akan). Contoh sederhana: **.txt cocok dengan file apa pun yang tidak dimulai di '.' dan berakhir dengan .txt di direktori kerja Tugas atau subdirektori apa pun. Jika nama file berisi karakter kartubebas, itu dapat diloloskan menggunakan tanda kurung siku (misalnya abc[] akan cocok dengan file bernama abc*). Perhatikan bahwa \ dan / diperlakukan sebagai pemisah direktori di Windows, tetapi hanya / ada di Linux. Variabel lingkungan (%var% pada Windows atau $var di Linux) diperluas sebelum pola diterapkan.
uploadOptions	OutputFileUploadOptions	Opsi tambahan untuk operasi unggahan, termasuk dalam kondisi apa untuk melakukan unggahan.

OutputFileBlobContainerDestination

Menentukan tujuan unggahan file dalam kontainer penyimpanan blob Azure.

Nama	Jenis	Deskripsi
containerUrl	string	URL kontainer dalam Azure Blob Storage untuk mengunggah file. Jika tidak menggunakan identitas terkelola, URL harus menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin tulis ke kontainer.
identityReference	ComputeNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Blob Storage yang ditentukan oleh containerUrl Identitas harus memiliki akses tulis ke kontainer Azure Blob Storage
path	string	Blob tujuan atau direktori virtual dalam kontainer Azure Storage. Jika filePattern mengacu pada file tertentu (yaitu tidak berisi kartubebas), maka jalur adalah nama blob yang akan diunggah file tersebut. Jika filePattern berisi satu atau beberapa kartubebas (dan oleh karena itu mungkin cocok dengan beberapa file), maka jalur adalah nama direktori virtual blob (yang sebelumnya ditujukan ke setiap nama blob) untuk mengunggah file. Jika dihilangkan, file diunggah ke akar kontainer dengan nama blob yang cocok dengan nama file mereka.
uploadHeaders	HttpHeader[]	Daftar pasangan nama-nilai untuk header yang akan digunakan dalam mengunggah file output Header ini akan ditentukan saat mengunggah file ke Azure Storage. Dokumen resmi tentang header yang diizinkan saat mengunggah blob: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Tujuan tempat file harus diunggah.

Nama	Jenis	Deskripsi
container	OutputFileBlobContainerDestination	Lokasi di penyimpanan blob Azure tempat file diunggah.

OutputFileUploadCondition

Kondisi di mana file output Tugas atau sekumpulan file harus diunggah.

Nama	Jenis	Deskripsi
taskcompletion	string	Unggah file setelah proses Tugas keluar, apa pun kode keluarnya.
taskfailure	string	Unggah file hanya setelah proses Tugas keluar dengan kode keluar bukan nol.
tasksuccess	string	Unggah file hanya setelah proses Tugas keluar dengan kode keluar 0.

OutputFileUploadOptions

Detail tentang operasi pengunggahan file output, termasuk dalam kondisi apa untuk melakukan unggahan.

Nama	Jenis	Deskripsi
uploadCondition	OutputFileUploadCondition	Kondisi di mana file output Tugas atau sekumpulan file harus diunggah. Defaultnya adalah pelengkapan tugas.

ResourceFile

Satu file atau beberapa file yang akan diunduh ke Simpul Komputasi.

Nama	Jenis	Deskripsi
autoStorageContainerName	string	Nama kontainer penyimpanan di Akun penyimpanan otomatis. Properti autoStorageContainerName, storageContainerUrl, dan httpUrl saling eksklusif dan salah satunya harus ditentukan.
blobPrefix	string	Awalan blob yang akan digunakan saat mengunduh blob dari kontainer Azure Storage. Hanya blob yang namanya dimulai dengan awalan yang ditentukan yang akan diunduh. Properti hanya valid ketika autoStorageContainerName atau storageContainerUrl digunakan. Awalan ini bisa berupa nama file parsial atau subdirektori. Jika awalan tidak ditentukan, semua file dalam kontainer akan diunduh.
fileMode	string	Atribut mode izin file dalam format oktal. Properti ini hanya berlaku untuk file yang diunduh ke Simpul Komputasi Linux. Ini akan diabaikan jika ditentukan untuk resourceFile yang akan diunduh ke Simpul Komputasi Windows. Jika properti ini tidak ditentukan untuk Simpul Komputasi Linux, maka nilai default 0770 diterapkan ke file.
filePath	string	Lokasi pada Simpul Komputasi untuk mengunduh file, relatif terhadap direktori kerja Tugas. Jika properti httpUrl ditentukan, filePath diperlukan dan menjelaskan jalur tempat file akan diunduh, termasuk nama file. Jika tidak, jika properti autoStorageContainerName atau storageContainerUrl ditentukan, filePath bersifat opsional dan merupakan direktori untuk mengunduh file. Dalam kasus di mana filePath digunakan sebagai direktori, struktur direktori apa pun yang sudah terkait dengan data input akan disimpan secara penuh dan ditambahkan ke direktori filePath yang ditentukan. Jalur relatif yang ditentukan tidak dapat keluar dari direktori kerja Tugas (misalnya dengan menggunakan '..').
httpUrl	string	URL file yang akan diunduh. Properti autoStorageContainerName, storageContainerUrl, dan httpUrl saling eksklusif dan salah satunya harus ditentukan. Jika URL menunjuk ke Azure Blob Storage, URL harus dapat dibaca dari simpul komputasi. Ada tiga cara untuk mendapatkan URL tersebut untuk blob di penyimpanan Azure: menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin baca pada blob, menggunakan identitas terkelola dengan izin baca, atau atur ACL untuk blob atau kontainernya untuk memungkinkan akses publik.
identityReference	ComputeNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Blob Storage yang ditentukan oleh storageContainerUrl atau httpUrl Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.
storageContainerUrl	string	URL kontainer blob dalam Azure Blob Storage. Properti autoStorageContainerName, storageContainerUrl, dan httpUrl saling eksklusif dan salah satunya harus ditentukan. URL ini harus dapat dibaca dan dapat dicantumkan dari simpul komputasi. Ada tiga cara untuk mendapatkan URL tersebut untuk kontainer di penyimpanan Azure: menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin baca dan daftar pada kontainer, menggunakan identitas terkelola dengan izin baca dan daftar, atau atur ACL untuk kontainer untuk mengizinkan akses publik.