Pools - Replace Pool Properties

Layanan:: Batch Service

Versi API:: 2025-06-01

Memperbarui properti Kumpulan yang ditentukan.
Ini sepenuhnya menggantikan semua properti Kolam yang dapat diperbarui. Misalnya, jika Kumpulan memiliki StartTask yang terkait dengannya dan jika StartTask tidak ditentukan dengan permintaan ini, maka layanan Batch akan menghapus StartTask yang ada.

POST {endpoint}/pools/{poolId}/updateproperties?api-version=2025-06-01

Dengan parameter opsional:

POST {endpoint}/pools/{poolId}/updateproperties?api-version=2025-06-01&timeOut={timeOut}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (uri)	Titik akhir akun batch (misalnya: https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	ID Kumpulan yang akan diperbarui.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
timeOut	query		integer (int32)	Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 30 detik. Jika nilainya lebih besar dari 30, defaultnya akan digunakan sebagai gantinya.".

Header Permintaan

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

Nama	Jenis	Deskripsi
client-request-id	string	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-rfc7231)	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
applicationPackageReferences	True	BatchApplicationPackageReference[]	Daftar Paket Aplikasi yang akan diinstal pada setiap Simpul Komputasi di Kumpulan. Daftar menggantikan referensi Paket Aplikasi yang ada pada Kumpulan. Perubahan pada referensi Paket Aplikasi memengaruhi semua Simpul Komputasi baru yang bergabung dengan Kumpulan, tetapi tidak memengaruhi Simpul Komputasi yang sudah ada di Kumpulan hingga di-boot ulang atau digambut ulang. Ada maksimum 10 referensi Paket Aplikasi pada Kumpulan tertentu. Jika dihilangkan, atau jika Anda menentukan koleksi kosong, referensi Paket Aplikasi yang ada akan dihapus dari Kumpulan. Maksimum 10 referensi dapat ditentukan pada Kumpulan tertentu.
metadata	True	BatchMetadataItem[]	Daftar pasangan nilai nama yang terkait dengan Kumpulan sebagai metadata. Daftar ini menggantikan metadata yang ada yang dikonfigurasi pada Kumpulan. Jika dihilangkan, atau jika Anda menentukan koleksi kosong, metadata yang ada akan dihapus dari Kumpulan.
startTask		BatchStartTask	Tugas untuk dijalankan pada setiap Simpul Komputasi saat bergabung dengan Kumpulan. Tugas berjalan ketika Simpul Komputasi ditambahkan ke Kumpulan atau ketika Simpul Komputasi dimulai ulang. Jika elemen ini ada, elemen ini menimpa StartTask yang ada. Jika dihilangkan, StartTask yang ada akan dihapus dari Kumpulan.

Respons

Nama	Jenis	Deskripsi
204 No Content		Tidak ada konten untuk dikirim untuk permintaan ini, tetapi header mungkin berguna. Header DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

204 No Content

Tidak ada konten untuk dikirim untuk permintaan ini, tetapi header mungkin berguna.

Header

DataServiceId: string
ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Respons kesalahan tak terduga.

Keamanan

OAuth2Auth

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

Cakupan

Nama	Deskripsi
https://batch.core.windows.net//.default

Contoh

Pool update

Permintaan sampel

HTTP

POST {endpoint}/pools/poolId/updateproperties?api-version=2025-06-01



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "applicationPackageReferences": [],
  "metadata": []
}

Respon sampel

Kode status:: 204

Definisi

Nama	Deskripsi
AutoUserScope	Enum AutoUserScope
AutoUserSpecification	Menentukan opsi untuk pengguna otomatis yang menjalankan Tugas Azure Batch.
BatchApplicationPackageReference	Referensi ke Paket yang akan disebarkan ke Simpul Komputasi.
BatchError	Respons kesalahan diterima dari layanan Azure Batch.
BatchErrorDetail	Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
BatchErrorMessage	Pesan kesalahan diterima dalam respons kesalahan Azure Batch.
BatchMetadataItem	Layanan Batch tidak menetapkan arti apa pun untuk metadata ini; hanya untuk penggunaan kode pengguna.
BatchNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.
BatchPoolReplaceOptions	Parameter untuk mengganti properti pada Kumpulan Azure Batch.
BatchStartTask	Batch akan mencoba kembali Tugas ketika operasi pemulihan dipicu pada Node. Contoh operasi pemulihan termasuk (tetapi tidak terbatas pada) ketika Node yang tidak sehat di-boot ulang atau Simpul Komputasi menghilang karena kegagalan host. Percobaan ulang karena operasi pemulihan tidak bergantung pada dan tidak dihitung terhadap maxTaskRetryCount. Bahkan jika maxTaskRetryCount adalah 0, coba lagi internal karena operasi pemulihan dapat terjadi. Karena itu, semua Tugas harus idempotoen. Ini berarti Tugas perlu mentolerir terganggu dan dimulai ulang tanpa menyebabkan kerusakan atau data duplikat. Praktik terbaik untuk Tugas yang berjalan lama adalah menggunakan beberapa bentuk titik pemeriksaan. Dalam beberapa kasus, StartTask mungkin dijalankan kembali meskipun Simpul Komputasi tidak di-boot ulang. Perawatan khusus harus dilakukan untuk menghindari StartTasks yang membuat proses breakaway atau menginstal/meluncurkan layanan dari direktori kerja StartTask, karena ini akan memblokir Batch agar tidak dapat menjalankan kembali StartTask.
BatchTaskContainerSettings	Pengaturan kontainer untuk Tugas.
ContainerHostBatchBindMountEntry	Entri jalur dan mode pemasangan yang ingin Anda pasang ke dalam kontainer tugas.
ContainerHostDataPath	Jalur yang akan dipasang ke kontainer tugas kontainer.
ContainerRegistryReference	Registri kontainer privat.
ContainerWorkingDirectory	Enum ContainerWorkingDirectory
ElevationLevel	Enum ElevationLevel
EnvironmentSetting	Variabel lingkungan yang akan diatur pada proses Tugas.
ResourceFile	Satu file atau beberapa file yang akan diunduh ke Simpul Komputasi.
UserIdentity	Definisi identitas pengguna tempat Tugas dijalankan. Tentukan properti userName atau autoUser, tetapi tidak keduanya.

AutoUserScope

Enumerasi

Enum AutoUserScope

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

AutoUserSpecification

Objek

Menentukan opsi untuk pengguna otomatis yang menjalankan Tugas Azure 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.

BatchApplicationPackageReference

Objek

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.

BatchError

Objek

Respons kesalahan diterima dari layanan Azure Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
message	BatchErrorMessage	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

Objek

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.

BatchErrorMessage

Objek

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

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

BatchMetadataItem

Objek

Layanan Batch tidak menetapkan arti apa pun untuk metadata ini; hanya untuk penggunaan kode pengguna.

Nama	Jenis	Deskripsi
name	string	Nama item metadata.
value	string	Nilai item metadata.

BatchNodeIdentityReference

Objek

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

Nama	Jenis	Deskripsi
resourceId	string (arm-id)	Id sumber daya ARM dari identitas yang ditetapkan pengguna.

BatchPoolReplaceOptions

Objek

Parameter untuk mengganti properti pada Kumpulan Azure Batch.

Nama	Jenis	Deskripsi
applicationPackageReferences	BatchApplicationPackageReference[]	Daftar Paket Aplikasi yang akan diinstal pada setiap Simpul Komputasi di Kumpulan. Daftar menggantikan referensi Paket Aplikasi yang ada pada Kumpulan. Perubahan pada referensi Paket Aplikasi memengaruhi semua Simpul Komputasi baru yang bergabung dengan Kumpulan, tetapi tidak memengaruhi Simpul Komputasi yang sudah ada di Kumpulan hingga di-boot ulang atau digambut ulang. Ada maksimum 10 referensi Paket Aplikasi pada Kumpulan tertentu. Jika dihilangkan, atau jika Anda menentukan koleksi kosong, referensi Paket Aplikasi yang ada akan dihapus dari Kumpulan. Maksimum 10 referensi dapat ditentukan pada Kumpulan tertentu.
metadata	BatchMetadataItem[]	Daftar pasangan nilai nama yang terkait dengan Kumpulan sebagai metadata. Daftar ini menggantikan metadata yang ada yang dikonfigurasi pada Kumpulan. Jika dihilangkan, atau jika Anda menentukan koleksi kosong, metadata yang ada akan dihapus dari Kumpulan.
startTask	BatchStartTask	Tugas untuk dijalankan pada setiap Simpul Komputasi saat bergabung dengan Kumpulan. Tugas berjalan ketika Simpul Komputasi ditambahkan ke Kumpulan atau ketika Simpul Komputasi dimulai ulang. Jika elemen ini ada, elemen ini menimpa StartTask yang ada. Jika dihilangkan, StartTask yang ada akan dihapus dari Kumpulan.

BatchStartTask

Objek

Batch akan mencoba kembali Tugas ketika operasi pemulihan dipicu pada Node. Contoh operasi pemulihan termasuk (tetapi tidak terbatas pada) ketika Node yang tidak sehat di-boot ulang atau Simpul Komputasi menghilang karena kegagalan host. Percobaan ulang karena operasi pemulihan tidak bergantung pada dan tidak dihitung terhadap maxTaskRetryCount. Bahkan jika maxTaskRetryCount adalah 0, coba lagi internal karena operasi pemulihan dapat terjadi. Karena itu, semua Tugas harus idempotoen. Ini berarti Tugas perlu mentolerir terganggu dan dimulai ulang tanpa menyebabkan kerusakan atau data duplikat. Praktik terbaik untuk Tugas yang berjalan lama adalah menggunakan beberapa bentuk titik pemeriksaan. Dalam beberapa kasus, StartTask mungkin dijalankan kembali meskipun Simpul Komputasi tidak di-boot ulang. Perawatan khusus harus dilakukan untuk menghindari StartTasks yang membuat proses breakaway atau menginstal/meluncurkan layanan dari direktori kerja StartTask, karena ini akan memblokir Batch agar tidak dapat menjalankan kembali StartTask.

Nama	Jenis	Deskripsi
commandLine	string	Baris perintah StartTask. 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	BatchTaskContainerSettings	Pengaturan untuk kontainer tempat StartTask berjalan. Ketika ini ditentukan, semua direktori secara rekursif di bawah AZ_BATCH_NODE_ROOT_DIR (akar direktori Azure Batch pada simpul) dipetakan ke dalam kontainer, semua variabel lingkungan Tugas dipetakan ke dalam kontainer, dan baris perintah Tugas dijalankan dalam kontainer. File yang dihasilkan dalam kontainer di luar AZ_BATCH_NODE_ROOT_DIR mungkin tidak tercermin ke disk host, yang berarti bahwa API file Batch tidak akan dapat mengakses file tersebut.
environmentSettings	EnvironmentSetting[]	Daftar pengaturan variabel lingkungan untuk StartTask.
maxTaskRetryCount	integer (int32)	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. 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. 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).
resourceFiles	ResourceFile[]	Daftar file yang akan diunduh layanan Batch ke Simpul Komputasi sebelum menjalankan baris perintah. 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. File yang tercantum di bawah elemen ini terletak di direktori kerja Tugas.
userIdentity	UserIdentity	Identitas pengguna tempat StartTask berjalan. Jika dihilangkan, Tugas berjalan sebagai pengguna non-administratif yang unik untuk Tugas.
waitForSuccess	boolean	Apakah layanan Batch harus menunggu StartTask berhasil diselesaikan (yaitu, keluar dengan kode keluar 0) sebelum menjadwalkan Tugas apa pun pada Simpul Komputasi. Jika true dan StartTask gagal pada Node, layanan Batch mencoba kembali StartTask hingga jumlah coba lagi maksimumnya (maxTaskRetryCount). Jika Tugas masih belum berhasil diselesaikan setelah semua percobaan ulang, maka layanan Batch menandai Simpul tidak dapat digunakan, dan tidak akan menjadwalkan Tugas ke dalamnya. Kondisi ini dapat dideteksi melalui status Simpul Komputasi dan detail info kegagalan. Jika false, layanan Batch tidak akan menunggu StartTask selesai. Dalam hal ini, Tugas lain dapat mulai dijalankan pada Simpul Komputasi saat StartTask masih berjalan; dan bahkan jika StartTask gagal, Tugas baru akan terus dijadwalkan pada Simpul Komputasi. Nilai bawaan adalah benar.

BatchTaskContainerSettings

Objek

Pengaturan kontainer untuk Tugas.

Nama	Jenis	Deskripsi
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Jalur yang ingin Anda pasang ke tugas kontainer. Jika array ini null atau tidak ada, tugas kontainer akan memasang seluruh drive disk sementara di windows (atau AZ_BATCH_NODE_ROOT_DIR di Linux). Ini tidak akan memasang jalur data apa pun ke dalam kontainer jika array ini diatur sebagai kosong.
containerRunOptions	string	Opsi tambahan untuk perintah buat kontainer. Opsi tambahan ini disediakan sebagai argumen ke perintah "buat docker", selain yang dikontrol oleh Layanan Batch.
imageName	string	Gambar yang akan digunakan untuk membuat kontainer tempat Tugas akan berjalan. Ini adalah referensi Gambar lengkap, seperti yang akan ditentukan untuk "docker pull". Jika tidak ada tag yang disediakan sebagai bagian dari nama Gambar, tag ":latest" digunakan sebagai default.
registry	ContainerRegistryReference	Registri pribadi yang berisi Gambar kontainer. Pengaturan ini dapat dihilangkan jika sudah disediakan pada pembuatan Kumpulan.
workingDirectory	ContainerWorkingDirectory	Lokasi direktori kerja tugas kontainer. Defaultnya adalah 'taskWorkingDirectory'.

ContainerHostBatchBindMountEntry

Objek

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

Enumerasi

Jalur yang akan dipasang ke kontainer tugas kontainer.

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

ContainerRegistryReference

Objek

Registri kontainer privat.

Nama	Jenis	Deskripsi
identityReference	BatchNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Container Registry alih-alih nama pengguna dan kata sandi.
password	string (password)	Kata sandi untuk masuk ke server registri.
registryServer	string (uri)	URL registri. Jika dihilangkan, defaultnya adalah "docker.io".
username	string	Nama pengguna untuk masuk ke server registri.

ContainerWorkingDirectory

Enumerasi

Enum ContainerWorkingDirectory

Nilai	Deskripsi
taskWorkingDirectory	Gunakan direktori kerja Tugas layanan Batch standar, yang akan berisi File Sumber Daya Tugas yang diisi oleh Batch.
containerImageDefault	Gunakan direktori kerja yang ditentukan dalam Gambar kontainer. Berhati-hatilah karena direktori ini tidak akan berisi File Sumber Daya yang diunduh oleh Batch.

ElevationLevel

Enumerasi

Enum ElevationLevel

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

EnvironmentSetting

Objek

Variabel lingkungan yang akan diatur pada proses Tugas.

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

ResourceFile

Objek

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 Linux Compute Node. Ini akan diabaikan jika ditentukan untuk resourceFile yang akan diunduh ke Node Komputasi Windows. Jika properti ini tidak ditentukan untuk Node Komputasi Linux, maka nilai default 0770 diterapkan ke file.
filePath	string	Lokasi pada Node Komputasi tempat 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 (uri)	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	BatchNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Blob Storage yang ditentukan oleh storageContainerUrl atau httpUrl.
storageContainerUrl	string (uri)	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.

UserIdentity

Objek

Definisi identitas pengguna tempat Tugas dijalankan. Tentukan properti userName atau autoUser, tetapi tidak keduanya.

Nama	Jenis	Deskripsi
autoUser	AutoUserSpecification	Pengguna otomatis tempat Tugas dijalankan. Properti userName dan autoUser saling eksklusif; Anda harus menentukan satu tetapi tidak keduanya.
username	string	Nama identitas pengguna tempat Tugas dijalankan. Properti userName dan autoUser saling eksklusif; Anda harus menentukan satu tetapi tidak keduanya.