Nodes - List Nodes

Layanan:: Batch Service

Versi API:: 2025-06-01

Mencantumkan Node Komputasi di Kumpulan yang ditentukan.

GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01

Dengan parameter opsional:

GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&$select={$select}

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 tempat Anda ingin mencantumkan Node Komputasi.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
$filter	query		string	Klausa $filter OData. Untuk informasi selengkapnya tentang membuat filter ini, lihat https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool.
$select	query		string[]	Klausa $select OData.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Jumlah maksimum item yang akan dikembalikan dalam respons. Maksimal 1000 aplikasi dapat dikembalikan.
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

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.

Respons

Nama	Jenis	Deskripsi
200 OK	BatchNodeListResult	Permintaan telah berhasil. Header ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

BatchNodeListResult

Permintaan telah berhasil.

Header

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

Node list

Permintaan sampel

HTTP

GET {endpoint}/pools/poolId/nodes?api-version=2025-06-01

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "id": "tvm-1695681911_1-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T22:22:27.2236818Z",
      "lastBootTime": "2025-11-22T22:22:24.4634125Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T22:22:27.2236818Z",
        "endTime": "2025-11-22T22:22:27.567189Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_2-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:37:31.4285526Z",
      "lastBootTime": "2025-11-22T19:37:28.623369Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:37:31.4285526Z",
        "endTime": "2025-11-22T19:37:31.838028Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_3-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:36:51.0013378Z",
      "lastBootTime": "2025-11-22T19:36:48.21721Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:36:51.0013378Z",
        "endTime": "2025-11-22T19:36:51.2363447Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AutoUserScope	Enum AutoUserScope
AutoUserSpecification	Menentukan opsi untuk pengguna otomatis yang menjalankan Tugas Azure Batch.
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.
BatchErrorSourceCategory	Enum BatchErrorSourceCategory
BatchNode	Simpul Komputasi dalam layanan Batch.
BatchNodeAgentInfo	Agen Simpul Komputasi Batch adalah program yang berjalan pada setiap Simpul Komputasi di Kumpulan dan menyediakan kemampuan Batch pada Simpul Komputasi.
BatchNodeEndpointConfiguration	Konfigurasi titik akhir untuk Simpul Komputasi.
BatchNodeError	Kesalahan yang ditemui oleh Simpul Komputasi.
BatchNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.
BatchNodeListResult	Hasil daftar Simpul Komputasi dalam Kumpulan.
BatchNodeState	Enum BatchNodeState
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.
BatchStartTaskInfo	Informasi tentang StartTask yang berjalan pada Simpul Komputasi.
BatchStartTaskState	Enum BatchStartTaskState
BatchTaskContainerExecutionInfo	Berisi informasi tentang kontainer yang dijalankan Tugas.
BatchTaskContainerSettings	Pengaturan kontainer untuk Tugas.
BatchTaskExecutionInfo	Informasi tentang eksekusi Tugas.
BatchTaskExecutionResult	Enum BatchTaskExecutionResult
BatchTaskFailureInfo	Informasi tentang kegagalan Tugas.
BatchTaskInfo	Informasi tentang Tugas yang berjalan pada Simpul Komputasi.
BatchTaskState	Enum BatchTaskState
BatchVmImageReference	Referensi ke Gambar Marketplace Azure Virtual Machines atau Gambar Azure Compute Gallery. Untuk mendapatkan daftar semua referensi Gambar Marketplace Azure yang diverifikasi oleh Azure Batch, lihat operasi 'Daftar Gambar yang Didukung'.
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.
InboundEndpoint	Titik akhir masuk pada Simpul Komputasi.
InboundEndpointProtocol	Enum InboundEndpointProtocol
NameValuePair	Mewakili pasangan nama-nilai.
ResourceFile	Satu file atau beberapa file yang akan diunduh ke Simpul Komputasi.
SchedulingState	Enum SchedulingState.
UserIdentity	Definisi identitas pengguna tempat Tugas dijalankan. Tentukan properti userName atau autoUser, tetapi tidak keduanya.
VirtualMachineInfo	Info tentang status komputer virtual saat ini.

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.

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.

BatchErrorSourceCategory

Enumerasi

Enum BatchErrorSourceCategory

Nilai	Deskripsi
usererror	Kesalahan ini disebabkan oleh masalah pengguna, seperti kesalahan konfigurasi.
servererror	Kesalahan ini disebabkan oleh masalah server internal.

BatchNode

Objek

Simpul Komputasi dalam layanan Batch.

Nama	Jenis	Deskripsi
affinityId	string	Pengidentifikasi yang dapat diteruskan saat menambahkan Tugas untuk meminta agar Tugas dijadwalkan pada Simpul Komputasi ini. 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.
allocationTime	string (date-time)	Waktu di mana Simpul Komputasi ini dialokasikan ke Kumpulan. Ini adalah waktu ketika Simpul Komputasi awalnya dialokasikan dan tidak berubah sekali diatur. Ini tidak diperbarui ketika Simpul Komputasi disembuhkan atau didahulukan.
endpointConfiguration	BatchNodeEndpointConfiguration	Konfigurasi titik akhir untuk Simpul Komputasi.
errors	BatchNodeError[]	Daftar kesalahan yang saat ini sedang ditemui oleh Simpul Komputasi.
id	string	ID Simpul Komputasi. Setiap Simpul Komputasi yang ditambahkan ke Kumpulan diberi ID unik. Setiap kali Simpul Komputasi dihapus dari Kumpulan, semua file lokalnya dihapus, dan ID diklaim kembali dan dapat digunakan kembali untuk Simpul Komputasi baru.
ipAddress	string	Alamat IP yang dapat digunakan Node lain untuk berkomunikasi dengan Simpul Komputasi ini. Setiap Simpul Komputasi yang ditambahkan ke Kumpulan diberi alamat IP unik. Setiap kali Simpul Komputasi dihapus dari Kumpulan, semua file lokalnya dihapus, dan alamat IP diklaim kembali dan dapat digunakan kembali untuk Simpul Komputasi baru.
ipv6Address	string	Alamat IPv6 yang dapat digunakan Node lain untuk berkomunikasi dengan Node Komputasi ini. Setiap Simpul Komputasi yang ditambahkan ke Kumpulan diberi alamat IP unik. Setiap kali Simpul Komputasi dihapus dari Kumpulan, semua file lokalnya dihapus, dan alamat IP diklaim kembali dan dapat digunakan kembali untuk Simpul Komputasi baru. Properti ini tidak akan ada jika Kumpulan tidak dikonfigurasi untuk IPv6.
isDedicated	boolean	Apakah Simpul Komputasi ini adalah Simpul Komputasi khusus. Jika false, Simpul Komputasi adalah Simpul Komputasi Spot/Berprioritas rendah.
lastBootTime	string (date-time)	Terakhir kali di mana Simpul Komputasi dimulai. Properti ini mungkin tidak ada jika status Simpul Komputasi tidak dapat digunakan.
nodeAgentInfo	BatchNodeAgentInfo	Informasi tentang versi agen Simpul Komputasi dan waktu Simpul Komputasi ditingkatkan ke versi baru.
recentTasks	BatchTaskInfo[]	Daftar Tugas yang statusnya baru saja berubah. Properti ini hanya ada jika setidaknya satu Tugas telah berjalan pada Simpul Komputasi ini sejak ditetapkan ke Kumpulan.
runningTaskSlotsCount	integer (int32)	Jumlah total slot penjadwalan yang digunakan oleh saat ini menjalankan Tugas Pekerjaan pada Simpul Komputasi. Ini termasuk Tugas Manajer Pekerjaan dan Tugas normal, tetapi bukan Persiapan Pekerjaan, Rilis Pekerjaan, atau Tugas Mulai.
runningTasksCount	integer (int32)	Jumlah total Tugas Pekerjaan yang sedang berjalan pada Simpul Komputasi. Ini termasuk Tugas Manajer Pekerjaan dan Tugas normal, tetapi bukan Persiapan Pekerjaan, Rilis Pekerjaan, atau Tugas Mulai.
schedulingState	SchedulingState	Apakah Simpul Komputasi tersedia untuk Penjadwalan Tugas.
startTask	BatchStartTask	Tugas yang ditentukan untuk dijalankan pada Simpul Komputasi saat bergabung dengan Kumpulan.
startTaskInfo	BatchStartTaskInfo	Informasi runtime tentang eksekusi StartTask pada Simpul Komputasi.
state	BatchNodeState	Status Simpul Komputasi saat ini.
stateTransitionTime	string (date-time)	Waktu saat Simpul Komputasi memasuki statusnya saat ini.
totalTasksRun	integer (int32)	Jumlah total Tugas Pekerjaan yang diselesaikan pada Simpul Komputasi. Ini termasuk Tugas Manajer Pekerjaan dan Tugas normal, tetapi bukan Persiapan Pekerjaan, Rilis Pekerjaan, atau Tugas Mulai.
totalTasksSucceeded	integer (int32)	Jumlah total Tugas Pekerjaan yang berhasil diselesaikan (dengan exitCode 0) pada Simpul Komputasi. Ini termasuk Tugas Manajer Pekerjaan dan Tugas normal, tetapi bukan Persiapan Pekerjaan, Rilis Pekerjaan, atau Tugas Mulai.
url	string (uri)	URL Simpul Komputasi.
virtualMachineInfo	VirtualMachineInfo	Info tentang status komputer virtual saat ini.
vmSize	string	Ukuran komputer virtual yang menghosting Simpul Komputasi. Untuk informasi tentang ukuran komputer virtual yang tersedia di Kumpulan, lihat Memilih ukuran VM untuk Simpul Komputasi di Kumpulan Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

BatchNodeAgentInfo

Objek

Agen Simpul Komputasi Batch adalah program yang berjalan pada setiap Simpul Komputasi di Kumpulan dan menyediakan kemampuan Batch pada Simpul Komputasi.

Nama	Jenis	Deskripsi
lastUpdateTime	string (date-time)	Waktu ketika agen Simpul Komputasi diperbarui pada Simpul Komputasi. Ini adalah terakhir kalinya agen Compute Node diperbarui ke versi baru.
version	string	Versi agen Simpul Komputasi Batch yang berjalan pada Simpul Komputasi. Nomor versi ini dapat diperiksa terhadap catatan rilis agen Compute Node yang terletak di https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

BatchNodeEndpointConfiguration

Objek

Konfigurasi titik akhir untuk Simpul Komputasi.

Nama	Jenis	Deskripsi
inboundEndpoints	InboundEndpoint[]	Daftar titik akhir masuk yang dapat diakses di Compute Node.

BatchNodeError

Objek

Kesalahan yang ditemui oleh Simpul Komputasi.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan Compute Node. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
errorDetails	NameValuePair[]	Daftar detail kesalahan tambahan yang terkait dengan kesalahan Compute Node.
message	string	Pesan yang menjelaskan kesalahan Compute Node, yang dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

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.

BatchNodeListResult

Objek

Hasil daftar Simpul Komputasi dalam Kumpulan.

Nama	Jenis	Deskripsi
odata.nextLink	string (uri)	URL untuk mendapatkan kumpulan hasil berikutnya.
value	BatchNode[]	Daftar Node Komputasi.

BatchNodeState

Enumerasi

Enum BatchNodeState

Nilai	Deskripsi
idle	Node Komputasi saat ini tidak menjalankan Tugas.
rebooting	Compute Node sedang di-boot ulang.
reimaging	Compute Node sedang melakukan pencitraan ulang.
running	Compute Node menjalankan satu atau beberapa Tugas (selain StartTask).
unusable	Node Komputasi tidak dapat digunakan untuk eksekusi Tugas karena kesalahan.
creating	Layanan Batch telah memperoleh komputer virtual yang mendasarinya dari Azure Compute, tetapi belum mulai bergabung dengan Pool.
starting	Layanan Batch dimulai pada komputer virtual yang mendasarinya.
waitingforstarttask	StartTask telah mulai berjalan di Compute Node, tetapi waitForSuccess diatur dan StartTask belum selesai.
starttaskfailed	StartTask telah gagal pada Compute Node (dan menghabiskan semua percobaan ulang), dan waitForSuccess diatur. Compute Node tidak dapat digunakan untuk menjalankan Tasks.
unknown	Layanan Batch telah kehilangan kontak dengan Compute Node, dan tidak mengetahui status sebenarnya.
leavingpool	Node Komputasi meninggalkan Kumpulan, baik karena pengguna secara eksplisit menghapusnya atau karena Kumpulan mengubah ukuran atau menurunkan skala otomatis.
offline	Simpul Komputasi saat ini tidak menjalankan Tugas, dan penjadwalan Tugas baru ke Simpul Komputasi dinonaktifkan.
preempted	Simpul Komputasi Spot/Berprioritas rendah telah didahului. Tugas yang berjalan pada Simpul Komputasi ketika didahulukan akan dijadwalkan ulang ketika Simpul Komputasi lain tersedia.
upgradingos	Node Komputasi sedang menjalani operasi peningkatan OS.
deallocated	Node Komputasi dibatalkan alokasinya.
deallocating	Compute Node membatalkan alokasi.

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.

BatchStartTaskInfo

Objek

Informasi tentang StartTask yang berjalan pada Simpul Komputasi.

Nama	Jenis	Deskripsi
containerInfo	BatchTaskContainerExecutionInfo	Informasi tentang kontainer tempat Tugas dijalankan. Properti ini diatur hanya jika Tugas berjalan dalam konteks kontainer.
endTime	string (date-time)	Waktu di mana StartTask berhenti berjalan. Ini adalah waktu akhir eksekusi terbaru StartTask, jika eksekusi tersebut telah selesai (bahkan jika eksekusi itu gagal dan percobaan lagi tertunda). Elemen ini tidak ada jika StartTask sedang berjalan.
exitCode	integer (int32)	Kode keluar program yang ditentukan pada baris perintah StartTask. Properti ini diatur hanya jika StartTask dalam status selesai. Secara umum, kode keluar untuk suatu proses mencerminkan konvensi khusus yang diterapkan oleh pengembang aplikasi untuk proses tersebut. Jika Anda menggunakan nilai kode keluar untuk membuat keputusan dalam kode Anda, pastikan Anda mengetahui konvensi kode keluar yang digunakan oleh proses aplikasi. Namun, jika layanan Batch mengakhiri StartTask (karena batas waktu, atau penghentian pengguna melalui API), Anda mungkin melihat kode keluar yang ditentukan sistem operasi.
failureInfo	BatchTaskFailureInfo	Informasi yang menjelaskan kegagalan Tugas, jika ada. Properti ini diatur hanya jika Tugas dalam status selesai dan mengalami kegagalan.
lastRetryTime	string (date-time)	Waktu terakhir di mana percobaan ulang Tugas mulai berjalan. Elemen ini hanya ada jika Task dicoba ulang (yaitu retryCount bukan nol). Jika ada, ini biasanya sama dengan startTime, tetapi mungkin berbeda jika Tugas telah dimulai ulang karena alasan selain coba lagi; misalnya, jika Compute Node di-boot ulang selama percobaan ulang, maka startTime diperbarui tetapi lastRetryTime tidak.
result	BatchTaskExecutionResult	Hasil eksekusi Tugas. Jika nilainya 'gagal', maka detail kegagalan dapat ditemukan di properti failureInfo.
retryCount	integer (int32)	Berapa kali Tugas telah dicoba ulang oleh layanan Batch. Kegagalan aplikasi tugas (kode keluar bukan nol) dicoba ulang, kesalahan pra-pemrosesan (Tugas tidak dapat dijalankan) dan kesalahan unggahan file tidak dicoba ulang. Layanan Batch akan mencoba kembali Tugas hingga batas yang ditentukan oleh batasan.
startTime	string (date-time)	Waktu di mana StartTask mulai berjalan. Nilai ini diatur ulang setiap kali Tugas dimulai ulang atau dicoba ulang (yaitu, ini adalah waktu terbaru di mana StartTask mulai berjalan).
state	BatchStartTaskState	Status StartTask pada Node Komputasi.

BatchStartTaskState

Enumerasi

Enum BatchStartTaskState

Nilai	Deskripsi
running	StartTask saat ini sedang berjalan.
completed	StartTask telah keluar dengan kode keluar 0, atau StartTask telah gagal dan batas coba lagi telah tercapai, atau proses StartTask tidak berjalan karena kesalahan persiapan Tugas (seperti kegagalan pengunduhan file sumber daya).

BatchTaskContainerExecutionInfo

Objek

Berisi informasi tentang kontainer yang dijalankan Tugas.

Nama	Jenis	Deskripsi
containerId	string	ID kontainer.
error	string	Informasi kesalahan terperinci tentang kontainer. Ini adalah string kesalahan terperinci dari layanan Docker, jika tersedia. Ini setara dengan bidang kesalahan yang dikembalikan oleh "docker inspect".
state	string	Keadaan kontainer. Ini adalah status kontainer menurut layanan Docker. Ini setara dengan bidang status yang dikembalikan oleh "docker inspect".

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'.

BatchTaskExecutionInfo

Objek

Informasi tentang eksekusi Tugas.

Nama	Jenis	Deskripsi
containerInfo	BatchTaskContainerExecutionInfo	Informasi tentang kontainer tempat Tugas dijalankan. Properti ini diatur hanya jika Tugas berjalan dalam konteks kontainer.
endTime	string (date-time)	Waktu di mana Tugas selesai. Properti ini diatur hanya jika Tugas dalam status Selesai.
exitCode	integer (int32)	Kode keluar program yang ditentukan pada baris perintah Tugas. Properti ini diatur hanya jika Tugas dalam status selesai. Secara umum, kode keluar untuk suatu proses mencerminkan konvensi khusus yang diterapkan oleh pengembang aplikasi untuk proses tersebut. Jika Anda menggunakan nilai kode keluar untuk membuat keputusan dalam kode Anda, pastikan Anda mengetahui konvensi kode keluar yang digunakan oleh proses aplikasi. Namun, jika layanan Batch mengakhiri Tugas (karena batas waktu, atau penghentian pengguna melalui API), Anda mungkin melihat kode keluar yang ditentukan sistem operasi.
failureInfo	BatchTaskFailureInfo	Informasi yang menjelaskan kegagalan Tugas, jika ada. Properti ini diatur hanya jika Tugas dalam status selesai dan mengalami kegagalan.
lastRequeueTime	string (date-time)	Waktu terbaru di mana Tugas telah diantrek ulang oleh layanan Batch sebagai hasil dari permintaan pengguna. Properti ini diatur hanya jika requeueCount bukan nol.
lastRetryTime	string (date-time)	Waktu terakhir di mana percobaan ulang Tugas mulai berjalan. Elemen ini hanya ada jika Task dicoba ulang (yaitu retryCount bukan nol). Jika ada, ini biasanya sama dengan startTime, tetapi mungkin berbeda jika Tugas telah dimulai ulang karena alasan selain coba lagi; misalnya, jika Compute Node di-boot ulang selama percobaan ulang, maka startTime diperbarui tetapi lastRetryTime tidak.
requeueCount	integer (int32)	Berapa kali Tugas telah diantri ulang oleh layanan Batch sebagai hasil dari permintaan pengguna. Saat pengguna menghapus Node Komputasi dari Kumpulan (dengan mengubah ukuran/mengecilkan kumpulan) atau saat Pekerjaan dinonaktifkan, pengguna dapat menentukan bahwa Tugas yang sedang berjalan pada Node Komputasi akan diantrekan ulang untuk eksekusi. Hitungan ini melacak berapa kali Tugas telah diantrekan ulang karena alasan ini.
result	BatchTaskExecutionResult	Hasil eksekusi Tugas. Jika nilainya 'gagal', maka detail kegagalan dapat ditemukan di properti failureInfo.
retryCount	integer (int32)	Berapa kali Tugas telah dicoba ulang oleh layanan Batch. Kegagalan aplikasi tugas (kode keluar bukan nol) dicoba ulang, kesalahan pra-pemrosesan (Tugas tidak dapat dijalankan) dan kesalahan unggahan file tidak dicoba ulang. Layanan Batch akan mencoba kembali Tugas hingga batas yang ditentukan oleh batasan.
startTime	string (date-time)	Waktu di mana Tugas mulai berjalan. 'Berjalan' sesuai dengan status yang sedang berjalan, jadi jika Tugas menentukan file sumber daya atau Paket, maka waktu mulai mencerminkan waktu di mana Tugas mulai mengunduh atau menyebarkannya. Jika Tugas telah dimulai ulang atau dicoba ulang, ini adalah waktu terakhir di mana Tugas mulai berjalan. Properti ini hanya ada untuk Tugas yang dalam status berjalan atau selesai.

BatchTaskExecutionResult

Enumerasi

Enum BatchTaskExecutionResult

Nilai	Deskripsi
success	Tugas berhasil berjalan.
failure	Ada kesalahan selama pemrosesan Tugas. Kegagalan mungkin terjadi sebelum proses Tugas diluncurkan, saat proses Tugas sedang dijalankan, atau setelah proses Tugas keluar.

BatchTaskFailureInfo

Objek

Informasi tentang kegagalan Tugas.

Nama	Jenis	Deskripsi
category	BatchErrorSourceCategory	Kategori kesalahan Tugas.
code	string	Pengidentifikasi untuk kesalahan Tugas. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
details	NameValuePair[]	Daftar detail tambahan yang terkait dengan kesalahan.
message	string	Pesan yang menjelaskan kesalahan Tugas, yang dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

BatchTaskInfo

Objek

Informasi tentang Tugas yang berjalan pada Simpul Komputasi.

Nama	Jenis	Deskripsi
executionInfo	BatchTaskExecutionInfo	Informasi tentang pelaksanaan Tugas.
jobId	string	ID Pekerjaan tempat Tugas berada.
subtaskId	integer (int32)	ID subtugas jika Tugas adalah Tugas multi-instance.
taskId	string	ID tugas.
taskState	BatchTaskState	Keadaan Tugas saat ini.
taskUrl	string (uri)	URL tugas.

BatchTaskState

Enumerasi

Enum BatchTaskState

Nilai	Deskripsi
active	Tugas diantri dan dapat dijalankan, tetapi saat ini tidak ditetapkan ke Node Komputasi. Tugas memasuki status ini saat dibuat, saat diaktifkan setelah dinonaktifkan, atau saat menunggu percobaan lagi setelah eksekusi gagal.
preparing	Tugas telah ditetapkan ke Node Komputasi, tetapi sedang menunggu Tugas Persiapan Pekerjaan yang diperlukan untuk diselesaikan pada Node Komputasi. Jika Tugas Persiapan Pekerjaan berhasil, Tugas akan beralih ke berjalan. Jika Tugas Persiapan Pekerjaan gagal, Tugas akan kembali aktif dan akan memenuhi syarat untuk ditetapkan ke Node Komputasi yang berbeda.
running	Tugas berjalan pada Compute Node. Ini termasuk persiapan tingkat tugas seperti mengunduh file sumber daya atau menyebarkan Paket yang ditentukan pada Tugas - ini tidak selalu berarti bahwa baris perintah Tugas telah mulai dieksekusi.
completed	Tugas tidak lagi memenuhi syarat untuk dijalankan, biasanya karena Tugas telah berhasil diselesaikan, atau Tugas telah selesai tidak berhasil dan telah menghabiskan batas percobaan ulangnya. Tugas juga ditandai sebagai selesai jika terjadi kesalahan saat meluncurkan Tugas, atau ketika Tugas telah dihentikan.

BatchVmImageReference

Objek

Referensi ke Gambar Marketplace Azure Virtual Machines atau Gambar Azure Compute Gallery. Untuk mendapatkan daftar semua referensi Gambar Marketplace Azure yang diverifikasi oleh Azure Batch, lihat operasi 'Daftar Gambar yang Didukung'.

Nama	Jenis	Deskripsi
communityGalleryImageId	string	Pengidentifikasi unik gambar galeri komunitas. Properti ini saling eksklusif dengan properti lain dan dapat diambil dari panggilan GET gambar galeri komunitas.
exactVersion	string	Versi spesifik dari gambar platform atau gambar pasar yang digunakan untuk membuat node. Bidang baca-saja ini berbeda dari 'versi' hanya jika nilai yang ditentukan untuk 'versi' saat kumpulan dibuat adalah 'terbaru'.
offer	string	Jenis penawaran Gambar Marketplace Azure Virtual Machines. Misalnya, UbuntuServer atau WindowsServer.
publisher	string	Penerbit Gambar Marketplace Azure Virtual Machines. Misalnya, Canonical atau MicrosoftWindowsServer.
sharedGalleryImageId	string	Pengidentifikasi unik gambar galeri bersama. Properti ini saling eksklusif dengan properti lain dan dapat diambil dari panggilan GET gambar galeri bersama.
sku	string	SKU gambar marketplace Azure Virtual Machines. Misalnya, 18.04-LTS atau 2019-Datacenter.
version	string	Versi Gambar Marketplace Azure Virtual Machines. Nilai 'terbaru' dapat ditentukan untuk memilih versi terbaru dari Gambar. Jika dihilangkan, defaultnya adalah 'terbaru'.
virtualMachineImageId	string (arm-id)	Pengidentifikasi sumber daya ARM dari Gambar Azure Compute Gallery. Node Komputasi di Kumpulan akan dibuat menggunakan ID Gambar ini. Ini berbentuk /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} atau /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} untuk selalu default ke versi gambar terbaru. Properti ini saling eksklusif dengan properti ImageReference lainnya. Gambar Galeri Komputasi Azure harus memiliki replika di wilayah yang sama dan harus berada dalam langganan yang sama dengan akun Azure Batch. Jika versi gambar tidak ditentukan dalam imageId, versi terbaru akan digunakan. Untuk informasi tentang pengaturan firewall untuk agen Batch Compute Node untuk berkomunikasi dengan layanan Batch, lihat https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

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.

InboundEndpoint

Objek

Titik akhir masuk pada Simpul Komputasi.

Nama	Jenis	Deskripsi
backendPort	integer (int32)	Nomor port backend titik akhir.
frontendPort	integer (int32)	Nomor port publik titik akhir.
name	string	Nama titik akhir.
protocol	InboundEndpointProtocol	Protokol titik akhir.
publicFQDN	string	Nama domain publik yang sepenuhnya memenuhi syarat untuk Compute Node.
publicIPAddress	string	Alamat IP publik dari Compute Node.

InboundEndpointProtocol

Enumerasi

Enum InboundEndpointProtocol

Nilai	Deskripsi
tcp	Gunakan TCP untuk titik akhir.
udp	Gunakan UDP untuk titik akhir.

NameValuePair

Objek

Mewakili pasangan nama-nilai.

Nama	Jenis	Deskripsi
name	string	Nama dalam pasangan nama-nilai.
value	string	Nilai dalam pasangan nama-nilai.

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.

SchedulingState

Enumerasi

Enum SchedulingState.

Nilai	Deskripsi
enabled	Tugas dapat dijadwalkan pada Node Komputasi.
disabled	Tidak ada Tugas baru yang akan dijadwalkan di Node Komputasi. Tugas yang sudah berjalan di Node Komputasi masih dapat berjalan hingga selesai. Semua Node Komputasi dimulai dengan penjadwalan diaktifkan.

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.

VirtualMachineInfo

Objek

Info tentang status komputer virtual saat ini.

Nama	Jenis	Deskripsi
imageReference	BatchVmImageReference	Referensi ke Gambar Marketplace Azure Virtual Machine.
scaleSetVmResourceId	string	ID sumber daya VM Set Skala Komputer Virtual Simpul Komputasi saat ini. Hanya ditentukan jika Akun Batch dibuat dengan properti poolAllocationMode diatur ke 'UserSubscription'.

Bagikan melalui

Nodes - List Nodes

Parameter URI

Header Permintaan

Respons

Keamanan

OAuth2Auth

Cakupan

Contoh

Node list

Permintaan sampel

Respon sampel

Definisi

AutoUserScope

AutoUserSpecification

BatchError

BatchErrorDetail

BatchErrorMessage

BatchErrorSourceCategory

BatchNode

BatchNodeAgentInfo

BatchNodeEndpointConfiguration

BatchNodeError

BatchNodeIdentityReference

BatchNodeListResult

BatchNodeState

BatchStartTask

BatchStartTaskInfo

BatchStartTaskState

BatchTaskContainerExecutionInfo

BatchTaskContainerSettings

BatchTaskExecutionInfo

BatchTaskExecutionResult

BatchTaskFailureInfo

BatchTaskInfo

BatchTaskState

BatchVmImageReference

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistryReference

ContainerWorkingDirectory

ElevationLevel

EnvironmentSetting

InboundEndpoint

InboundEndpointProtocol

NameValuePair

ResourceFile

SchedulingState

UserIdentity

VirtualMachineInfo