Pool - Add

Menambahkan Kumpulan ke Akun yang ditentukan.
Saat menamai Kumpulan, hindari menyertakan informasi sensitif seperti nama pengguna atau nama proyek rahasia. Informasi ini mungkin muncul dalam log telemetri yang dapat diakses oleh teknisi Dukungan Microsoft.

POST {batchUrl}/pools?api-version=2023-11-01.18.0
POST {batchUrl}/pools?timeout={timeout}&api-version=2023-11-01.18.0

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
batchUrl
path True

string

URL dasar untuk semua permintaan layanan Azure Batch.

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 30 detik.

Header Permintaan

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

Nama Diperlukan Jenis Deskripsi
client-request-id

string

uuid

Identitas permintaan yang dihasilkan pemanggil, 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
id True

string

String yang secara unik mengidentifikasi Kumpulan dalam Akun.
ID dapat berisi kombinasi karakter alfanumerik termasuk tanda hubung dan garis bawah, dan tidak boleh berisi lebih dari 64 karakter. ID adalah mempertahankan huruf besar/kecil dan tidak peka huruf besar/kecil (artinya, Anda mungkin tidak memiliki dua ID Kumpulan dalam Akun yang hanya berbeda menurut kasus).

vmSize True

string

Ukuran komputer virtual di Kumpulan. Semua komputer virtual dalam Kumpulan berukuran sama.
Untuk informasi tentang ukuran komputer virtual yang tersedia untuk kumpulan Cloud Services (kumpulan yang dibuat dengan cloudServiceConfiguration), lihat Ukuran untuk Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch mendukung semua ukuran VM Cloud Services kecuali ExtraSmall, A1V2, dan A2V2. Untuk informasi tentang ukuran VM yang tersedia untuk Kumpulan menggunakan Gambar dari Virtual Machines Marketplace (kumpulan yang dibuat dengan virtualMachineConfiguration) lihat Ukuran untuk Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) atau Ukuran untuk Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch mendukung semua ukuran Azure VM kecuali STANDARD_A0 dan yang memiliki penyimpanan premium (STANDARD_GS, STANDARD_DS, dan seri STANDARD_DSV2).

applicationLicenses

string[]

Daftar lisensi aplikasi yang akan disediakan layanan Batch pada setiap Simpul Komputasi di Kumpulan.
Daftar lisensi aplikasi harus merupakan subset dari lisensi aplikasi layanan Batch yang tersedia. Jika lisensi diminta yang tidak didukung, pembuatan Kumpulan akan gagal.

applicationPackageReferences

ApplicationPackageReference[]

Daftar Paket yang akan diinstal pada setiap Simpul Komputasi di Kumpulan.
Saat membuat kumpulan, ID aplikasi paket harus sepenuhnya memenuhi syarat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Perubahan pada referensi Paket memengaruhi semua Simpul baru yang bergabung dengan Kumpulan, tetapi tidak memengaruhi Simpul Komputasi yang sudah ada di Kumpulan hingga di-boot ulang atau digambatkan ulang. Ada maksimum 10 referensi Paket pada Kumpulan tertentu.

autoScaleEvaluationInterval

string

Interval waktu untuk menyesuaikan ukuran Kumpulan secara otomatis sesuai dengan rumus skala otomatis.
Nilai defaultnya adalah 15 menit. Nilai minimum dan maksimum masing-masing adalah 5 menit dan 168 jam. Jika Anda menentukan nilai kurang dari 5 menit atau lebih besar dari 168 jam, layanan Batch mengembalikan kesalahan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

autoScaleFormula

string

Rumus untuk jumlah Simpul Komputasi yang diinginkan di Kumpulan.
Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke false. Diperlukan jika enableAutoScale diatur ke true. Rumus diperiksa validitasnya sebelum Kumpulan dibuat. Jika rumus tidak valid, layanan Batch menolak permintaan dengan informasi kesalahan terperinci. Untuk informasi selengkapnya tentang menentukan rumus ini, lihat 'Menskalakan Simpul Komputasi secara otomatis dalam kumpulan Azure Batch' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Daftar Sertifikat yang akan diinstal pada setiap Simpul Komputasi di Kumpulan.
Untuk Simpul Windows, layanan Batch menginstal Sertifikat ke penyimpanan dan lokasi Sertifikat yang ditentukan. Untuk Simpul Komputasi Linux, Sertifikat disimpan dalam direktori di dalam direktori kerja Tugas dan variabel lingkungan AZ_BATCH_CERTIFICATES_DIR diberikan ke Tugas untuk mengkueri lokasi ini. Untuk Sertifikat dengan visibilitas 'remoteUser', direktori 'certs' dibuat di direktori beranda pengguna (misalnya, /home/{user-name}/certs) dan Sertifikat ditempatkan di direktori tersebut.

Peringatan: Properti ini tidak digunakan lagi dan akan dihapus setelah Februari 2024. Silakan gunakan Ekstensi Azure KeyVault sebagai gantinya.

cloudServiceConfiguration

CloudServiceConfiguration

Konfigurasi layanan cloud untuk Kumpulan.
Properti ini dan virtualMachineConfiguration saling eksklusif dan salah satu properti harus ditentukan. Properti ini tidak dapat ditentukan jika Akun Batch dibuat dengan properti poolAllocationMode yang diatur ke 'UserSubscription'.

displayName

string

Nama tampilan untuk Kumpulan.
Nama tampilan tidak perlu unik dan dapat berisi karakter Unicode hingga panjang maksimum 1024.

enableAutoScale

boolean

Apakah ukuran Kumpulan harus secara otomatis menyesuaikan dari waktu ke waktu.
Jika false, setidaknya salah satu targetDedicatedNodes dan targetLowPriorityNodes harus ditentukan. Jika true, properti autoScaleFormula diperlukan dan Kumpulan secara otomatis mengubah ukuran sesuai dengan rumus. Nilai defaultnya adalah false.

enableInterNodeCommunication

boolean

Apakah Kumpulan mengizinkan komunikasi langsung antara Simpul Komputasi.
Mengaktifkan komunikasi antar-simpul membatasi ukuran maksimum Kumpulan karena pembatasan penyebaran pada Simpul Komputasi Kumpulan. Ini dapat mengakibatkan Kumpulan tidak mencapai ukuran yang diinginkan. Nilai defaultnya adalah false.

metadata

MetadataItem[]

Daftar pasangan nama-nilai yang terkait dengan Kumpulan sebagai metadata.
Layanan Batch tidak menetapkan arti apa pun untuk metadata; hanya untuk penggunaan kode pengguna.

mountConfiguration

MountConfiguration[]

Pasang penyimpanan menggunakan sistem file tertentu selama seluruh masa pakai kumpulan.
Pasang penyimpanan menggunakan sistem file berbasis Azure fileshare, NFS, CIFS, atau Blobfuse.

networkConfiguration

NetworkConfiguration

Konfigurasi jaringan untuk Kumpulan.
Konfigurasi jaringan untuk Kumpulan.

resizeTimeout

string

Waktu habis untuk alokasi Simpul Komputasi ke Kumpulan.
Batas waktu ini hanya berlaku untuk penskalakan manual; tidak berpengaruh ketika enableAutoScale diatur ke true. Nilai defaultnya adalah 15 menit. Nilai minimum adalah 5 menit. Jika Anda menentukan nilai kurang dari 5 menit, layanan Batch mengembalikan kesalahan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

resourceTags

object

Tag yang ditentukan pengguna yang terkait dengan kumpulan.
Tag yang ditentukan pengguna yang akan dikaitkan dengan kumpulan Azure Batch. Ketika ditentukan, tag ini disebarkan ke sumber daya Azure yang mendukung yang terkait dengan kumpulan. Properti ini hanya dapat ditentukan ketika akun Batch dibuat dengan properti poolAllocationMode diatur ke 'UserSubscription'.

startTask

StartTask

Tugas yang ditentukan untuk dijalankan pada setiap Simpul Komputasi saat bergabung dengan Kumpulan.
Tugas berjalan ketika Simpul Komputasi ditambahkan ke Kumpulan atau ketika Simpul Komputasi dimulai ulang.

targetDedicatedNodes

integer

Jumlah Simpul Komputasi khusus yang diinginkan di Kumpulan.
Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke true. Jika enableAutoScale diatur ke false, maka Anda harus mengatur targetDedicatedNodes, targetLowPriorityNodes, atau keduanya.

targetLowPriorityNodes

integer

Jumlah Simpul Komputasi Spot/Prioritas rendah yang diinginkan di Kumpulan.
Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke true. Jika enableAutoScale diatur ke false, maka Anda harus mengatur targetDedicatedNodes, targetLowPriorityNodes, atau keduanya.

targetNodeCommunicationMode

NodeCommunicationMode

Mode komunikasi simpul yang diinginkan untuk kumpulan.
Jika dihilangkan, nilai defaultnya adalah Default.

taskSchedulingPolicy

TaskSchedulingPolicy

Bagaimana Tugas didistribusikan di seluruh Simpul Komputasi dalam Kumpulan.
Jika tidak ditentukan, defaultnya adalah spread.

taskSlotsPerNode

integer

Jumlah slot tugas yang dapat digunakan untuk menjalankan tugas bersamaan pada satu simpul komputasi dalam kumpulan.
Nilai default adalah 1. Nilai maksimum adalah lebih kecil dari 4 kali jumlah inti vmSize kumpulan atau 256.

userAccounts

UserAccount[]

Daftar Akun pengguna yang akan dibuat pada setiap Simpul Komputasi di Kumpulan.

virtualMachineConfiguration

VirtualMachineConfiguration

Konfigurasi komputer virtual untuk Kumpulan.
Properti dan cloudServiceConfiguration ini saling eksklusif dan salah satu properti harus ditentukan.

Respons

Nama Jenis Deskripsi
201 Created

Permintaan ke layanan Batch berhasil.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

Kesalahan dari layanan Batch.

Keamanan

azure_auth

Microsoft Entra alur kode autentikasi OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama Deskripsi
user_impersonation Meniru akun pengguna Anda

Authorization

Type: apiKey
In: header

Contoh

Add a CloudServiceConfiguration pool
Add a pool with accelerated networking
Add a pool with mount drive specified
Add a pool with SecurityProfile
Add a simple pool with resourceTags
Add a VirtualMachineConfiguration pool
Add a VirtualMachineConfiguration pool with containers
Add a VirtualMachineConfiguration pool with extensions
Add a VirtualMachineConfiguration pool with OS disk
Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Add a CloudServiceConfiguration pool

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "poolId",
  "vmSize": "small",
  "cloudServiceConfiguration": {
    "osFamily": "4"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Add a pool with accelerated networking

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool01",
  "vmSize": "Standard_D1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2,
  "networkConfiguration": {
    "enableAcceleratedNetworking": true
  }
}

Sample Response

Add a pool with mount drive specified

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0


{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "mountConfiguration": [
    {
      "azureBlobFileSystemConfiguration": {
        "accountName": "accountName",
        "containerName": "blobContainerName",
        "accountKey": "accountKey",
        "relativeMountPath": "bfusepath"
      }
    },
    {
      "azureFileShareConfiguration": {
        "accountName": "accountName",
        "azureFileUrl": "https://myaccount.file.core.windows.net/fileshare",
        "accountKey": "accountKey",
        "relativeMountPath": "filesharepath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "nfsMountConfiguration": {
        "source": "somesource nfs url",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "cifsMountConfiguration": {
        "username": "accountName",
        "password": "password",
        "source": "//myaccount.file.core.windows.net/file",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    }
  ],
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Add a pool with SecurityProfile

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04",
    "securityProfile": {
      "securityType": "trustedLaunch",
      "encryptionAtHost": true,
      "uefiSettings": {
        "secureBootEnabled": false
      }
    }
  },
  "targetDedicatedNodes": 1
}

Sample Response

Add a simple pool with resourceTags

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04"
  },
  "targetDedicatedNodes": 1,
  "resourceTags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  }
}

Sample Response

Add a VirtualMachineConfiguration pool

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Add a VirtualMachineConfiguration pool with containers

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "120_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "containerConfiguration": {
      "type": "dockerCompatible",
      "containerImageNames": [
        "busybox"
      ]
    }
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Add a VirtualMachineConfiguration pool with extensions

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "extensions": [
      {
        "name": "batchextension1",
        "type": "KeyVaultForLinux",
        "publisher": "Microsoft.Azure.KeyVault",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": "{\"secretsManagementSettingsKey\":\"secretsManagementSettingsValue\",\"authenticationSettingsKey\":\"authenticationSettingsValue\"}"
      }
    ]
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ],
  "targetNodeCommunicationMode": "simplified"
}

Sample Response

Add a VirtualMachineConfiguration pool with OS disk

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "standard_d2s_v3",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "osDisk": {
      "diskSizeGB": 100,
      "managedDisk": {
        "storageAccountType": "standardssd_lrs"
      },
      "caching": "readwrite",
      "ephemeralOSDiskSettings": {
        "placement": "CacheDisk"
      }
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 1,
  "enableAutoScale": false
}

Sample Response

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool002",
  "vmSize": "Standard_A1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "windowsConfiguration": {
      "enableAutomaticUpdates": false
    },
    "serviceArtifactReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2
}

Sample Response

Definisi

Nama Deskripsi
ApplicationPackageReference

Referensi ke Paket yang akan disebarkan ke Simpul Komputasi.

AutoUserScope

Cakupan untuk pengguna otomatis

AutoUserSpecification

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

AzureBlobFileSystemConfiguration

Informasi yang digunakan untuk menyambungkan ke Kontainer Azure Storage menggunakan Blobfuse.

AzureFileShareConfiguration

Informasi yang digunakan untuk menyambungkan ke Azure Fileshare.

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

CachingType

Jenis penembolokan yang akan diaktifkan untuk disk.

CertificateReference

Referensi ke Sertifikat yang akan diinstal pada Simpul Komputasi di Kumpulan.

CertificateStoreLocation

Lokasi penyimpanan Sertifikat pada Simpul Komputasi tempat menginstal Sertifikat.

CertificateVisibility

Akun pengguna mana di Simpul Komputasi yang harus memiliki akses ke data privat Sertifikat.

CIFSMountConfiguration

Informasi yang digunakan untuk menyambungkan ke sistem file CIFS.

CloudServiceConfiguration

Konfigurasi untuk Simpul Komputasi dalam Kumpulan berdasarkan platform Azure Cloud Services.

ComputeNodeFillType

Bagaimana Tugas didistribusikan di seluruh Simpul Komputasi dalam Kumpulan.

ComputeNodeIdentityReference

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

ContainerConfiguration

Konfigurasi untuk Kumpulan yang mendukung kontainer.

ContainerRegistry

Registri kontainer privat.

ContainerType

Teknologi kontainer yang akan digunakan.

ContainerWorkingDirectory

Lokasi direktori kerja Tugas kontainer.

DataDisk

Pengaturan yang akan digunakan oleh disk data yang terkait dengan Simpul Komputasi di Kumpulan. Saat menggunakan diska data terlampir, Anda perlu memasang dan memformat diska dari dalam VM untuk menggunakannya.

DiffDiskPlacement

Menentukan penempatan disk ephemeral untuk disk sistem operasi untuk semua simpul komputasi (VM) di kumpulan.

DiffDiskSettings

Menentukan Pengaturan Disk ephemeral untuk disk sistem operasi yang digunakan oleh simpul komputasi (VM).

DiskEncryptionConfiguration

Konfigurasi enkripsi disk diterapkan pada simpul komputasi di kumpulan. Konfigurasi enkripsi disk tidak didukung pada kumpulan Linux yang dibuat dengan Azure Compute Gallery Image.

DiskEncryptionTarget

Daftar target disk Layanan Batch akan dienkripsi pada simpul komputasi.

DynamicVNetAssignmentScope

Cakupan penugasan vnet dinamis.

ElevationLevel

Tingkat elevasi pengguna.

EnvironmentSetting

Variabel lingkungan yang akan diatur pada proses Tugas.

ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.

ImageReference

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

InboundEndpointProtocol

Protokol titik akhir.

InboundNATPool

Kumpulan NAT masuk yang dapat digunakan untuk mengatasi port tertentu pada Simpul Komputasi di Kumpulan Batch secara eksternal.

IPAddressProvisioningType

Jenis provisi untuk Alamat IP Publik untuk Kumpulan.

LinuxUserConfiguration

Properti yang digunakan untuk membuat Akun pengguna pada Simpul Komputasi Linux.

LoginMode

Mode masuk untuk pengguna

ManagedDisk
MetadataItem

Pasangan nama-nilai yang terkait dengan sumber daya layanan Batch.

MountConfiguration

Sistem file yang dipasang pada setiap simpul.

NetworkConfiguration

Konfigurasi jaringan untuk Kumpulan.

NetworkSecurityGroupRule

Aturan grup keamanan jaringan untuk diterapkan ke titik akhir masuk.

NetworkSecurityGroupRuleAccess

Tindakan yang harus diambil untuk alamat IP, rentang subnet, atau tag tertentu.

NFSMountConfiguration

Informasi yang digunakan untuk menyambungkan ke sistem file NFS.

NodeCommunicationMode

Menentukan bagaimana kumpulan berkomunikasi dengan layanan Batch.

NodePlacementConfiguration

Konfigurasi penempatan simpul untuk kumpulan.

NodePlacementPolicyType

Kebijakan penempatan untuk mengalokasikan simpul di kumpulan.

OSDisk

Pengaturan untuk disk sistem operasi simpul komputasi (VM).

PoolAddParameter

Kumpulan di layanan Azure Batch untuk ditambahkan.

PoolEndpointConfiguration

Konfigurasi titik akhir untuk Kumpulan.

PublicIPAddressConfiguration

Konfigurasi Alamat IP publik dari konfigurasi jaringan Kumpulan.

ResourceFile

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

SecurityProfile

Menentukan pengaturan profil keamanan untuk komputer virtual atau set skala komputer virtual.

SecurityTypes

Menentukan SecurityType komputer virtual. Ini harus diatur ke nilai yang ditentukan untuk mengaktifkan UefiSettings.

ServiceArtifactReference

Menentukan id referensi artefak layanan yang digunakan untuk mengatur versi gambar yang sama untuk semua komputer virtual dalam set skala saat menggunakan versi gambar 'terbaru'.

StartTask

Tugas yang dijalankan saat Simpul bergabung dengan Kumpulan di layanan Azure Batch, atau saat Simpul Komputasi di-boot ulang atau digambut ulang.

StorageAccountType

Jenis Akun penyimpanan untuk digunakan dalam membuat disk data atau disk OS.

TaskContainerSettings

Pengaturan kontainer untuk Tugas.

TaskSchedulingPolicy

Menentukan bagaimana Tugas harus didistribusikan di seluruh Simpul Komputasi.

UefiSettings

Menentukan pengaturan keamanan seperti boot aman dan vTPM yang digunakan saat membuat komputer virtual.

UserAccount

Properti yang digunakan untuk membuat pengguna yang digunakan untuk menjalankan Tugas pada Simpul Komputasi Azure Batch.

UserIdentity

Definisi identitas pengguna tempat Tugas dijalankan.

VirtualMachineConfiguration

Konfigurasi untuk Simpul Komputasi dalam Kumpulan berdasarkan infrastruktur Azure Virtual Machines.

VMExtension

Konfigurasi untuk ekstensi komputer virtual.

WindowsConfiguration

Pengaturan sistem operasi Windows untuk diterapkan ke komputer virtual.

WindowsUserConfiguration

Properti yang digunakan untuk membuat Akun pengguna pada Simpul Komputasi Windows.

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.

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

AzureBlobFileSystemConfiguration

Informasi yang digunakan untuk menyambungkan ke Kontainer Azure Storage menggunakan Blobfuse.

Nama Jenis Deskripsi
accountKey

string

Kunci Akun Azure Storage.
Properti ini saling eksklusif dengan sasKey dan identitas; tepat satu harus ditentukan.

accountName

string

Nama Akun Azure Storage.

blobfuseOptions

string

Opsi baris perintah tambahan untuk diteruskan ke perintah pemasangan.
Ini adalah opsi 'penggunaan bersih' di Windows dan opsi 'mount' di Linux.

containerName

string

Nama Kontainer Azure Blob Storage.

identityReference

ComputeNodeIdentityReference

Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses containerName
Properti ini saling eksklusif dengan accountKey dan sasKey; tepat satu harus ditentukan.

relativeMountPath

string

Jalur relatif pada simpul komputasi tempat sistem file akan dipasang
Semua sistem file dipasang relatif terhadap direktori pemasangan Batch, dapat diakses melalui variabel lingkungan AZ_BATCH_NODE_MOUNTS_DIR.

sasKey

string

Token SAS Azure Storage.
Properti ini saling eksklusif dengan accountKey dan identitas; tepat satu harus ditentukan.

AzureFileShareConfiguration

Informasi yang digunakan untuk menyambungkan ke Azure Fileshare.

Nama Jenis Deskripsi
accountKey

string

Kunci akun Azure Storage.

accountName

string

Nama akun Azure Storage.

azureFileUrl

string

URL Azure Files.
Ini adalah formulir 'https://{account}.file.core.windows.net/'.

mountOptions

string

Opsi baris perintah tambahan untuk diteruskan ke perintah pemasangan.
Ini adalah opsi 'penggunaan bersih' di Windows dan opsi 'mount' di Linux.

relativeMountPath

string

Jalur relatif pada simpul komputasi tempat sistem file akan dipasang
Semua sistem file dipasang relatif terhadap direktori pemasangan Batch, dapat diakses melalui variabel lingkungan AZ_BATCH_NODE_MOUNTS_DIR.

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode tidak berubah 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 disertakan dengan respons kesalahan.

CachingType

Jenis penembolokan yang akan diaktifkan untuk disk.

Nama Jenis Deskripsi
none

string

Mode penembolokan untuk disk tidak diaktifkan.

readonly

string

Mode penembolokan untuk disk hanya dapat dibaca.

readwrite

string

Mode penembolokan untuk disk dibaca dan ditulis.

CertificateReference

Referensi ke Sertifikat yang akan diinstal pada Simpul Komputasi di Kumpulan.

Nama Jenis Deskripsi
storeLocation

CertificateStoreLocation

Lokasi penyimpanan Sertifikat pada Simpul Komputasi tempat menginstal Sertifikat.
Nilai defaultnya adalah currentuser. Properti ini hanya berlaku untuk Kumpulan yang dikonfigurasi dengan Simpul Komputasi Windows (yaitu, dibuat dengan cloudServiceConfiguration, atau dengan virtualMachineConfiguration menggunakan referensi Gambar Windows). Untuk Simpul Komputasi Linux, Sertifikat disimpan dalam direktori di dalam direktori kerja Tugas dan variabel lingkungan AZ_BATCH_CERTIFICATES_DIR disediakan ke Tugas untuk mengkueri lokasi ini. Untuk Sertifikat dengan visibilitas 'remoteUser', direktori 'certs' dibuat di direktori beranda pengguna (misalnya, /home/{user-name}/certs) dan Sertifikat ditempatkan di direktori tersebut.

storeName

string

Nama penyimpanan Sertifikat pada Simpul Komputasi tempat menginstal Sertifikat.
Properti ini hanya berlaku untuk Kumpulan yang dikonfigurasi dengan Simpul Komputasi Windows (yaitu, dibuat dengan cloudServiceConfiguration, atau dengan virtualMachineConfiguration menggunakan referensi Gambar Windows). Nama penyimpanan umum meliputi: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, tetapi nama penyimpanan kustom apa pun juga dapat digunakan. Nilai defaultnya adalah My.

thumbprint

string

Thumbprint Sertifikat.

thumbprintAlgorithm

string

Algoritma yang terkait dengan thumbprint. Ini harus sha1.

visibility

CertificateVisibility[]

Akun pengguna mana di Simpul Komputasi yang harus memiliki akses ke data privat Sertifikat.
Anda dapat menentukan lebih dari satu visibilitas dalam koleksi ini. Defaultnya adalah semua Akun.

CertificateStoreLocation

Lokasi penyimpanan Sertifikat pada Simpul Komputasi tempat menginstal Sertifikat.

Nama Jenis Deskripsi
currentuser

string

Sertifikat harus diinstal ke penyimpanan Sertifikat CurrentUser.

localmachine

string

Sertifikat harus diinstal ke penyimpanan Sertifikat LocalMachine.

CertificateVisibility

Akun pengguna mana di Simpul Komputasi yang harus memiliki akses ke data privat Sertifikat.

Nama Jenis Deskripsi
remoteuser

string

Sertifikat harus terlihat oleh akun pengguna tempat pengguna mengakses Simpul Komputasi dari jarak jauh.

starttask

string

Sertifikat harus terlihat oleh akun pengguna tempat StartTask dijalankan. Perhatikan bahwa jika Cakupan AutoUser adalah Kumpulan untuk StartTask dan Tugas, sertifikat ini juga akan terlihat oleh Tugas.

task

string

Sertifikat harus terlihat oleh akun pengguna tempat Tugas Pekerjaan dijalankan.

CIFSMountConfiguration

Informasi yang digunakan untuk menyambungkan ke sistem file CIFS.

Nama Jenis Deskripsi
mountOptions

string

Opsi baris perintah tambahan untuk diteruskan ke perintah pemasangan.
Ini adalah opsi 'penggunaan bersih' di Windows dan opsi 'mount' di Linux.

password

string

Kata sandi yang digunakan untuk autentikasi terhadap sistem file CIFS.

relativeMountPath

string

Jalur relatif pada simpul komputasi tempat sistem file akan dipasang
Semua sistem file dipasang relatif terhadap direktori pemasangan Batch, dapat diakses melalui variabel lingkungan AZ_BATCH_NODE_MOUNTS_DIR.

source

string

URI sistem file yang akan dipasang.

username

string

Pengguna yang digunakan untuk autentikasi terhadap sistem file CIFS.

CloudServiceConfiguration

Konfigurasi untuk Simpul Komputasi dalam Kumpulan berdasarkan platform Azure Cloud Services.

Nama Jenis Deskripsi
osFamily

string

Keluarga OS Tamu Azure yang akan diinstal pada komputer virtual di Kumpulan.
Nilai yang mungkin adalah: 2 - OS Family 2, setara dengan Windows Server 2008 R2 SP1. 3 - OS Family 3, setara dengan Windows Server 2012. 4 - OS Family 4, setara dengan Windows Server 2012 R2. 5 - OS Family 5, setara dengan Windows Server 2016. 6 - OS Family 6, setara dengan Windows Server 2019. Untuk informasi selengkapnya, lihat Rilis OS Tamu Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

osVersion

string

Versi OS Tamu Azure yang akan diinstal pada komputer virtual di Kumpulan.
Nilai defaultnya adalah * yang menentukan versi sistem operasi terbaru untuk keluarga OS yang ditentukan.

ComputeNodeFillType

Bagaimana Tugas didistribusikan di seluruh Simpul Komputasi dalam Kumpulan.

Nama Jenis Deskripsi
pack

string

Tugas sebanyak mungkin (taskSlotsPerNode) harus ditetapkan ke setiap Simpul Komputasi di Kumpulan sebelum Tugas ditetapkan ke Simpul Komputasi berikutnya di Kumpulan.

spread

string

Tugas harus ditetapkan secara merata di semua Simpul Komputasi di Kumpulan.

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.

ContainerConfiguration

Konfigurasi untuk Kumpulan yang mendukung kontainer.

Nama Jenis Deskripsi
containerImageNames

string[]

Kumpulan nama Gambar kontainer.
Ini adalah referensi Gambar lengkap, seperti yang akan ditentukan untuk "penarikan docker". Gambar akan bersumber dari registri Docker default kecuali Gambar sepenuhnya memenuhi syarat dengan registri alternatif.

containerRegistries

ContainerRegistry[]

Registri privat tambahan tempat kontainer dapat ditarik.
Jika ada Gambar yang harus diunduh dari registri privat yang memerlukan kredensial, kredensial tersebut harus disediakan di sini.

type

ContainerType

Teknologi kontainer yang akan digunakan.

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.

ContainerType

Teknologi kontainer yang akan digunakan.

Nama Jenis Deskripsi
criCompatible

string

Teknologi berbasis CRI akan digunakan untuk meluncurkan kontainer.

dockerCompatible

string

Teknologi kontainer yang kompatibel dengan Docker akan digunakan untuk meluncurkan kontainer.

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.

DataDisk

Pengaturan yang akan digunakan oleh disk data yang terkait dengan Simpul Komputasi di Kumpulan. Saat menggunakan diska data terlampir, Anda perlu memasang dan memformat diska dari dalam VM untuk menggunakannya.

Nama Jenis Deskripsi
caching

CachingType

Jenis penembolokan yang akan diaktifkan untuk disk data.
Nilai default untuk penembolokan adalah readwrite. Untuk informasi tentang opsi penembolokan, lihat: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Ukuran disk awal dalam gigabyte.

lun

integer

Nomor unit logis.
Lun digunakan untuk mengidentifikasi setiap disk data secara unik. Jika melampirkan beberapa disk, masing-masing harus memiliki lun yang berbeda. Nilai harus antara 0 dan 63, inklusif.

storageAccountType

StorageAccountType

Jenis Akun penyimpanan yang akan digunakan untuk disk data.
Jika dihilangkan, defaultnya adalah "standard_lrs".

DiffDiskPlacement

Menentukan penempatan disk ephemeral untuk disk sistem operasi untuk semua simpul komputasi (VM) di kumpulan.

Nama Jenis Deskripsi
CacheDisk

string

Disk OS Sementara disimpan di cache VM.

DiffDiskSettings

Menentukan Pengaturan Disk ephemeral untuk disk sistem operasi yang digunakan oleh simpul komputasi (VM).

Nama Jenis Deskripsi
placement

DiffDiskPlacement

Menentukan penempatan disk ephemeral untuk disk sistem operasi untuk semua VM di kumpulan.
Properti ini dapat digunakan oleh pengguna dalam permintaan untuk memilih lokasi misalnya, ruang disk cache untuk provisi disk OS Ephemeral. Untuk informasi selengkapnya tentang persyaratan ukuran disk OS Ephemeral, silakan lihat persyaratan ukuran disk OS Ephemeral untuk VM Windows di https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements dan VM Linux di https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

Konfigurasi enkripsi disk diterapkan pada simpul komputasi di kumpulan. Konfigurasi enkripsi disk tidak didukung pada kumpulan Linux yang dibuat dengan Azure Compute Gallery Image.

Nama Jenis Deskripsi
targets

DiskEncryptionTarget[]

Daftar target disk Layanan Batch akan dienkripsi pada simpul komputasi.
Jika dihilangkan, tidak ada disk pada simpul komputasi di kumpulan yang akan dienkripsi. Di kumpulan Linux, hanya "TemporaryDisk" yang didukung; pada kumpulan Windows, "OsDisk" dan "TemporaryDisk" harus ditentukan.

DiskEncryptionTarget

Daftar target disk Layanan Batch akan dienkripsi pada simpul komputasi.

Nama Jenis Deskripsi
osdisk

string

Disk OS pada simpul komputasi dienkripsi.

temporarydisk

string

Disk sementara pada simpul komputasi dienkripsi. Di Linux enkripsi ini berlaku untuk partisi lain (seperti pada disk data yang dipasang) ketika enkripsi terjadi pada waktu boot.

DynamicVNetAssignmentScope

Cakupan penugasan vnet dinamis.

Nama Jenis Deskripsi
job

string

Penugasan VNet dinamis dilakukan per pekerjaan.

none

string

Tidak ada penetapan VNet dinamis yang diaktifkan.

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 yang diterima dalam respons kesalahan Azure Batch.

Nama Jenis Deskripsi
lang

string

Kode bahasa pesan kesalahan

value

string

Teks pesan.

ImageReference

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

Nama Jenis Deskripsi
exactVersion

string

Versi spesifik gambar platform atau gambar marketplace yang digunakan untuk membuat simpul. Bidang baca-saja ini berbeda dari 'versi' hanya jika nilai yang ditentukan untuk 'versi' ketika kumpulan dibuat adalah 'terbaru'.

offer

string

Jenis penawaran Azure Virtual Machines Marketplace Image.
Misalnya, UbuntuServer atau WindowsServer.

publisher

string

Penerbit Azure Virtual Machines Marketplace Image.
Misalnya, Canonical atau MicrosoftWindowsServer.

sku

string

SKU Gambar Azure Virtual Machines Marketplace.
Misalnya, 18.04-LTS atau 2019-Datacenter.

version

string

Versi Azure Virtual Machines Marketplace Image.
Nilai 'terbaru' dapat ditentukan untuk memilih versi terbaru Gambar. Jika dihilangkan, defaultnya adalah 'terbaru'.

virtualMachineImageId

string

Pengidentifikasi sumber daya ARM dari Gambar Azure Compute Gallery. Simpul Komputasi di Kumpulan akan dibuat menggunakan Id Gambar ini. Ini adalah formulir /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 Azure Compute Gallery 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 Simpul Komputasi Batch untuk berkomunikasi dengan layanan Batch, lihat https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Protokol titik akhir.

Nama Jenis Deskripsi
tcp

string

Gunakan TCP untuk titik akhir.

udp

string

Gunakan UDP untuk titik akhir.

InboundNATPool

Kumpulan NAT masuk yang dapat digunakan untuk mengatasi port tertentu pada Simpul Komputasi di Kumpulan Batch secara eksternal.

Nama Jenis Deskripsi
backendPort

integer

Nomor port pada Simpul Komputasi.
Ini harus unik dalam Kumpulan Batch. Nilai yang dapat diterima adalah antara 1 dan 65535 kecuali untuk 22, 3389, 29876 dan 29877 karena ini dicadangkan. Jika ada nilai yang dipesan yang disediakan, permintaan gagal dengan kode status HTTP 400.

frontendPortRangeEnd

integer

Nomor port terakhir dalam rentang port eksternal yang akan digunakan untuk menyediakan akses masuk ke backendPort pada Simpul Komputasi individual.
Rentang nilai yang dapat diterima antara 1 dan 65534 kecuali port dari 50000 hingga 55000 yang dicadangkan oleh layanan Batch. Semua rentang dalam Kumpulan harus berbeda dan tidak dapat tumpang tindih. Setiap rentang harus berisi setidaknya 40 port. Jika ada nilai yang dipesan atau tumpang tindih yang disediakan permintaan gagal dengan kode status HTTP 400.

frontendPortRangeStart

integer

Nomor port pertama dalam rentang port eksternal yang akan digunakan untuk menyediakan akses masuk ke backendPort pada Simpul Komputasi individual.
Nilai yang dapat diterima berkisar antara 1 dan 65534 kecuali port dari 50000 hingga 55000 yang dicadangkan. Semua rentang dalam Kumpulan harus berbeda dan tidak dapat tumpang tindih. Setiap rentang harus berisi setidaknya 40 port. Jika ada nilai yang dipesan atau tumpang tindih yang disediakan permintaan gagal dengan kode status HTTP 400.

name

string

Nama titik akhir.
Nama harus unik dalam Kumpulan Batch, dapat berisi huruf, angka, garis bawah, titik, dan tanda hubung. Nama harus dimulai dengan huruf atau angka, harus diakhir dengan huruf, angka, atau garis bawah, dan tidak boleh melebihi 77 karakter. Jika ada nilai yang tidak valid yang disediakan permintaan gagal dengan kode status HTTP 400.

networkSecurityGroupRules

NetworkSecurityGroupRule[]

Daftar aturan grup keamanan jaringan yang akan diterapkan ke titik akhir.
Jumlah maksimum aturan yang dapat ditentukan di semua titik akhir pada Kumpulan Batch adalah 25. Jika tidak ada aturan grup keamanan jaringan yang ditentukan, aturan default akan dibuat untuk mengizinkan akses masuk ke backendPort yang ditentukan. Jika jumlah maksimum aturan grup keamanan jaringan terlampaui, permintaan gagal dengan kode status HTTP 400.

protocol

InboundEndpointProtocol

Protokol titik akhir.

IPAddressProvisioningType

Jenis provisi untuk Alamat IP Publik untuk Kumpulan.

Nama Jenis Deskripsi
batchmanaged

string

IP publik akan dibuat dan dikelola oleh Batch. Mungkin ada beberapa IP publik tergantung pada ukuran Kumpulan.

nopublicipaddresses

string

Tidak ada Alamat IP publik yang akan dibuat.

usermanaged

string

IP publik disediakan oleh pengguna dan akan digunakan untuk memprovisikan Simpul Komputasi.

LinuxUserConfiguration

Properti yang digunakan untuk membuat Akun pengguna pada Simpul Komputasi Linux.

Nama Jenis Deskripsi
gid

integer

ID grup untuk Akun pengguna.
Properti uid dan gid harus ditentukan bersama-sama atau tidak sama sekali. Jika tidak ditentukan, sistem operasi yang mendasar akan memilih gid.

sshPrivateKey

string

Kunci privat SSH untuk Akun pengguna.
Kunci privat tidak boleh dilindungi kata sandi. Kunci privat digunakan untuk mengonfigurasi autentikasi berbasis kunci asimetris secara otomatis untuk SSH antara Simpul Komputasi di Kumpulan Linux ketika properti enableInterNodeCommunication Pool benar (diabaikan jika enableInterNodeCommunication salah). Ini dilakukan dengan menempatkan pasangan kunci ke direktori .ssh pengguna. Jika tidak ditentukan, SSH tanpa kata sandi tidak dikonfigurasi antara Simpul Komputasi (tidak ada modifikasi direktori .ssh pengguna yang dilakukan).

uid

integer

ID pengguna Akun pengguna.
Properti uid dan gid harus ditentukan bersama-sama atau tidak sama sekali. Jika tidak ditentukan, sistem operasi yang mendasar akan memilih uid.

LoginMode

Mode masuk untuk pengguna

Nama Jenis Deskripsi
batch

string

Mode masuk LOGON32_LOGON_BATCH Win32. Mode masuk batch direkomendasikan untuk proses paralel yang berjalan lama.

interactive

string

Mode masuk LOGON32_LOGON_INTERACTIVE Win32. UAC diaktifkan pada Windows VirtualMachineConfiguration Pools. Jika opsi ini digunakan dengan identitas pengguna yang ditinggikan di Kumpulan VirtualMachineConfiguration Windows, sesi pengguna tidak akan ditinggikan kecuali aplikasi yang dijalankan oleh baris perintah Tugas dikonfigurasi untuk selalu memerlukan hak administratif atau untuk selalu memerlukan hak istimewa maksimum.

ManagedDisk

Nama Jenis Deskripsi
storageAccountType

StorageAccountType

Jenis akun penyimpanan untuk disk terkelola.

MetadataItem

Pasangan nama-nilai yang terkait dengan sumber daya layanan Batch.

Nama Jenis Deskripsi
name

string

Nama item metadata.

value

string

Nilai item metadata.

MountConfiguration

Sistem file yang dipasang pada setiap simpul.

Nama Jenis Deskripsi
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

Kontainer Azure Storage untuk dipasang menggunakan FUSE blob pada setiap simpul.
Properti ini saling eksklusif dengan semua properti lainnya.

azureFileShareConfiguration

AzureFileShareConfiguration

Azure File Share untuk dipasang pada setiap simpul.
Properti ini saling eksklusif dengan semua properti lainnya.

cifsMountConfiguration

CIFSMountConfiguration

Sistem file CIFS/SMB untuk dipasang pada setiap simpul.
Properti ini saling eksklusif dengan semua properti lainnya.

nfsMountConfiguration

NFSMountConfiguration

Sistem file NFS untuk dipasang pada setiap simpul.
Properti ini saling eksklusif dengan semua properti lainnya.

NetworkConfiguration

Konfigurasi jaringan untuk Kumpulan.

Nama Jenis Deskripsi
dynamicVNetAssignmentScope

DynamicVNetAssignmentScope

Cakupan penugasan vnet dinamis.

enableAcceleratedNetworking

boolean

Apakah kumpulan ini harus memfungsikan jaringan terakselerasi.
Jaringan terakselerasi memungkinkan virtualisasi I/O root tunggal (SR-IOV) ke VM, yang dapat menyebabkan peningkatan performa jaringan. Untuk detail selengkapnya, lihat: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

endpointConfiguration

PoolEndpointConfiguration

Konfigurasi untuk titik akhir pada Simpul Komputasi di Kumpulan Batch.
Konfigurasi titik akhir kumpulan hanya didukung pada Kumpulan dengan properti virtualMachineConfiguration.

publicIPAddressConfiguration

PublicIPAddressConfiguration

Konfigurasi IpAddress Publik untuk Simpul Komputasi di Kumpulan Batch.
Properti konfigurasi IP publik hanya didukung pada Kumpulan dengan properti virtualMachineConfiguration.

subnetId

string

Pengidentifikasi sumber daya ARM dari subnet jaringan virtual yang akan bergabung dengan Simpul Komputasi Kumpulan. Ini adalah formulir /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.
Jaringan virtual harus berada di wilayah dan langganan yang sama dengan Akun Azure Batch. Subnet yang ditentukan harus memiliki alamat IP gratis yang cukup untuk mengakomodasi jumlah Simpul Komputasi di Kumpulan. Jika subnet tidak memiliki alamat IP gratis yang cukup, Kumpulan akan mengalokasikan sebagian Node dan kesalahan pengubahan ukuran akan terjadi. Perwakilan layanan 'MicrosoftAzureBatch' harus memiliki peran 'Kontributor Komputer Virtual Klasik' Role-Based Access Control (RBAC) untuk VNet yang ditentukan. Subnet yang ditentukan harus mengizinkan komunikasi dari layanan Azure Batch untuk dapat menjadwalkan Tugas pada Simpul. Ini dapat diverifikasi dengan memeriksa apakah VNet yang ditentukan memiliki Kelompok Keamanan Jaringan (NSG) terkait. Jika komunikasi ke Simpul dalam subnet yang ditentukan ditolak oleh NSG, maka layanan Batch akan mengatur status Simpul Komputasi menjadi tidak dapat digunakan. Untuk Kumpulan yang dibuat dengan virtualMachineConfiguration hanya jaringan virtual ARM ('Microsoft.Network/virtualNetworks') yang didukung, tetapi untuk Kumpulan yang dibuat dengan cloudServiceConfiguration baik JARINGAN virtual ARM maupun klasik didukung. Jika VNet yang ditentukan memiliki Kelompok Keamanan Jaringan (NSG) terkait, maka beberapa port sistem yang dipesan harus diaktifkan untuk komunikasi masuk. Untuk Kumpulan yang dibuat dengan konfigurasi komputer virtual, aktifkan port 29876 dan 29877, serta port 22 untuk Linux dan port 3389 untuk Windows. Untuk Kumpulan yang dibuat dengan konfigurasi layanan cloud, aktifkan port 10100, 20100, dan 30100. Aktifkan juga koneksi keluar ke Azure Storage pada port 443. Untuk detail selengkapnya lihat: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Aturan grup keamanan jaringan untuk diterapkan ke titik akhir masuk.

Nama Jenis Deskripsi
access

NetworkSecurityGroupRuleAccess

Tindakan yang harus diambil untuk alamat IP, rentang subnet, atau tag tertentu.

priority

integer

Prioritas untuk aturan ini.
Prioritas dalam Kumpulan harus unik dan dievaluasi dalam urutan prioritas. Semakin rendah angka semakin tinggi prioritasnya. Misalnya, aturan dapat ditentukan dengan nomor pesanan 150, 250, dan 350. Aturan dengan jumlah pesanan 150 lebih diutamakan daripada aturan yang memiliki urutan 250. Prioritas yang diizinkan adalah 150 hingga 4096. Jika ada nilai yang dipesan atau duplikat yang disediakan permintaan gagal dengan kode status HTTP 400.

sourceAddressPrefix

string

Awalan atau tag alamat sumber yang cocok dengan aturan.
Nilai yang valid adalah satu alamat IP (yaitu 10.10.10.10), subnet IP (yaitu 192.168.1.0/24), tag default, atau * (untuk semua alamat). Jika ada nilai lain yang disediakan, permintaan gagal dengan kode status HTTP 400.

sourcePortRanges

string[]

Rentang port sumber yang cocok dengan aturan.
Nilai yang valid adalah '' (untuk semua port 0 - 65535), port tertentu (yaitu 22), atau rentang port (yaitu 100-200). Port harus dalam kisaran 0 hingga 65535. Setiap entri dalam koleksi ini tidak boleh tumpang tindih dengan entri lain (baik rentang atau port individual). Jika ada nilai lain yang disediakan, permintaan gagal dengan kode status HTTP 400. Nilai defaultnya adalah ''.

NetworkSecurityGroupRuleAccess

Tindakan yang harus diambil untuk alamat IP, rentang subnet, atau tag tertentu.

Nama Jenis Deskripsi
allow

string

Izinkan akses.

deny

string

Tolak akses.

NFSMountConfiguration

Informasi yang digunakan untuk menyambungkan ke sistem file NFS.

Nama Jenis Deskripsi
mountOptions

string

Opsi baris perintah tambahan untuk diteruskan ke perintah pemasangan.
Ini adalah opsi 'penggunaan bersih' di Windows dan opsi 'mount' di Linux.

relativeMountPath

string

Jalur relatif pada simpul komputasi tempat sistem file akan dipasang
Semua sistem file dipasang relatif terhadap direktori pemasangan Batch, dapat diakses melalui variabel lingkungan AZ_BATCH_NODE_MOUNTS_DIR.

source

string

URI sistem file yang akan dipasang.

NodeCommunicationMode

Menentukan bagaimana kumpulan berkomunikasi dengan layanan Batch.

Nama Jenis Deskripsi
classic

string

Simpul yang menggunakan mode komunikasi klasik memerlukan komunikasi TCP masuk pada port 29876 dan 29877 dari "BatchNodeManagement. Tag layanan {region}" dan komunikasi TCP keluar pada port 443 ke "Storage.region" dan "BatchNodeManagement. Tag layanan {region}".

default

string

Mode komunikasi simpul secara otomatis diatur oleh layanan Batch.

simplified

string

Simpul yang menggunakan mode komunikasi yang disederhanakan memerlukan komunikasi TCP keluar pada port 443 ke "BatchNodeManagement. Tag layanan {region}". Tidak diperlukan port masuk terbuka.

NodePlacementConfiguration

Konfigurasi penempatan simpul untuk kumpulan.

Nama Jenis Deskripsi
policy

NodePlacementPolicyType

Jenis Kebijakan penempatan simpul pada Kumpulan Batch.
Kebijakan alokasi yang digunakan oleh Layanan Batch untuk menyediakan simpul. Jika tidak ditentukan, Batch akan menggunakan kebijakan regional.

NodePlacementPolicyType

Kebijakan penempatan untuk mengalokasikan simpul di kumpulan.

Nama Jenis Deskripsi
regional

string

Semua simpul dalam kumpulan akan dialokasikan di wilayah yang sama.

zonal

string

Simpul di kumpulan akan tersebar di berbagai zona ketersediaan dengan penyeimbangan upaya terbaik.

OSDisk

Pengaturan untuk disk sistem operasi simpul komputasi (VM).

Nama Jenis Deskripsi
caching

CachingType

Menentukan persyaratan penembolokan. Nilai yang mungkin adalah: None, ReadOnly, ReadWrite. Nilai defaultnya adalah: Tidak ada untuk penyimpanan Standar. ReadOnly untuk penyimpanan Premium.
Nilai default untuk penembolokan tidak ada. Untuk informasi tentang opsi penembolokan, lihat: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Ukuran disk awal dalam GB saat membuat disk OS baru.

ephemeralOSDiskSettings

DiffDiskSettings

Menentukan Pengaturan Disk ephemeral untuk disk sistem operasi yang digunakan oleh simpul komputasi (VM).

managedDisk

ManagedDisk

Parameter disk terkelola.

writeAcceleratorEnabled

boolean

Menentukan apakah writeAccelerator harus diaktifkan atau dinonaktifkan pada disk.

PoolAddParameter

Kumpulan di layanan Azure Batch untuk ditambahkan.

Nama Jenis Deskripsi
applicationLicenses

string[]

Daftar lisensi aplikasi yang akan disediakan layanan Batch pada setiap Simpul Komputasi di Kumpulan.
Daftar lisensi aplikasi harus merupakan subset dari lisensi aplikasi layanan Batch yang tersedia. Jika lisensi diminta yang tidak didukung, pembuatan Kumpulan akan gagal.

applicationPackageReferences

ApplicationPackageReference[]

Daftar Paket yang akan diinstal pada setiap Simpul Komputasi di Kumpulan.
Saat membuat kumpulan, ID aplikasi paket harus sepenuhnya memenuhi syarat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Perubahan pada referensi Paket memengaruhi semua Simpul baru yang bergabung dengan Kumpulan, tetapi tidak memengaruhi Simpul Komputasi yang sudah ada di Kumpulan hingga di-boot ulang atau digambatkan ulang. Ada maksimum 10 referensi Paket pada Kumpulan tertentu.

autoScaleEvaluationInterval

string

Interval waktu untuk menyesuaikan ukuran Kumpulan secara otomatis sesuai dengan rumus skala otomatis.
Nilai defaultnya adalah 15 menit. Nilai minimum dan maksimum masing-masing adalah 5 menit dan 168 jam. Jika Anda menentukan nilai kurang dari 5 menit atau lebih besar dari 168 jam, layanan Batch mengembalikan kesalahan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

autoScaleFormula

string

Rumus untuk jumlah Simpul Komputasi yang diinginkan di Kumpulan.
Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke false. Diperlukan jika enableAutoScale diatur ke true. Rumus diperiksa validitasnya sebelum Kumpulan dibuat. Jika rumus tidak valid, layanan Batch menolak permintaan dengan informasi kesalahan terperinci. Untuk informasi selengkapnya tentang menentukan rumus ini, lihat 'Menskalakan Simpul Komputasi secara otomatis dalam Kumpulan Azure Batch' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Daftar Sertifikat yang akan diinstal pada setiap Simpul Komputasi di Kumpulan.
Untuk Simpul Windows, layanan Batch menginstal Sertifikat ke penyimpanan dan lokasi Sertifikat yang ditentukan. Untuk Simpul Komputasi Linux, Sertifikat disimpan dalam direktori di dalam direktori kerja Tugas dan variabel lingkungan AZ_BATCH_CERTIFICATES_DIR diberikan ke Tugas untuk mengkueri lokasi ini. Untuk Sertifikat dengan visibilitas 'remoteUser', direktori 'certs' dibuat di direktori beranda pengguna (misalnya, /home/{user-name}/certs) dan Sertifikat ditempatkan di direktori tersebut.

Peringatan: Properti ini tidak digunakan lagi dan akan dihapus setelah Februari 2024. Silakan gunakan Ekstensi Azure KeyVault sebagai gantinya.

cloudServiceConfiguration

CloudServiceConfiguration

Konfigurasi layanan cloud untuk Kumpulan.
Properti ini dan virtualMachineConfiguration saling eksklusif dan salah satu properti harus ditentukan. Properti ini tidak dapat ditentukan jika Akun Batch dibuat dengan properti poolAllocationMode yang diatur ke 'UserSubscription'.

displayName

string

Nama tampilan untuk Kumpulan.
Nama tampilan tidak perlu unik dan dapat berisi karakter Unicode hingga panjang maksimum 1024.

enableAutoScale

boolean

Apakah ukuran Kumpulan harus secara otomatis menyesuaikan dari waktu ke waktu.
Jika false, setidaknya salah satu targetDedicatedNodes dan targetLowPriorityNodes harus ditentukan. Jika true, properti autoScaleFormula diperlukan dan Kumpulan secara otomatis mengubah ukuran sesuai dengan rumus. Nilai defaultnya adalah false.

enableInterNodeCommunication

boolean

Apakah Kumpulan mengizinkan komunikasi langsung antara Simpul Komputasi.
Mengaktifkan komunikasi antar-simpul membatasi ukuran maksimum Kumpulan karena pembatasan penyebaran pada Simpul Komputasi Kumpulan. Ini dapat mengakibatkan Kumpulan tidak mencapai ukuran yang diinginkan. Nilai defaultnya adalah false.

id

string

String yang secara unik mengidentifikasi Kumpulan dalam Akun.
ID dapat berisi kombinasi karakter alfanumerik termasuk tanda hubung dan garis bawah, dan tidak boleh berisi lebih dari 64 karakter. ID adalah mempertahankan huruf besar/kecil dan tidak peka huruf besar/kecil (artinya, Anda mungkin tidak memiliki dua ID Kumpulan dalam Akun yang hanya berbeda menurut kasus).

metadata

MetadataItem[]

Daftar pasangan nama-nilai yang terkait dengan Kumpulan sebagai metadata.
Layanan Batch tidak menetapkan arti apa pun untuk metadata; hanya untuk penggunaan kode pengguna.

mountConfiguration

MountConfiguration[]

Pasang penyimpanan menggunakan sistem file tertentu selama seluruh masa pakai kumpulan.
Pasang penyimpanan menggunakan sistem file berbasis Azure fileshare, NFS, CIFS, atau Blobfuse.

networkConfiguration

NetworkConfiguration

Konfigurasi jaringan untuk Kumpulan.
Konfigurasi jaringan untuk Kumpulan.

resizeTimeout

string

Waktu habis untuk alokasi Simpul Komputasi ke Kumpulan.
Batas waktu ini hanya berlaku untuk penskalakan manual; tidak berpengaruh ketika enableAutoScale diatur ke true. Nilai defaultnya adalah 15 menit. Nilai minimum adalah 5 menit. Jika Anda menentukan nilai kurang dari 5 menit, layanan Batch mengembalikan kesalahan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

resourceTags

object

Tag yang ditentukan pengguna yang terkait dengan kumpulan.
Tag yang ditentukan pengguna yang akan dikaitkan dengan kumpulan Azure Batch. Ketika ditentukan, tag ini disebarkan ke sumber daya Azure yang mendukung yang terkait dengan kumpulan. Properti ini hanya dapat ditentukan ketika akun Batch dibuat dengan properti poolAllocationMode diatur ke 'UserSubscription'.

startTask

StartTask

Tugas yang ditentukan untuk dijalankan pada setiap Simpul Komputasi saat bergabung dengan Kumpulan.
Tugas berjalan ketika Simpul Komputasi ditambahkan ke Kumpulan atau ketika Simpul Komputasi dimulai ulang.

targetDedicatedNodes

integer

Jumlah Simpul Komputasi khusus yang diinginkan di Kumpulan.
Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke true. Jika enableAutoScale diatur ke false, maka Anda harus mengatur targetDedicatedNodes, targetLowPriorityNodes, atau keduanya.

targetLowPriorityNodes

integer

Jumlah Simpul Komputasi Spot/Prioritas rendah yang diinginkan di Kumpulan.
Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke true. Jika enableAutoScale diatur ke false, maka Anda harus mengatur targetDedicatedNodes, targetLowPriorityNodes, atau keduanya.

targetNodeCommunicationMode

NodeCommunicationMode

Mode komunikasi simpul yang diinginkan untuk kumpulan.
Jika dihilangkan, nilai defaultnya adalah Default.

taskSchedulingPolicy

TaskSchedulingPolicy

Bagaimana Tugas didistribusikan di seluruh Simpul Komputasi dalam Kumpulan.
Jika tidak ditentukan, defaultnya adalah spread.

taskSlotsPerNode

integer

Jumlah slot tugas yang dapat digunakan untuk menjalankan tugas bersamaan pada satu simpul komputasi dalam kumpulan.
Nilai default adalah 1. Nilai maksimum adalah lebih kecil dari 4 kali jumlah inti vmSize kumpulan atau 256.

userAccounts

UserAccount[]

Daftar Akun pengguna yang akan dibuat pada setiap Simpul Komputasi di Kumpulan.

virtualMachineConfiguration

VirtualMachineConfiguration

Konfigurasi komputer virtual untuk Kumpulan.
Properti dan cloudServiceConfiguration ini saling eksklusif dan salah satu properti harus ditentukan.

vmSize

string

Ukuran komputer virtual di Kumpulan. Semua komputer virtual dalam Kumpulan berukuran sama.
Untuk informasi tentang ukuran komputer virtual yang tersedia untuk kumpulan Cloud Services (kumpulan yang dibuat dengan cloudServiceConfiguration), lihat Ukuran untuk Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch mendukung semua ukuran VM Cloud Services kecuali ExtraSmall, A1V2, dan A2V2. Untuk informasi tentang ukuran VM yang tersedia untuk Kumpulan menggunakan Gambar dari Virtual Machines Marketplace (kumpulan yang dibuat dengan virtualMachineConfiguration) lihat Ukuran untuk Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) atau Ukuran untuk Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch mendukung semua ukuran Azure VM kecuali STANDARD_A0 dan yang memiliki penyimpanan premium (STANDARD_GS, STANDARD_DS, dan seri STANDARD_DSV2).

PoolEndpointConfiguration

Konfigurasi titik akhir untuk Kumpulan.

Nama Jenis Deskripsi
inboundNATPools

InboundNATPool[]

Daftar Kumpulan NAT masuk yang dapat digunakan untuk mengatasi port tertentu pada Simpul Komputasi individual secara eksternal.
Jumlah maksimum Kumpulan NAT masuk per Kumpulan Batch adalah 5. Jika jumlah maksimum Kumpulan NAT masuk melebihi permintaan gagal dengan kode status HTTP 400. Ini tidak dapat ditentukan jika IPAddressProvisioningType adalah NoPublicIPAddresses.

PublicIPAddressConfiguration

Konfigurasi Alamat IP publik dari konfigurasi jaringan Kumpulan.

Nama Jenis Deskripsi
ipAddressIds

string[]

Daftar IP publik yang akan digunakan layanan Batch saat menyediakan Simpul Komputasi.
Jumlah IP yang ditentukan di sini membatasi ukuran maksimum Kumpulan - 100 simpul khusus atau 100 simpul Spot/Prioritas rendah dapat dialokasikan untuk setiap IP publik. Misalnya, kumpulan yang membutuhkan 250 VM khusus akan membutuhkan setidaknya 3 IP publik yang ditentukan. Setiap elemen koleksi ini berbentuk: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

IPAddressProvisioningType

Jenis provisi untuk Alamat IP Publik untuk Kumpulan.
Nilai defaultnya adalah BatchManaged.

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

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 seperti itu untuk blob di penyimpanan Azure: menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin baca pada blob, menggunakan identitas terkelola dengan izin baca, atau mengatur 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 seperti itu untuk kontainer di penyimpanan Azure: sertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin baca dan daftar pada kontainer, gunakan identitas terkelola dengan izin baca dan daftar, atau atur ACL untuk kontainer guna mengizinkan akses publik.

SecurityProfile

Menentukan pengaturan profil keamanan untuk komputer virtual atau set skala komputer virtual.

Nama Jenis Deskripsi
encryptionAtHost

boolean

Properti ini dapat digunakan oleh pengguna dalam permintaan untuk mengaktifkan atau menonaktifkan Enkripsi Host untuk komputer virtual atau set skala komputer virtual. Ini akan mengaktifkan enkripsi untuk semua disk termasuk disk Sumber Daya/Temp di host itu sendiri.

securityType

SecurityTypes

Menentukan SecurityType komputer virtual. Ini harus diatur ke nilai yang ditentukan untuk mengaktifkan UefiSettings.

uefiSettings

UefiSettings

Menentukan pengaturan keamanan seperti boot aman dan vTPM yang digunakan saat membuat komputer virtual.
Menentukan pengaturan keamanan seperti boot aman dan vTPM yang digunakan saat membuat komputer virtual.

SecurityTypes

Menentukan SecurityType komputer virtual. Ini harus diatur ke nilai yang ditentukan untuk mengaktifkan UefiSettings.

Nama Jenis Deskripsi
trustedLaunch

string

Peluncuran terpercaya melindungi dari teknik serangan canggih dan terus-menerus.

ServiceArtifactReference

Menentukan id referensi artefak layanan yang digunakan untuk mengatur versi gambar yang sama untuk semua komputer virtual dalam set skala saat menggunakan versi gambar 'terbaru'.

Nama Jenis Deskripsi
id

string

Id referensi artefak layanan serviceArtifactReference
Id referensi artefak layanan dalam bentuk /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StartTask

Tugas yang dijalankan saat Simpul bergabung dengan Kumpulan di layanan Azure Batch, atau saat Simpul Komputasi di-boot ulang atau digambut ulang.

Nama Jenis Deskripsi
commandLine

string

Baris perintah StartTask.
Baris perintah tidak berjalan di bawah shell, dan karena itu tidak dapat memanfaatkan fitur shell seperti ekspansi variabel lingkungan. Jika Anda ingin memanfaatkan fitur tersebut, Anda harus memanggil shell di baris perintah, misalnya menggunakan "cmd /c MyCommand" di Windows atau "/bin/sh -c MyCommand" di Linux. Jika baris perintah mengacu pada jalur file, baris tersebut harus menggunakan jalur relatif (relatif terhadap direktori kerja Tugas), atau menggunakan variabel lingkungan yang disediakan Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

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 diproduksi 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-file tersebut.

environmentSettings

EnvironmentSetting[]

Daftar pengaturan variabel lingkungan untuk StartTask.

maxTaskRetryCount

integer

Berapa kali maksimum Tugas dapat dicoba kembali.
Layanan Batch mencoba kembali Tugas jika kode keluarnya bukan nol. Perhatikan bahwa nilai ini secara khusus mengontrol jumlah percobaan kembali. Layanan Batch akan mencoba Tugas sekali, dan kemudian dapat mencoba kembali hingga batas ini. Misalnya, jika jumlah percobaan kembali 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 kembali).

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, pengumpulan 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, untuk 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 yang 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. Secara default adalah benar.

StorageAccountType

Jenis Akun penyimpanan untuk digunakan dalam membuat disk data atau disk OS.

Nama Jenis Deskripsi
premium_lrs

string

Disk data/disk OS harus menggunakan penyimpanan redundan lokal premium.

standard_lrs

string

Disk data/disk OS harus menggunakan penyimpanan redundan lokal standar.

standardssd_lrs

string

Disk data/disk OS harus menggunakan penyimpanan redundan lokal SSD standar.

TaskContainerSettings

Pengaturan kontainer untuk Tugas.

Nama Jenis Deskripsi
containerRunOptions

string

Opsi tambahan untuk perintah buat kontainer.
Opsi tambahan ini disediakan sebagai argumen ke perintah "docker create", selain yang dikontrol oleh Layanan Batch.

imageName

string

Gambar yang digunakan untuk membuat kontainer tempat Tugas akan berjalan.
Ini adalah referensi Gambar lengkap, seperti yang akan ditentukan ke "penarikan docker". Jika tidak ada tag yang disediakan sebagai bagian dari Nama gambar, tag ":latest" digunakan sebagai default.

registry

ContainerRegistry

Registri privat yang berisi Gambar kontainer.
Pengaturan ini dapat dihilangkan jika sudah disediakan di pembuatan Pool.

workingDirectory

ContainerWorkingDirectory

Lokasi direktori kerja Tugas kontainer.
Defaultnya adalah 'taskWorkingDirectory'.

TaskSchedulingPolicy

Menentukan bagaimana Tugas harus didistribusikan di seluruh Simpul Komputasi.

Nama Jenis Deskripsi
nodeFillType

ComputeNodeFillType

Bagaimana Tugas didistribusikan di seluruh Simpul Komputasi dalam Kumpulan.
Jika tidak ditentukan, defaultnya adalah spread.

UefiSettings

Menentukan pengaturan keamanan seperti boot aman dan vTPM yang digunakan saat membuat komputer virtual.

Nama Jenis Deskripsi
secureBootEnabled

boolean

Menentukan apakah boot aman harus diaktifkan pada komputer virtual.

vTpmEnabled

boolean

Menentukan apakah vTPM harus diaktifkan pada komputer virtual.

UserAccount

Properti yang digunakan untuk membuat pengguna yang digunakan untuk menjalankan Tugas pada Simpul Komputasi Azure Batch.

Nama Jenis Deskripsi
elevationLevel

ElevationLevel

Tingkat elevasi Akun pengguna.
Nilai defaultnya adalah nonAdmin.

linuxUserConfiguration

LinuxUserConfiguration

Konfigurasi pengguna khusus Linux untuk Akun pengguna.
Properti ini diabaikan jika ditentukan pada Kumpulan Windows. Jika tidak ditentukan, pengguna dibuat dengan opsi default.

name

string

Nama Akun pengguna. Nama dapat berisi karakter Unicode hingga panjang maksimum 20.

password

string

Kata sandi untuk Akun pengguna.

windowsUserConfiguration

WindowsUserConfiguration

Konfigurasi pengguna khusus Windows untuk Akun pengguna.
Properti ini hanya dapat ditentukan jika pengguna berada di Kumpulan Windows. Jika tidak ditentukan dan pada Kumpulan Windows, pengguna dibuat dengan opsi default.

UserIdentity

Definisi identitas pengguna tempat Tugas dijalankan.

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.

VirtualMachineConfiguration

Konfigurasi untuk Simpul Komputasi dalam Kumpulan berdasarkan infrastruktur Azure Virtual Machines.

Nama Jenis Deskripsi
containerConfiguration

ContainerConfiguration

Konfigurasi kontainer untuk Kumpulan.
Jika ditentukan, penyetelan dilakukan pada setiap Simpul Komputasi di Kumpulan untuk memungkinkan Tugas berjalan dalam kontainer. Semua Tugas reguler dan Tugas manajer Pekerjaan yang dijalankan pada Kumpulan ini harus menentukan properti containerSettings, dan semua Tugas lainnya dapat menentukannya.

dataDisks

DataDisk[]

Konfigurasi untuk disk data yang dilampirkan ke Simpul Komputasi di Kumpulan.
Properti ini harus ditentukan jika Simpul Komputasi di Kumpulan harus memiliki disk data kosong yang melekat padanya. Ini tidak dapat diperbarui. Setiap Simpul Komputasi mendapatkan disknya sendiri (disk bukan berbagi file). Disk yang ada tidak dapat dilampirkan, setiap disk yang terpasang kosong. Ketika Simpul Komputasi dihapus dari Kumpulan, disk dan semua data yang terkait dengannya juga dihapus. Disk tidak diformat setelah dilampirkan, disk harus diformat sebelum digunakan - untuk informasi selengkapnya lihat https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux dan https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

diskEncryptionConfiguration

DiskEncryptionConfiguration

Konfigurasi enkripsi disk untuk kumpulan.
Jika ditentukan, enkripsi dilakukan pada setiap simpul di kumpulan selama provisi simpul.

extensions

VMExtension[]

Ekstensi komputer virtual untuk kumpulan.
Jika ditentukan, ekstensi yang disebutkan dalam konfigurasi ini akan diinstal pada setiap simpul.

imageReference

ImageReference

Referensi ke Azure Virtual Machines Marketplace Image atau Gambar Komputer Virtual kustom untuk digunakan.

licenseType

string

Jenis lisensi lokal yang akan digunakan saat menyebarkan sistem operasi.
Ini hanya berlaku untuk Gambar yang berisi sistem operasi Windows, dan hanya boleh digunakan ketika Anda menyimpan lisensi lokal yang valid untuk Simpul Komputasi yang akan disebarkan. Jika dihilangkan, tidak ada diskon lisensi lokal yang diterapkan. Nilainya adalah:

Windows_Server - Lisensi lokal adalah untuk Windows Server. Windows_Client - Lisensi lokal adalah untuk Klien Windows.

nodeAgentSKUId

string

SKU agen Simpul Komputasi Batch yang akan disediakan pada Simpul Komputasi di Kumpulan.
Agen Simpul Komputasi Batch adalah program yang berjalan pada setiap Simpul Komputasi di Kumpulan, dan menyediakan antarmuka perintah dan kontrol antara Simpul Komputasi dan layanan Batch. Ada berbagai implementasi agen Simpul Komputasi, yang dikenal sebagai SKU, untuk sistem operasi yang berbeda. Anda harus menentukan SKU agen Simpul Komputasi yang cocok dengan referensi Gambar yang dipilih. Untuk mendapatkan daftar SKU agen Simpul Komputasi yang didukung bersama dengan daftar referensi Gambar terverifikasi mereka, lihat operasi 'Daftar SKU agen Simpul Komputasi yang didukung'.

nodePlacementConfiguration

NodePlacementConfiguration

Konfigurasi penempatan simpul untuk kumpulan.
Konfigurasi ini akan menentukan aturan tentang bagaimana simpul dalam kumpulan akan dialokasikan secara fisik.

osDisk

OSDisk

Pengaturan untuk disk sistem operasi Komputer Virtual.

securityProfile

SecurityProfile

Menentukan pengaturan profil keamanan untuk komputer virtual atau set skala komputer virtual.
Menentukan pengaturan profil keamanan untuk komputer virtual atau set skala komputer virtual.

serviceArtifactReference

ServiceArtifactReference

Menentukan id referensi artefak layanan yang digunakan untuk mengatur versi gambar yang sama untuk semua komputer virtual dalam set skala saat menggunakan versi gambar 'terbaru'.
Id referensi artefak layanan dalam bentuk /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

windowsConfiguration

WindowsConfiguration

Pengaturan sistem operasi Windows pada komputer virtual.
Properti ini tidak boleh ditentukan jika properti imageReference menentukan Gambar OS Linux.

VMExtension

Konfigurasi untuk ekstensi komputer virtual.

Nama Jenis Deskripsi
autoUpgradeMinorVersion

boolean

Menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Setelah disebarkan, bagaimanapun, ekstensi tidak akan meningkatkan versi kecil kecuali dipekerjakan kembali, bahkan jika properti ini diatur ke true.

enableAutomaticUpgrade

boolean

Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia.

name

string

Nama ekstensi komputer virtual.

protectedSettings

object

Ekstensi dapat berisi protectedSettings atau protectedSettingsFromKeyVault atau tidak ada pengaturan yang dilindungi sama sekali.

provisionAfterExtensions

string[]

Kumpulan nama ekstensi.
Kumpulan nama ekstensi setelah ekstensi ini perlu disediakan.

publisher

string

Nama penerbit handler ekstensi.

settings

object

Pengaturan publik berformat JSON untuk ekstensi.

type

string

Jenis ekstensi.

typeHandlerVersion

string

Versi handler skrip.

WindowsConfiguration

Pengaturan sistem operasi Windows untuk diterapkan ke komputer virtual.

Nama Jenis Deskripsi
enableAutomaticUpdates

boolean

Apakah pembaruan otomatis diaktifkan pada komputer virtual.
Jika dihilangkan, nilai defaultnya adalah true.

WindowsUserConfiguration

Properti yang digunakan untuk membuat Akun pengguna pada Simpul Komputasi Windows.

Nama Jenis Deskripsi
loginMode

LoginMode

Mode masuk untuk pengguna
Nilai default untuk Kumpulan VirtualMachineConfiguration adalah 'batch' dan untuk Kumpulan CloudServiceConfiguration adalah 'interaktif'.