Bagikan melalui


Pool - Create

Membuat kumpulan baru di dalam akun yang ditentukan.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}?api-version=2024-07-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-zA-Z0-9]+$

Nama untuk akun Batch yang harus unik di wilayah tersebut. Nama akun batch harus terdiri dari antara 3 dan 24 karakter dan hanya boleh menggunakan angka dan huruf kecil. Nama ini digunakan sebagai bagian dari nama DNS yang digunakan untuk mengakses layanan Batch di wilayah tempat akun dibuat. Misalnya: http://accountname.region.batch.azure.com/.

poolName
path True

string

minLength: 1
maxLength: 64
pattern: ^[a-zA-Z0-9_-]+$

Nama kumpulan. Ini harus unik dalam akun.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

subscriptionId
path True

string (uuid)

ID langganan target. Nilainya harus sebuah UUID.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
If-Match

string

Versi status entitas (ETag) dari kumpulan yang akan diperbarui. Nilai "*" dapat digunakan untuk menerapkan operasi hanya jika kumpulan sudah ada. Jika dihilangkan, operasi ini akan selalu diterapkan.

If-None-Match

string

Atur ke '*' untuk mengizinkan kumpulan baru dibuat, tetapi untuk mencegah pembaruan kumpulan yang ada. Nilai lain akan diabaikan.

Isi Permintaan

Nama Jenis Deskripsi
identity

BatchPoolIdentity

Jenis identitas yang digunakan untuk Kumpulan Batch.

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

properties.applicationPackages

ApplicationPackageReference[]

Daftar paket aplikasi yang akan diinstal pada setiap simpul komputasi di kumpulan.
Perubahan pada referensi paket aplikasi memengaruhi semua simpul komputasi baru yang bergabung dengan kumpulan, tetapi tidak memengaruhi simpul komputasi yang sudah ada di kumpulan hingga di-boot ulang atau digambut ulang. Ada maksimum 10 referensi paket aplikasi pada kumpulan tertentu.

properties.certificates

CertificateReference[]

Daftar sertifikat yang akan diinstal pada setiap simpul komputasi di kumpulan.
Untuk simpul komputasi 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 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.

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

properties.deploymentConfiguration

DeploymentConfiguration

Properti ini menjelaskan komputer virtual tempat simpul kumpulan akan disebarkan.
Properti konfigurasi penyebaran.

properties.displayName

string

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

properties.interNodeCommunication

InterNodeCommunicationState

Apakah kumpulan mengizinkan komunikasi langsung antar simpul.
Ini memberlakukan pembatasan di mana simpul dapat ditetapkan ke kumpulan. Mengaktifkan nilai ini dapat mengurangi kemungkinan jumlah simpul yang diminta untuk dialokasikan di kumpulan. Jika tidak ditentukan, nilai ini default ke 'Dinonaktifkan'.

properties.metadata

MetadataItem[]

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

properties.mountConfiguration

MountConfiguration[]

Daftar sistem file yang akan dipasang pada setiap simpul di kumpulan.
Ini mendukung Azure Files, NFS, CIFS/SMB, dan Blobfuse.

properties.networkConfiguration

NetworkConfiguration

Konfigurasi jaringan untuk kumpulan.
Konfigurasi jaringan untuk kumpulan.

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

properties.scaleSettings

ScaleSettings

Pengaturan yang mengonfigurasi jumlah simpul dalam kumpulan.
Menentukan ukuran kumpulan yang diinginkan. Ini bisa berupa 'fixedScale' di mana targetDedicatedNodes yang diminta ditentukan, atau 'autoScale' yang menentukan rumus yang dievaluasi ulang secara berkala. Jika properti ini tidak ditentukan, kumpulan akan memiliki skala tetap dengan 0 targetDedicatedNodes.

properties.startTask

StartTask

Tugas yang ditentukan untuk dijalankan pada setiap simpul komputasi saat menggabungkan kumpulan.
Dalam operasi PATCH (pembaruan), properti ini dapat diatur ke objek kosong untuk menghapus tugas mulai dari kumpulan.

properties.targetNodeCommunicationMode

NodeCommunicationMode

Menentukan bagaimana kumpulan berkomunikasi dengan layanan Batch.
Jika dihilangkan, nilai defaultnya adalah Default.

properties.taskSchedulingPolicy

TaskSchedulingPolicy

Bagaimana tugas didistribusikan di seluruh simpul komputasi dalam kumpulan.
Jika tidak ditentukan, defaultnya adalah spread.

properties.taskSlotsPerNode

integer (int32)

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

properties.upgradePolicy

UpgradePolicy

Kebijakan peningkatan untuk kumpulan.
Menjelaskan kebijakan peningkatan - otomatis, manual, atau bergulir.

properties.userAccounts

UserAccount[]

Daftar akun pengguna yang akan dibuat pada setiap simpul di kumpulan.

properties.vmSize

string

Ukuran komputer virtual di kumpulan. Semua VM dalam kumpulan berukuran sama.
Untuk informasi tentang ukuran VM yang tersedia, lihat Ukuran untuk Komputer Virtual di Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). Batch mendukung semua ukuran Azure VM kecuali STANDARD_A0 dan yang memiliki penyimpanan premium (STANDARD_GS, STANDARD_DS, dan seri STANDARD_DSV2).

tags

object

Tag sumber daya.

Respons

Nama Jenis Deskripsi
200 OK

Pool

Permintaan telah berhasil.

Header

ETag: string

Other Status Codes

CloudError

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

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

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

CreatePool - accelerated networking
CreatePool - Custom Image
CreatePool - Full VirtualMachineConfiguration
CreatePool - Minimal VirtualMachineConfiguration
CreatePool - No public IP
CreatePool - Public IPs
CreatePool - ResourceTags
CreatePool - SecurityProfile
CreatePool - Tags
CreatePool - UpgradePolicy
CreatePool - UserAssignedIdentities
CreatePool - VirtualMachineConfiguration Extensions
CreatePool - VirtualMachineConfiguration OSDisk
CreatePool - VirtualMachineConfiguration ServiceArtifactReference

CreatePool - accelerated networking

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64"
      }
    },
    "networkConfiguration": {
      "enableAcceleratedNetworking": true,
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "STANDARD_D1_V2"
  }
}

Respon sampel

ETag: W/"0x8DB46CB72A227E2"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2023-04-27T03:00:34.0646502Z",
    "creationTime": "2023-04-27T02:59:41.8592226Z",
    "currentDedicatedNodes": 1,
    "currentLowPriorityNodes": 0,
    "currentNodeCommunicationMode": "Classic",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-04-27T02:59:41.8592226Z",
    "networkConfiguration": {
      "dynamicVnetAssignmentScope": "none",
      "enableAcceleratedNetworking": true,
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-04-27T02:59:41.8592226Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-04-27T02:59:41.8592226Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D1_V2"
  }
}

CreatePool - Custom Image

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Respon sampel

ETag: W/"0x8D4EDFEBFADF4AB"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - Full VirtualMachineConfiguration

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "dataDisks": [
          {
            "caching": "ReadWrite",
            "diskSizeGB": 30,
            "lun": 0,
            "storageAccountType": "Premium_LRS"
          },
          {
            "caching": "None",
            "diskSizeGB": 200,
            "lun": 1,
            "storageAccountType": "Standard_LRS"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [
            "OsDisk",
            "TemporaryDisk"
          ]
        },
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-Datacenter-SmallDisk",
          "version": "latest"
        },
        "licenseType": "Windows_Server",
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "osDisk": {
          "ephemeralOSDiskSettings": {
            "placement": "CacheDisk"
          }
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "name": "testnat",
            "backendPort": 12001,
            "frontendPortRangeEnd": 15100,
            "frontendPortRangeStart": 15000,
            "networkSecurityGroupRules": [
              {
                "access": "Allow",
                "priority": 150,
                "sourceAddressPrefix": "192.100.12.45",
                "sourcePortRanges": [
                  "1",
                  "2"
                ]
              },
              {
                "access": "Deny",
                "priority": 3500,
                "sourceAddressPrefix": "*",
                "sourcePortRanges": [
                  "*"
                ]
              }
            ],
            "protocol": "TCP"
          }
        ]
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Respon sampel

ETag: W/"0x8D4EDFEBFADF4AB"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "dataDisks": [
          {
            "caching": "ReadWrite",
            "diskSizeGB": 30,
            "lun": 0,
            "storageAccountType": "Premium_LRS"
          },
          {
            "caching": "None",
            "diskSizeGB": 200,
            "lun": 1,
            "storageAccountType": "Standard_LRS"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [
            "OsDisk",
            "TemporaryDisk"
          ]
        },
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-Datacenter-SmallDisk",
          "version": "latest"
        },
        "licenseType": "Windows_Server",
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "name": "testnat",
            "backendPort": 12001,
            "frontendPortRangeEnd": 15100,
            "frontendPortRangeStart": 15000,
            "networkSecurityGroupRules": [
              {
                "access": "Allow",
                "priority": 150,
                "sourceAddressPrefix": "192.100.12.45",
                "sourcePortRanges": [
                  "1",
                  "2"
                ]
              },
              {
                "access": "Deny",
                "priority": 3500,
                "sourceAddressPrefix": "*",
                "sourcePortRanges": [
                  "*"
                ]
              }
            ],
            "protocol": "TCP"
          }
        ]
      }
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - Minimal VirtualMachineConfiguration

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Respon sampel

ETag: W/"0x8D4EDFEBFADF4AB"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - No public IP

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "provision": "NoPublicIPAddresses"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "vmSize": "STANDARD_D4"
  }
}

Respon sampel

ETag: W/"0x8D4EDFEBFADF4AB"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "provision": "NoPublicIPAddresses"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - Public IPs

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "ipAddressIds": [
          "/subscriptions/12345678-1234-1234-1234-1234567890121/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
        ],
        "provision": "UserManaged"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "vmSize": "STANDARD_D4"
  }
}

Respon sampel

ETag: W/"0x8D4EDFEBFADF4AB"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "ipAddressIds": [
          "/subscriptions/12345678-1234-1234-1234-1234567890121/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
        ],
        "provision": "UserManaged"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - ResourceTags

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "resourceTags": {
      "TagName1": "TagValue1",
      "TagName2": "TagValue2"
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Respon sampel

ETag: W/"0x8DB554F8E08BCF4"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-09-27T07:33:13.0625789Z",
      "targetDedicatedNodes": 1
    },
    "resourceTags": {
      "TagName1": "TagValue1",
      "TagName2": "TagValue2"
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - SecurityProfile

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04",
        "securityProfile": {
          "encryptionAtHost": true,
          "securityType": "trustedLaunch",
          "uefiSettings": {
            "secureBootEnabled": null,
            "vTpmEnabled": false
          }
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Respon sampel

ETag: W/"0x8DB554F8E08BCF4"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04",
        "securityProfile": {
          "encryptionAtHost": true,
          "securityType": "trustedLaunch",
          "uefiSettings": {
            "vTpmEnabled": false
          }
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-06-14T07:03:58.3231917Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - Tags

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-jammy",
          "publisher": "Canonical",
          "sku": "22_04-lts",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 22.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Respon sampel

ETag: W/"0x8DB554F8E08BCF4"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-jammy",
          "publisher": "Canonical",
          "sku": "22_04-lts",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 22.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-09-27T07:33:13.0625789Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - UpgradePolicy

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "disableAutomaticRollback": true,
        "enableAutomaticOSUpgrade": true,
        "osRollingUpgradeDeferral": true,
        "useRollingUpgradePolicy": true
      },
      "mode": "automatic",
      "rollingUpgradePolicy": {
        "enableCrossZoneUpgrade": true,
        "maxBatchInstancePercent": 20,
        "maxUnhealthyInstancePercent": 20,
        "maxUnhealthyUpgradedInstancePercent": 20,
        "pauseTimeBetweenBatches": "PT0S",
        "prioritizeUnhealthyInstances": false,
        "rollbackFailedInstancesOnPolicyBreach": false
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Respon sampel

ETag: W/"0x8DB51E64D3C3B69"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
    "creationTime": "2023-05-11T06:16:44.2372184Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-05-11T06:16:44.2372184Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-05-11T06:16:44.2372184Z",
      "targetDedicatedNodes": 2
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "disableAutomaticRollback": true,
        "enableAutomaticOSUpgrade": true,
        "osRollingUpgradeDeferral": true,
        "useRollingUpgradePolicy": true
      },
      "mode": "automatic",
      "rollingUpgradePolicy": {
        "enableCrossZoneUpgrade": true,
        "maxBatchInstancePercent": 20,
        "maxUnhealthyInstancePercent": 20,
        "maxUnhealthyUpgradedInstancePercent": 20,
        "pauseTimeBetweenBatches": "PT0S",
        "prioritizeUnhealthyInstances": false,
        "rollbackFailedInstancesOnPolicyBreach": false
      }
    },
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - UserAssignedIdentities

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
    }
  },
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Respon sampel

ETag: W/"0x8D4EDFEBFADF4AB"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
        "clientId": "clientId1",
        "principalId": "principalId1"
      },
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {
        "clientId": "clientId2",
        "principalId": "principalId2"
      }
    }
  },
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
    "creationTime": "2020-10-01T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2020-10-01T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - VirtualMachineConfiguration Extensions

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-focal",
          "publisher": "Canonical",
          "sku": "20_04-lts"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 20.04",
        "extensions": [
          {
            "name": "batchextension1",
            "type": "KeyVaultForLinux",
            "autoUpgradeMinorVersion": true,
            "enableAutomaticUpgrade": true,
            "publisher": "Microsoft.Azure.KeyVault",
            "settings": {
              "authenticationSettingsKey": "authenticationSettingsValue",
              "secretsManagementSettingsKey": "secretsManagementSettingsValue"
            },
            "typeHandlerVersion": "2.0"
          }
        ]
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "targetNodeCommunicationMode": "Default",
    "vmSize": "STANDARD_D4"
  }
}

Respon sampel

ETag: W/"0x8D4EDFEBFADF4AB"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-focal",
          "publisher": "Canonical",
          "sku": "20_04-lts"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 20.04",
        "extensions": [
          {
            "name": "batchextension1",
            "type": "KeyVaultForLinux",
            "autoUpgradeMinorVersion": true,
            "enableAutomaticUpgrade": true,
            "publisher": "Microsoft.Azure.KeyVault",
            "settings": {
              "authenticationSettingsKey": "authenticationSettingsValue",
              "secretsManagementSettingsKey": "secretsManagementSettingsValue"
            },
            "typeHandlerVersion": "2.0"
          }
        ]
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "targetNodeCommunicationMode": "Default",
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - VirtualMachineConfiguration OSDisk

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "windowsserver",
          "publisher": "microsoftwindowsserver",
          "sku": "2022-datacenter-smalldisk"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "osDisk": {
          "caching": "ReadWrite",
          "diskSizeGB": 100,
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "writeAcceleratorEnabled": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d2s_v3"
  }
}

Respon sampel

ETag: W/"0x8DB51F14DC1A8AD"
{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
    "creationTime": "2023-08-24T02:12:27.7527697Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "windowsserver",
          "publisher": "microsoftwindowsserver",
          "sku": "2022-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "osDisk": {
          "caching": "ReadWrite",
          "diskSizeGB": 100,
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "writeAcceleratorEnabled": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-08-24T02:12:27.7527697Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-08-24T02:12:27.7527697Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D2_V3"
  }
}

CreatePool - VirtualMachineConfiguration ServiceArtifactReference

Permintaan sampel

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "serviceArtifactReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      },
      "mode": "automatic"
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Respon sampel

ETag: W/"0x8DB51F14DC1A8AD"
{
  "name": "mypool41",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
    "creationTime": "2023-05-11T07:44:44.8580493Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "serviceArtifactReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-05-11T07:44:44.8580493Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-05-11T07:44:44.8580493Z",
      "targetDedicatedNodes": 2
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      },
      "mode": "automatic"
    },
    "vmSize": "STANDARD_D4S_V3"
  }
}

Definisi

Nama Deskripsi
AllocationState

Apakah kumpulan mengubah ukuran.

ApplicationPackageReference

Menautkan ke paket aplikasi di dalam akun batch

AutomaticOSUpgradePolicy

Parameter konfigurasi yang digunakan untuk melakukan peningkatan OS otomatis.

AutoScaleRun

Hasil dan kesalahan dari eksekusi rumus skala otomatis kumpulan.

AutoScaleRunError

Kesalahan yang terjadi saat menskalakan kumpulan secara otomatis.

AutoScaleSettings

Pengaturan Skala Otomatis untuk kumpulan.

AutoUserScope

Nilai defaultnya adalah Kumpulan. Jika kumpulan menjalankan Windows, nilai Tugas harus ditentukan jika isolasi yang lebih ketat antar tugas diperlukan. Misalnya, jika tugas memutasi registri dengan cara yang dapat memengaruhi tugas lain, atau jika sertifikat telah ditentukan pada kumpulan yang seharusnya tidak dapat diakses oleh tugas normal tetapi harus dapat diakses dengan memulai tugas.

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.

BatchPoolIdentity

Identitas kumpulan Batch, jika dikonfigurasi. Jika identitas kumpulan diperbarui selama memperbarui kumpulan yang ada, hanya vm baru yang dibuat setelah kumpulan menyusut ke 0 yang akan memiliki identitas yang diperbarui

CachingType

Jenis penembolokan yang akan diaktifkan untuk disk.

CertificateReference

Referensi ke sertifikat yang akan diinstal pada simpul komputasi dalam kumpulan. Ini harus ada di dalam akun yang sama dengan kumpulan.

CertificateStoreLocation

Nilai defaultnya adalah currentUser. Properti ini hanya berlaku untuk kumpulan yang dikonfigurasi dengan simpul komputasi 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.

CertificateVisibility
CIFSMountConfiguration

Informasi yang digunakan untuk menyambungkan ke sistem file CIFS.

CloudError

Respons kesalahan dari layanan Batch.

CloudErrorBody

Respons kesalahan dari layanan Batch.

ComputeNodeDeallocationOption

Menentukan apa yang harus dilakukan dengan simpul dan tugas yang sedang berjalan setelah dipilih untuk pembatalan alokasi.

ComputeNodeFillType

Bagaimana tugas harus didistribusikan di seluruh simpul komputasi.

ComputeNodeIdentityReference

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

ContainerConfiguration

Konfigurasi untuk kumpulan yang diaktifkan kontainer.

ContainerHostBatchBindMountEntry

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

ContainerHostDataPath

Jalur yang akan dipasang ke kontainer tugas kontainer.

ContainerRegistry

Registri kontainer privat.

ContainerType

Teknologi kontainer yang akan digunakan.

ContainerWorkingDirectory

Bendera untuk menunjukkan di mana direktori kerja tugas kontainer berada. Defaultnya adalah 'taskWorkingDirectory'.

createdByType

Jenis identitas yang membuat sumber daya.

DataDisk

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

DeploymentConfiguration

Properti konfigurasi penyebaran.

DiffDiskPlacement

Lokasi di mana disk OS harus ditempatkan.

DiffDiskSettings

Menentukan Pengaturan Disk ephemeral untuk disk sistem operasi yang digunakan oleh komputer virtual.

DiskEncryptionConfiguration

Konfigurasi enkripsi disk diterapkan pada simpul komputasi di kumpulan. Konfigurasi enkripsi disk tidak didukung pada kumpulan Linux yang dibuat dengan Gambar Komputer Virtual atau Gambar Azure Compute Gallery.

DiskEncryptionTarget

Jika dihilangkan, tidak ada disk pada simpul komputasi di kumpulan yang akan dienkripsi.

DynamicVNetAssignmentScope

Cakupan penetapan vnet dinamis.

ElevationLevel

Tingkat elevasi pengguna.

EnvironmentSetting

Variabel lingkungan yang akan diatur pada proses tugas.

FixedScaleSettings

Memperbaiki pengaturan skala untuk kumpulan.

ImageReference

Referensi ke gambar Azure Virtual Machines Marketplace atau sumber daya Gambar Azure dari Komputer Virtual kustom. Untuk mendapatkan daftar semua imageReferences yang diverifikasi oleh Azure Batch, lihat operasi 'Daftar SKU agen simpul 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.

InterNodeCommunicationState

Ini memberlakukan pembatasan di mana simpul dapat ditetapkan ke kumpulan. Mengaktifkan nilai ini dapat mengurangi kemungkinan jumlah simpul yang diminta untuk dialokasikan di kumpulan. Jika tidak ditentukan, nilai ini default ke 'Dinonaktifkan'.

IPAddressProvisioningType

Jenis provisi untuk Alamat IP Publik untuk Kumpulan Batch.

LinuxUserConfiguration

Properti yang digunakan untuk membuat akun pengguna pada simpul Linux.

LoginMode

Menentukan mode masuk untuk pengguna. Nilai defaultnya adalah Interaktif.

ManagedDisk
MetadataItem

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

MountConfiguration

Sistem file yang akan 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 batch.

NodePlacementPolicyType

Nilai defaultnya adalah regional.

OSDisk

Pengaturan untuk disk sistem operasi komputer virtual.

Pool

Berisi informasi tentang kumpulan.

PoolEndpointConfiguration

Konfigurasi titik akhir untuk kumpulan.

PoolIdentityType

Jenis identitas yang digunakan untuk Kumpulan Batch.

PoolProvisioningState

Status kumpulan saat ini.

PublicIPAddressConfiguration

Konfigurasi Alamat IP publik dari konfigurasi jaringan Kumpulan.

ResizeError

Kesalahan yang terjadi saat mengubah ukuran kumpulan.

ResizeOperationStatus

Detail tentang operasi mengubah ukuran saat ini atau terakhir selesai.

ResourceFile

Satu file atau beberapa file yang akan diunduh ke simpul komputasi.

RollingUpgradePolicy

Parameter konfigurasi yang digunakan saat melakukan peningkatan bergulir.

ScaleSettings

Pengaturan skala untuk kumpulan

SecurityEncryptionTypes

Menentukan EncryptionType dari disk terkelola. Ini diatur ke VMGuestStateOnly untuk enkripsi hanya blob VMGuestState, dan NonPersistedTPM untuk tidak mempertahankan status firmware di blob VMGuestState. Catatan: Ini hanya dapat diatur untuk VM Rahasia dan diperlukan saat menggunakan VM Rahasia.

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

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

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.

UpgradeMode

Menentukan mode peningkatan ke komputer virtual dalam set skala.

Nilai yang mungkin adalah:

Manual - Anda mengontrol aplikasi pembaruan ke komputer virtual dalam set skala. Anda melakukan ini dengan menggunakan tindakan manualUpgrade.

Otomatis - Semua komputer virtual dalam set skala secara otomatis diperbarui secara bersamaan.

Rolling - Set skala melakukan pembaruan dalam batch dengan waktu jeda opsional di antaranya.

UpgradePolicy

Menjelaskan kebijakan peningkatan - otomatis, manual, atau bergulir.

UserAccount

Properti yang digunakan untuk membuat pengguna pada simpul Azure Batch.

UserAssignedIdentities

Daftar identitas pengguna terkait.

UserIdentity

Definisi identitas pengguna tempat tugas dijalankan.

VirtualMachineConfiguration

Konfigurasi untuk simpul komputasi dalam kumpulan berdasarkan infrastruktur Azure Virtual Machines.

VMDiskSecurityProfile

Menentukan pengaturan profil keamanan untuk disk terkelola. Catatan: Ini hanya dapat diatur untuk VM Rahasia dan diperlukan saat menggunakan VM Rahasia.

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

AllocationState

Apakah kumpulan mengubah ukuran.

Nilai Deskripsi
Steady

Kumpulan tidak mengubah ukuran. Tidak ada perubahan pada jumlah simpul dalam kumpulan yang sedang berlangsung. Kumpulan memasuki status ini ketika dibuat dan ketika tidak ada operasi yang dilakukan pada kumpulan untuk mengubah jumlah simpul.

Resizing

Kumpulan mengubah ukuran; artinya, simpul komputasi sedang ditambahkan atau dihapus dari kumpulan.

Stopping

Kumpulan mengubah ukuran, tetapi pengguna telah meminta agar perubahan ukuran dihentikan, tetapi permintaan berhenti belum selesai.

ApplicationPackageReference

Menautkan ke paket aplikasi di dalam akun batch

Nama Jenis Deskripsi
id

string

ID paket aplikasi yang akan diinstal. Ini harus berada di dalam akun batch yang sama dengan kumpulan. Ini dapat menjadi referensi ke versi tertentu atau versi default jika ada.

version

string

Versi aplikasi yang akan disebarkan. Jika dihilangkan, versi default disebarkan.
Jika ini dihilangkan, dan tidak ada versi default yang ditentukan untuk aplikasi ini, permintaan gagal dengan kode kesalahan InvalidApplicationPackageReferences. Jika Anda memanggil REST API secara langsung, kode status HTTP adalah 409.

AutomaticOSUpgradePolicy

Parameter konfigurasi yang digunakan untuk melakukan peningkatan OS otomatis.

Nama Jenis Deskripsi
disableAutomaticRollback

boolean

Apakah fitur putar kembali gambar OS harus dinonaktifkan.

enableAutomaticOSUpgrade

boolean

Menunjukkan apakah peningkatan OS harus secara otomatis diterapkan ke instans set skala secara bergulir saat versi gambar OS yang lebih baru tersedia.

Jika ini diatur ke true untuk kumpulan berbasis Windows, WindowsConfiguration.enableAutomaticUpdates tidak dapat diatur ke true.

osRollingUpgradeDeferral

boolean

Tangguhkan peningkatan OS di TVM jika mereka menjalankan tugas.

useRollingUpgradePolicy

boolean

Menunjukkan apakah kebijakan peningkatan bergulir harus digunakan selama Peningkatan OS Otomatis. Peningkatan OS Otomatis akan kembali ke kebijakan default jika tidak ada kebijakan yang ditentukan pada VMSS.

AutoScaleRun

Hasil dan kesalahan dari eksekusi rumus skala otomatis kumpulan.

Nama Jenis Deskripsi
error

AutoScaleRunError

Detail kesalahan yang ditemui mengevaluasi rumus skala otomatis pada kumpulan, jika evaluasi tidak berhasil.
Kesalahan yang terjadi saat menskalakan kumpulan secara otomatis.

evaluationTime

string (date-time)

Waktu di mana rumus skala otomatis terakhir dievaluasi.

results

string

Nilai akhir dari semua variabel yang digunakan dalam evaluasi rumus skala otomatis.
Setiap nilai variabel dikembalikan dalam formulir $variable=value, dan variabel dipisahkan oleh titik koma.

AutoScaleRunError

Kesalahan yang terjadi saat menskalakan kumpulan secara otomatis.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.

details

AutoScaleRunError[]

Detail tambahan tentang kesalahan.

message

string

Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

AutoScaleSettings

Pengaturan Skala Otomatis untuk kumpulan.

Nama Jenis Deskripsi
evaluationInterval

string (duration)

Interval waktu untuk menyesuaikan ukuran kumpulan secara otomatis sesuai dengan rumus skala otomatis.
Jika dihilangkan, nilai defaultnya adalah 15 menit (PT15M).

formula

string

Rumus untuk jumlah simpul komputasi yang diinginkan dalam kumpulan.

AutoUserScope

Nilai defaultnya adalah Kumpulan. Jika kumpulan menjalankan Windows, nilai Tugas harus ditentukan jika isolasi yang lebih ketat antar tugas diperlukan. Misalnya, jika tugas memutasi registri dengan cara yang dapat memengaruhi tugas lain, atau jika sertifikat telah ditentukan pada kumpulan yang seharusnya tidak dapat diakses oleh tugas normal tetapi harus dapat diakses dengan memulai tugas.

Nilai Deskripsi
Task

Menentukan bahwa layanan harus membuat pengguna baru untuk tugas tersebut.

Pool

Menentukan bahwa tugas berjalan sebagai akun pengguna otomatis umum yang dibuat pada setiap simpul dalam kumpulan.

AutoUserSpecification

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

Nama Jenis Deskripsi
elevationLevel

ElevationLevel

Tingkat elevasi pengguna.
Nilai defaultnya adalah nonAdmin.

scope

AutoUserScope

Cakupan untuk pengguna otomatis
Nilai defaultnya adalah Kumpulan. Jika kumpulan menjalankan Windows, nilai Tugas harus ditentukan jika isolasi yang lebih ketat antar tugas diperlukan. Misalnya, jika tugas memutasi registri dengan cara yang dapat memengaruhi tugas lain, atau jika sertifikat telah ditentukan pada kumpulan yang seharusnya tidak dapat diakses oleh tugas normal tetapi harus dapat diakses dengan memulai tugas.

AzureBlobFileSystemConfiguration

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

Nama Jenis Deskripsi
accountKey

string (password)

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 (password)

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 (password)

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.

BatchPoolIdentity

Identitas kumpulan Batch, jika dikonfigurasi. Jika identitas kumpulan diperbarui selama memperbarui kumpulan yang ada, hanya vm baru yang dibuat setelah kumpulan menyusut ke 0 yang akan memiliki identitas yang diperbarui

Nama Jenis Deskripsi
type

PoolIdentityType

Jenis identitas yang digunakan untuk Kumpulan Batch.

userAssignedIdentities

<string,  UserAssignedIdentities>

Daftar identitas pengguna yang terkait dengan kumpulan Batch.

CachingType

Jenis penembolokan yang akan diaktifkan untuk disk.

Nilai Deskripsi
None

Mode penembolokan untuk disk tidak diaktifkan.

ReadOnly

Mode penembolokan untuk disk hanya dibaca.

ReadWrite

Mode penembolokan untuk disk dibaca dan ditulis.

CertificateReference

Referensi ke sertifikat yang akan diinstal pada simpul komputasi dalam kumpulan. Ini harus ada di dalam akun yang sama dengan kumpulan.

Nama Jenis Deskripsi
id

string

ID sertifikat yang sepenuhnya memenuhi syarat untuk diinstal pada kumpulan. Ini harus berada di dalam akun batch yang sama dengan kumpulan.

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

visibility

CertificateVisibility[]

Akun pengguna mana pada simpul komputasi yang harus memiliki akses ke data privat sertifikat.

CertificateStoreLocation

Nilai defaultnya adalah currentUser. Properti ini hanya berlaku untuk kumpulan yang dikonfigurasi dengan simpul komputasi 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.

Nilai Deskripsi
CurrentUser

Sertifikat harus diinstal ke penyimpanan sertifikat CurrentUser.

LocalMachine

Sertifikat harus diinstal ke penyimpanan sertifikat LocalMachine.

CertificateVisibility

Nilai Deskripsi
StartTask

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

Task

Sertifikat harus terlihat oleh akun pengguna di mana tugas pekerjaan dijalankan.

RemoteUser

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

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 (password)

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.

CloudError

Respons kesalahan dari layanan Batch.

Nama Jenis Deskripsi
error

CloudErrorBody

Isi respons kesalahan.

CloudErrorBody

Respons kesalahan dari layanan Batch.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.

details

CloudErrorBody[]

Daftar detail tambahan tentang kesalahan.

message

string

Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

target

string

Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

ComputeNodeDeallocationOption

Menentukan apa yang harus dilakukan dengan simpul dan tugas yang sedang berjalan setelah dipilih untuk pembatalan alokasi.

Nilai Deskripsi
Requeue

Hentikan proses tugas yang sedang berjalan dan antre kembali tugas. Tugas akan berjalan lagi ketika simpul tersedia. Hapus simpul segera setelah tugas dihentikan.

Terminate

Hentikan tugas yang sedang berjalan. Tugas akan diselesaikan dengan failureInfo yang menunjukkan bahwa mereka dihentikan, dan tidak akan berjalan lagi. Hapus simpul segera setelah tugas dihentikan.

TaskCompletion

Perbolehkan tugas yang sedang berjalan selesai. Jadwalkan tidak ada tugas baru saat menunggu. Hapus simpul ketika semua tugas telah selesai.

RetainedData

Tidak digunakan lagi, kami menyarankan Anda untuk mengunggah data tugas ke Azure Storage dalam tugas Anda dan menggunakannya TaskCompletion sebagai gantinya. Izinkan tugas yang sedang berjalan selesai, lalu tunggu semua periode retensi data tugas kedaluwarsa. Jadwalkan tidak ada tugas baru saat menunggu. Hapus simpul ketika semua periode retensi tugas telah kedaluwarsa.

ComputeNodeFillType

Bagaimana tugas harus didistribusikan di seluruh simpul komputasi.

Nilai Deskripsi
Spread

Tugas harus ditetapkan secara merata di semua simpul di kumpulan.

Pack

Tugas sebanyak mungkin (taskSlotsPerNode) harus ditetapkan ke setiap simpul di kumpulan sebelum tugas apa pun ditetapkan ke simpul berikutnya 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 diaktifkan 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.

ContainerHostBatchBindMountEntry

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

Nama Jenis Deskripsi
isReadOnly

boolean

Pasang jalur sumber ini sebagai mode baca-saja atau tidak. Nilai defaultnya adalah false (mode baca/tulis).
Untuk Linux, jika Anda memasang jalur ini sebagai mode baca/tulis, ini tidak berarti bahwa semua pengguna dalam kontainer memiliki akses baca/tulis untuk jalur, itu tergantung pada akses di VM host. Jika jalur ini dipasang baca-saja, semua pengguna dalam kontainer tidak akan dapat mengubah jalur.

source

ContainerHostDataPath

Jalur yang akan dipasang ke kontainer tugas kontainer.

ContainerHostDataPath

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.

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 (password)

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.

Nilai Deskripsi
DockerCompatible

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

CriCompatible

Teknologi berbasis CRI akan digunakan untuk meluncurkan kontainer.

ContainerWorkingDirectory

Bendera untuk menunjukkan di mana direktori kerja tugas kontainer berada. Defaultnya adalah 'taskWorkingDirectory'.

Nilai Deskripsi
TaskWorkingDirectory

Gunakan direktori kerja tugas layanan Batch standar, yang akan berisi file sumber daya Tugas yang diisi oleh Batch.

ContainerImageDefault

Menggunakan direktori kerja yang ditentukan gambar kontainer. Berhati-hatilah bahwa direktori ini tidak akan berisi file sumber daya yang diunduh oleh Batch.

createdByType

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
User
Application
ManagedIdentity
Key

DataDisk

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

Nama Jenis Deskripsi
caching

CachingType

Jenis penembolokan yang akan diaktifkan untuk disk.
Nilainya adalah:

none - Mode penembolokan untuk disk tidak diaktifkan. readOnly - Mode penembolokan untuk disk hanya dibaca. readWrite - Mode penembolokan untuk disk dibaca dan ditulis.

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 (int32)

Ukuran disk awal dalam GB saat membuat disk data baru.

lun

integer (int32)

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 untuk digunakan dalam membuat disk data atau disk OS.
Jika dihilangkan, defaultnya adalah "Standard_LRS". Nilainya adalah:

Standard_LRS - Disk data harus menggunakan penyimpanan standar yang berlebihan secara lokal. Premium_LRS - Disk data harus menggunakan penyimpanan redundan lokal premium.

DeploymentConfiguration

Properti konfigurasi penyebaran.

Nama Jenis Deskripsi
virtualMachineConfiguration

VirtualMachineConfiguration

Konfigurasi komputer virtual untuk kumpulan.
Konfigurasi untuk simpul komputasi dalam kumpulan berdasarkan infrastruktur Azure Virtual Machines.

DiffDiskPlacement

Lokasi di mana disk OS harus ditempatkan.

Nilai Deskripsi
CacheDisk

Disk OS akan ditempatkan pada disk cache VM.

DiffDiskSettings

Menentukan Pengaturan Disk ephemeral untuk disk sistem operasi yang digunakan oleh komputer virtual.

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 mana sistem operasi harus berada. misalnya, ruang disk cache untuk provisi disk OS Ephemeral. Untuk informasi selengkapnya tentang persyaratan ukuran disk OS Ephemeral, lihat persyaratan ukuran disk OS Ephemeral untuk VM Windows di VM https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements dan Linux pada https://learn.microsoft.com/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 Gambar Komputer Virtual atau Gambar Azure Compute Gallery.

Nama Jenis Deskripsi
targets

DiskEncryptionTarget[]

Daftar target disk Layanan Batch akan dienkripsi pada simpul komputasi
Pada kumpulan Linux, hanya "TemporaryDisk" yang didukung; pada kumpulan Windows, "OsDisk" dan "TemporaryDisk" harus ditentukan.

DiskEncryptionTarget

Jika dihilangkan, tidak ada disk pada simpul komputasi di kumpulan yang akan dienkripsi.

Nilai Deskripsi
OsDisk

Disk OS pada simpul komputasi dienkripsi.

TemporaryDisk

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 penetapan vnet dinamis.

Nilai Deskripsi
none

Tidak ada penetapan VNet dinamis yang diaktifkan.

job

Penugasan VNet dinamis dilakukan per pekerjaan. Jika nilai ini diatur, ID subnet konfigurasi jaringan juga harus diatur. Fitur ini memerlukan persetujuan sebelum digunakan, silakan hubungi dukungan

ElevationLevel

Tingkat elevasi pengguna.

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

Variabel lingkungan yang akan diatur pada proses tugas.

Nama Jenis Deskripsi
name

string

Nama variabel lingkungan.

value

string

Nilai variabel lingkungan.

FixedScaleSettings

Memperbaiki pengaturan skala untuk kumpulan.

Nama Jenis Nilai default Deskripsi
nodeDeallocationOption

ComputeNodeDeallocationOption

Menentukan apa yang harus dilakukan dengan simpul dan tugas yang sedang berjalan jika ukuran kumpulan menurun.
Jika dihilangkan, nilai defaultnya adalah Antrean Ulang.

resizeTimeout

string (duration)

PT15M

Batas waktu untuk alokasi simpul komputasi ke kumpulan.
Nilai defaultnya adalah 15 menit. Nilai batas waktu menggunakan format ISO 8601. Misalnya, gunakan PT10M selama 10 menit. Nilai minimum adalah 5 menit. Jika Anda menentukan nilai kurang dari 5 menit, layanan Batch menolak permintaan dengan kesalahan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

targetDedicatedNodes

integer (int32)

Jumlah simpul komputasi khusus yang diinginkan di kumpulan.
Setidaknya salah satu targetDedicatedNodes, targetLowPriorityNodes harus diatur.

targetLowPriorityNodes

integer (int32)

Jumlah simpul komputasi Spot/berprioritas rendah yang diinginkan di kumpulan.
Setidaknya salah satu targetDedicatedNodes, targetLowPriorityNodes harus diatur.

ImageReference

Referensi ke gambar Azure Virtual Machines Marketplace atau sumber daya Gambar Azure dari Komputer Virtual kustom. Untuk mendapatkan daftar semua imageReferences yang diverifikasi oleh Azure Batch, lihat operasi 'Daftar SKU agen simpul 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.

id

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}.
Properti ini saling eksklusif dengan properti lain. Gambar Azure Compute Gallery harus memiliki replika di wilayah yang sama dengan akun Azure Batch. Untuk informasi tentang pengaturan firewall untuk agen simpul Batch untuk berkomunikasi dengan layanan Batch, lihat https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

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 Azure Virtual Machines Marketplace.
Misalnya, 18.04-LTS atau 2022-datacenter.

version

string

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

InboundEndpointProtocol

Protokol titik akhir.

Nilai Deskripsi
TCP

Gunakan TCP untuk titik akhir.

UDP

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 (int32)

Nomor port pada simpul komputasi.
Ini harus unik dalam kumpulan Batch. Nilai yang dapat diterima adalah antara 1 dan 65535 kecuali untuk 29876 dan 29877 karena ini dicadangkan. Jika ada nilai cadangan yang disediakan, permintaan gagal dengan kode status HTTP 400.

frontendPortRangeEnd

integer (int32)

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. Jika ada nilai yang dicadangkan atau tumpang tindih disediakan, permintaan gagal dengan kode status HTTP 400.

frontendPortRangeStart

integer (int32)

Nomor port pertama 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. Semua rentang dalam kumpulan harus berbeda dan tidak dapat tumpang tindih. Jika ada nilai yang dicadangkan atau tumpang tindih 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.

InterNodeCommunicationState

Ini memberlakukan pembatasan di mana simpul dapat ditetapkan ke kumpulan. Mengaktifkan nilai ini dapat mengurangi kemungkinan jumlah simpul yang diminta untuk dialokasikan di kumpulan. Jika tidak ditentukan, nilai ini default ke 'Dinonaktifkan'.

Nilai Deskripsi
Enabled

Aktifkan komunikasi jaringan antar komputer virtual.

Disabled

Nonaktifkan komunikasi jaringan antara komputer virtual.

IPAddressProvisioningType

Jenis provisi untuk Alamat IP Publik untuk Kumpulan Batch.

Nilai Deskripsi
BatchManaged

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

UserManaged

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

NoPublicIPAddresses

Tidak ada Alamat IP publik yang akan dibuat untuk Simpul Komputasi di Kumpulan.

LinuxUserConfiguration

Properti yang digunakan untuk membuat akun pengguna pada simpul Linux.

Nama Jenis Deskripsi
gid

integer (int32)

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 (password)

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 di kumpulan Linux ketika properti enableInterNodeCommunication kumpulan benar (diabaikan jika enableInterNodeCommunication salah). Ini dilakukan dengan menempatkan pasangan kunci ke dalam direktori .ssh pengguna. Jika tidak ditentukan, SSH tanpa kata sandi tidak dikonfigurasi antara simpul (tidak ada modifikasi direktori .ssh pengguna yang dilakukan).

uid

integer (int32)

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

Menentukan mode masuk untuk pengguna. Nilai defaultnya adalah Interaktif.

Nilai Deskripsi
Batch

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

Interactive

Mode masuk LOGON32_LOGON_INTERACTIVE Win32. Beberapa aplikasi memerlukan izin yang terkait dengan mode masuk interaktif. Jika ini adalah kasus untuk aplikasi yang digunakan dalam tugas Anda, maka opsi ini disarankan.

ManagedDisk

Nama Jenis Deskripsi
securityProfile

VMDiskSecurityProfile

Menentukan profil keamanan untuk disk terkelola.
Menentukan pengaturan profil keamanan untuk disk terkelola. Catatan: Ini hanya dapat diatur untuk VM Rahasia dan diperlukan saat menggunakan VM Rahasia.

storageAccountType

StorageAccountType

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

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

Berbagi File Azure 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 Nilai default Deskripsi
dynamicVnetAssignmentScope

DynamicVNetAssignmentScope

none

Cakupan penetapan vnet dinamis.

enableAcceleratedNetworking

boolean

Apakah kumpulan ini harus mengaktifkan jaringan yang dipercepat.
Jaringan yang dipercepat 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 untuk kumpulan.

publicIPAddressConfiguration

PublicIPAddressConfiguration

Konfigurasi IpAddress Publik untuk Simpul Komputasi di Kumpulan Batch.
Konfigurasi Alamat IP publik dari konfigurasi jaringan Kumpulan.

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 di kumpulan. Jika subnet tidak memiliki alamat IP gratis yang cukup, kumpulan akan mengalokasikan sebagian simpul komputasi 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 memungkinkan komunikasi dari layanan Azure Batch untuk dapat menjadwalkan tugas pada simpul komputasi. Ini dapat diverifikasi dengan memeriksa apakah VNet yang ditentukan memiliki Kelompok Keamanan Jaringan (NSG) terkait. Jika komunikasi ke simpul komputasi dalam subnet yang ditentukan ditolak oleh NSG, maka layanan Batch akan mengatur status simpul komputasi menjadi tidak dapat digunakan. Jika VNet yang ditentukan memiliki Kelompok Keamanan Jaringan (NSG) terkait, maka beberapa port sistem yang dipesan harus diaktifkan untuk komunikasi masuk, termasuk port 29876 dan 29877. Aktifkan juga koneksi keluar ke Azure Storage pada port 443. Untuk detail selengkapnya lihat: https://learn.microsoft.com/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 (int32)

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 nomor urut 150 lebih diutamakan daripada aturan yang memiliki urutan 250. Prioritas yang diizinkan adalah 150 hingga 4096. Jika ada nilai cadangan 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 diberikan, 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) atau array port atau rentang port (yaitu 100-200). Port harus dalam kisaran 0 hingga 65535 dan rentang port atau port tidak dapat tumpang tindih. Jika ada nilai lain yang diberikan, permintaan gagal dengan kode status HTTP 400. Nilai defaultnya adalah *.

NetworkSecurityGroupRuleAccess

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

Nilai Deskripsi
Allow

Izinkan akses.

Deny

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.

Nilai Deskripsi
Default

Mode komunikasi simpul secara otomatis diatur oleh layanan Batch.

Classic

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

Simplified

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

Nama Jenis Deskripsi
policy

NodePlacementPolicyType

Kebijakan penempatan untuk mengalokasikan simpul di kumpulan.
Kebijakan alokasi yang digunakan oleh Layanan Batch untuk menyediakan simpul. Jika tidak ditentukan, Batch akan menggunakan kebijakan regional.

NodePlacementPolicyType

Nilai defaultnya adalah regional.

Nilai Deskripsi
Regional

Semua simpul di kumpulan akan dialokasikan di wilayah yang sama.

Zonal

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

OSDisk

Pengaturan untuk disk sistem operasi komputer virtual.

Nama Jenis Deskripsi
caching

CachingType

Jenis penembolokan yang akan diaktifkan untuk disk.

diskSizeGB

integer (int32)

Ukuran disk awal dalam GB saat membuat disk OS baru.

ephemeralOSDiskSettings

DiffDiskSettings

Menentukan Pengaturan Disk ephemeral untuk disk sistem operasi yang digunakan oleh komputer virtual.

managedDisk

ManagedDisk

Parameter disk terkelola.

writeAcceleratorEnabled

boolean

Menentukan apakah writeAccelerator harus diaktifkan atau dinonaktifkan pada disk.

Pool

Berisi informasi tentang kumpulan.

Nama Jenis Nilai default Deskripsi
etag

string

ETag sumber daya, digunakan untuk pernyataan konkurensi.

id

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

BatchPoolIdentity

Jenis identitas yang digunakan untuk Kumpulan Batch.

name

string

Nama sumber daya

properties.allocationState

AllocationState

Apakah kumpulan mengubah ukuran.

properties.allocationStateTransitionTime

string (date-time)

Waktu saat kumpulan memasuki status alokasinya saat ini.

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

properties.applicationPackages

ApplicationPackageReference[]

Daftar paket aplikasi yang akan diinstal pada setiap simpul komputasi di kumpulan.
Perubahan pada referensi paket aplikasi memengaruhi semua simpul komputasi baru yang bergabung dengan kumpulan, tetapi tidak memengaruhi simpul komputasi yang sudah ada di kumpulan hingga di-boot ulang atau digambut ulang. Ada maksimum 10 referensi paket aplikasi pada kumpulan tertentu.

properties.autoScaleRun

AutoScaleRun

Hasil dan kesalahan dari eksekusi terakhir rumus skala otomatis.
Properti ini diatur hanya jika kumpulan secara otomatis diskalakan, yaitu autoScaleSettings digunakan.

properties.certificates

CertificateReference[]

Daftar sertifikat yang akan diinstal pada setiap simpul komputasi di kumpulan.
Untuk simpul komputasi 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 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.

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

properties.creationTime

string (date-time)

Waktu pembuatan kumpulan.

properties.currentDedicatedNodes

integer (int32)

Jumlah simpul komputasi khusus yang saat ini ada di kumpulan.

properties.currentLowPriorityNodes

integer (int32)

Jumlah simpul komputasi Spot/berprioritas rendah yang saat ini berada di kumpulan.

properties.currentNodeCommunicationMode

NodeCommunicationMode

Menentukan bagaimana kumpulan berkomunikasi dengan layanan Batch.

properties.deploymentConfiguration

DeploymentConfiguration

Properti ini menjelaskan komputer virtual tempat simpul kumpulan akan disebarkan.
Properti konfigurasi penyebaran.

properties.displayName

string

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

properties.interNodeCommunication

InterNodeCommunicationState

Apakah kumpulan mengizinkan komunikasi langsung antar simpul.
Ini memberlakukan pembatasan di mana simpul dapat ditetapkan ke kumpulan. Mengaktifkan nilai ini dapat mengurangi kemungkinan jumlah simpul yang diminta untuk dialokasikan di kumpulan. Jika tidak ditentukan, nilai ini default ke 'Dinonaktifkan'.

properties.lastModified

string (date-time)

Waktu terakhir yang dimodifikasi dari kumpulan.
Ini adalah terakhir kalinya data tingkat kumpulan, seperti targetDedicatedNodes atau autoScaleSettings, diubah. Ini tidak memperhitungkan perubahan tingkat simpul seperti status perubahan simpul komputasi.

properties.metadata

MetadataItem[]

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

properties.mountConfiguration

MountConfiguration[]

Daftar sistem file yang akan dipasang pada setiap simpul di kumpulan.
Ini mendukung Azure Files, NFS, CIFS/SMB, dan Blobfuse.

properties.networkConfiguration

NetworkConfiguration

Konfigurasi jaringan untuk kumpulan.
Konfigurasi jaringan untuk kumpulan.

properties.provisioningState

PoolProvisioningState

Status kumpulan saat ini.

properties.provisioningStateTransitionTime

string (date-time)

Waktu saat kumpulan memasuki statusnya saat ini.

properties.resizeOperationStatus

ResizeOperationStatus

Berisi detail tentang operasi mengubah ukuran saat ini atau terakhir selesai.
Menjelaskan operasi saat ini (jika AllocationState kumpulan mengubah ukuran) atau operasi yang diselesaikan sebelumnya (jika AllocationState Stabil).

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

properties.scaleSettings

ScaleSettings

Pengaturan yang mengonfigurasi jumlah simpul dalam kumpulan.
Menentukan ukuran kumpulan yang diinginkan. Ini bisa berupa 'fixedScale' di mana targetDedicatedNodes yang diminta ditentukan, atau 'autoScale' yang menentukan rumus yang dievaluasi ulang secara berkala. Jika properti ini tidak ditentukan, kumpulan akan memiliki skala tetap dengan 0 targetDedicatedNodes.

properties.startTask

StartTask

Tugas yang ditentukan untuk dijalankan pada setiap simpul komputasi saat menggabungkan kumpulan.
Dalam operasi PATCH (pembaruan), properti ini dapat diatur ke objek kosong untuk menghapus tugas mulai dari kumpulan.

properties.targetNodeCommunicationMode

NodeCommunicationMode

Menentukan bagaimana kumpulan berkomunikasi dengan layanan Batch.
Jika dihilangkan, nilai defaultnya adalah Default.

properties.taskSchedulingPolicy

TaskSchedulingPolicy

Bagaimana tugas didistribusikan di seluruh simpul komputasi dalam kumpulan.
Jika tidak ditentukan, defaultnya adalah spread.

properties.taskSlotsPerNode

integer (int32)

1

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

properties.upgradePolicy

UpgradePolicy

Kebijakan peningkatan untuk kumpulan.
Menjelaskan kebijakan peningkatan - otomatis, manual, atau bergulir.

properties.userAccounts

UserAccount[]

Daftar akun pengguna yang akan dibuat pada setiap simpul di kumpulan.

properties.vmSize

string

Ukuran komputer virtual di kumpulan. Semua VM dalam kumpulan berukuran sama.
Untuk informasi tentang ukuran VM yang tersedia, lihat Ukuran untuk Komputer Virtual di Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). Batch mendukung semua ukuran Azure VM kecuali STANDARD_A0 dan yang memiliki penyimpanan premium (STANDARD_GS, STANDARD_DS, dan seri STANDARD_DSV2).

systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

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.

PoolIdentityType

Jenis identitas yang digunakan untuk Kumpulan Batch.

Nilai Deskripsi
UserAssigned

Kumpulan Batch memiliki identitas yang ditetapkan pengguna dengannya.

None

Kumpulan Batch tidak memiliki identitas yang terkait dengannya. Pengaturan None di kumpulan pembaruan akan menghapus identitas yang ada.

PoolProvisioningState

Status kumpulan saat ini.

Nilai Deskripsi
Succeeded

Kumpulan tersedia untuk menjalankan tugas tergantung pada ketersediaan simpul komputasi.

Deleting

Pengguna telah meminta agar kumpulan dihapus, tetapi operasi penghapusan belum selesai.

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 node Spot/berprioritas 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 adalah dari formulir: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

IPAddressProvisioningType

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

ResizeError

Kesalahan yang terjadi saat mengubah ukuran kumpulan.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.

details

ResizeError[]

Detail tambahan tentang kesalahan.

message

string

Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

ResizeOperationStatus

Detail tentang operasi mengubah ukuran saat ini atau terakhir selesai.

Nama Jenis Deskripsi
errors

ResizeError[]

Detail kesalahan apa pun yang ditemui saat melakukan perubahan ukuran terakhir pada kumpulan.
Properti ini diatur hanya jika terjadi kesalahan selama pengubahan ukuran kumpulan terakhir, dan hanya ketika alokasi kumpulanState Stabil.

nodeDeallocationOption

ComputeNodeDeallocationOption

Menentukan apa yang harus dilakukan dengan simpul dan tugas yang sedang berjalan setelah dipilih untuk pembatalan alokasi.
Nilai defaultnya adalah antrean ulang.

resizeTimeout

string (duration)

Batas waktu untuk alokasi simpul komputasi ke kumpulan atau penghapusan simpul komputasi dari kumpulan.
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).

startTime

string (date-time)

Waktu ketika operasi pengubahan ukuran ini dimulai.

targetDedicatedNodes

integer (int32)

Jumlah simpul komputasi khusus yang diinginkan di kumpulan.

targetLowPriorityNodes

integer (int32)

Jumlah simpul komputasi Spot/berprioritas rendah yang diinginkan di kumpulan.

ResourceFile

Satu file atau beberapa file yang akan diunduh ke simpul komputasi.

Nama Jenis Deskripsi
autoStorageContainerName

string

Nama kontainer penyimpanan di akun penyimpanan otomatis.
Properti autoStorageContainerName, storageContainerUrl, dan httpUrl saling eksklusif dan salah satunya harus ditentukan.

blobPrefix

string

Awalan blob yang akan digunakan saat mengunduh blob dari kontainer Azure Storage. Hanya blob yang namanya dimulai dengan awalan yang ditentukan yang akan diunduh.
Properti hanya valid ketika autoStorageContainerName atau storageContainerUrl digunakan. Awalan ini bisa berupa nama file parsial atau subdirektori. Jika awalan tidak ditentukan, semua file dalam kontainer akan diunduh.

fileMode

string

Atribut mode izin file dalam format oktal.
Properti ini hanya berlaku untuk file yang diunduh ke simpul komputasi Linux. Ini akan diabaikan jika ditentukan untuk resourceFile yang akan diunduh ke simpul Windows. Jika properti ini tidak ditentukan untuk simpul Linux, maka nilai default 0770 diterapkan ke file.

filePath

string

Lokasi pada simpul komputasi untuk mengunduh file, relatif terhadap direktori kerja tugas.
Jika properti httpUrl ditentukan, filePath diperlukan dan menjelaskan jalur tempat file akan diunduh, termasuk nama file. Jika tidak, jika properti autoStorageContainerName atau storageContainerUrl ditentukan, filePath bersifat opsional dan merupakan direktori untuk mengunduh file. Dalam kasus di mana filePath digunakan sebagai direktori, struktur direktori apa pun yang sudah terkait dengan data input akan disimpan secara penuh dan ditambahkan ke direktori filePath yang ditentukan. Jalur relatif yang ditentukan tidak dapat keluar dari direktori kerja tugas (misalnya dengan menggunakan '..').

httpUrl

string

URL file yang akan diunduh.
Properti autoStorageContainerName, storageContainerUrl, dan httpUrl saling eksklusif dan salah satunya harus ditentukan. Jika URL menunjuk ke Azure Blob Storage, URL harus dapat dibaca dari simpul komputasi. Ada tiga cara untuk mendapatkan URL tersebut untuk blob di penyimpanan Azure: menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin baca pada blob, menggunakan identitas terkelola dengan izin baca, atau atur ACL untuk blob atau kontainernya untuk memungkinkan akses publik.

identityReference

ComputeNodeIdentityReference

Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Blob Storage yang ditentukan oleh storageContainerUrl atau httpUrl
Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.

storageContainerUrl

string

URL kontainer blob dalam Azure Blob Storage.
Properti autoStorageContainerName, storageContainerUrl, dan httpUrl saling eksklusif dan salah satunya harus ditentukan. URL ini harus dapat dibaca dan dapat dicantumkan dari simpul komputasi. Ada tiga cara untuk mendapatkan URL tersebut untuk kontainer di penyimpanan Azure: menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin baca dan daftar pada kontainer, menggunakan identitas terkelola dengan izin baca dan daftar, atau atur ACL untuk kontainer untuk mengizinkan akses publik.

RollingUpgradePolicy

Parameter konfigurasi yang digunakan saat melakukan peningkatan bergulir.

Nama Jenis Deskripsi
enableCrossZoneUpgrade

boolean

Izinkan VMSS untuk mengabaikan batas AZ saat membuat batch peningkatan. Pertimbangkan Domain Pembaruan dan maxBatchInstancePercent untuk menentukan ukuran batch. Jika bidang ini tidak diatur, Azure Azure Batch tidak akan mengatur nilai defaultnya. Nilai enableCrossZoneUpgrade pada VirtualMachineScaleSet yang dibuat akan diputuskan oleh konfigurasi default pada VirtualMachineScaleSet. Bidang ini dapat diatur ke true atau false hanya saat menggunakan NodePlacementConfiguration sebagai Zonal.

maxBatchInstancePercent

integer (int32)

minimum: 5
maximum: 100

Persentase maksimum dari total instans komputer virtual yang akan ditingkatkan secara bersamaan dengan peningkatan bergulir dalam satu batch. Karena ini adalah instans maksimum yang tidak sehat dalam batch sebelumnya atau di masa mendatang dapat menyebabkan persentase instans dalam batch berkurang untuk memastikan keandalan yang lebih tinggi. Nilai bidang ini harus antara 5 dan 100, inklusif. Jika maxBatchInstancePercent dan maxUnhealthyInstancePercent ditetapkan dengan nilai, nilai maxBatchInstancePercent tidak boleh lebih dari maxUnhealthyInstancePercent.

maxUnhealthyInstancePercent

integer (int32)

minimum: 5
maximum: 100

Persentase maksimum dari total instans komputer virtual dalam set skala yang dapat secara bersamaan tidak sehat, baik sebagai akibat dari peningkatan, atau dengan ditemukan dalam keadaan tidak sehat oleh pemeriksaan kesehatan komputer virtual sebelum peningkatan bergulir dibatalkan. Batasan ini akan diperiksa sebelum memulai batch apa pun. Nilai bidang ini harus antara 5 dan 100, inklusif. Jika maxBatchInstancePercent dan maxUnhealthyInstancePercent ditetapkan dengan nilai, nilai maxBatchInstancePercent tidak boleh lebih dari maxUnhealthyInstancePercent.

maxUnhealthyUpgradedInstancePercent

integer (int32)

minimum: 0
maximum: 100

Persentase maksimum instans komputer virtual yang ditingkatkan yang dapat ditemukan dalam keadaan tidak sehat. Pemeriksaan ini akan terjadi setelah setiap batch ditingkatkan. Jika persentase ini pernah terlampaui, pembaruan bergulir akan dibatalkan. Nilai bidang ini harus antara 0 dan 100, inklusif.

pauseTimeBetweenBatches

string

Waktu tunggu antara menyelesaikan pembaruan untuk semua komputer virtual dalam satu batch dan memulai batch berikutnya. Durasi waktu harus ditentukan dalam format ISO 8601.

prioritizeUnhealthyInstances

boolean

Tingkatkan semua instans yang tidak sehat dalam set skala sebelum instans sehat apa pun.

rollbackFailedInstancesOnPolicyBreach

boolean

Pembatalan instans gagal ke model sebelumnya jika kebijakan Peningkatan Bergulir dilanggar.

ScaleSettings

Pengaturan skala untuk kumpulan

Nama Jenis Deskripsi
autoScale

AutoScaleSettings

Pengaturan Skala Otomatis untuk kumpulan.
Properti dan fixedScale ini saling eksklusif dan salah satu properti harus ditentukan.

fixedScale

FixedScaleSettings

Memperbaiki pengaturan skala untuk kumpulan.
Properti dan skala otomatis ini saling eksklusif dan salah satu properti harus ditentukan.

SecurityEncryptionTypes

Menentukan EncryptionType dari disk terkelola. Ini diatur ke VMGuestStateOnly untuk enkripsi hanya blob VMGuestState, dan NonPersistedTPM untuk tidak mempertahankan status firmware di blob VMGuestState. Catatan: Ini hanya dapat diatur untuk VM Rahasia dan diperlukan saat menggunakan VM Rahasia.

Nilai Deskripsi
NonPersistedTPM
VMGuestStateOnly

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.

SecurityTypes

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

Nilai Deskripsi
trustedLaunch

Peluncuran tepercaya melindungi dari teknik serangan tingkat lanjut dan persisten.

confidentialVM

Komputasi rahasia Azure menawarkan VM rahasia adalah untuk penyewa dengan persyaratan keamanan dan kerahasiaan tinggi. VM ini menyediakan batas yang kuat dan diberlakukan perangkat keras untuk membantu memenuhi kebutuhan keamanan Anda. Anda dapat menggunakan VM rahasia untuk migrasi tanpa membuat perubahan pada kode Anda, dengan platform yang melindungi status VM Anda agar tidak dibaca atau dimodifikasi.

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 komputasi bergabung dengan kumpulan di layanan Azure Batch, atau saat simpul komputasi di-boot ulang atau digambut ulang.

Nama Jenis Nilai default Deskripsi
commandLine

string

Baris perintah tugas mulai.
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. Diperlukan jika ada properti lain dari startTask yang ditentukan.

containerSettings

TaskContainerSettings

Pengaturan untuk kontainer tempat tugas mulai 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.

environmentSettings

EnvironmentSetting[]

Daftar pengaturan variabel lingkungan untuk tugas mulai.

maxTaskRetryCount

integer (int32)

0

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 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. Defaultnya adalah 0

resourceFiles

ResourceFile[]

Daftar file yang akan diunduh layanan Batch ke simpul komputasi sebelum menjalankan baris perintah.

userIdentity

UserIdentity

Identitas pengguna tempat tugas mulai berjalan.
Jika dihilangkan, tugas berjalan sebagai pengguna non-administratif yang unik untuk tugas tersebut.

waitForSuccess

boolean

Apakah layanan Batch harus menunggu tugas mulai berhasil diselesaikan (yaitu, untuk keluar dengan kode keluar 0) sebelum menjadwalkan tugas apa pun pada simpul komputasi.
Jika true dan tugas mulai gagal pada simpul komputasi, layanan Batch mencoba kembali tugas mulai hingga jumlah percobaan kembali maksimumnya (maxTaskRetryCount). Jika tugas masih belum berhasil diselesaikan setelah semua percobaan ulang, maka layanan Batch menandai simpul komputasi tidak dapat digunakan, dan tidak akan menjadwalkan tugas ke simpul tersebut. Kondisi ini dapat dideteksi melalui status simpul dan detail kesalahan penjadwalan. Jika false, layanan Batch tidak akan menunggu tugas mulai selesai. Dalam hal ini, tugas lain dapat mulai dijalankan pada simpul komputasi saat tugas mulai masih berjalan; dan bahkan jika tugas mulai gagal, tugas baru akan terus dijadwalkan pada simpul. Defaultnya adalah true.

StorageAccountType

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

Nilai Deskripsi
Standard_LRS

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

Premium_LRS

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

StandardSSD_LRS

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

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string (date-time)

Stempel waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.

TaskContainerSettings

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 digunakan untuk membuat kontainer tempat tugas akan dijalankan.
Ini adalah referensi gambar lengkap, seperti yang akan ditentukan untuk "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 pada pembuatan kumpulan.

workingDirectory

ContainerWorkingDirectory

Bendera untuk menunjukkan di mana direktori kerja tugas kontainer berada. Defaultnya adalah 'taskWorkingDirectory'.

TaskSchedulingPolicy

Menentukan bagaimana tugas harus didistribusikan di seluruh simpul komputasi.

Nama Jenis Nilai default Deskripsi
nodeFillType

ComputeNodeFillType

Spread

Bagaimana tugas harus didistribusikan di seluruh simpul komputasi.

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.

UpgradeMode

Menentukan mode peningkatan ke komputer virtual dalam set skala.

Nilai yang mungkin adalah:

Manual - Anda mengontrol aplikasi pembaruan ke komputer virtual dalam set skala. Anda melakukan ini dengan menggunakan tindakan manualUpgrade.

Otomatis - Semua komputer virtual dalam set skala secara otomatis diperbarui secara bersamaan.

Rolling - Set skala melakukan pembaruan dalam batch dengan waktu jeda opsional di antaranya.

Nilai Deskripsi
automatic

Semua komputer virtual dalam set skala secara otomatis diperbarui secara bersamaan.

manual

Anda mengontrol aplikasi pembaruan ke komputer virtual dalam set skala. Anda melakukan ini dengan menggunakan tindakan manualUpgrade.

rolling

Instans yang ada dalam set skala diturunkan dalam batch yang akan ditingkatkan. Setelah batch yang ditingkatkan selesai, instans akan mulai mengambil lalu lintas lagi dan batch berikutnya akan dimulai. Ini berlanjut sampai semua instans membawa up-to-date.

UpgradePolicy

Menjelaskan kebijakan peningkatan - otomatis, manual, atau bergulir.

Nama Jenis Deskripsi
automaticOSUpgradePolicy

AutomaticOSUpgradePolicy

Parameter konfigurasi yang digunakan untuk melakukan peningkatan OS otomatis.

mode

UpgradeMode

Menentukan mode peningkatan ke komputer virtual dalam set skala.

Nilai yang mungkin adalah:

Manual - Anda mengontrol aplikasi pembaruan ke komputer virtual dalam set skala. Anda melakukan ini dengan menggunakan tindakan manualUpgrade.

Otomatis - Semua komputer virtual dalam set skala secara otomatis diperbarui secara bersamaan.

Rolling - Set skala melakukan pembaruan dalam batch dengan waktu jeda opsional di antaranya.

rollingUpgradePolicy

RollingUpgradePolicy

Parameter konfigurasi yang digunakan saat melakukan peningkatan bergulir.

UserAccount

Properti yang digunakan untuk membuat pengguna pada simpul Azure Batch.

Nama Jenis Deskripsi
elevationLevel

ElevationLevel

Tingkat elevasi pengguna.
nonAdmin - Pengguna otomatis adalah pengguna standar tanpa akses yang ditingkatkan. admin - Pengguna otomatis adalah pengguna dengan akses yang ditinggikan dan beroperasi dengan izin Administrator penuh. 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 (password)

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.

UserAssignedIdentities

Daftar identitas pengguna terkait.

Nama Jenis Deskripsi
clientId

string

Id klien identitas yang ditetapkan pengguna.

principalId

string

Id utama identitas yang ditetapkan pengguna.

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, penyiapan dilakukan pada setiap simpul di kumpulan untuk memungkinkan tugas dijalankan 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 terpasang pada simpul komputasi di kumpulan.
Properti ini harus ditentukan jika simpul komputasi di kumpulan harus memiliki disk data kosong yang melekat padanya.

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 Gambar Marketplace Azure Virtual Machines atau Gambar Komputer Virtual kustom untuk digunakan.
Referensi ke gambar Azure Virtual Machines Marketplace atau sumber daya Gambar Azure dari Komputer Virtual kustom. Untuk mendapatkan daftar semua imageReferences yang diverifikasi oleh Azure Batch, lihat operasi 'Daftar SKU agen simpul yang didukung'.

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 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 Batch yang akan disediakan pada simpul komputasi di kumpulan.
Agen simpul Batch adalah program yang berjalan pada setiap simpul di kumpulan, dan menyediakan antarmuka perintah dan kontrol antara simpul dan layanan Batch. Ada berbagai implementasi agen node, yang dikenal sebagai SKU, untuk sistem operasi yang berbeda. Anda harus menentukan SKU agen simpul yang cocok dengan referensi gambar yang dipilih. Untuk mendapatkan daftar SKU agen simpul yang didukung bersama dengan daftar referensi gambar terverifikasi mereka, lihat operasi 'Daftar SKU agen simpul yang didukung'.

nodePlacementConfiguration

NodePlacementConfiguration

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

osDisk

OSDisk

Pengaturan untuk disk sistem operasi Komputer Virtual.
Berisi konfigurasi untuk pengaturan OSDisk ephemeral.

securityProfile

SecurityProfile

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 imageReference menentukan gambar OS Linux.

VMDiskSecurityProfile

Menentukan pengaturan profil keamanan untuk disk terkelola. Catatan: Ini hanya dapat diatur untuk VM Rahasia dan diperlukan saat menggunakan VM Rahasia.

Nama Jenis Deskripsi
securityEncryptionType

SecurityEncryptionTypes

Menentukan EncryptionType dari disk terkelola. Ini diatur ke VMGuestStateOnly untuk enkripsi hanya blob VMGuestState, dan NonPersistedTPM untuk tidak mempertahankan status firmware di blob VMGuestState. Catatan: Ini hanya dapat diatur untuk VM Rahasia dan diperlukan saat menggunakan VM Rahasia.

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. Namun, setelah disebarkan, ekstensi tidak akan meningkatkan versi minor kecuali disebarkan ulang, bahkan dengan 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

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

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

Nama Jenis Deskripsi
loginMode

LoginMode

Mode masuk untuk pengguna
Menentukan mode masuk untuk pengguna. Nilai defaultnya adalah Interaktif.