Pools - Create Pool

Usługa:: Batch Service

Wersja interfejsu API:: 2025-06-01

Tworzy pulę dla określonego konta.
Podczas nazewnictwa pul należy unikać dołączania poufnych informacji, takich jak nazwy użytkowników lub nazwy projektów tajnych. Te informacje mogą być wyświetlane w dziennikach telemetrii dostępnych dla inżynierów pomocy technicznej firmy Microsoft.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Punkt końcowy konta usługi Batch (na przykład: https://batchaccount.eastus2.batch.azure.com).
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
timeOut	query		integer (int32)	Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta domyślna wersja domyślna.".

Nagłówek żądania

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

Nazwa	Typ	Opis
client-request-id	string	Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Czy serwer powinien zwrócić identyfikator żądania klienta w odpowiedzi.
ocp-date	string (date-time-rfc7231)	Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Treść żądania

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

Nazwa	Wymagane	Typ	Opis
id	True	string	Ciąg, który jednoznacznie identyfikuje pulę w ramach konta. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator zachowuje wielkość liter i nie uwzględnia wielkości liter (oznacza to, że w ramach konta nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).
vmSize	True	string	Rozmiar maszyn wirtualnych w puli. Wszystkie maszyny wirtualne w puli mają ten sam rozmiar. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych na platformie Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).
applicationPackageReferences		BatchApplicationPackageReference[]	Lista pakietów do zainstalowania w każdym węźle obliczeniowym w puli. Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub zrewidowane. W danej puli istnieje maksymalnie 10 odwołań do pakietu.
autoScaleEvaluationInterval		string (duration)	Interwał czasu, w którym ma być automatycznie dostosowywany rozmiar puli zgodnie z formułą autoskalowania. Wartość domyślna to 15 minut. Minimalna i maksymalna wartość to odpowiednio 5 minut i 168 godzin. Jeśli określisz wartość mniejszą niż 5 minut lub większą niż 168 godzin, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
autoScaleFormula		string	Formuła dla żądanej liczby węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli dla parametru enableAutoScale ustawiono wartość false. Jest to wymagane, jeśli wartość enableAutoScale jest ustawiona na wartość true. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz "Automatyczne skalowanie węzłów obliczeniowych w puli usługi Azure Batch" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).
displayName		string	Nazwa wyświetlana puli. Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.
enableAutoScale		boolean	Określa, czy rozmiar puli powinien być automatycznie dostosowywany w miarę upływu czasu. Jeśli wartość false, należy określić co najmniej jeden z elementów targetDedicatedNodes i targetLowPriorityNodes. Jeśli wartość true, właściwość autoScaleFormula jest wymagana, a rozmiar puli zostanie automatycznie zmieniony zgodnie z formułą. Wartość domyślna to fałsz.
enableInterNodeCommunication		boolean	Określa, czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi. Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to fałsz.
metadata		BatchMetadataItem[]	Lista par name-value skojarzonych z pulą jako metadanych. Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.
mountConfiguration		MountConfiguration[]	Zainstaluj magazyn przy użyciu określonego systemu plików przez cały okres istnienia puli. Zainstaluj magazyn przy użyciu udziału plików platformy Azure, NFS, CIFS lub systemu plików opartego na systemie blobfuse.
networkConfiguration		NetworkConfiguration	Konfiguracja sieci dla puli.
resizeTimeout		string (duration)	Limit czasu alokacji węzłów obliczeniowych do puli. Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego wpływu, gdy parametr enableAutoScale jest ustawiony na wartość true. Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
startTask		BatchStartTask	Zadanie określone do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli. Zadanie jest uruchamiane po dodaniu węzła obliczeniowego do puli lub ponownym uruchomieniu węzła obliczeniowego.
targetDedicatedNodes		integer (int32)	Żądana liczba dedykowanych węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.
targetLowPriorityNodes		integer (int32)	Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.
taskSchedulingPolicy		BatchTaskSchedulingPolicy	Sposób dystrybucji zadań między węzłami obliczeniowymi w puli. Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.
taskSlotsPerNode		integer (int32)	Liczba slotów zadaniowych, których można użyć do uruchamiania współbieżnych zadań na pojedynczym węźle obliczeniowym w puli. Wartość domyślna to 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.
upgradePolicy		UpgradePolicy	Zasady uaktualniania puli. Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.
userAccounts		UserAccount[]	Lista kont użytkowników do utworzenia w każdym węźle obliczeniowym w puli.
virtualMachineConfiguration		VirtualMachineConfiguration	Konfiguracja maszyny wirtualnej dla puli. Tę właściwość należy określić.

Odpowiedzi

Nazwa	Typ	Opis
201 Created		Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób. Nagłówki DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Nieoczekiwana odpowiedź na błąd.

Nazwa

Typ

Opis

201 Created

Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.

Nagłówki

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

Other Status Codes

BatchError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa	Opis
https://batch.core.windows.net//.default

Przykłady

Creates a pool with accelerated networking

Creates a pool with confidential disk encryption set for user subscription accounts

Creates a pool with disk encryption set for user subscription accounts

Creates a pool with dual stack networking

Creates a pool with mount drive specified

Creates a pool with SecurityProfile

Creates a VirtualMachineConfiguration pool

Creates a VirtualMachineConfiguration pool with containers

Creates a VirtualMachineConfiguration pool with extensions

Creates a VirtualMachineConfiguration pool with OS disk

Creates a VirtualMachineConfiguration pool with ServiceArtifactReference

Creates a pool with accelerated networking

Przykładowe żądanie

HTTP

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



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

Przykładowa odpowiedź

Kod stanu:: 201

Creates a pool with confidential disk encryption set for user subscription accounts

Przykładowe żądanie

HTTP

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



{
  "id": "pool",
  "vmSize": "Standard_DC2as_v5",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2019-datacenter-core-g2",
      "version": "latest"
    },
    "osDisk": {
      "managedDisk": {
        "storageAccountType": "standard_lrs",
        "diskEncryptionSet": {
          "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
        },
        "securityProfile": {
          "securityEncryptionType": "DiskWithVMGuestState"
        }
      }
    },
    "dataDisks": [
      {
        "lun": 0,
        "diskSizeGB": 1024,
        "managedDisk": {
          "storageAccountType": "standard_lrs",
          "diskEncryptionSet": {
            "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
          }
        }
      }
    ],
    "securityProfile": {
      "securityType": "confidentialvm",
      "uefiSettings": {
        "vTpmEnabled": true,
        "secureBootEnabled": true
      }
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 1
}

Przykładowa odpowiedź

Kod stanu:: 201

Creates a pool with disk encryption set for user subscription accounts

Przykładowe żądanie

HTTP

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



{
  "id": "pool",
  "vmSize": "Standard_D2ds_v5",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2019-datacenter-core-g2",
      "version": "latest"
    },
    "osDisk": {
      "managedDisk": {
        "storageAccountType": "standard_lrs",
        "diskEncryptionSet": {
          "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
        }
      }
    },
    "dataDisks": [
      {
        "lun": 0,
        "diskSizeGB": 1024,
        "managedDisk": {
          "storageAccountType": "standard_lrs",
          "diskEncryptionSet": {
            "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
          }
        }
      }
    ],
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 1
}

Przykładowa odpowiedź

Kod stanu:: 201

Creates a pool with dual stack networking

Przykładowe żądanie

HTTP

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



{
  "id": "dualstackpool",
  "vmSize": "Standard_D2ds_v5",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "ubuntu-24_04-lts",
      "sku": "server"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "networkConfiguration": {
    "publicIPAddressConfiguration": {
      "ipFamilies": [
        "IPv4",
        "IPv6"
      ]
    },
    "endpointConfiguration": {
      "inboundNATPools": [
        {
          "backendPort": 22,
          "frontendPortRangeStart": 40000,
          "frontendPortRangeEnd": 40500,
          "name": "sshpool",
          "protocol": "tcp",
          "networkSecurityGroupRules": [
            {
              "access": "allow",
              "priority": 1000,
              "sourceAddressPrefix": "*",
              "sourcePortRanges": [
                "*"
              ]
            }
          ]
        }
      ]
    }
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0
}

Przykładowa odpowiedź

Kod stanu:: 201

Creates a pool with mount drive specified

Przykładowe żądanie

HTTP

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


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

Przykładowa odpowiedź

Kod stanu:: 201

Creates a pool with SecurityProfile

Przykładowe żądanie

HTTP

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



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

Przykładowa odpowiedź

Kod stanu:: 201

Creates a VirtualMachineConfiguration pool

Przykładowe żądanie

HTTP

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



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

Przykładowa odpowiedź

Kod stanu:: 201

Creates a VirtualMachineConfiguration pool with containers

Przykładowe żądanie

HTTP

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



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

Przykładowa odpowiedź

Kod stanu:: 201

Creates a VirtualMachineConfiguration pool with extensions

Przykładowe żądanie

HTTP

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



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

Przykładowa odpowiedź

Kod stanu:: 201

Creates a VirtualMachineConfiguration pool with OS disk

Przykładowe żądanie

HTTP

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



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

Przykładowa odpowiedź

Kod stanu:: 201

Creates a VirtualMachineConfiguration pool with ServiceArtifactReference

Przykładowe żądanie

HTTP

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



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

Przykładowa odpowiedź

Kod stanu:: 201

Definicje

Nazwa	Opis
AutomaticOsUpgradePolicy	Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego.
AutoUserScope	Enumy AutoUserScope
AutoUserSpecification	Określa opcje dla użytkownika automatycznego, który uruchamia zadanie usługi Azure Batch.
AzureBlobFileSystemConfiguration	Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse.
AzureFileShareConfiguration	Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure.
BatchApplicationPackageReference	Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.
BatchContainerConfiguration	Konfiguracja pul z obsługą kontenerów.
BatchDiffDiskSettings	Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).
BatchError	Odebrano odpowiedź o błędzie z usługi Azure Batch.
BatchErrorDetail	Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.
BatchErrorMessage	Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.
BatchInboundNatPool	Pula nat dla ruchu przychodzącego, która może służyć do adresowania określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie.
BatchJobDefaultOrder	Enums BatchJobDefaultOrder
BatchMetadataItem	Usługa Batch nie przypisuje żadnego znaczenia do tych metadanych; służy wyłącznie do używania kodu użytkownika.
BatchNodeFillType	Enums BatchNodeFillType
BatchNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.
BatchNodePlacementConfiguration	W przypadku umieszczania regionalnego węzły w puli zostaną przydzielone w tym samym regionie. W przypadku umieszczania strefowego węzły w puli będą rozmieszczone w różnych strefach z najlepszym równoważeniem nakładu pracy.
BatchNodePlacementPolicyType	Enums BatchNodePlacementPolicyType
BatchOsDisk	Ustawienia dysku systemu operacyjnego węzła obliczeniowego (VM).
BatchPoolCreateOptions	Parametry tworzenia puli usługi Azure Batch.
BatchPoolEndpointConfiguration	Konfiguracja punktu końcowego dla puli.
BatchPoolIdentityReference	Odwołanie do jednej z tożsamości puli w celu zaszyfrowania dysku. Ta tożsamość będzie używana do uzyskiwania dostępu do magazynu kluczy.
BatchPublicIpAddressConfiguration	Konfiguracja publicznego adresu IP konfiguracji sieci puli.
BatchStartTask	Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. W niektórych przypadkach funkcja StartTask może zostać ponownie uruchomiona, mimo że węzeł obliczeniowy nie został ponownie uruchomiony. Należy zachować szczególną ostrożność, aby uniknąć zadań StartTasks, które tworzą proces przerwania lub instalują/uruchamiają usługi z katalogu roboczego StartTask, ponieważ uniemożliwi to usłudze Batch ponowne uruchomienie zadania StartTask.
BatchTaskContainerSettings	Ustawienia kontenera dla zadania.
BatchTaskSchedulingPolicy	Określa sposób dystrybucji zadań w węzłach obliczeniowych.
BatchUefiSettings	Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej.
BatchVmDiskSecurityProfile	Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: Można ją ustawić tylko dla poufnych maszyn wirtualnych i jest to wymagane w przypadku korzystania z poufnych maszyn wirtualnych.
BatchVmImageReference	Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazów witryny Azure Marketplace zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych obrazów".
CachingType	Enumy CachingType
CifsMountConfiguration	Informacje używane do nawiązywania połączenia z systemem plików CIFS.
ContainerHostBatchBindMountEntry	Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań.
ContainerHostDataPath	Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.
ContainerRegistryReference	Prywatny rejestr kontenerów.
ContainerType	Enums ContainerType
ContainerWorkingDirectory	Enums ContainerWorkingDirectory
DataDisk	Ustawienia, które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z maszyny wirtualnej, aby ich używać.
DiffDiskPlacement	Określa efemeryczne rozmieszczenie dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (VM) w puli. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, w której powinien znajdować się system operacyjny. np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku Ephemeral OS, prosimy zapoznać się z wymaganiami dotyczącymi rozmiaru dysku Ephemeral OS dla maszyn wirtualnych z Windows at i https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linuksa pod https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements
DiskCustomerManagedKey	Odwołanie do klucza zarządzanego przez klienta w celu zaszyfrowania dysku.
DiskEncryptionConfiguration	Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej za pomocą obrazu galerii obliczeń platformy Azure.
DiskEncryptionSetParameters	Identyfikator zasobu usługi ARM zestawu szyfrowania dysku.
DiskEncryptionTarget	Enumy DiskEncryptionTarget
DynamicVNetAssignmentScope	Enums DynamicVNetAssignmentScope
ElevationLevel	Enumy ElevationLevel
EnvironmentSetting	Zmienna środowiskowa, która ma być ustawiana w procesie zadania.
HostEndpointSettings	Określa określone ustawienia punktu końcowego hosta.
HostEndpointSettingsModeTypes	Enums HostEndpointSettingsModeTypes
InboundEndpointProtocol	Enums InboundEndpointProtocol
IpAddressProvisioningType	IPAddressProvisioningType enums
IPFamily	Rodziny adresów IP używane do określania wersji adresów IP dostępnych w puli.
IPTag	Zawiera tag IP skojarzony z publicznym adresem IP.
LinuxUserConfiguration	Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux.
LoginMode	Enumy LoginMode
ManagedDisk	Parametry dysku zarządzanego.
MountConfiguration	System plików do zainstalowania w każdym węźle.
NetworkConfiguration	Konfiguracja sieci dla puli.
NetworkSecurityGroupRule	Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego.
NetworkSecurityGroupRuleAccess	Enumy NetworkSecurityGroupRuleAccess
NfsMountConfiguration	Informacje używane do nawiązywania połączenia z systemem plików NFS.
ProxyAgentSettings	Określa ustawienia proxyAgent podczas tworzenia maszyny wirtualnej.
ResourceFile	Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.
RollingUpgradePolicy	Parametry konfiguracji używane podczas uaktualniania stopniowego.
SecurityEncryptionTypes	Enumy SecurityEncryptionTypes
SecurityProfile	Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.
SecurityTypes	Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs UefiSettings.
ServiceArtifactReference	Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania w przypadku używania "najnowszej" wersji obrazu.
StorageAccountType	Wyliczenia StorageAccountType
UpgradeMode	Enumy UpgradeMode
UpgradePolicy	Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.
UserAccount	Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym usługi Azure Batch.
UserIdentity	Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie. Określ właściwość userName lub autoUser, ale nie obie.
VirtualMachineConfiguration	Konfiguracja węzłów obliczeniowych w puli oparta na infrastrukturze usługi Azure Virtual Machines.
VMExtension	Konfiguracja rozszerzeń maszyn wirtualnych.
WindowsConfiguration	Ustawienia systemu operacyjnego Windows, które mają być stosowane do maszyny wirtualnej.
WindowsUserConfiguration	Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Windows.

AutomaticOsUpgradePolicy

Objekt

Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego.

Nazwa	Typ	Opis
disableAutomaticRollback	boolean	Czy funkcja wycofywania obrazów systemu operacyjnego powinna być wyłączona.
enableAutomaticOSUpgrade	boolean	Wskazuje, czy uaktualnienia systemu operacyjnego powinny być automatycznie stosowane do wystąpień zestawu skalowania w sposób kroczący, gdy nowsza wersja obrazu systemu operacyjnego stanie się dostępna. Jeśli dla pul opartych na systemie Windows ustawiono wartość true, WindowsConfiguration.enableAutomaticUpdates nie można ustawić wartości true.
osRollingUpgradeDeferral	boolean	Odroczenie uaktualnień systemu operacyjnego na maszynach TVM, jeśli są uruchomione zadania.
useRollingUpgradePolicy	boolean	Wskazuje, czy zasady uaktualniania stopniowego powinny być używane podczas automatycznego uaktualniania systemu operacyjnego. Automatyczne uaktualnianie systemu operacyjnego spowoduje powrót do domyślnych zasad, jeśli żadne zasady nie są zdefiniowane w zestawie skalowania maszyn wirtualnych.

AutoUserScope

Wyliczenie

Enumy AutoUserScope

Wartość	Opis
task	Określa, że usługa powinna utworzyć nowego użytkownika do zadania.
pool	Określa, że zadanie jest wykonywane jako wspólne automatyczne konto użytkownika, które jest tworzone na każdym węźle obliczeniowym w puli.

AutoUserSpecification

Objekt

Określa opcje dla użytkownika automatycznego, który uruchamia zadanie usługi Azure Batch.

Nazwa	Typ	Opis
elevationLevel	ElevationLevel	Poziom podniesienia uprawnień użytkownika automatycznego. Wartość domyślna to nonAdmin.
scope	AutoUserScope	Zakres użytkownika automatycznego. Wartość domyślna to pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Na przykład, jeśli zadanie mutuje rejestr w sposób, który może mieć wpływ na inne zadania.

AzureBlobFileSystemConfiguration

Objekt

Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse.

Nazwa	Typ	Opis
accountKey	string (password)	Klucz konta usługi Azure Storage. Ta właściwość wzajemnie się wyklucza zarówno z kluczem sasKey, jak i tożsamością; należy określić dokładnie jeden.
accountName	string	Nazwa konta usługi Azure Storage.
blobfuseOptions	string	Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux.
containerName	string	Nazwa kontenera usługi Azure Blob Storage.
identityReference	BatchNodeIdentityReference	Odniesienie do przypisanej przez użytkownika tożsamości do użycia do uzyskania containerName. Ta właściwość wzajemnie wyklucza się zarówno z kluczem accountKey, jak i sasKey; należy określić dokładnie jeden.
relativeMountPath	string	Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.
sasKey	string (password)	Token SAS usługi Azure Storage. Ta właściwość wzajemnie wyklucza się zarówno z kluczem konta, jak i tożsamością; należy określić dokładnie jeden.

AzureFileShareConfiguration

Objekt

Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure.

Nazwa	Typ	Opis
accountKey	string (password)	Klucz konta usługi Azure Storage.
accountName	string	Nazwa konta usługi Azure Storage.
azureFileUrl	string (uri)	Adres URL usługi Azure Files. Jest to formularz "https://{account}.file.core.windows.net/".
mountOptions	string	Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux.
relativeMountPath	string	Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

BatchApplicationPackageReference

Objekt

Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.

Nazwa	Typ	Opis
applicationId	string	ID aplikacji do wdrożenia. Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Wersja aplikacji do wdrożenia. W przypadku pominięcia zostanie wdrożona domyślna wersja. Jeśli ten wniosek zostanie pominięty w Pool, a domyślna wersja nie zostanie określona dla tej aplikacji, żądanie kończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences i kodem statusowym HTTP 409. Jeśli to zostanie pominięte w zadaniu i nie podano domyślnej wersji dla tej aplikacji, zadanie zostaje nieudane z błędem wstępnego przetwarzania.

BatchContainerConfiguration

Objekt

Konfiguracja pul z obsługą kontenerów.

Nazwa	Typ	Opis
containerImageNames	string[]	Kolekcja nazw obrazów kontenerów. To jest pełne odniesienie do Image, jak byłoby określone jako "docker pull". Obraz będzie pozyskiwany z domyślnego rejestru Dockera, chyba że jest w pełni kwalifikowany z alternatywnym rejestrem.
containerRegistries	ContainerRegistryReference[]	Dodatkowe rejestry prywatne, z których można ściągać kontenery. Jeśli jakiekolwiek obrazy muszą zostać pobrane z prywatnego rejestru, który wymaga poświadczeń, należy je tutaj podać.
type	ContainerType	Technologia kontenera do użycia.

BatchDiffDiskSettings

Objekt

Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).

Nazwa	Typ	Opis
placement	DiffDiskPlacement	Określa efemeryczne umieszczanie dysku dla dysku systemu operacyjnego dla wszystkich maszyn wirtualnych w puli. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji dysku efemerycznego systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku systemu operacyjnego efemerycznego, zapoznaj się z wymaganiami dotyczącymi rozmiaru dysku efemerycznego systemu operacyjnego dla maszyn wirtualnych z systemem Windows na https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements i maszynach wirtualnych z systemem Linux w https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

BatchError

Objekt

Odebrano odpowiedź o błędzie z usługi Azure Batch.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	BatchErrorMessage	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values	BatchErrorDetail[]	Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Objekt

Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.

Nazwa	Typ	Opis
key	string	Identyfikator określający znaczenie właściwości Value.
value	string	Dodatkowe informacje zawarte w odpowiedzi na błąd.

BatchErrorMessage

Objekt

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

Nazwa	Typ	Opis
lang	string	Kod językowy komunikatu o błędzie.
value	string	Tekst wiadomości.

BatchInboundNatPool

Objekt

Pula nat dla ruchu przychodzącego, która może służyć do adresowania określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie.

Nazwa	Typ	Opis
backendPort	integer (int32)	Numer portu w węźle Compute. To musi być unikalne w ramach Batch Pool. Dopuszczalne wartości to od 1 do 65535 z wyjątkiem 29876 i 29877, ponieważ są one zarezerwowane. Jeśli podano jakiekolwiek wartości zarezerwowane, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
frontendPortRangeEnd	integer (int32)	Ostatni numer portu w zakresie zewnętrznych portów, które będą wykorzystywane do zapewnienia dostępu do backendPortu na poszczególnych węzłach obliczeniowych. Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane przez usługę Batch. Wszystkie zakresy w Puli muszą być odrębne i nie mogą się nakładać. Każda gama musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
frontendPortRangeStart	integer (int32)	Pierwszy numer portu w zakresie zewnętrznych portów, które będą wykorzystywane do zapewnienia dostępu do backendPortu na poszczególnych węzłach obliczeniowych. Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w Puli muszą być odrębne i nie mogą się nakładać. Każda gama musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
name	string	Nazwa punktu końcowego. Nazwa musi być unikalna w ramach Batch Pool, może zawierać litery, cyfry, podkreślenia, kropki i myślniki. Nazwy muszą zaczynać się literą lub cyfrą, muszą kończyć się literą, cyfrą lub podkreśleniami i nie mogą przekraczać 77 znaków. Jeśli podano nieprawidłowe wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
networkSecurityGroupRules	NetworkSecurityGroupRule[]	Lista reguł sieciowej grupy zabezpieczeń, które zostaną zastosowane do punktu końcowego. Maksymalna liczba reguł, które można określić na wszystkich końcach puli wsadowej, wynosi 25. Jeśli nie określono żadnych reguł sieciowej grupy zabezpieczeń, zostanie utworzona domyślna reguła zezwalania na dostęp przychodzący do określonego zapleczaPort. Jeśli maksymalna liczba reguł sieciowej grupy zabezpieczeń zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
protocol	InboundEndpointProtocol	Protokół punktu końcowego.

BatchJobDefaultOrder

Wyliczenie

Enums BatchJobDefaultOrder

Wartość	Opis
none	Zadania powinny być planowane równomiernie ze wszystkich zadań o równym priorytecie dla puli.
creationtime	Jeśli zadania mają równy priorytet, zadania z wcześniej utworzonych zadań powinny być zaplanowane jako pierwsze.

BatchMetadataItem

Objekt

Usługa Batch nie przypisuje żadnego znaczenia do tych metadanych; służy wyłącznie do używania kodu użytkownika.

Nazwa	Typ	Opis
name	string	Nazwa elementu metadanych.
value	string	Wartość elementu metadanych.

BatchNodeFillType

Wyliczenie

Enums BatchNodeFillType

Wartość	Opis
spread	Zadania powinny być przydzielane równomiernie pomiędzy wszystkie węzły obliczeniowe w puli.
pack	Jak najwięcej Zadań (taskSlotsPerNode) powinno być przypisanych do każdego węzła obliczeniowego w puli, zanim jakiekolwiek zadania zostaną przypisane do następnego węzła obliczeniowego w puli.

BatchNodeIdentityReference

Objekt

Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.

Nazwa	Typ	Opis
resourceId	string (arm-id)	Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika.

BatchNodePlacementConfiguration

Objekt

W przypadku umieszczania regionalnego węzły w puli zostaną przydzielone w tym samym regionie. W przypadku umieszczania strefowego węzły w puli będą rozmieszczone w różnych strefach z najlepszym równoważeniem nakładu pracy.

Nazwa	Typ	Opis
policy	BatchNodePlacementPolicyType	Typ zasad umieszczania węzła w pulach usługi Batch. Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych.

BatchNodePlacementPolicyType

Wyliczenie

Enums BatchNodePlacementPolicyType

Wartość	Opis
regional	Wszystkie węzły w puli zostaną przydzielone w tym samym regionie.
zonal	Węzły w puli będą rozproszone po różnych strefach dostępności z najlepszym balansowaniem wysiłku.

BatchOsDisk

Objekt

Ustawienia dysku systemu operacyjnego węzła obliczeniowego (VM).

Nazwa	Typ	Opis
caching	CachingType	Określa wymagania dotyczące buforowania. Możliwe wartości to: None, ReadOnly, ReadWrite. Wartości domyślne to: Brak w przypadku magazynu w warstwie Standardowa. Funkcja ReadOnly dla usługi Premium Storage.
diskSizeGB	integer (int32)	Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku systemu operacyjnego.
ephemeralOSDiskSettings	BatchDiffDiskSettings	Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).
managedDisk	ManagedDisk	Parametry dysku zarządzanego.
writeAcceleratorEnabled	boolean	Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator.

BatchPoolCreateOptions

Objekt

Parametry tworzenia puli usługi Azure Batch.

Nazwa	Typ	Opis
applicationPackageReferences	BatchApplicationPackageReference[]	Lista pakietów do zainstalowania w każdym węźle obliczeniowym w puli. Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub zrewidowane. W danej puli istnieje maksymalnie 10 odwołań do pakietu.
autoScaleEvaluationInterval	string (duration)	Interwał czasu, w którym ma być automatycznie dostosowywany rozmiar puli zgodnie z formułą autoskalowania. Wartość domyślna to 15 minut. Minimalna i maksymalna wartość to odpowiednio 5 minut i 168 godzin. Jeśli określisz wartość mniejszą niż 5 minut lub większą niż 168 godzin, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
autoScaleFormula	string	Formuła dla żądanej liczby węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli dla parametru enableAutoScale ustawiono wartość false. Jest to wymagane, jeśli wartość enableAutoScale jest ustawiona na wartość true. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz "Automatyczne skalowanie węzłów obliczeniowych w puli usługi Azure Batch" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).
displayName	string	Nazwa wyświetlana puli. Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.
enableAutoScale	boolean	Określa, czy rozmiar puli powinien być automatycznie dostosowywany w miarę upływu czasu. Jeśli wartość false, należy określić co najmniej jeden z elementów targetDedicatedNodes i targetLowPriorityNodes. Jeśli wartość true, właściwość autoScaleFormula jest wymagana, a rozmiar puli zostanie automatycznie zmieniony zgodnie z formułą. Wartość domyślna to fałsz.
enableInterNodeCommunication	boolean	Określa, czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi. Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to fałsz.
id	string	Ciąg, który jednoznacznie identyfikuje pulę w ramach konta. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator zachowuje wielkość liter i nie uwzględnia wielkości liter (oznacza to, że w ramach konta nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).
metadata	BatchMetadataItem[]	Lista par name-value skojarzonych z pulą jako metadanych. Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.
mountConfiguration	MountConfiguration[]	Zainstaluj magazyn przy użyciu określonego systemu plików przez cały okres istnienia puli. Zainstaluj magazyn przy użyciu udziału plików platformy Azure, NFS, CIFS lub systemu plików opartego na systemie blobfuse.
networkConfiguration	NetworkConfiguration	Konfiguracja sieci dla puli.
resizeTimeout	string (duration)	Limit czasu alokacji węzłów obliczeniowych do puli. Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego wpływu, gdy parametr enableAutoScale jest ustawiony na wartość true. Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
startTask	BatchStartTask	Zadanie określone do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli. Zadanie jest uruchamiane po dodaniu węzła obliczeniowego do puli lub ponownym uruchomieniu węzła obliczeniowego.
targetDedicatedNodes	integer (int32)	Żądana liczba dedykowanych węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.
targetLowPriorityNodes	integer (int32)	Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy.
taskSchedulingPolicy	BatchTaskSchedulingPolicy	Sposób dystrybucji zadań między węzłami obliczeniowymi w puli. Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.
taskSlotsPerNode	integer (int32)	Liczba slotów zadaniowych, których można użyć do uruchamiania współbieżnych zadań na pojedynczym węźle obliczeniowym w puli. Wartość domyślna to 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.
upgradePolicy	UpgradePolicy	Zasady uaktualniania puli. Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.
userAccounts	UserAccount[]	Lista kont użytkowników do utworzenia w każdym węźle obliczeniowym w puli.
virtualMachineConfiguration	VirtualMachineConfiguration	Konfiguracja maszyny wirtualnej dla puli. Tę właściwość należy określić.
vmSize	string	Rozmiar maszyn wirtualnych w puli. Wszystkie maszyny wirtualne w puli mają ten sam rozmiar. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych na platformie Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

BatchPoolEndpointConfiguration

Objekt

Konfiguracja punktu końcowego dla puli.

Nazwa	Typ	Opis
inboundNATPools	BatchInboundNatPool[]	Lista przychodzących pul NAT, które mogą być używane do adresowania konkretnych portów na pojedynczym węźle obliczeniowym zewnętrznie. Maksymalna liczba przychodzących pul NAT na pulę wsadową wynosi 5. Jeśli maksymalna liczba przychodzących pul NAT zostanie przekroczona, żądanie kończy się niepowodzeniem z kodem statusu HTTP 400. Nie można tego określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses.

BatchPoolIdentityReference

Objekt

Odwołanie do jednej z tożsamości puli w celu zaszyfrowania dysku. Ta tożsamość będzie używana do uzyskiwania dostępu do magazynu kluczy.

Nazwa	Typ	Opis
resourceId	string (arm-id)	Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika. To odwołanie musi być uwzględnione w tożsamościach puli.

BatchPublicIpAddressConfiguration

Objekt

Konfiguracja publicznego adresu IP konfiguracji sieci puli.

Nazwa	Typ	Opis
ipAddressIds	string[] (arm-id)	Lista publicznych adresów IP, których usługa Batch będzie używać podczas aprowizacji węzłów obliczeniowych. Liczba adresów IP określonych tutaj ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów typu spot/low-priority można przydzielić dla każdego publicznego adresu IP. Na przykład pula wymagając 250 dedykowanych maszyn wirtualnych wymaga co najmniej 3 publicznych adresów IP. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.
ipFamilies	IPFamily[]	Rodziny adresów IP używane do określania wersji adresów IP dostępnych w puli. Rodziny adresów IP służą do określania pul z jednym lub dwoma stosami. W przypadku pojedynczego stosu oczekiwana wartość to IPv4. W przypadku dwóch stosów oczekiwane wartości to IPv4 i IPv6.
ipTags	IPTag[]	Lista tagów IP skojarzonych z publicznymi adresami IP puli. Tagi IP służą do kategoryzowania i filtrowania publicznych adresów IP na potrzeby rozliczeń i zarządzania.
provision	IpAddressProvisioningType	Typ aprowizacji dla publicznych adresów IP dla puli. Wartość domyślna to BatchManaged.

BatchStartTask

Objekt

Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. W niektórych przypadkach funkcja StartTask może zostać ponownie uruchomiona, mimo że węzeł obliczeniowy nie został ponownie uruchomiony. Należy zachować szczególną ostrożność, aby uniknąć zadań StartTasks, które tworzą proces przerwania lub instalują/uruchamiają usługi z katalogu roboczego StartTask, ponieważ uniemożliwi to usłudze Batch ponowne uruchomienie zadania StartTask.

Nazwa	Typ	Opis
commandLine	string	Wiersz polecenia starttask. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	BatchTaskContainerSettings	Ustawienia kontenera, pod którym działa StartTask. Gdy to zostanie określone, wszystkie katalogi rekurencyjnie poniżej AZ_BATCH_NODE_ROOT_DIR (korzenia katalogów Azure Batch na węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe Task są mapowane do kontenera, a wiersz poleceń Task jest wykonywany w kontenerze. Pliki wytworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie być odzwierciedlone na dysku hosta, co oznacza, że API plików wsadowych nie będą miały dostępu do tych plików.
environmentSettings	EnvironmentSetting[]	Lista ustawień zmiennych środowiskowych dla elementu StartTask.
maxTaskRetryCount	integer (int32)	Maksymalna liczba ponownych prób wykonania zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje raz wykonać zadanie, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie do 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania podrzędnego uruchamiania ani żadnego zadania podrzędnego. Wartość domyślna to 0 (bez ponownych prób).
resourceFiles	ResourceFile[]	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji plików ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker. Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania.
userIdentity	UserIdentity	Tożsamość użytkownika, pod którą działa StartTask. Jeśli zostanie pominięte, Zadanie działa jako użytkownik nieadministracyjny, unikalny dla Zadania.
waitForSuccess	boolean	Czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i parametr StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznacza węzeł bezużyteczny i nie będzie planować zadań do niego. Ten warunek można wykryć za pomocą szczegółów stanu węzła obliczeniowego i informacji o błędzie. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania StartTask. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy funkcja StartTask jest nadal uruchomiona; a nawet jeśli zadanie StartTask zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle obliczeniowym. Wartość domyślna to true.

BatchTaskContainerSettings

Objekt

Ustawienia kontenera dla zadania.

Nazwa	Typ	Opis
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Ścieżki, które chcesz zamontować w zadaniu kontenera. Jeśli ta tablica ma wartość null lub nie istnieje, zadanie kontenera zainstaluje cały dysk tymczasowy w systemie Windows (lub AZ_BATCH_NODE_ROOT_DIR w systemie Linux). Jeśli ta tablica jest ustawiona jako pusta, nie zainstaluje żadnych ścieżek danych w kontenerze.
containerRunOptions	string	Dodatkowe opcje polecenia create kontenera. Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch.
imageName	string	Obraz, którego używa się do stworzenia kontenera, w którym zadanie będzie działać. To jest pełne odniesienie do Image, jak byłoby określone jako "docker pull". Jeśli w nazwie obrazu nie ma tagu, domyślnie używa się tagu ":latest".
registry	ContainerRegistryReference	Prywatny rejestr, który zawiera obraz kontenera. To ustawienie można pominąć, jeśli było już dostępne podczas tworzenia puli.
workingDirectory	ContainerWorkingDirectory	Lokalizacja katalogu roboczego kontenera Task. Wartość domyślna to "taskWorkingDirectory".

BatchTaskSchedulingPolicy

Objekt

Określa sposób dystrybucji zadań w węzłach obliczeniowych.

Nazwa	Typ	Domyślna wartość	Opis
jobDefaultOrder	BatchJobDefaultOrder	none	Kolejność planowania zadań z różnych zadań o tym samym priorytecie. Jeśli nie zostanie określony, wartość domyślna to none.
nodeFillType	BatchNodeFillType		Sposób dystrybucji zadań między węzłami obliczeniowymi w puli. Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

BatchUefiSettings

Objekt

Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej.

Nazwa	Typ	Opis
secureBootEnabled	boolean	Określa, czy bezpieczny rozruch powinien być włączony na maszynie wirtualnej.
vTpmEnabled	boolean	Określa, czy maszyna wirtualna ma być włączona na maszynie wirtualnej.

BatchVmDiskSecurityProfile

Objekt

Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: Można ją ustawić tylko dla poufnych maszyn wirtualnych i jest to wymagane w przypadku korzystania z poufnych maszyn wirtualnych.

Nazwa	Typ	Opis
securityEncryptionType	SecurityEncryptionTypes	Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: Można ją ustawić tylko dla poufnych maszyn wirtualnych i jest wymagana w przypadku korzystania z poufnych maszyn wirtualnych.

BatchVmImageReference

Objekt

Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazów witryny Azure Marketplace zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych obrazów".

Nazwa	Typ	Opis
communityGalleryImageId	string	Unikalny identyfikator obrazu galerii społecznościowej. Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może być pobierana z wywołania GET obrazu galerii społeczności.
exactVersion	string	Konkretna wersja obrazu platformy lub marketplace użytego do stworzenia węzła. To pole tylko do odczytu różni się od 'version' tylko wtedy, gdy wartość podany dla 'version' podczas tworzenia puli była 'laprint'.
offer	string	Typ oferty to Azure Virtual Machines Marketplace Image. Na przykład UbuntuServer lub WindowsServer.
publisher	string	Wydawca obrazu Azure Virtual Machines Marketplace. Na przykład Canonical lub MicrosoftWindowsServer.
sharedGalleryImageId	string	Unikalny identyfikator wspólnego zdjęcia galerii. Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może zostać pobrana z wywołania GET obrazu galerii udostępnionej.
sku	string	SKU obrazu Azure Virtual Machines Marketplace. Na przykład 18.04-LTS lub 2019-Datacenter.
version	string	Wersja Azure Virtual Machines Marketplace Image. Można określić wartość 'najnowszy', aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest".
virtualMachineImageId	string (arm-id)	Identyfikator zasobu usługi ARM obrazu galerii obliczeniowej platformy Azure. Węzły obliczeniowe w puli będą tworzone za pomocą tego ID obrazu. Ma ona formę /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} lub /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}, gdzie zawsze domyślnie wraca do najnowszej wersji obrazu. Ta własność jest wzajemnie wyłączna z innymi właściwościami ImageReference. Obraz Azure Compute Gallery Gallery musi mieć repliki w tym samym regionie i musi być w tej samej subskrypcji co konto Azure Batch. Jeśli wersja obrazu nie jest określona w imageId, zostanie użyta najnowsza wersja. Aby uzyskać informacje o ustawieniach zapory dla agenta Batch Compute Node, aby komunikował się z usługą https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configurationBatch .

CachingType

Wyliczenie

Enumy CachingType

Wartość	Opis
none	Tryb buforowania dysku nie jest włączony.
readonly	Tryb buforowania dysku jest tylko do odczytu.
readwrite	Tryb buforowania dysku jest odczytywany i zapisywany.

CifsMountConfiguration

Objekt

Informacje używane do nawiązywania połączenia z systemem plików CIFS.

Nazwa	Typ	Opis
mountOptions	string	Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux.
password	string (password)	Hasło używane do uwierzytelniania w systemie plików CIFS.
relativeMountPath	string	Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.
source	string	Identyfikator URI systemu plików do zainstalowania.
username	string	Użytkownik do użycia do uwierzytelniania w systemie plików CIFS.

ContainerHostBatchBindMountEntry

Objekt

Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań.

Nazwa	Typ	Opis
isReadOnly	boolean	Zainstaluj tę ścieżkę źródłową jako tryb tylko do odczytu lub nie. Wartość domyślna to false (tryb odczytu/zapisu). W przypadku systemu Linux, jeśli zainstalujesz tę ścieżkę jako tryb odczytu/zapisu, nie oznacza to, że wszyscy użytkownicy w kontenerze mają dostęp do odczytu/zapisu dla ścieżki, zależy to od dostępu na maszynie wirtualnej hosta. Jeśli ta ścieżka jest instalowana tylko do odczytu, wszyscy użytkownicy w kontenerze nie będą mogli modyfikować ścieżki.
source	ContainerHostDataPath	Można wybrać ścieżkę instalowaną dla klienta kontenera.

ContainerHostDataPath

Wyliczenie

Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.

Wartość	Opis
Shared	Ścieżka zadania obejmującego wiele wystąpień w celu udostępnienia plików.
Startup	Ścieżka zadania podrzędnego uruchamiania.
VfsMounts	Ścieżka zawiera wszystkie wirtualne systemy plików są instalowane w tym węźle.
Task	Ścieżka zadania.
JobPrep	Ścieżka zadania przygotowania zadania.
Applications	Ścieżka aplikacji.

ContainerRegistryReference

Objekt

Prywatny rejestr kontenerów.

Nazwa	Typ	Opis
identityReference	BatchNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do usługi Azure Container Registry zamiast nazwy użytkownika i hasła.
password	string (password)	Hasło do logowania się na serwerze rejestru.
registryServer	string (uri)	Adres URL rejestru. W przypadku pominięcia wartość domyślna to "docker.io".
username	string	Nazwa użytkownika do logowania się na serwerze rejestru.

ContainerType

Wyliczenie

Enums ContainerType

Wartość	Opis
dockerCompatible	Technologia kontenera zgodna z platformą Docker będzie używana do uruchamiania kontenerów.
criCompatible	Technologia oparta na cri będzie używana do uruchamiania kontenerów.

ContainerWorkingDirectory

Wyliczenie

Enums ContainerWorkingDirectory

Wartość	Opis
taskWorkingDirectory	Użyj standardowego katalogu roboczygo Batch Service Task Task (Task Service Working Folder), który będzie zawierał pliki zasobów zadań wypełnione przez Batch.
containerImageDefault	Użyj katalogu roboczego zdefiniowanego w kontenerze Image. Należy pamiętać, że ten katalog nie będzie zawierał plików zasobów pobranych przez Batch.

DataDisk

Objekt

Ustawienia, które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z maszyny wirtualnej, aby ich używać.

Nazwa	Typ	Opis
caching	CachingType	Typ buforowania, który ma być włączony dla dysków danych. Wartość domyślna buforowania to readwrite. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer (int32)	Początkowy rozmiar dysku w gigabajtach.
lun	integer (int32)	Numer jednostki logicznej. Element logicalUnitNumber służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną wartość logicznąUnitNumber. Wartość musi należeć do przedziału od 0 do 63 włącznie.
managedDisk	ManagedDisk	Parametry dysku zarządzanego.
storageAccountType	StorageAccountType	Typ konta magazynu, który ma być używany dla dysku danych. W przypadku pominięcia wartość domyślna to "standard_lrs".

DiffDiskPlacement

Wyliczenie

Określa efemeryczne rozmieszczenie dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (VM) w puli. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, w której powinien znajdować się system operacyjny. np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku Ephemeral OS, prosimy zapoznać się z wymaganiami dotyczącymi rozmiaru dysku Ephemeral OS dla maszyn wirtualnych z Windows at i https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linuksa pod https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

Wartość	Opis
cachedisk	Efemeryczny dysk systemu operacyjnego jest przechowywany w pamięci podręcznej maszyny wirtualnej.

DiskCustomerManagedKey

Objekt

Odwołanie do klucza zarządzanego przez klienta w celu zaszyfrowania dysku.

Nazwa	Typ	Opis
identityReference	BatchPoolIdentityReference	Odwołanie do jednej z tożsamości puli w celu zaszyfrowania dysku. Ta tożsamość będzie używana do uzyskiwania dostępu do usługi KeyVault.
keyUrl	string	W pełni wersjonowany adres URL klucza wskazujący klucz w usłudze KeyVault. Segment wersji adresu URL jest wymagany niezależnie od wartości rotationToLatestKeyVersionEnabled.
rotationToLatestKeyVersionEnabled	boolean	Ustaw tę flagę na true, aby umożliwić automatyczną aktualizację szyfrowania dysku do najnowszej wersji klucza. Wartość domyślna to „false”.

DiskEncryptionConfiguration

Objekt

Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej za pomocą obrazu galerii obliczeń platformy Azure.

Nazwa	Typ	Opis
customerManagedKey	DiskCustomerManagedKey	Odwołanie do klucza zarządzanego przez klienta w celu zaszyfrowania dysku systemu operacyjnego. Klucz zarządzany przez klienta zaszyfruje dysk systemu operacyjnego za pomocą EncryptionAtRest, a domyślnie zaszyfrujemy również dysk danych. Można go używać tylko wtedy, gdy pula jest skonfigurowana przy użyciu tożsamości, a program OsDisk jest ustawiony jako jeden z obiektów docelowych programu DiskEncryption.
targets	DiskEncryptionTarget[]	Lista dysków docelowych obiektów docelowych usługi Batch zostanie zaszyfrowana w węźle obliczeniowym. Lista dysków docelowych obiektów docelowych usługi Batch zostanie zaszyfrowana w węźle obliczeniowym.

DiskEncryptionSetParameters

Objekt

Identyfikator zasobu usługi ARM zestawu szyfrowania dysku.

Nazwa	Typ	Opis
id	string (arm-id)	Identyfikator zasobu usługi ARM zestawu szyfrowania dysku. Zasób musi znajdować się w tej samej subskrypcji co konto usługi Batch.

DiskEncryptionTarget

Wyliczenie

Enumy DiskEncryptionTarget

Wartość	Opis
osdisk	Dysk systemu operacyjnego w węźle obliczeniowym jest szyfrowany.
temporarydisk	Dysk tymczasowy w węźle obliczeniowym jest szyfrowany. W systemie Linux to szyfrowanie ma zastosowanie do innych partycji (takich jak te na zainstalowanych dyskach danych), gdy szyfrowanie odbywa się w czasie rozruchu.

DynamicVNetAssignmentScope

Wyliczenie

Enums DynamicVNetAssignmentScope

Wartość	Opis
none	Nie włączono dynamicznego przypisania sieci wirtualnej.
job	Dynamiczne przypisywanie sieci wirtualnej jest wykonywane na zadanie.

ElevationLevel

Wyliczenie

Enumy ElevationLevel

Wartość	Opis
nonadmin	Użytkownik jest użytkownikiem standardowym bez podwyższonego poziomu dostępu.
admin	Użytkownik jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora.

EnvironmentSetting

Objekt

Zmienna środowiskowa, która ma być ustawiana w procesie zadania.

Nazwa	Typ	Opis
name	string	Nazwa zmiennej środowiskowej.
value	string	Wartość zmiennej środowiskowej.

HostEndpointSettings

Objekt

Określa określone ustawienia punktu końcowego hosta.

Nazwa	Typ	Opis
inVMAccessControlProfileReferenceId	string	Określa odwołanie do identyfikatora zasobu InVMAccessControlProfileVersion w postaci /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}.
mode	HostEndpointSettingsModeTypes	Określa tryb wykonywania zasad kontroli dostępu.

HostEndpointSettingsModeTypes

Wyliczenie

Enums HostEndpointSettingsModeTypes

Wartość	Opis
Audit	W trybie inspekcji system działa tak, jakby wymuszał zasady kontroli dostępu, w tym emitowanie wpisów odmowy dostępu w dziennikach, ale w rzeczywistości nie odmawia żadnych żądań do hostowania punktów końcowych.
Enforce	Tryb wymuszania jest zalecanym trybem działania, a system będzie egzekwował politykę kontroli dostępu. Ta właściwość nie może być używana razem z 'inVMAccessControlProfileReferenceId'.

InboundEndpointProtocol

Wyliczenie

Enums InboundEndpointProtocol

Wartość	Opis
tcp	Użyj protokołu TCP dla punktu końcowego.
udp	Użyj protokołu UDP dla punktu końcowego.

IpAddressProvisioningType

Wyliczenie

IPAddressProvisioningType enums

Wartość	Opis
batchmanaged	Publiczny adres IP zostanie utworzony i zarządzany przez usługę Batch. W zależności od rozmiaru puli może istnieć wiele publicznych adresów IP.
usermanaged	Publiczne adresy IP są udostępniane przez użytkownika i będą używane do aprowizowania węzłów obliczeniowych.
nopublicipaddresses	Nie zostanie utworzony żaden publiczny adres IP.

IPFamily

Wyliczenie

Rodziny adresów IP używane do określania wersji adresów IP dostępnych w puli.

Wartość	Opis
IPv4	IPv4 jest dostępne w tej grupie.
IPv6	IPv6 jest dostępny w tej grupie.

IPTag

Objekt

Zawiera tag IP skojarzony z publicznym adresem IP.

Nazwa	Typ	Opis
ipTagType	string	Typ tagu adresu IP. Przykład: FirstPartyUsage.
tag	string	Wartość tagu IP skojarzonego z publicznym adresem IP. Przykład: SQL.

LinuxUserConfiguration

Objekt

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux.

Nazwa	Typ	Opis
gid	integer (int32)	Identyfikator grupy dla konta użytkownika. Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid.
sshPrivateKey	string (password)	Prywatny klucz SSH do konta użytkownika. Klucz prywatny nie może być chroniony hasłem. Klucz prywatny służy do automatycznej konfiguracji uwierzytelniania SSH opartego na kluczu asymetrycznym pomiędzy węzłami obliczeniowymi w puli Linuksa, gdy właściwość puli enableInterNodeCommunication jest prawdziwa (jest ignorowana, jeśli enableInterNodeCommunication jest fałszywa). Robi to przez umieszczenie pary kluczy w katalogu .ssh użytkownika. Jeśli nie jest to określone, SSH bez hasła nie jest konfigurowane pomiędzy węzłami obliczeniowymi (nie ma żadnych modyfikacji katalogu .ssh użytkownika).
uid	integer (int32)	ID użytkownika konta użytkownika. Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid.

LoginMode

Wyliczenie

Enumy LoginMode

Wartość

Opis

batch

Tryb logowania LOGON32_LOGON_BATCH Win32. Tryb logowania wsadowego jest zalecany w przypadku długotrwałych procesów równoległych.

interactive

Tryb logowania LOGON32_LOGON_INTERACTIVE Win32. UAC jest włączone w Windows VirtualMachineConfiguration Pools. Jeśli ta opcja jest używana z podwyższoną tożsamością użytkownika w WirtualMachineConfiguration Pool Windows, sesja użytkownika nie zostanie podniesiona, chyba że aplikacja wykonywana przez wiersz poleceń Zadania jest skonfigurowana tak, aby zawsze wymagała uprawnień administratorskich lub maksymalnie wymagała.

ManagedDisk

Objekt

Parametry dysku zarządzanego.

Nazwa	Typ	Opis
diskEncryptionSet	DiskEncryptionSetParameters	Określa identyfikator zasobu zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta dla dysku zarządzanego. Można go ustawić tylko w trybie UserSubscription.
securityProfile	BatchVmDiskSecurityProfile	Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego.
storageAccountType	StorageAccountType	Typ konta magazynu dla dysku zarządzanego.

MountConfiguration

Objekt

System plików do zainstalowania w każdym węźle.

Nazwa	Typ	Opis
azureBlobFileSystemConfiguration	AzureBlobFileSystemConfiguration	Kontener usługi Azure Storage do zainstalowania przy użyciu funkcji FUSE obiektu blob w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami.
azureFileShareConfiguration	AzureFileShareConfiguration	Udział plików platformy Azure do zainstalowania w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami.
cifsMountConfiguration	CifsMountConfiguration	System plików CIFS/SMB do zainstalowania w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami.
nfsMountConfiguration	NfsMountConfiguration	System plików NFS do zainstalowania w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami.

NetworkConfiguration

Objekt

Konfiguracja sieci dla puli.

Nazwa	Typ	Opis
dynamicVNetAssignmentScope	DynamicVNetAssignmentScope	Zakres dynamicznego przypisania sieci wirtualnej.
enableAcceleratedNetworking	boolean	Czy ta pula powinna włączyć przyspieszoną sieć. Przyspieszona sieć umożliwia wirtualizację we/wy pojedynczego katalogu głównego (SR-IOV) do maszyny wirtualnej, co może prowadzić do zwiększenia wydajności sieci. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration	BatchPoolEndpointConfiguration	Konfiguracja punktów końcowych na węzłach obliczeniowych w puli wsadowej.
publicIPAddressConfiguration	BatchPublicIpAddressConfiguration	Konfiguracja publicznego adresu IPAddress dla węzłów obliczeniowych w puli usługi Batch.
subnetId	string	Identyfikator zasobu ARM podsieci wirtualnej sieci, do którego dołączają węzły obliczeniowe puli. Jest to formularz /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Wskazana podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów obliczeniowych w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (RBAC) dla określonej sieci wirtualnej. Wskazana podsieć musi umożliwiać komunikację z usługą Azure Batch, aby umożliwić planowanie zadań na węzłach. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Obsługiwane są tylko wirtualne sieci ARM ("Microsoft.Network/virtualNetworks"). Jeśli określony VNet posiada powiązane grupy bezpieczeństwa sieciowego (NSG), należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej, w tym porty 29876 i 29877. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Objekt

Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego.

Nazwa	Typ	Opis
access	NetworkSecurityGroupRuleAccess	Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.
priority	integer (int32)	Priorytet tej reguły. Priorytety w puli muszą być unikalne i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła z numerem porządkowym 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
sourceAddressPrefix	string	Prefiks adresu źródłowego lub tag, który ma być zgodny z regułą. Prawidłowe wartości to pojedynczy adres IP (tj. 10.10.10.10.10), podsieć IP (tj. 192.168.1.0/24), tag domyślny lub * (dla wszystkich adresów). Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
sourcePortRanges	string[]	Zakresy portów źródłowych zgodne z regułą. Poprawne wartości to '' (dla wszystkich portów 0 - 65535), konkretny port (np. 22) lub zakres portów (np. 100-200). Porty muszą mieścić się w zakresie od 0 do 65535. Każdy wpis w tej kolekcji nie może nakładać się na żaden inny wpis (ani zakres, ani pojedynczy port). Jeśli podane są inne wartości, żądanie kończy się niepowodzeniem z kodem statusowym HTTP 400. Domyślna wartość to "".

NetworkSecurityGroupRuleAccess

Wyliczenie

Enumy NetworkSecurityGroupRuleAccess

Wartość	Opis
allow	Zezwalaj na dostęp.
deny	Odmowa dostępu.

NfsMountConfiguration

Objekt

Informacje używane do nawiązywania połączenia z systemem plików NFS.

Nazwa	Typ	Opis
mountOptions	string	Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux.
relativeMountPath	string	Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.
source	string	Identyfikator URI systemu plików do zainstalowania.

ProxyAgentSettings

Objekt

Określa ustawienia proxyAgent podczas tworzenia maszyny wirtualnej.

Nazwa	Typ	Opis
enabled	boolean	Określa, czy funkcja protokołu Metadata Security Protocol powinna być włączona na maszynie wirtualnej, czy w zestawie skalowania maszyn wirtualnych. Wartość domyślna to False.
imds	HostEndpointSettings	Ustawienia punktu końcowego IMDS.
wireServer	HostEndpointSettings	Ustawienia punktu końcowego WireServer.

ResourceFile

Objekt

Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.

Nazwa	Typ	Opis
autoStorageContainerName	string	Nazwa kontenera magazynowego w konto automatycznego przechowywania. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich.
blobPrefix	string	Prefiks obiektu blob używany podczas pobierania obiektów blob z kontenera usługi Azure Storage. Zostaną pobrane tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu. Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, zostaną pobrane wszystkie pliki w kontenerze.
fileMode	string	Atrybut trybu uprawnień pliku w formacie ósemkowym. Ta właściwość dotyczy tylko plików pobieranych do Linux Compute Nodes. Zostanie zignorowany, jeśli jest określony dla pliku zasobów, który zostanie pobrany do węzła obliczeń Windows. Jeśli ta właściwość nie jest określona dla węzła obliczeniowego Linuksa, do pliku przypisywana jest domyślna wartość 0770.
filePath	string	Lokalizacja na węźle obliczeniowym, do której należy pobrać plik(y), względem katalogu roboczego zadania. Jeśli określono właściwość httpUrl, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy filePath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może wyjść z katalogu roboczego zadania (na przykład używając '..').
httpUrl	string (uri)	Adres URL pliku do pobrania. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL wskazuje usługę Azure Blob Storage, musi być czytelny z węzłów obliczeniowych. Istnieją trzy sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob, używanie tożsamości zarządzanej z uprawnieniami do odczytu lub ustawianie listy ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.
identityReference	BatchNodeIdentityReference	Odniesienie do tożsamości przypisanej przez użytkownika do dostępu do Azure Blob Storage określone przez storageContainerUrl lub httpUrl.
storageContainerUrl	string (uri)	Adres URL kontenera obiektów blob w usłudze Azure Blob Storage. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia z węzłów obliczeniowych. Istnieją trzy sposoby uzyskania takiego adresu URL dla kontenera w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego (SAS) udzielając uprawnień do odczytu i listy w kontenerze, używanie tożsamości zarządzanej z uprawnieniami do odczytu i listy lub ustawianie listy ACL dla kontenera, aby zezwolić na dostęp publiczny.

RollingUpgradePolicy

Objekt

Parametry konfiguracji używane podczas uaktualniania stopniowego.

Nazwa	Typ	Opis
enableCrossZoneUpgrade	boolean	Zezwalaj usłudze VMSS na ignorowanie granic az podczas konstruowania partii uaktualniania. Weź pod uwagę domenę aktualizacji i parametr maxBatchInstancePercent w celu określenia rozmiaru partii. To pole może być ustawione na wartość true lub false tylko w przypadku używania wartości NodePlacementConfiguration jako strefowej.
maxBatchInstancePercent	integer (int32)	Maksymalny procent łącznych wystąpień maszyn wirtualnych, które zostaną uaktualnione jednocześnie przez uaktualnienie stopniowe w jednej partii. Ponieważ jest to maksimum, wystąpienia w złej kondycji w poprzednich lub przyszłych partiach mogą spowodować spadek procentu wystąpień w partii w celu zapewnienia większej niezawodności. Wartość tego pola powinna należeć do zakresu od 5 do 100 włącznie. Jeśli parametr maxBatchInstancePercent i maxUnhealthyInstancePercent są przypisywane z wartością, wartość maxBatchInstancePercent nie powinna być większa niż wartość maxUnhealthyInstancePercent.
maxUnhealthyInstancePercent	integer (int32)	Maksymalny procent łącznej liczby wystąpień maszyn wirtualnych w zestawie skalowania, które mogą być jednocześnie w złej kondycji, w wyniku uaktualnienia lub przez odnalezienie w stanie złej kondycji przez kontrolę kondycji maszyny wirtualnej przed przerwaniem uaktualnienia stopniowego. To ograniczenie zostanie sprawdzone przed uruchomieniem dowolnej partii. Wartość tego pola powinna należeć do zakresu od 5 do 100 włącznie. Jeśli parametr maxBatchInstancePercent i maxUnhealthyInstancePercent są przypisywane z wartością, wartość maxBatchInstancePercent nie powinna być większa niż wartość maxUnhealthyInstancePercent.
maxUnhealthyUpgradedInstancePercent	integer (int32)	Maksymalny procent uaktualnionych wystąpień maszyn wirtualnych, które można znaleźć w złej kondycji. Ta kontrola będzie miała miejsce po uaktualnieniu każdej partii. Jeśli ta wartość procentowa zostanie kiedykolwiek przekroczona, przerywa się aktualizacja stopniowa. Wartość tego pola powinna należeć do zakresu od 0 do 100 włącznie.
pauseTimeBetweenBatches	string (duration)	Czas oczekiwania między ukończeniem aktualizacji dla wszystkich maszyn wirtualnych w jednej partii a uruchomieniem następnej partii. Czas trwania należy określić w formacie ISO 8601.
prioritizeUnhealthyInstances	boolean	Uaktualnij wszystkie wystąpienia w złej kondycji w zestawie skalowania przed wszelkimi wystąpieniami w dobrej kondycji.
rollbackFailedInstancesOnPolicyBreach	boolean	Wycofywanie nie powiodło się wystąpienia do poprzedniego modelu, jeśli zasady uaktualniania stopniowego zostały naruszone.

SecurityEncryptionTypes

Wyliczenie

Enumy SecurityEncryptionTypes

Wartość	Opis
DiskWithVMGuestState	EncryptionType dysku zarządzanego jest ustawiony na DiskWithVMGuestState na potrzeby szyfrowania dysku zarządzanego wraz z obiektem blob VMGuestState. Nie jest obsługiwany w dyskach danych.
NonPersistedTPM	EncryptionType dysku zarządzanego jest ustawiony na NonPersistedTPM, aby nie utrwalać stanu oprogramowania układowego w obiekcie blob VMGuestState.
VMGuestStateOnly	EncryptionType dysku zarządzanego jest ustawiony na VMGuestStateOnly w celu szyfrowania tylko obiektu blob VMGuestState.

SecurityProfile

Objekt

Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.

Nazwa	Typ	Opis
encryptionAtHost	boolean	Ta właściwość może być używana przez użytkownika w żądaniu włączenia lub wyłączenia szyfrowania hosta dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. Spowoduje to włączenie szyfrowania dla wszystkich dysków, w tym dysku zasobu/tymczasowego na samym hoście. Aby uzyskać więcej informacji na temat szyfrowania w wymaganiach dotyczących hosta, zobacz https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes.
proxyAgentSettings	ProxyAgentSettings	Określa ustawienia proxyAgent podczas tworzenia maszyny wirtualnej.
securityType	SecurityTypes	Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs UefiSettings.
uefiSettings	BatchUefiSettings	Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej. Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej.

SecurityTypes

Wyliczenie

Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs UefiSettings.

Wartość

Opis

trustedLaunch

Zaufane uruchamianie chroni przed zaawansowanymi i trwałymi technikami ataków.

confidentialvm

Poufne przetwarzanie na platformie Azure oferuje poufne maszyny wirtualne przeznaczone dla dzierżaw z wysokimi wymaganiami dotyczącymi zabezpieczeń i poufności. Te maszyny wirtualne zapewniają silną, wymuszaną sprzętowo granicę, która pomaga spełnić twoje potrzeby w zakresie zabezpieczeń. Możesz użyć poufnych maszyn wirtualnych do migracji bez wprowadzania zmian w kodzie, a platforma chroni stan maszyny wirtualnej przed odczytem lub zmodyfikowaniem.

ServiceArtifactReference

Objekt

Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania w przypadku używania "najnowszej" wersji obrazu.

Nazwa	Typ	Opis
id	string	Identyfikator referencyjny artefaktu serwisowego ServiceArtifactReference. Identyfikator odwołania artefaktu usługi w postaci /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StorageAccountType

Wyliczenie

Wyliczenia StorageAccountType

Wartość	Opis
standard_lrs	Dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego.
premium_lrs	Dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.
standardssd_lrs	Dysk danych/dysk systemu operacyjnego powinien używać magazynu lokalnie nadmiarowego SSD w warstwie Standardowa.

UpgradeMode

Wyliczenie

Enumy UpgradeMode

Wartość	Opis
automatic	Wszystkie maszyny wirtualne w zestawie skalowania są automatycznie aktualizowane w tym samym czasie.
manual	Kontrolujesz stosowanie aktualizacji do maszyn wirtualnych w zestawie skalowania. W tym celu należy użyć akcji manualUpgrade.
rolling	Istniejące wystąpienia w zestawie skalowania są wyłączane w partiach, które mają zostać uaktualnione. Po zakończeniu uaktualniania partii wystąpienia zaczną ponownie kierować ruch, a następna partia rozpocznie się. Będzie to kontynuowane do momentu, aż wszystkie wystąpienia up-to-date.

UpgradePolicy

Objekt

Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.

Nazwa	Typ	Opis
automaticOSUpgradePolicy	AutomaticOsUpgradePolicy	Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego. Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego.
mode	UpgradeMode	Określa tryb uaktualniania maszyn wirtualnych w zestawie skalowania. Dopuszczalne wartości: ręczne — kontrolujesz stosowanie aktualizacji do maszyn wirtualnych w zestawie skalowania. W tym celu należy użyć akcji manualUpgrade. automatyczne — wszystkie maszyny wirtualne w zestawie skalowania są automatycznie aktualizowane w tym samym czasie. rolling — zestaw skalowania wykonuje aktualizacje w partiach z opcjonalnym czasem wstrzymania między.
rollingUpgradePolicy	RollingUpgradePolicy	Parametry konfiguracji używane podczas uaktualniania stopniowego.

UserAccount

Objekt

Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym usługi Azure Batch.

Nazwa	Typ	Opis
elevationLevel	ElevationLevel	Poziom wysokości konta użytkownika. Wartość domyślna to nonAdmin.
linuxUserConfiguration	LinuxUserConfiguration	Specyficzna dla Linuksa konfiguracja użytkownika dla konta użytkownika. Ta właściwość jest ignorowana, jeśli jest określona w puli Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych.
name	string	Nazwa konta użytkownika. Nazwy mogą zawierać dowolne znaki Unicode o maksymalnej długości do 20.
password	string (password)	Hasło do konta użytkownika.
windowsUserConfiguration	WindowsUserConfiguration	Specyficzna dla Windows konfiguracja użytkownika dla konta użytkownika. Ta właściwość może być określona tylko wtedy, gdy użytkownik korzysta z puli Windows. Jeśli nie jest to określone i korzysta z puli Windows, użytkownik jest tworzony z domyślnymi opcjami.

UserIdentity

Objekt

Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie. Określ właściwość userName lub autoUser, ale nie obie.

Nazwa	Typ	Opis
autoUser	AutoUserSpecification	Użytkownik automatyczny, pod którym uruchamiane jest zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.
username	string	Nazwa tożsamości użytkownika, pod którą wykonywane jest zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.

VirtualMachineConfiguration

Objekt

Konfiguracja węzłów obliczeniowych w puli oparta na infrastrukturze usługi Azure Virtual Machines.

Nazwa	Typ	Opis
containerConfiguration	BatchContainerConfiguration	Konfiguracja kontenera dla Pool. Jeśli jest to wskazane, konfiguracja jest przeprowadzana na każdym węźle obliczeniowym w puli, aby umożliwić wykonywanie zadań w kontenerach. Wszystkie zwykłe zadania i zadania menedżera zadań wykonywane na tej puli muszą określać właściwość containerSettings, a wszystkie pozostałe zadania mogą ją określać.
dataDisks	DataDisk[]	Konfiguracja dla dysków danych dołączonych do węzłów obliczeniowych w puli. Ta właściwość musi być określona, jeśli węzły obliczeniowe w puli muszą mieć do siebie dołączone puste dyski danych. Nie można tego zaktualizować. Każdy węzeł obliczeniowy otrzymuje własny dysk (dysk nie jest współdzielonym plikiem). Istniejące dyski nie mogą być podłączone, każda podłączona dyska jest pusta. Gdy węzeł obliczeniowy zostaje usunięty z puli, dysk i wszystkie z nim powiązane dane również zostają usunięte. Dysk nie jest sformatowany po dołączeniu, musi być sformatowany przed użyciem – więcej informacji można znaleźć w zobacz https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux i https://learn.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.
diskEncryptionConfiguration	DiskEncryptionConfiguration	Konfiguracja szyfrowania dysków dla puli. Jeśli określono, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzłów.
extensions	VMExtension[]	Rozszerzenie maszyny wirtualnej dla puli. Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane w każdym węźle.
imageReference	BatchVmImageReference	Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub niestandardowego obrazu maszyny wirtualnej do użycia.
licenseType	string	Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinno być używane tylko wtedy, gdy posiadasz ważne licencje lokalne dla węzłów obliczeniowych, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows.
nodeAgentSKUId	string	Jednostka SKU agenta węzła obliczeniowego usługi Batch do aprowizacji w węzłach obliczeniowych w puli. Agent węzła obliczeniowego usługi Batch to program uruchamiany w każdym węźle obliczeniowym w puli i udostępnia interfejs polecenia i sterowania między węzłem obliczeniowym a usługą Batch. Istnieją różne implementacje agenta węzła obliczeniowego nazywanego jednostkami SKU dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła obliczeniowego zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła obliczeniowego wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła obliczeniowego".
nodePlacementConfiguration	BatchNodePlacementConfiguration	Konfiguracja umieszczania węzła dla puli. Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli.
osDisk	BatchOsDisk	Ustawienia dysku systemu operacyjnego maszyny wirtualnej.
securityProfile	SecurityProfile	Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.
serviceArtifactReference	ServiceArtifactReference	Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania w przypadku używania "najnowszej" wersji obrazu. Identyfikator odwołania artefaktu usługi w postaci /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}
windowsConfiguration	WindowsConfiguration	Ustawienia systemu operacyjnego Windows na maszynie wirtualnej. Ta właściwość nie może być określana, jeśli właściwość imageReference określa obraz systemu Linux OS.

VMExtension

Objekt

Konfiguracja rozszerzeń maszyn wirtualnych.

Nazwa	Typ	Opis
autoUpgradeMinorVersion	boolean	Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.
enableAutomaticUpgrade	boolean	Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia.
name	string	Nazwa rozszerzenia maszyny wirtualnej.
protectedSettings	object	Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.
provisionAfterExtensions	string[]	Kolekcja nazw rozszerzeń. Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie.
publisher	string	Nazwa wydawcy programu obsługi rozszerzeń.
settings	object	Ustawienia publiczne w formacie JSON dla rozszerzenia.
type	string	Rodzaj przedłużenia.
typeHandlerVersion	string	Wersja programu obsługi skryptów.

WindowsConfiguration

Objekt

Ustawienia systemu operacyjnego Windows, które mają być stosowane do maszyny wirtualnej.

Nazwa	Typ	Opis
enableAutomaticUpdates	boolean	Określa, czy aktualizacje automatyczne są włączone na maszynie wirtualnej. W przypadku pominięcia wartość domyślna to true.

WindowsUserConfiguration

Objekt

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Windows.

Nazwa	Typ	Opis
loginMode	LoginMode	Tryb logowania dla użytkownika. Domyślnie to "partia".

Udostępnij przez

Pools - Create Pool

Parametry identyfikatora URI

Nagłówek żądania

Treść żądania

Odpowiedzi

Zabezpieczenia

OAuth2Auth

Zakresy

Przykłady

Creates a pool with accelerated networking

Przykładowe żądanie

Przykładowa odpowiedź

Creates a pool with confidential disk encryption set for user subscription accounts

Przykładowe żądanie

Przykładowa odpowiedź

Creates a pool with disk encryption set for user subscription accounts

Przykładowe żądanie

Przykładowa odpowiedź

Creates a pool with dual stack networking

Przykładowe żądanie

Przykładowa odpowiedź

Creates a pool with mount drive specified

Przykładowe żądanie

Przykładowa odpowiedź

Creates a pool with SecurityProfile

Przykładowe żądanie

Przykładowa odpowiedź

Creates a VirtualMachineConfiguration pool

Przykładowe żądanie

Przykładowa odpowiedź

Creates a VirtualMachineConfiguration pool with containers

Przykładowe żądanie

Przykładowa odpowiedź

Creates a VirtualMachineConfiguration pool with extensions

Przykładowe żądanie

Przykładowa odpowiedź

Creates a VirtualMachineConfiguration pool with OS disk

Przykładowe żądanie

Przykładowa odpowiedź

Creates a VirtualMachineConfiguration pool with ServiceArtifactReference

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AutomaticOsUpgradePolicy

AutoUserScope

AutoUserSpecification

AzureBlobFileSystemConfiguration

AzureFileShareConfiguration

BatchApplicationPackageReference

BatchContainerConfiguration

BatchDiffDiskSettings

BatchError

BatchErrorDetail

BatchErrorMessage

BatchInboundNatPool

BatchJobDefaultOrder

BatchMetadataItem

BatchNodeFillType

BatchNodeIdentityReference

BatchNodePlacementConfiguration

BatchNodePlacementPolicyType

BatchOsDisk

BatchPoolCreateOptions

BatchPoolEndpointConfiguration

BatchPoolIdentityReference

BatchPublicIpAddressConfiguration

BatchStartTask

BatchTaskContainerSettings

BatchTaskSchedulingPolicy

BatchUefiSettings

BatchVmDiskSecurityProfile

BatchVmImageReference

CachingType

CifsMountConfiguration

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistryReference

ContainerType

ContainerWorkingDirectory