Pools - Create Pool

Dienst:: Batch Service

API-Version:: 2025-06-01

Erstellt einen Pool für das angegebene Konto.
Vermeiden Sie beim Benennen von Pools vertrauliche Informationen wie Benutzernamen oder geheime Projektnamen. Diese Informationen können in Telemetrieprotokollen angezeigt werden, auf die microsoft-Supporttechniker zugreifen können.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Batchkontoendpunkt (z. B. https://batchaccount.eastus2.batch.azure.com).
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
timeOut	query		integer (int32)	Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden ausgeben kann. Der Standardwert ist 30 Sekunden. Ist der Wert größer als 30, wird stattdessen der Standard verwendet."

Anforderungsheader

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

Name	Typ	Beschreibung
client-request-id	string	Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Gibt an, ob der Server die Clientanforderungs-ID in der Antwort zurückgeben soll.
ocp-date	string (date-time-rfc7231)	Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. legen Sie sie explizit fest, wenn Sie die REST-API direkt aufrufen.

Anforderungstext

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

Name	Erforderlich	Typ	Beschreibung
id	True	string	Eine Zeichenfolge, die den Pool innerhalb des Kontos eindeutig identifiziert. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie verfügen möglicherweise nicht über zwei Pool-IDs innerhalb eines Kontos, die sich nur nach Groß-/Kleinschreibung unterscheiden).
vmSize	True	string	Die Größe virtueller Computer im Pool. Alle virtuellen Computer in einem Pool haben die gleiche Größe. Informationen zu den verfügbaren VM-Größen für Pools, die Images aus dem Virtual Machines Marketplace verwenden (Pools, die mit virtualMachineConfiguration erstellt wurden), finden Sie unter Größen für virtuelle Computer in Azure (https://v4.hkg1.meaqua.org/azure/virtual-machines/sizes/overview). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).
applicationPackageReferences		BatchApplicationPackageReference[]	Die Liste der Pakete, die auf jedem Computeknoten im Pool installiert werden sollen. Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Änderungen an Paketverweise wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt wurden. Es gibt maximal 10 Paketverweise für einen bestimmten Pool.
autoScaleEvaluationInterval		string (duration)	Das Zeitintervall, in dem die Poolgröße automatisch entsprechend der Autoskalenformel angepasst werden soll. Der Standardwert beträgt 15 Minuten. Der Mindest- und Maximalwert beträgt 5 Minuten bzw. 168 Stunden. Wenn Sie einen Wert angeben, der kleiner als 5 Minuten oder größer als 168 Stunden ist, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).
autoScaleFormula		string	Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "false" festgelegt ist. Es ist erforderlich, wenn enableAutoScale auf "true" festgelegt ist. Die Formel wird vor der Erstellung des Pools auf Gültigkeit überprüft. Wenn die Formel ungültig ist, lehnt der Batchdienst die Anforderung mit detaillierten Fehlerinformationen ab. Weitere Informationen zum Angeben dieser Formel finden Sie unter "Automatisches Skalieren von Computeknoten in einem Azure-Batchpool" (https://v4.hkg1.meaqua.org/azure/batch/batch-automatic-scaling).
displayName		string	Der Anzeigename für den Pool. Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten.
enableAutoScale		boolean	Gibt an, ob die Poolgröße im Laufe der Zeit automatisch angepasst werden soll. Wenn false, muss mindestens eine der targetDedicatedNodes und targetLowPriorityNodes angegeben werden. Bei "true" ist die AutoScaleFormula-Eigenschaft erforderlich, und der Pool ändert die Größe automatisch entsprechend der Formel. Der Standardwert ist "false".
enableInterNodeCommunication		boolean	Gibt an, ob der Pool die direkte Kommunikation zwischen Computeknoten zulässt. Das Aktivieren der Kommunikation zwischen Knoten begrenzt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen auf den Computeknoten des Pools. Dies kann dazu führen, dass der Pool seine gewünschte Größe nicht erreicht. Der Standardwert ist "false".
metadata		BatchMetadataItem[]	Eine Liste von Name-Wert-Paaren, die dem Pool als Metadaten zugeordnet sind. Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.
mountConfiguration		MountConfiguration[]	Bereitstellen des Speichers mithilfe des angegebenen Dateisystems für die gesamte Lebensdauer des Pools. Binden Sie den Speicher mithilfe eines Azure-Dateifreigabe-, NFS-, CIFS- oder Blobfuse-basierten Dateisystems ein.
networkConfiguration		NetworkConfiguration	Die Netzwerkkonfiguration für den Pool.
resizeTimeout		string (duration)	Das Timeout für die Zuordnung von Computeknoten zum Pool. Dieses Timeout gilt nur für die manuelle Skalierung; es hat keine Auswirkung, wenn enableAutoScale auf "true" festgelegt ist. Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).
startTask		BatchStartTask	Eine Aufgabe, die für jeden Computeknoten ausgeführt werden soll, während er dem Pool beitritt. Die Aufgabe wird ausgeführt, wenn der Computeknoten dem Pool hinzugefügt wird oder wenn der Computeknoten neu gestartet wird.
targetDedicatedNodes		integer (int32)	Die gewünschte Anzahl dedizierter Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
targetLowPriorityNodes		integer (int32)	Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
taskSchedulingPolicy		BatchTaskSchedulingPolicy	Wie Aufgaben über Computeknoten in einem Pool verteilt werden. Wenn nicht angegeben, wird die Standardeinstellung verteilt.
taskSlotsPerNode		integer (int32)	Die Anzahl von Taskslots, die verwendet werden können, um gleichzeitige Tasks auf einem einzelnen Computeknoten im Pool auszuführen. Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256.
upgradePolicy		UpgradePolicy	Die Upgraderichtlinie für den Pool. Beschreibt eine Upgraderichtlinie – automatisch, manuell oder rolliert.
userAccounts		UserAccount[]	Die Liste der Benutzerkonten, die auf jedem Computeknoten im Pool erstellt werden sollen.
virtualMachineConfiguration		VirtualMachineConfiguration	Die Konfiguration des virtuellen Computers für den Pool. Diese Eigenschaft muss angegeben werden.

Antworten

Name	Typ	Beschreibung
201 Created		Die Anforderung ist erfolgreich und eine neue Ressource wurde als Ergebnis erstellt. Header DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

201 Created

Die Anforderung ist erfolgreich und eine neue Ressource wurde als Ergebnis erstellt.

Header

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

Other Status Codes

BatchError

Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name	Beschreibung
https://batch.core.windows.net//.default

Beispiele

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 201

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

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a pool with disk encryption set for user subscription accounts

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a pool with dual stack networking

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a pool with mount drive specified

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a pool with SecurityProfile

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a VirtualMachineConfiguration pool

Beispielanforderung

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"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a VirtualMachineConfiguration pool with containers

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a VirtualMachineConfiguration pool with extensions

Beispielanforderung

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"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a VirtualMachineConfiguration pool with OS disk

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Creates a VirtualMachineConfiguration pool with ServiceArtifactReference

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:: 201

Definitionen

Name	Beschreibung
AutomaticOsUpgradePolicy	Die Konfigurationsparameter, die zum Ausführen eines automatischen Betriebssystemupgrades verwendet werden.
AutoUserScope	AutoUserScope-Enums
AutoUserSpecification	Gibt die Optionen für den automatischen Benutzer an, der eine Azure-Batchaufgabe ausführt.
AzureBlobFileSystemConfiguration	Informationen, die zum Herstellen einer Verbindung mit einem Azure Storage-Container mithilfe von Blobfuse verwendet werden.
AzureFileShareConfiguration	Informationen, die zum Herstellen einer Verbindung mit einer Azure Fileshare verwendet werden.
BatchApplicationPackageReference	Ein Verweis auf ein Paket, das auf Computeknoten bereitgestellt werden soll.
BatchContainerConfiguration	Die Konfiguration für containerfähige Pools.
BatchDiffDiskSettings	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom Computeknoten (VM) verwendet wird.
BatchError	Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.
BatchErrorDetail	Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.
BatchErrorMessage	Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.
BatchInboundNatPool	Ein eingehender NAT-Pool, der verwendet werden kann, um bestimmte Ports auf Computeknoten in einem Batchpool extern zu adressieren.
BatchJobDefaultOrder	BatchJobDefaultOrder-Enums
BatchMetadataItem	Der Batchdienst weist diesen Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.
BatchNodeFillType	BatchNodeFillType Enume
BatchNodeIdentityReference	Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.
BatchNodePlacementConfiguration	Für die regionale Platzierung werden Knoten im Pool in derselben Region zugewiesen. Bei der Platzierung von Zonen werden Knoten im Pool über verschiedene Zonen verteilt, wobei der Best-Effort-Ausgleich erfolgt.
BatchNodePlacementPolicyType	BatchNodePlacementPolicyType Enume
BatchOsDisk	Einstellungen für den Betriebssystemdatenträger des Computeknotens (VM).
BatchPoolCreateOptions	Parameter zum Erstellen eines Azure-Batchpools.
BatchPoolEndpointConfiguration	Die Endpunktkonfiguration für einen Pool.
BatchPoolIdentityReference	Die Referenz einer der Poolidentitäten zum Verschlüsseln des Datenträgers. Diese Identität wird für den Zugriff auf den Schlüsseltresor verwendet.
BatchPublicIpAddressConfiguration	Die konfiguration der öffentlichen IP-Adresse der Netzwerkkonfiguration eines Pools.
BatchStartTask	Batch wiederholt Aufgaben, wenn ein Wiederherstellungsvorgang auf einem Knoten ausgelöst wird. Beispiele für Wiederherstellungsvorgänge sind (aber nicht beschränkt darauf), wenn ein fehlerhafter Knoten neu gestartet wird oder ein Computeknoten aufgrund eines Hostfehlers verschwunden ist. Wiederholungen aufgrund von Wiederherstellungsvorgängen sind unabhängig von und werden nicht für das maxTaskRetryCount gezählt. Auch wenn das maxTaskRetryCount 0 ist, kann ein interner Wiederholungsversuch aufgrund eines Wiederherstellungsvorgangs auftreten. Aus diesem Gründen sollten alle Aufgaben idempotent sein. Dies bedeutet, dass Aufgaben unterbrochen und neu gestartet werden müssen, ohne dass Beschädigte oder doppelte Daten verursacht werden. Die bewährte Methode für lange ausgeführte Aufgaben besteht darin, eine Form der Prüfpunkterstellung zu verwenden. In einigen Fällen kann der StartTask erneut ausgeführt werden, obwohl der Computeknoten nicht neu gestartet wurde. Es sollte besonders darauf geachtet werden, startTasks zu vermeiden, die Unterbrechungsvorgang erstellen oder Dienste aus dem StartTask-Arbeitsverzeichnis installieren/starten, da dadurch verhindert wird, dass Batch die StartTask erneut ausführen kann.
BatchTaskContainerSettings	Die Containereinstellungen für eine Aufgabe.
BatchTaskSchedulingPolicy	Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen.
BatchUefiSettings	Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden.
BatchVmDiskSecurityProfile	Gibt die Sicherheitsprofileinstellungen für den verwalteten Datenträger an. Hinweis: Er kann nur für vertrauliche VMs festgelegt werden und ist erforderlich, wenn vertrauliche VMs verwendet werden.
BatchVmImageReference	Ein Verweis auf ein Azure Virtual Machines Marketplace Image oder ein Azure Compute Gallery Image. Informationen zum Abrufen der Liste aller azure Marketplace-Imageverweise, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Unterstützte Bilder auflisten".
CachingType	CachingType Enums
CifsMountConfiguration	Informationen, die zum Herstellen einer Verbindung mit einem CIFS-Dateisystem verwendet werden.
ContainerHostBatchBindMountEntry	Der Eintrag des Pfad- und Bereitstellungsmodus, den Sie in Aufgabencontainer bereitstellen möchten.
ContainerHostDataPath	Die Pfade, die im Container der Containeraufgabe bereitgestellt werden.
ContainerRegistryReference	Eine private Containerregistrierung.
ContainerType	ContainerType Enums
ContainerWorkingDirectory	ContainerWorkingDirectory-Enums
DataDisk	Einstellungen, die von den Datenträgern verwendet werden, die Computeknoten im Pool zugeordnet sind. Wenn Sie angefügte Datenträger verwenden, müssen Sie die Datenträger innerhalb einer VM bereitstellen und formatieren, um sie zu verwenden.
DiffDiskPlacement	Spezifiziert die ephemere Festplattenplatzierung für Betriebssystem-Festplatte für alle Rechenknoten (VMs) im Pool. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um auszuwählen, an welchem Speicherort sich das Betriebssystem befinden soll. z. B. Cachespeicherplatz für ephemerale Betriebssystemdatenträgerbereitstellung. Für weitere Informationen zu den Anforderungen an die Festplattengröße des Ephemeral OS siehe bitte die Anforderungen an die Festplattengröße des Ephemeral OS für Windows-VMs bei und https://v4.hkg1.meaqua.org/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linux-VMs unter https://v4.hkg1.meaqua.org/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements
DiskCustomerManagedKey	Die Referenz zum vom Kunden verwalteten Schlüssel zum Verschlüsseln des Datenträgers.
DiskEncryptionConfiguration	Die Auf Computeknoten im Pool angewendete Datenträgerverschlüsselungskonfiguration. Die Datenträgerverschlüsselungskonfiguration wird im Linux-Pool, der mit dem Azure Compute Gallery Image erstellt wurde, nicht unterstützt.
DiskEncryptionSetParameters	Die ARM-Ressourcen-ID des Datenträgerverschlüsselungssatzes.
DiskEncryptionTarget	DiskEncryptionTarget-Enums
DynamicVNetAssignmentScope	DynamicVNetAssignmentScope-Enums
ElevationLevel	ElevationLevel-Enums
EnvironmentSetting	Eine Umgebungsvariable, die für einen Vorgangsprozess festgelegt werden soll.
HostEndpointSettings	Gibt bestimmte Einstellungen für Hostendpunkte an.
HostEndpointSettingsModeTypes	HostEndpointSettingsModeTypes enums
InboundEndpointProtocol	InboundEndpointProtocol enums
IpAddressProvisioningType	IPAddressProvisioningType enums
IPFamily	Die IP-Familien, die zum Angeben von IP-Versionen verwendet werden, die für den Pool verfügbar sind.
IPTag	Enthält das IP-Tag, das der öffentlichen IP-Adresse zugeordnet ist.
LinuxUserConfiguration	Eigenschaften, die zum Erstellen eines Benutzerkontos auf einem Linux-Computeknoten verwendet werden.
LoginMode	LoginMode-Enums
ManagedDisk	Die Parameter des verwalteten Datenträgers.
MountConfiguration	Das Dateisystem, das auf jedem Knoten bereitgestellt werden soll.
NetworkConfiguration	Die Netzwerkkonfiguration für einen Pool.
NetworkSecurityGroupRule	Eine Netzwerksicherheitsgruppenregel, die auf einen eingehenden Endpunkt angewendet werden soll.
NetworkSecurityGroupRuleAccess	NetworkSecurityGroupRuleAccess-Enume
NfsMountConfiguration	Informationen, die zum Herstellen einer Verbindung mit einem NFS-Dateisystem verwendet werden.
ProxyAgentSettings	Gibt proxyAgent-Einstellungen beim Erstellen des virtuellen Computers an.
ResourceFile	Eine einzelne Datei oder mehrere Dateien, die in einen Computeknoten heruntergeladen werden sollen.
RollingUpgradePolicy	Die Konfigurationsparameter, die beim Ausführen eines rollierenden Upgrades verwendet werden.
SecurityEncryptionTypes	SecurityEncryptionTypes Enums
SecurityProfile	Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers an.
SecurityTypes	Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren.
ServiceArtifactReference	Gibt die Dienstartefaktereferenz-ID an, die zum Festlegen derselben Imageversion für alle virtuellen Computer im Skalierungssatz bei Verwendung der neuesten Imageversion verwendet wird.
StorageAccountType	StorageAccountType-Enumerationen
UpgradeMode	UpgradeMode-Enums
UpgradePolicy	Beschreibt eine Upgraderichtlinie – automatisch, manuell oder rolliert.
UserAccount	Eigenschaften zum Erstellen eines Benutzers, der zum Ausführen von Aufgaben auf einem Azure Batch Compute Node verwendet wird.
UserIdentity	Die Definition der Benutzeridentität, unter der die Aufgabe ausgeführt wird. Geben Sie entweder die Eigenschaft "userName" oder "autoUser" an, aber nicht beide.
VirtualMachineConfiguration	Die Konfiguration für Computeknoten in einem Pool basierend auf der Azure Virtual Machines-Infrastruktur.
VMExtension	Die Konfiguration für Erweiterungen virtueller Computer.
WindowsConfiguration	Windows-Betriebssystemeinstellungen, die auf den virtuellen Computer angewendet werden sollen.
WindowsUserConfiguration	Eigenschaften, die zum Erstellen eines Benutzerkontos auf einem Windows-Computeknoten verwendet werden.

AutomaticOsUpgradePolicy

Objekt

Die Konfigurationsparameter, die zum Ausführen eines automatischen Betriebssystemupgrades verwendet werden.

Name	Typ	Beschreibung
disableAutomaticRollback	boolean	Gibt an, ob das Rollbackfeature des Betriebssystemimages deaktiviert werden soll.
enableAutomaticOSUpgrade	boolean	Gibt an, ob Betriebssystemupgrades automatisch auf Skalierungssatzinstanzen angewendet werden sollen, wenn eine neuere Version des Betriebssystemimages verfügbar wird. Wenn dies für Windows-basierte Pools auf "true" festgelegt ist, können "WindowsConfiguration.enableAutomaticUpdates"- nicht auf "true" festgelegt werden.
osRollingUpgradeDeferral	boolean	Verzögern Sie Betriebssystemupgrades auf tvMs, wenn sie Aufgaben ausführen.
useRollingUpgradePolicy	boolean	Gibt an, ob die Rollupgraderichtlinie während des Automatischen Betriebssystemupgrades verwendet werden soll. Das automatische Betriebssystemupgrade wird auf die Standardrichtlinie zurückfallen, wenn keine Richtlinie für vmSS definiert ist.

AutoUserScope

Enumeration

AutoUserScope-Enums

Wert	Beschreibung
task	Spezifiziert, dass der Dienst einen neuen Benutzer für die Aufgabe anlegen soll.
pool	Spezifiziert, dass die Aufgabe als gemeinsames automatisches Benutzerkonto ausgeführt wird, das auf jedem Rechenknoten in einem Pool erstellt wird.

AutoUserSpecification

Objekt

Gibt die Optionen für den automatischen Benutzer an, der eine Azure-Batchaufgabe ausführt.

Name	Typ	Beschreibung
elevationLevel	ElevationLevel	Die Höhenstufe des automatischen Benutzers. Der Standardwert ist "nonAdmin".
scope	AutoUserScope	Der Bereich für den automatischen Benutzer. Der Standardwert ist Pool. Wenn der Pool Windows ausführt, sollte ein Wert der Aufgabe angegeben werden, wenn eine strengere Isolierung zwischen Vorgängen erforderlich ist. Dies ist beispielsweise der Fall, wenn die Aufgabe die Registrierung in einer Weise ändert, die sich auf andere Aufgaben auswirken kann.

AzureBlobFileSystemConfiguration

Objekt

Informationen, die zum Herstellen einer Verbindung mit einem Azure Storage-Container mithilfe von Blobfuse verwendet werden.

Name	Typ	Beschreibung
accountKey	string (password)	Der Azure Storage-Kontoschlüssel. Diese Eigenschaft schließt sich gegenseitig mit sasKey und Identität aus; genau einer muss angegeben werden.
accountName	string	Der Azure-Speicherkontoname
blobfuseOptions	string	Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.
containerName	string	Der Name des Azure Blob Storage-Containers.
identityReference	BatchNodeIdentityReference	Die Referenz auf die vom Benutzer zugewiesene Identität, um auf containerName zuzugreifen. Diese Eigenschaft schließt sich gegenseitig mit accountKey und sasKey aus. genau einer muss angegeben werden.
relativeMountPath	string	Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.
sasKey	string (password)	Das Azure Storage SAS-Token. Diese Eigenschaft schließt sich gegenseitig mit AccountKey und Identität aus; genau einer muss angegeben werden.

AzureFileShareConfiguration

Objekt

Informationen, die zum Herstellen einer Verbindung mit einer Azure Fileshare verwendet werden.

Name	Typ	Beschreibung
accountKey	string (password)	Der Azure Storage-Kontoschlüssel.
accountName	string	Der Name des Azure Storage-Kontos.
azureFileUrl	string (uri)	Die Azure Files-URL. Dies ist das Format "https://{account}.file.core.windows.net/".
mountOptions	string	Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.
relativeMountPath	string	Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.

BatchApplicationPackageReference

Objekt

Ein Verweis auf ein Paket, das auf Computeknoten bereitgestellt werden soll.

Name	Typ	Beschreibung
applicationId	string	Die ID der zu implementierenden Anwendung. Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Die Version der bereitzustellenden Anwendung. Wenn sie weggelassen wird, wird die Standardversion bereitgestellt. Wenn dies in einem Pool weggelassen wird und für diese Anwendung keine Standardversion angegeben ist, schlägt die Anfrage mit dem Fehlercode InvalidApplicationPackageReferences und dem HTTP-Statuscode 409 fehl. Wenn dies bei einer Aufgabe weggelassen wird und für diese Anwendung keine Standardversion angegeben ist, scheitert die Aufgabe mit einem Vorverarbeitungsfehler.

BatchContainerConfiguration

Objekt

Die Konfiguration für containerfähige Pools.

Name	Typ	Beschreibung
containerImageNames	string[]	Die Sammlung von Container-Bildnamen. Dies ist die vollständige Image-Referenz, wie sie bei "docker pull" angegeben wäre. Ein Image wird aus dem Standard-Docker-Register bezogen, es sei denn, das Image ist vollständig mit einer alternativen Registry qualifiziert.
containerRegistries	ContainerRegistryReference[]	Zusätzliche private Register, aus denen Container abgerufen werden können. Wenn Bilder aus einem privaten Register heruntergeladen werden müssen, das Zugangsdaten benötigt, müssen diese hier angegeben werden.
type	ContainerType	Die zu verwendende Containertechnologie.

BatchDiffDiskSettings

Objekt

Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom Computeknoten (VM) verwendet wird.

Name	Typ	Beschreibung
placement	DiffDiskPlacement	Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger für alle virtuellen Computer im Pool an. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, z. B. Cachespeicherplatz für die Bereitstellung ephemerer Betriebssystemdatenträger. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter ephemeren Betriebssystemgrößenanforderungen für Windows-VMs unter https://v4.hkg1.meaqua.org/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements und Linux-VMs unter https://v4.hkg1.meaqua.org/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

BatchError

Objekt

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	BatchErrorMessage	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
values	BatchErrorDetail[]	Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthalten.

BatchErrorDetail

Objekt

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.

Name	Typ	Beschreibung
key	string	Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.
value	string	Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

BatchErrorMessage

Objekt

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

Name	Typ	Beschreibung
lang	string	Der Sprachcode der Fehlermeldung.
value	string	Der Text der Nachricht.

BatchInboundNatPool

Objekt

Ein eingehender NAT-Pool, der verwendet werden kann, um bestimmte Ports auf Computeknoten in einem Batchpool extern zu adressieren.

Name	Typ	Beschreibung
backendPort	integer (int32)	Die Portnummer des Compute Node. Dies muss innerhalb eines Batch-Pools einzigartig sein. Zulässige Werte liegen zwischen 1 und 65535, mit Ausnahme von 29876 und 29877, da diese reserviert sind. Wenn reservierte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.
frontendPortRangeEnd	integer (int32)	Die letzte Portnummer im Bereich der externen Ports, die verwendet werden, um eingehenden Zugriff auf den BackendPort auf einzelnen Rechenknoten zu ermöglichen. Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen unterschiedlich sein und dürfen sich nicht überlappen. Jeder Bereich muss mindestens 40 Ports enthalten. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.
frontendPortRangeStart	integer (int32)	Die erste Portnummer im Bereich der externen Ports, die verwendet werden, um eingehenden Zugriff auf den BackendPort auf einzelnen Rechenknoten bereitzustellen. Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen unterschiedlich sein und dürfen sich nicht überlappen. Jeder Bereich muss mindestens 40 Ports enthalten. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.
name	string	Der Name des Endpunkts. Der Name muss innerhalb eines Batch-Pools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.
networkSecurityGroupRules	NetworkSecurityGroupRule[]	Eine Liste der Regeln für Netzwerksicherheitsgruppen, die auf den Endpunkt angewendet werden. Die maximale Anzahl von Regeln, die über alle Endpunkte in einem Batch Pool festgelegt werden können, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.
protocol	InboundEndpointProtocol	Das Protokoll des Endpunkts.

BatchJobDefaultOrder

Enumeration

BatchJobDefaultOrder-Enums

Wert	Beschreibung
none	Aufgaben sollten aus allen gleichprioritären Jobs für den Pool einheitlich geplant werden.
creationtime	Wenn Jobs die gleiche Priorität haben, sollten Aufgaben aus früher erstellten Jobs zuerst geplant werden.

BatchMetadataItem

Objekt

Der Batchdienst weist diesen Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.

Name	Typ	Beschreibung
name	string	Der Name des Metadatenelements.
value	string	Der Wert des Metadatenelements.

BatchNodeFillType

Enumeration

BatchNodeFillType Enume

Wert	Beschreibung
spread	Aufgaben sollten gleichmäßig über alle Rechenknoten im Pool verteilt werden.
pack	So viele Aufgaben wie möglich (taskSlotsPerNode) sollten jedem Rechenknoten im Pool zugewiesen werden, bevor Aufgaben dem nächsten Rechenknoten im Pool zugewiesen werden.

BatchNodeIdentityReference

Objekt

Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.

Name	Typ	Beschreibung
resourceId	string (arm-id)	Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität.

BatchNodePlacementConfiguration

Objekt

Für die regionale Platzierung werden Knoten im Pool in derselben Region zugewiesen. Bei der Platzierung von Zonen werden Knoten im Pool über verschiedene Zonen verteilt, wobei der Best-Effort-Ausgleich erfolgt.

Name	Typ	Beschreibung
policy	BatchNodePlacementPolicyType	Knotenplatzierungsrichtlinientyp in Batchpools. Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie.

BatchNodePlacementPolicyType

Enumeration

BatchNodePlacementPolicyType Enume

Wert	Beschreibung
regional	Alle Knoten im Pool werden in derselben Region zugewiesen.
zonal	Die Knoten im Pool werden sich über verschiedene Verfügbarkeitszonen mit Best-Effort-Balancierung verteilen.

BatchOsDisk

Objekt

Einstellungen für den Betriebssystemdatenträger des Computeknotens (VM).

Name	Typ	Beschreibung
caching	CachingType	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None, ReadOnly, ReadWrite. Die Standardwerte sind: Keine für den Standardspeicher. ReadOnly für Premium-Speicher.
diskSizeGB	integer (int32)	Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers.
ephemeralOSDiskSettings	BatchDiffDiskSettings	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom Computeknoten (VM) verwendet wird.
managedDisk	ManagedDisk	Die Parameter des verwalteten Datenträgers.
writeAcceleratorEnabled	boolean	Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

BatchPoolCreateOptions

Objekt

Parameter zum Erstellen eines Azure-Batchpools.

Name	Typ	Beschreibung
applicationPackageReferences	BatchApplicationPackageReference[]	Die Liste der Pakete, die auf jedem Computeknoten im Pool installiert werden sollen. Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Änderungen an Paketverweise wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt wurden. Es gibt maximal 10 Paketverweise für einen bestimmten Pool.
autoScaleEvaluationInterval	string (duration)	Das Zeitintervall, in dem die Poolgröße automatisch entsprechend der Autoskalenformel angepasst werden soll. Der Standardwert beträgt 15 Minuten. Der Mindest- und Maximalwert beträgt 5 Minuten bzw. 168 Stunden. Wenn Sie einen Wert angeben, der kleiner als 5 Minuten oder größer als 168 Stunden ist, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).
autoScaleFormula	string	Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "false" festgelegt ist. Es ist erforderlich, wenn enableAutoScale auf "true" festgelegt ist. Die Formel wird vor der Erstellung des Pools auf Gültigkeit überprüft. Wenn die Formel ungültig ist, lehnt der Batchdienst die Anforderung mit detaillierten Fehlerinformationen ab. Weitere Informationen zum Angeben dieser Formel finden Sie unter "Automatisches Skalieren von Computeknoten in einem Azure-Batchpool" (https://v4.hkg1.meaqua.org/azure/batch/batch-automatic-scaling).
displayName	string	Der Anzeigename für den Pool. Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten.
enableAutoScale	boolean	Gibt an, ob die Poolgröße im Laufe der Zeit automatisch angepasst werden soll. Wenn false, muss mindestens eine der targetDedicatedNodes und targetLowPriorityNodes angegeben werden. Bei "true" ist die AutoScaleFormula-Eigenschaft erforderlich, und der Pool ändert die Größe automatisch entsprechend der Formel. Der Standardwert ist "false".
enableInterNodeCommunication	boolean	Gibt an, ob der Pool die direkte Kommunikation zwischen Computeknoten zulässt. Das Aktivieren der Kommunikation zwischen Knoten begrenzt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen auf den Computeknoten des Pools. Dies kann dazu führen, dass der Pool seine gewünschte Größe nicht erreicht. Der Standardwert ist "false".
id	string	Eine Zeichenfolge, die den Pool innerhalb des Kontos eindeutig identifiziert. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie verfügen möglicherweise nicht über zwei Pool-IDs innerhalb eines Kontos, die sich nur nach Groß-/Kleinschreibung unterscheiden).
metadata	BatchMetadataItem[]	Eine Liste von Name-Wert-Paaren, die dem Pool als Metadaten zugeordnet sind. Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.
mountConfiguration	MountConfiguration[]	Bereitstellen des Speichers mithilfe des angegebenen Dateisystems für die gesamte Lebensdauer des Pools. Binden Sie den Speicher mithilfe eines Azure-Dateifreigabe-, NFS-, CIFS- oder Blobfuse-basierten Dateisystems ein.
networkConfiguration	NetworkConfiguration	Die Netzwerkkonfiguration für den Pool.
resizeTimeout	string (duration)	Das Timeout für die Zuordnung von Computeknoten zum Pool. Dieses Timeout gilt nur für die manuelle Skalierung; es hat keine Auswirkung, wenn enableAutoScale auf "true" festgelegt ist. Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).
startTask	BatchStartTask	Eine Aufgabe, die für jeden Computeknoten ausgeführt werden soll, während er dem Pool beitritt. Die Aufgabe wird ausgeführt, wenn der Computeknoten dem Pool hinzugefügt wird oder wenn der Computeknoten neu gestartet wird.
targetDedicatedNodes	integer (int32)	Die gewünschte Anzahl dedizierter Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
targetLowPriorityNodes	integer (int32)	Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
taskSchedulingPolicy	BatchTaskSchedulingPolicy	Wie Aufgaben über Computeknoten in einem Pool verteilt werden. Wenn nicht angegeben, wird die Standardeinstellung verteilt.
taskSlotsPerNode	integer (int32)	Die Anzahl von Taskslots, die verwendet werden können, um gleichzeitige Tasks auf einem einzelnen Computeknoten im Pool auszuführen. Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256.
upgradePolicy	UpgradePolicy	Die Upgraderichtlinie für den Pool. Beschreibt eine Upgraderichtlinie – automatisch, manuell oder rolliert.
userAccounts	UserAccount[]	Die Liste der Benutzerkonten, die auf jedem Computeknoten im Pool erstellt werden sollen.
virtualMachineConfiguration	VirtualMachineConfiguration	Die Konfiguration des virtuellen Computers für den Pool. Diese Eigenschaft muss angegeben werden.
vmSize	string	Die Größe virtueller Computer im Pool. Alle virtuellen Computer in einem Pool haben die gleiche Größe. Informationen zu den verfügbaren VM-Größen für Pools, die Images aus dem Virtual Machines Marketplace verwenden (Pools, die mit virtualMachineConfiguration erstellt wurden), finden Sie unter Größen für virtuelle Computer in Azure (https://v4.hkg1.meaqua.org/azure/virtual-machines/sizes/overview). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).

BatchPoolEndpointConfiguration

Objekt

Die Endpunktkonfiguration für einen Pool.

Name	Typ	Beschreibung
inboundNATPools	BatchInboundNatPool[]	Eine Liste von eingehenden NAT-Pools, die verwendet werden können, um spezifische Ports eines einzelnen Compute-Knotens extern zu adressieren. Die maximale Anzahl der eingehenden NAT-Pools pro Batch Pool beträgt 5. Wenn die maximale Anzahl eingehender NAT-Pools überschritten wird, scheitert die Anfrage mit HTTP-Statuscode 400. Dies kann nicht angegeben werden, wenn der IPAddressProvisioningType NoPublicIPAddresses ist.

BatchPoolIdentityReference

Objekt

Die Referenz einer der Poolidentitäten zum Verschlüsseln des Datenträgers. Diese Identität wird für den Zugriff auf den Schlüsseltresor verwendet.

Name	Typ	Beschreibung
resourceId	string (arm-id)	Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität. Dieser Verweis muss in den Poolidentitäten enthalten sein.

BatchPublicIpAddressConfiguration

Objekt

Die konfiguration der öffentlichen IP-Adresse der Netzwerkkonfiguration eines Pools.

Name	Typ	Beschreibung
ipAddressIds	string[] (arm-id)	Die Liste der öffentlichen IPs, die der Batchdienst beim Bereitstellen von Computeknoten verwendet. Die hier angegebene Anzahl von IPs begrenzt die maximale Größe des Pools – 100 dedizierte Knoten oder 100 Spot/Low-Priority-Knoten können für jede öffentliche IP zugewiesen werden. Ein Pool, der 250 dedizierte VMs benötigt, benötigt beispielsweise mindestens 3 öffentliche IPs. Jedes Element dieser Auflistung weist das Format auf: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.
ipFamilies	IPFamily[]	Die IP-Familien, die zum Angeben von IP-Versionen verwendet werden, die für den Pool verfügbar sind. IP-Familien werden verwendet, um Single-Stack- oder Dual-Stack-Pools zu bestimmen. Bei einem Einzelstapel lautet der erwartete Wert IPv4. Bei dualen Stapeln sind die erwarteten Werte IPv4 und IPv6.
ipTags	IPTag[]	Eine Liste der IP-Tags, die den öffentlichen IP-Adressen des Pools zugeordnet sind. IP-Tags werden verwendet, um öffentliche IP-Adressen zu Abrechnungs- und Verwaltungszwecken zu kategorisieren und zu filtern.
provision	IpAddressProvisioningType	Der Bereitstellungstyp für öffentliche IP-Adressen für den Pool. Der Standardwert ist BatchManaged.

BatchStartTask

Objekt

Batch wiederholt Aufgaben, wenn ein Wiederherstellungsvorgang auf einem Knoten ausgelöst wird. Beispiele für Wiederherstellungsvorgänge sind (aber nicht beschränkt darauf), wenn ein fehlerhafter Knoten neu gestartet wird oder ein Computeknoten aufgrund eines Hostfehlers verschwunden ist. Wiederholungen aufgrund von Wiederherstellungsvorgängen sind unabhängig von und werden nicht für das maxTaskRetryCount gezählt. Auch wenn das maxTaskRetryCount 0 ist, kann ein interner Wiederholungsversuch aufgrund eines Wiederherstellungsvorgangs auftreten. Aus diesem Gründen sollten alle Aufgaben idempotent sein. Dies bedeutet, dass Aufgaben unterbrochen und neu gestartet werden müssen, ohne dass Beschädigte oder doppelte Daten verursacht werden. Die bewährte Methode für lange ausgeführte Aufgaben besteht darin, eine Form der Prüfpunkterstellung zu verwenden. In einigen Fällen kann der StartTask erneut ausgeführt werden, obwohl der Computeknoten nicht neu gestartet wurde. Es sollte besonders darauf geachtet werden, startTasks zu vermeiden, die Unterbrechungsvorgang erstellen oder Dienste aus dem StartTask-Arbeitsverzeichnis installieren/starten, da dadurch verhindert wird, dass Batch die StartTask erneut ausführen kann.

Name	Typ	Beschreibung
commandLine	string	Die Befehlszeile des StartTask. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis "Aufgabe") verwenden oder die vom Batch bereitgestellte Umgebungsvariable (https://v4.hkg1.meaqua.org/azure/batch/batch-compute-node-environment-variables) verwenden.
containerSettings	BatchTaskContainerSettings	Die Einstellungen für den Container, unter dem der StartTask ausgeführt wird. Wenn dies angegeben ist, werden alle Verzeichnisse rekursiv unterhalb der AZ_BATCH_NODE_ROOT_DIR (der Wurzel der Azure Batch-Verzeichnisse auf dem Knoten) in den Container abgebildet, alle Task-Umgebungsvariablen werden in den Container abgebildet und die Task-Befehlszeile wird im Container ausgeführt. Dateien, die außerhalb AZ_BATCH_NODE_ROOT_DIR im Container erzeugt werden, werden möglicherweise nicht auf die Host-Festplatte zurückgewiesen, was bedeutet, dass Batch-Datei-APIs nicht auf diese Dateien zugreifen können.
environmentSettings	EnvironmentSetting[]	Eine Liste der Umgebungsvariableneinstellungen für den StartTask.
maxTaskRetryCount	integer (int32)	Die maximale Anzahl der Wiederholungsversuche des Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch die Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, wird der Batchdienst den Vorgang nicht wiederholen. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung, dies wird jedoch nicht für einen Startvorgang oder einen Vorgang empfohlen. Der Standardwert ist 0 (keine Wiederholungen).
resourceFiles	ResourceFile[]	Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Es gibt eine maximale Größe für die Liste der Ressourcendateien. Wenn die maximale Größe überschritten wird, schlägt die Anforderung fehl, und der Antwortfehlercode lautet "RequestEntityTooLarge". Wenn dies der Fall ist, muss die Sammlung von ResourceFiles in der Größe reduziert werden. Dies kann mithilfe von .zip Dateien, Anwendungspaketen oder Docker-Containern erreicht werden. Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe.
userIdentity	UserIdentity	Die Benutzeridentität, unter der die StartTask ausgeführt wird. Wenn sie weggelassen wird, läuft die Aufgabe als nicht-administrativer Benutzer, der einzigartig für die Aufgabe ist.
waitForSuccess	boolean	Gibt an, ob der Batchdienst warten soll, bis der StartTask erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Aufgaben auf dem Computeknoten geplant werden. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, wiederholt der Batchdienst die StartTask bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn die Aufgabe nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten nicht verwendbar und plant keine Vorgänge. Diese Bedingung kann über den Computerknotenstatus und Fehlerinformationen erkannt werden. Wenn "false" lautet, wartet der Batchdienst nicht, bis der StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während der StartTask noch ausgeführt wird. und auch wenn der StartTask fehlschlägt, werden neue Aufgaben weiterhin auf dem Computeknoten geplant. Der Standardwert ist "true".

BatchTaskContainerSettings

Objekt

Die Containereinstellungen für eine Aufgabe.

Name	Typ	Beschreibung
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Die Pfade, die Sie an containeraufgaben bereitstellen möchten. Wenn dieses Array null ist oder nicht vorhanden ist, stellt die Containeraufgabe das gesamte temporäre Laufwerk in Windows (oder AZ_BATCH_NODE_ROOT_DIR in Linux) ein. Es werden keine Datenpfade in Container bereitgestellt, wenn dieses Array als leer festgelegt ist.
containerRunOptions	string	Zusätzliche Optionen für den Befehl "Container erstellen". Diese zusätzlichen Optionen werden zusätzlich zu den vom Batchdienst gesteuerten Befehlen als Argumente für den Befehl "docker create" bereitgestellt.
imageName	string	Das Image, das verwendet wird, um den Container zu erstellen, in dem die Aufgabe ausgeführt wird. Dies ist die vollständige Image-Referenz, wie sie bei "docker pull" angegeben wäre. Wenn kein Tag im Bildnamen angegeben ist, wird standardmäßig das Tag ":latest" verwendet.
registry	ContainerRegistryReference	Das private Register, das das Container-Image enthält. Diese Einstellung kann weggelassen werden, wenn sie bereits bei der Poolerstellung bereitgestellt wurde.
workingDirectory	ContainerWorkingDirectory	Der Standort des Arbeitsverzeichnisses Container Task. Der Standardwert ist "taskWorkingDirectory".

BatchTaskSchedulingPolicy

Objekt

Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen.

Name	Typ	Standardwert	Beschreibung
jobDefaultOrder	BatchJobDefaultOrder	none	Die Reihenfolge für die Planung von Aufgaben aus verschiedenen Einzelvorgängen mit derselben Priorität. Wenn nicht angegeben, ist der Standardwert keine.
nodeFillType	BatchNodeFillType		Wie Aufgaben über Computeknoten in einem Pool verteilt werden. Wenn nicht angegeben, wird die Standardeinstellung verteilt.

BatchUefiSettings

Objekt

Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden.

Name	Typ	Beschreibung
secureBootEnabled	boolean	Gibt an, ob der sichere Start auf dem virtuellen Computer aktiviert werden soll.
vTpmEnabled	boolean	Gibt an, ob vTPM auf dem virtuellen Computer aktiviert werden soll.

BatchVmDiskSecurityProfile

Objekt

Gibt die Sicherheitsprofileinstellungen für den verwalteten Datenträger an. Hinweis: Er kann nur für vertrauliche VMs festgelegt werden und ist erforderlich, wenn vertrauliche VMs verwendet werden.

Name	Typ	Beschreibung
securityEncryptionType	SecurityEncryptionTypes	Gibt den EncryptionType des verwalteten Datenträgers an. Sie ist für die Verschlüsselung nur des VMGuestState-Blobs auf "VMGuestStateOnly" und "NonPersistedTPM" festgelegt, damit der Firmwarestatus im VMGuestState-Blob nicht beibehalten wird. Hinweis: Er kann nur für vertrauliche VMs festgelegt werden und ist erforderlich, wenn vertrauliche VMs verwendet werden.

BatchVmImageReference

Objekt

Ein Verweis auf ein Azure Virtual Machines Marketplace Image oder ein Azure Compute Gallery Image. Informationen zum Abrufen der Liste aller azure Marketplace-Imageverweise, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Unterstützte Bilder auflisten".

Name	Typ	Beschreibung
communityGalleryImageId	string	Die eindeutige Kennung des Bildes in der Community-Galerie. Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus und kann aus dem Get-Aufruf der Communitygalerie abgerufen werden.
exactVersion	string	Die spezifische Version des Plattform- oder Marktplatzimages, die zur Erstellung des Knotens verwendet wurde. Dieses Nur-Lese-Feld unterscheidet sich von 'version' nur, wenn der für 'version' angegebene Wert bei der Erstellung des Pools 'neueste' war.
offer	string	Der Angebotstyp des Azure Virtual Machines Marketplace Images. Beispiel: UbuntuServer oder WindowsServer.
publisher	string	Der Herausgeberin des Azure Virtual Machines Marketplace Image. Beispiel: Canonical oder MicrosoftWindowsServer.
sharedGalleryImageId	string	Die einzigartige Identifikatorin des gemeinsamen Galeriebilds. Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus und kann aus dem GET-Aufruf des freigegebenen Katalogbilds abgerufen werden.
sku	string	Die SKU des Azure Virtual Machines Marketplace Images. Beispiel: 18.04-LTS oder 2019-Datacenter.
version	string	Die Version des Azure Virtual Machines Marketplace Images. Ein Wert 'neueste' kann angegeben werden, um die neueste Version eines Images auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest".
virtualMachineImageId	string (arm-id)	Der ARM-Ressourcenbezeichner des Azure Compute Gallery Image. Compute-Knoten im Pool werden mit dieser Bild-ID erstellt. Dies ist in der Form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} oder /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}, um immer auf die neueste Image-Version zu setzen. Diese Eigenschaft schließt sich gegenseitig mit anderen ImageReference-Eigenschaften aus. Das Azure Compute Gallery Image muss Replikate in derselben Region haben und im selben Abonnement wie das Azure Batch-Konto sein. Wenn die Image-Version nicht in der imageID angegeben ist, wird die neueste Version verwendet. Informationen zu den Firewall-Einstellungen für den Batch Compute Node-Agenten zur Kommunikation mit dem Batch-Service finden https://v4.hkg1.meaqua.org/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configurationSie unter .

CachingType

Enumeration

CachingType Enums

Wert	Beschreibung
none	Der Cachemodus für den Datenträger ist nicht aktiviert.
readonly	Der Cachemodus für den Datenträger ist schreibgeschützt.
readwrite	Der Cachemodus für den Datenträger ist lese- und schreibgeschützt.

CifsMountConfiguration

Objekt

Informationen, die zum Herstellen einer Verbindung mit einem CIFS-Dateisystem verwendet werden.

Name	Typ	Beschreibung
mountOptions	string	Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.
password	string (password)	Das Kennwort, das für die Authentifizierung im CIFS-Dateisystem verwendet werden soll.
relativeMountPath	string	Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.
source	string	Der URI des zu mountden Dateisystems.
username	string	Der Benutzer, der für die Authentifizierung gegen das CIFS-Dateisystem verwendet werden soll.

ContainerHostBatchBindMountEntry

Objekt

Der Eintrag des Pfad- und Bereitstellungsmodus, den Sie in Aufgabencontainer bereitstellen möchten.

Name	Typ	Beschreibung
isReadOnly	boolean	Stellen Sie diesen Quellpfad als schreibgeschützten Modus ein oder nicht. Der Standardwert ist false (Lese-/Schreibmodus). Wenn Sie diesen Pfad für Linux als Lese-/Schreibmodus bereitstellen, bedeutet dies nicht, dass alle Benutzer im Container über den Lese-/Schreibzugriff für den Pfad verfügen, hängt sie vom Zugriff auf die Host-VM ab. Wenn dieser Pfad schreibgeschützt bereitgestellt wird, können alle Benutzer im Container den Pfad nicht ändern.
source	ContainerHostDataPath	Der Pfad, der für containerkunden bereitgestellt werden kann.

ContainerHostDataPath

Enumeration

Die Pfade, die im Container der Containeraufgabe bereitgestellt werden.

Wert	Beschreibung
Shared	Der Pfad für die Aufgabe mit mehreren Instanzen, um ihre Dateien freigegeben zu haben.
Startup	Der Pfad für die Startaufgabe.
VfsMounts	Der Pfad enthält alle virtuellen Dateisysteme, die auf diesem Knoten bereitgestellt werden.
Task	Der Vorgangspfad.
JobPrep	Der Auftragsvorstellungsvorgangspfad.
Applications	Der Anwendungspfad.

ContainerRegistryReference

Objekt

Eine private Containerregistrierung.

Name	Typ	Beschreibung
identityReference	BatchNodeIdentityReference	Der Verweis auf die vom Benutzer zugewiesene Identität, die für den Zugriff auf eine Azure-Containerregistrierung anstelle von Benutzername und Kennwort verwendet werden soll.
password	string (password)	Das Kennwort für die Anmeldung beim Registrierungsserver.
registryServer	string (uri)	Die Registrierungs-URL Wenn nicht angegeben, lautet der Standardwert "docker.io".
username	string	Der Benutzername, der sich beim Registrierungsserver anmeldet.

ContainerType

Enumeration

ContainerType Enums

Wert	Beschreibung
dockerCompatible	Eine Docker-kompatible Containertechnologie wird verwendet, um die Container zu starten.
criCompatible	Eine CRI-basierte Technologie wird verwendet, um die Container zu starten.

ContainerWorkingDirectory

Enumeration

ContainerWorkingDirectory-Enums

Wert	Beschreibung
taskWorkingDirectory	Verwenden Sie das Standard-Batch-Service-Arbeitsverzeichnis Task, das die Task Resource Dateien enthält, die von Batch gefüllt werden.
containerImageDefault	Verwenden Sie das Arbeitsverzeichnis, das im Container-Image definiert ist. Beachten Sie, dass dieses Verzeichnis die durch Batch heruntergeladenen Ressourcendateien nicht enthält.

DataDisk

Objekt

Einstellungen, die von den Datenträgern verwendet werden, die Computeknoten im Pool zugeordnet sind. Wenn Sie angefügte Datenträger verwenden, müssen Sie die Datenträger innerhalb einer VM bereitstellen und formatieren, um sie zu verwenden.

Name	Typ	Beschreibung
caching	CachingType	Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer (int32)	Die anfängliche Datenträgergröße in Gigabyte.
lun	integer (int32)	Die wahrheitslogische Einheitsnummer. Die logicalUnitNumber wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn Sie mehrere Datenträger anfügen, sollte jeder eine eindeutige logischeUnitNumber aufweisen. Der Wert muss zwischen 0 und 63 (einschließlich) liegen.
managedDisk	ManagedDisk	Die Parameter des verwalteten Datenträgers.
storageAccountType	StorageAccountType	Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs".

DiffDiskPlacement

Enumeration

Spezifiziert die ephemere Festplattenplatzierung für Betriebssystem-Festplatte für alle Rechenknoten (VMs) im Pool. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um auszuwählen, an welchem Speicherort sich das Betriebssystem befinden soll. z. B. Cachespeicherplatz für ephemerale Betriebssystemdatenträgerbereitstellung. Für weitere Informationen zu den Anforderungen an die Festplattengröße des Ephemeral OS siehe bitte die Anforderungen an die Festplattengröße des Ephemeral OS für Windows-VMs bei und https://v4.hkg1.meaqua.org/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linux-VMs unter https://v4.hkg1.meaqua.org/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

Wert	Beschreibung
cachedisk	Der ephemerale Betriebssystemdatenträger wird im VM-Cache gespeichert.

DiskCustomerManagedKey

Objekt

Die Referenz zum vom Kunden verwalteten Schlüssel zum Verschlüsseln des Datenträgers.

Name	Typ	Beschreibung
identityReference	BatchPoolIdentityReference	Die Referenz einer der Poolidentitäten zum Verschlüsseln des Datenträgers. Diese Identität wird für den Zugriff auf den Schlüsseltresor verwendet.
keyUrl	string	Vollversionierte Schlüssel-URL, die auf einen Schlüssel in KeyVault verweist. Das Versionssegment der URL ist unabhängig vom RotationToLatestKeyVersionEnabled-Wert erforderlich.
rotationToLatestKeyVersionEnabled	boolean	Legen Sie dieses Flag auf true fest, um die automatische Aktualisierung von Disk Encryption auf die neueste Schlüsselversion zu aktivieren. Der Standardwert ist "false".

DiskEncryptionConfiguration

Objekt

Die Auf Computeknoten im Pool angewendete Datenträgerverschlüsselungskonfiguration. Die Datenträgerverschlüsselungskonfiguration wird im Linux-Pool, der mit dem Azure Compute Gallery Image erstellt wurde, nicht unterstützt.

Name	Typ	Beschreibung
customerManagedKey	DiskCustomerManagedKey	Die Referenz zum kundenseitig verwalteten Schlüssel zum Verschlüsseln des Betriebssystemdatenträgers. Der vom Kunden verwaltete Schlüssel verschlüsselt den Betriebssystemdatenträger mit EncryptionAtRest, und standardmäßig wird auch der Datenträger verschlüsselt. Sie kann nur verwendet werden, wenn der Pool mit einer Identität konfiguriert ist und OsDisk als eines der Ziele von DiskEncryption festgelegt ist.
targets	DiskEncryptionTarget[]	Die Liste der Datenträgerziele für den Batchdienst wird auf dem Computeknoten verschlüsselt. Die Liste der Datenträgerziele für den Batchdienst wird auf dem Computeknoten verschlüsselt.

DiskEncryptionSetParameters

Objekt

Die ARM-Ressourcen-ID des Datenträgerverschlüsselungssatzes.

Name	Typ	Beschreibung
id	string (arm-id)	Die ARM-Ressourcen-ID des Datenträgerverschlüsselungssatzes. Die Ressource muss sich im selben Abonnement wie das Batch-Konto befinden.

DiskEncryptionTarget

Enumeration

DiskEncryptionTarget-Enums

Wert	Beschreibung
osdisk	Der Betriebssystemdatenträger auf dem Computeknoten ist verschlüsselt.
temporarydisk	Der temporäre Datenträger auf dem Computeknoten ist verschlüsselt. Unter Linux gilt diese Verschlüsselung für andere Partitionen (z. B. auf bereitgestellten Datenträgern), wenn die Verschlüsselung zur Startzeit auftritt.

DynamicVNetAssignmentScope

Enumeration

DynamicVNetAssignmentScope-Enums

Wert	Beschreibung
none	Es ist keine dynamische VNet-Zuweisung aktiviert.
job	Die dynamische VNet-Zuordnung erfolgt pro Auftrag.

ElevationLevel

Enumeration

ElevationLevel-Enums

Wert	Beschreibung
nonadmin	Der Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff.
admin	Der Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen.

EnvironmentSetting

Objekt

Eine Umgebungsvariable, die für einen Vorgangsprozess festgelegt werden soll.

Name	Typ	Beschreibung
name	string	Der Name der Umgebungsvariable.
value	string	Der Wert der Umgebungsvariable.

HostEndpointSettings

Objekt

Gibt bestimmte Einstellungen für Hostendpunkte an.

Name	Typ	Beschreibung
inVMAccessControlProfileReferenceId	string	Gibt den Verweis auf die InVMAccessControlProfileVersion-Ressourcen-ID im Format /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version} an.
mode	HostEndpointSettingsModeTypes	Gibt den Ausführungsmodus der Zugriffssteuerungsrichtlinie an.

HostEndpointSettingsModeTypes

Enumeration

HostEndpointSettingsModeTypes enums

Wert	Beschreibung
Audit	Im Überwachungsmodus fungiert das System so, als ob es die Zugriffssteuerungsrichtlinie erzwingt, einschließlich der Aussendung von Zugriffsverweigerungseinträgen in den Protokollen, aber es verweigert tatsächlich keine Anforderungen an Hostendpunkte.
Enforce	Der Durchsetzungsmodus ist der empfohlene Betriebsmodus und das System setzt die Zugriffskontrollrichtlinie durch. Diese Eigenschaft kann nicht zusammen mit 'inVMAccessControlProfileReferenceId' verwendet werden.

InboundEndpointProtocol

Enumeration

InboundEndpointProtocol enums

Wert	Beschreibung
tcp	Verwenden Sie TCP für den Endpunkt.
udp	Verwenden Sie UDP für den Endpunkt.

IpAddressProvisioningType

Enumeration

IPAddressProvisioningType enums

Wert	Beschreibung
batchmanaged	Eine öffentliche IP wird von Batch erstellt und verwaltet. Je nach Größe des Pools können mehrere öffentliche IPs vorhanden sein.
usermanaged	Öffentliche IPs werden vom Benutzer bereitgestellt und zum Bereitstellen der Computeknoten verwendet.
nopublicipaddresses	Es wird keine öffentliche IP-Adresse erstellt.

IPFamily

Enumeration

Die IP-Familien, die zum Angeben von IP-Versionen verwendet werden, die für den Pool verfügbar sind.

Wert	Beschreibung
IPv4	IPv4 steht dem Pool zur Verfügung.
IPv6	IPv6 steht dem Pool zur Verfügung.

IPTag

Objekt

Enthält das IP-Tag, das der öffentlichen IP-Adresse zugeordnet ist.

Name	Typ	Beschreibung
ipTagType	string	Der IP-Tag-Typ. Beispiel: FirstPartyUsage.
tag	string	Der Wert des IP-Tags, das der öffentlichen IP zugeordnet ist. Beispiel: SQL.

LinuxUserConfiguration

Objekt

Eigenschaften, die zum Erstellen eines Benutzerkontos auf einem Linux-Computeknoten verwendet werden.

Name	Typ	Beschreibung
gid	integer (int32)	Die Gruppen-ID für das Benutzerkonto. Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt.
sshPrivateKey	string (password)	Der private SSH-Schlüssel für das Benutzerkonto. Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um automatisch asymmetrisch-schlüsselbasierte Authentifizierung für SSH zwischen Compute-Knoten in einem Linux-Pool zu konfigurieren, wenn die enableInterNodeCommunication-Eigenschaft des Pools wahr ist (sie wird ignoriert, wenn enableInterNodeCommunication falsch ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Sofern nicht angegeben, wird passwortloses SSH zwischen den Compute Nodes nicht konfiguriert (es wird kein Bestand am .ssh-Verzeichnis des Benutzers vorgenommen).
uid	integer (int32)	Die Benutzer-ID des Benutzerkontos. Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt.

LoginMode

Enumeration

LoginMode-Enums

Wert

Beschreibung

batch

Der LOGON32_LOGON_BATCH Win32-Anmeldemodus. Der Batchanmeldungsmodus wird für lange ausgeführte parallele Prozesse empfohlen.

interactive

Der LOGON32_LOGON_INTERACTIVE Win32-Anmeldemodus. UAC ist auf Windows VirtualMachineConfiguration Pools aktiviert. Wenn diese Option mit einer erhöhten Benutzeridentität in einem Windows VirtualMachineConfiguration Pool verwendet wird, wird die Benutzersitzung nicht erhöht, es sei denn, die von der Task-Befehlszeile ausgeführte Anwendung ist so konfiguriert, dass sie immer Administratorrechte oder maximale Rechte benötigt.

ManagedDisk

Objekt

Die Parameter des verwalteten Datenträgers.

Name	Typ	Beschreibung
diskEncryptionSet	DiskEncryptionSetParameters	Gibt die vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an. Er kann nur im UserSubscription-Modus festgelegt werden.
securityProfile	BatchVmDiskSecurityProfile	Gibt die Sicherheitsprofileinstellungen für den verwalteten Datenträger an.
storageAccountType	StorageAccountType	Der Speicherkontotyp für verwaltete Datenträger.

MountConfiguration

Objekt

Das Dateisystem, das auf jedem Knoten bereitgestellt werden soll.

Name	Typ	Beschreibung
azureBlobFileSystemConfiguration	AzureBlobFileSystemConfiguration	Der Azure Storage-Container, der mithilfe von BLOB-FUSE auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.
azureFileShareConfiguration	AzureFileShareConfiguration	Die Azure-Dateifreigabe, die auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.
cifsMountConfiguration	CifsMountConfiguration	Das CIFS/SMB-Dateisystem, das auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.
nfsMountConfiguration	NfsMountConfiguration	Das NFS-Dateisystem, das auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.

NetworkConfiguration

Objekt

Die Netzwerkkonfiguration für einen Pool.

Name	Typ	Beschreibung
dynamicVNetAssignmentScope	DynamicVNetAssignmentScope	Der Umfang der dynamischen vnet-Zuordnung.
enableAcceleratedNetworking	boolean	Gibt an, ob dieser Pool beschleunigte Netzwerke aktivieren soll. Das beschleunigte Netzwerk ermöglicht die einzelne E/A-Virtualisierung (SR-IOV) für einen virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter: https://v4.hkg1.meaqua.org/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration	BatchPoolEndpointConfiguration	Die Konfiguration für Endpunkte auf Compute Nodes im Batch Pool.
publicIPAddressConfiguration	BatchPublicIpAddressConfiguration	Die Öffentliche IPAddress-Konfiguration für Computeknoten im Batchpool.
subnetId	string	Die ARM-Ressourcenkennung des virtuellen Netzwerksubnetzes, dem die Rechenknoten des Pools beitreten. Dies ist das Format "/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}". Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure-Batchkonto befinden. Das angegebene Subnetz sollte genügend freie IP-Adressen haben, um die Anzahl der Rechenknoten im Pool aufzunehmen. Wenn das Subnetz nicht genügend freie IP-Adressen hat, wird der Pool die Knoten teilweise zuweisen und ein Größenänderungsfehler tritt auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss die Kommunikation vom Azure Batch-Service ermöglichen, um Aufgaben auf den Knoten planen zu können. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Knoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Es werden nur ARM-virtuelle Netzwerke ('Microsoft.Network/virtualNetworks') unterstützt. Wenn das angegebene VNet zugehörige Network Security Groups (NSG) hat, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden, darunter die Ports 29876 und 29877. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Weitere Informationen finden Sie unter: https://v4.hkg1.meaqua.org/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Objekt

Eine Netzwerksicherheitsgruppenregel, die auf einen eingehenden Endpunkt angewendet werden soll.

Name	Typ	Beschreibung
access	NetworkSecurityGroupRuleAccess	Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll.
priority	integer (int32)	Die Priorität für diese Regel. Prioritäten innerhalb eines Pools müssen einzigartig sein und in der Reihenfolge der Priorität bewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 4096. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.
sourceAddressPrefix	string	Das Quelladressenpräfix oder -tag, das für die Regel übereinstimmen soll. Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.
sourcePortRanges	string[]	Die Quellportbereiche, die für die Regel übereinstimmen sollen. Gültige Werte sind '' (für alle Ports 0 - 65535), ein bestimmter Port (d. h. 22) oder ein Portbereich (d. h. 100–200). Die Ports müssen im Bereich von 0 bis 65535 liegen. Jeder Eintrag in dieser Sammlung darf keinen anderen Eintrag überlappen (weder eine Reichweite noch ein einzelner Port). Wenn weitere Werte angegeben werden, schlägt die Anfrage mit HTTP-Statuscode 400 fehl. Der Standardwert ist ''.

NetworkSecurityGroupRuleAccess

Enumeration

NetworkSecurityGroupRuleAccess-Enume

Wert	Beschreibung
allow	Zugriff zulassen.
deny	Zugriff verweigern.

NfsMountConfiguration

Objekt

Informationen, die zum Herstellen einer Verbindung mit einem NFS-Dateisystem verwendet werden.

Name	Typ	Beschreibung
mountOptions	string	Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.
relativeMountPath	string	Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.
source	string	Der URI des zu mountden Dateisystems.

ProxyAgentSettings

Objekt

Gibt proxyAgent-Einstellungen beim Erstellen des virtuellen Computers an.

Name	Typ	Beschreibung
enabled	boolean	Gibt an, ob das Feature "Metadata Security Protocol" auf dem virtuellen Computer oder der VM-Skalierungsgruppe aktiviert werden soll. Der Standardwert ist "False".
imds	HostEndpointSettings	Einstellungen für den IMDS-Endpunkt.
wireServer	HostEndpointSettings	Einstellungen für den WireServer-Endpunkt.

ResourceFile

Objekt

Eine einzelne Datei oder mehrere Dateien, die in einen Computeknoten heruntergeladen werden sollen.

Name	Typ	Beschreibung
autoStorageContainerName	string	Der Name des Speichercontainers im automatischen Speicherkonto. Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden.
blobPrefix	string	Das Blobpräfix, das beim Herunterladen von Blobs aus einem Azure Storage-Container verwendet werden soll. Nur die Blobs, deren Namen mit dem angegebenen Präfix beginnen, werden heruntergeladen. Die Eigenschaft ist nur gültig, wenn autoStorageContainerName oder storageContainerUrl verwendet wird. Dieses Präfix kann ein teilweiser Dateiname oder ein Unterverzeichnis sein. Wenn kein Präfix angegeben ist, werden alle Dateien im Container heruntergeladen.
fileMode	string	Das Attribut für den Dateiberechtigungsmodus im oktalen Format. Diese Eigenschaft gilt nur für Dateien, die auf Linux Compute Nodes heruntergeladen werden. Sie wird ignoriert, wenn sie für eine ResourceFile angegeben ist, die auf einen Windows-Compute-Node heruntergeladen wird. Wenn diese Eigenschaft für einen Linux Compute Node nicht angegeben ist, wird der Standardwert 0770 auf die Datei angewendet.
filePath	string	Der Ort auf dem Compute-Knoten, zu dem die Datei(en) heruntergeladen werden sollen, relativ zum Arbeitsverzeichnis der Task. Wenn die httpUrl-Eigenschaft angegeben ist, ist der FilePath erforderlich und beschreibt den Pfad, in den die Datei heruntergeladen wird, einschließlich des Dateinamens. Andernfalls ist filePath optional, wenn die autoStorageContainerName- oder storageContainerUrl-Eigenschaft angegeben ist, und das Verzeichnis, in das die Dateien heruntergeladen werden sollen. Wenn FilePath als Verzeichnis verwendet wird, werden alle bereits den Eingabedaten zugeordneten Verzeichnisstruktur vollständig aufbewahrt und an das angegebene FilePath-Verzeichnis angefügt. Der angegebene relative Pfad kann nicht aus dem Arbeitsverzeichnis der Aufgabe herausbrechen (zum Beispiel durch die Verwendung von '..').
httpUrl	string (uri)	Die URL der herunterzuladenden Datei. Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Wenn die URL auf Azure Blob Storage verweist, muss sie von Computeknoten gelesen werden. Es gibt drei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Leseberechtigungen für das Blob gewährt, eine verwaltete Identität mit Leseberechtigung verwenden oder die ACL für das Blob oder dessen Container so festlegen, dass der öffentliche Zugriff zulässig ist.
identityReference	BatchNodeIdentityReference	Die Referenz auf die vom Benutzer zugewiesene Identität, die zum Zugriff auf Azure Blob Storage verwendet wird, spezifiziert durch storageContainerUrl oder httpUrl.
storageContainerUrl	string (uri)	Die URL des Blobcontainers in Azure Blob Storage. Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss von Computeknoten lesbar und auflistenbar sein. Es gibt drei Möglichkeiten, eine solche URL für einen Container in Azure Storage abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Lese- und Listenberechtigungen für den Container gewährt, eine verwaltete Identität mit Lese- und Listenberechtigungen verwenden oder die ACL für den Container so festlegen, dass der öffentliche Zugriff zugelassen wird.

RollingUpgradePolicy

Objekt

Die Konfigurationsparameter, die beim Ausführen eines rollierenden Upgrades verwendet werden.

Name	Typ	Beschreibung
enableCrossZoneUpgrade	boolean	Zulassen, dass VMSS AZ-Grenzen beim Erstellen von Upgradebatches ignoriert. Berücksichtigen Sie die Updatedomäne und maxBatchInstancePercent, um die Batchgröße zu ermitteln. Dieses Feld kann nur bei Verwendung von NodePlacementConfiguration als Zonal auf "true" oder "false" festgelegt werden.
maxBatchInstancePercent	integer (int32)	Der maximale Prozentsatz der gesamten Instanzen des virtuellen Computers, die gleichzeitig durch das rollierende Upgrade in einem Batch aktualisiert werden. Da dies ein Maximum ist, können fehlerhafte Instanzen in früheren oder zukünftigen Batches dazu führen, dass der Prozentsatz der Instanzen in einem Batch verringert wird, um eine höhere Zuverlässigkeit sicherzustellen. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.
maxUnhealthyInstancePercent	integer (int32)	Der maximale Prozentsatz der Instanzen des virtuellen Computers im Skalierungssatz, der gleichzeitig fehlerhaft sein kann, entweder aufgrund eines Upgrades oder durch die Integritätsprüfungen des virtuellen Computers in einem fehlerhaften Zustand gefunden wird, bevor das Rollupgrade abgebrochen wird. Diese Einschränkung wird vor dem Starten eines Batches überprüft. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.
maxUnhealthyUpgradedInstancePercent	integer (int32)	Der maximale Prozentsatz der aktualisierten Virtuellen Computerinstanzen, die sich in einem fehlerhaften Zustand befinden. Diese Überprüfung erfolgt, nachdem jeder Batch aktualisiert wurde. Wenn dieser Prozentsatz jemals überschritten wird, wird das rollierende Update abgebrochen. Der Wert dieses Felds sollte zwischen 0 und 100 (einschließlich) liegen.
pauseTimeBetweenBatches	string (duration)	Die Wartezeit zwischen Abschluss des Updates für alle virtuellen Computer in einem Batch und starten den nächsten Batch. Die Zeitdauer sollte im ISO 8601-Format angegeben werden.
prioritizeUnhealthyInstances	boolean	Aktualisieren Sie alle fehlerhaften Instanzen in einem Skalierungssatz, bevor alle fehlerfreien Instanzen auftreten.
rollbackFailedInstancesOnPolicyBreach	boolean	Fehler bei Rollbackinstanzen beim vorherigen Modell, wenn die Richtlinie für das Rollupgrade verletzt wird.

SecurityEncryptionTypes

Enumeration

SecurityEncryptionTypes Enums

Wert	Beschreibung
DiskWithVMGuestState	EncryptionType des verwalteten Datenträgers wird auf DiskWithVMGuestState festgelegt, um den verwalteten Datenträger zusammen mit dem VMGuestState-Blob zu verschlüsseln. Sie wird in Datenfestplatten nicht unterstützt.
NonPersistedTPM	EncryptionType des verwalteten Datenträgers wird auf NonPersistedTPM festgelegt, da der Firmwarestatus im VMGuestState-Blob nicht beibehalten wird.
VMGuestStateOnly	EncryptionType des verwalteten Datenträgers wird auf VMGuestStateOnly festgelegt, um nur das VMGuestState-Blob zu verschlüsseln.

SecurityProfile

Objekt

Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers an.

Name	Typ	Beschreibung
encryptionAtHost	boolean	Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. Weitere Informationen zur Verschlüsselung bei Hostanforderungen finden Sie unter https://v4.hkg1.meaqua.org/azure/virtual-machines/disk-encryption#supported-vm-sizes.
proxyAgentSettings	ProxyAgentSettings	Gibt proxyAgent-Einstellungen beim Erstellen des virtuellen Computers an.
securityType	SecurityTypes	Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren.
uefiSettings	BatchUefiSettings	Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden.

SecurityTypes

Enumeration

Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren.

Wert

Beschreibung

trustedLaunch

Der vertrauenswürdige Start bietet Schutz vor komplexen und permanenten Angriffstechniken.

confidentialvm

Azure Vertraulich Computing bietet vertrauliche VMs für Mandanten mit hohen Sicherheits- und Vertraulichkeitsanforderungen. Diese VMs bieten einen starken, durch Hardware erzwungenen Schutz, um Ihre Sicherheitsanforderungen zu erfüllen. Sie können vertrauliche VMs für Migrationen verwenden, ohne Änderungen an Ihrem Code vorzunehmen, wobei die Plattform, die den Status Ihrer VM schützt, nicht gelesen oder geändert wird.

ServiceArtifactReference

Objekt

Gibt die Dienstartefaktereferenz-ID an, die zum Festlegen derselben Imageversion für alle virtuellen Computer im Skalierungssatz bei Verwendung der neuesten Imageversion verwendet wird.

Name	Typ	Beschreibung
id	string	Die Service-Artefakt-Referenz-ID von ServiceArtifactReference. Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StorageAccountType

Enumeration

StorageAccountType-Enumerationen

Wert	Beschreibung
standard_lrs	Der Datenträger sollte standardmäßigen lokal redundanten Speicher verwenden.
premium_lrs	Der Datenträger sollte lokal redundanten Premium-Speicher verwenden.
standardssd_lrs	Der Datenträger/Betriebssystemdatenträger sollte standardmäßigen SSD lokal redundanten Speicher verwenden.

UpgradeMode

Enumeration

UpgradeMode-Enums

Wert	Beschreibung
automatic	Alle virtuellen Computer im Skalierungssatz werden automatisch gleichzeitig aktualisiert.
manual	Sie steuern die Anwendung von Updates auf virtuelle Computer im Skalierungssatz. Dazu verwenden Sie die ManualUpgrade-Aktion.
rolling	Die vorhandenen Instanzen in einem Skalierungssatz werden in Batches heruntergesetzt, um aktualisiert zu werden. Sobald der aktualisierte Batch abgeschlossen ist, beginnen die Instanzen erneut mit dem Datenverkehr, und der nächste Batch beginnt. Dies wird fortgesetzt, bis alle Instanzen up-to-date gebracht wurden.

UpgradePolicy

Objekt

Beschreibt eine Upgraderichtlinie – automatisch, manuell oder rolliert.

Name	Typ	Beschreibung
automaticOSUpgradePolicy	AutomaticOsUpgradePolicy	Konfigurationsparameter, die zum Ausführen des automatischen Betriebssystemupgrades verwendet werden. Die Konfigurationsparameter, die zum Ausführen eines automatischen Betriebssystemupgrades verwendet werden.
mode	UpgradeMode	Gibt den Modus eines Upgrades auf virtuelle Computer im Skalierungssatz an. Mögliche Werte: manuelle – Sie steuern die Anwendung von Updates auf virtuelle Computer im Skalierungssatz. Dazu verwenden Sie die ManualUpgrade-Aktion. Automatische – Alle virtuellen Computer im Skalierungssatz werden automatisch gleichzeitig aktualisiert. Roll- – Skalierungssatz führt Aktualisierungen in Batches mit einer optionalen Pausenzeit dazwischen durch.
rollingUpgradePolicy	RollingUpgradePolicy	Die Konfigurationsparameter, die beim Ausführen eines rollierenden Upgrades verwendet werden.

UserAccount

Objekt

Eigenschaften zum Erstellen eines Benutzers, der zum Ausführen von Aufgaben auf einem Azure Batch Compute Node verwendet wird.

Name	Typ	Beschreibung
elevationLevel	ElevationLevel	Die Erhebungsebene des Benutzerkontos. Der Standardwert ist "nonAdmin".
linuxUserConfiguration	LinuxUserConfiguration	Die Linux-spezifische Benutzerkonfiguration für das Benutzerkonto. Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt.
name	string	Der Name des Benutzerkontos. Namen können bis zu einer maximalen Länge von 20 Unicode-Zeichen enthalten.
password	string (password)	Das Passwort für das Benutzerkonto.
windowsUserConfiguration	WindowsUserConfiguration	Die Windows-spezifische Benutzerkonfiguration für das Benutzerkonto. Diese Eigenschaft kann nur angegeben werden, wenn sich der Benutzer auf einem Windows-Pool befindet. Wenn nicht angegeben und auf einem Windows-Pool ist, wird der Benutzer mit den Standardoptionen erstellt.

UserIdentity

Objekt

Die Definition der Benutzeridentität, unter der die Aufgabe ausgeführt wird. Geben Sie entweder die Eigenschaft "userName" oder "autoUser" an, aber nicht beide.

Name	Typ	Beschreibung
autoUser	AutoUserSpecification	Der automatische Benutzer, unter dem die Aufgabe ausgeführt wird. Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben.
username	string	Der Name der Benutzeridentität, unter der die Aufgabe ausgeführt wird. Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben.

VirtualMachineConfiguration

Objekt

Die Konfiguration für Computeknoten in einem Pool basierend auf der Azure Virtual Machines-Infrastruktur.

Name	Typ	Beschreibung
containerConfiguration	BatchContainerConfiguration	Die Containerkonfiguration für den Pool. Falls angegeben, wird die Einrichtung an jedem Compute-Knoten im Pool durchgeführt, damit Aufgaben in Containern ausgeführt werden können. Alle regulären Tasks und Jobmanager-Aufgaben, die auf diesem Pool ausgeführt werden, müssen die ContainerSettings-Eigenschaft angeben, und alle anderen Tasks können dies angeben.
dataDisks	DataDisk[]	Die Konfiguration für Datenfestplatten, die an die Rechenknoten im Pool angeschlossen sind. Diese Eigenschaft muss angegeben werden, wenn die Rechenknoten im Pool leere Datenfestplatten an sich angeschlossen haben müssen. Dies kann nicht aktualisiert werden. Jeder Compute-Knoten erhält seine eigene Festplatte (die Festplatte ist keine Dateifreigabe). Vorhandene Festplatten können nicht angeschlossen werden, jede angeschlossene Festplatte ist leer. Wenn der Compute-Node aus dem Pool entfernt wird, werden auch die Festplatte und alle damit verbundenen Daten gelöscht. Die Festplatte wird nach dem Anschluss nicht formatiert, sie muss vor der Nutzung formatiert werden – für weitere Informationen siehe https://v4.hkg1.meaqua.org/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux und https://v4.hkg1.meaqua.org/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.
diskEncryptionConfiguration	DiskEncryptionConfiguration	Die Datenträgerverschlüsselungskonfiguration für den Pool. Wenn angegeben, wird die Verschlüsselung für jeden Knoten im Pool während der Knotenbereitstellung ausgeführt.
extensions	VMExtension[]	Die Erweiterung des virtuellen Computers für den Pool. Wenn angegeben, werden die in dieser Konfiguration genannten Erweiterungen auf jedem Knoten installiert.
imageReference	BatchVmImageReference	Ein Verweis auf das Azure Virtual Machines Marketplace-Image oder das zu verwendende benutzerdefinierte Virtuelle Computerimage.
licenseType	string	Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollten nur verwendet werden, wenn Sie gültige On-Premises-Lizenzen für die Compute-Nodes besitzen, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Die Werte sind: Windows_Server – Die lokale Lizenz gilt für Windows Server. Windows_Client – Die lokale Lizenz ist für Windows Client.
nodeAgentSKUId	string	Die SKU des Batch-Computeknoten-Agents, der auf Computeknoten im Pool bereitgestellt werden soll. Der Batch Compute Node-Agent ist ein Programm, das auf jedem Computeknoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Computeknoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Compute Node-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Computeknoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten ComputeKnoten-Agent-SKUs sowie deren Liste der überprüften Imageverweise finden Sie unter "Liste unterstützter Computeknoten-Agent-SKUs".
nodePlacementConfiguration	BatchNodePlacementConfiguration	Die Knotenplatzierungskonfiguration für den Pool. Diese Konfiguration gibt Regeln für die physische Zuordnung von Knoten im Pool an.
osDisk	BatchOsDisk	Einstellungen für den Betriebssystemdatenträger des virtuellen Computers.
securityProfile	SecurityProfile	Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers an.
serviceArtifactReference	ServiceArtifactReference	Gibt die Dienstartefaktereferenz-ID an, die zum Festlegen derselben Imageversion für alle virtuellen Computer im Skalierungssatz bei Verwendung der neuesten Imageversion verwendet wird. Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}
windowsConfiguration	WindowsConfiguration	Windows-Betriebssystemeinstellungen auf dem virtuellen Computer. Diese Eigenschaft darf nicht angegeben werden, wenn die imageReference-Eigenschaft ein Linux-OS-Image angibt.

VMExtension

Objekt

Die Konfiguration für Erweiterungen virtueller Computer.

Name	Typ	Beschreibung
autoUpgradeMinorVersion	boolean	Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist.
enableAutomaticUpgrade	boolean	Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist.
name	string	Der Name der Erweiterung des virtuellen Computers.
protectedSettings	object	Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten.
provisionAfterExtensions	string[]	Die Sammlung von Erweiterungsnamen. Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss.
publisher	string	Der Name des Herausgebers des Erweiterungshandlers.
settings	object	JSON-formatierte öffentliche Einstellungen für die Erweiterung.
type	string	Die Art der Verlängerung.
typeHandlerVersion	string	Die Version des Skripthandlers.

WindowsConfiguration

Objekt

Windows-Betriebssystemeinstellungen, die auf den virtuellen Computer angewendet werden sollen.

Name	Typ	Beschreibung
enableAutomaticUpdates	boolean	Gibt an, ob automatische Updates auf dem virtuellen Computer aktiviert sind. Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true".

WindowsUserConfiguration

Objekt

Eigenschaften, die zum Erstellen eines Benutzerkontos auf einem Windows-Computeknoten verwendet werden.

Name	Typ	Beschreibung
loginMode	LoginMode	Der Login-Modus für den Nutzer. Standardmäßig ist 'Batch'.

Freigeben über

Pools - Create Pool

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

OAuth2Auth

Bereiche

Beispiele

Creates a pool with accelerated networking

Beispielanforderung

Beispiel für eine Antwort

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

Beispielanforderung

Beispiel für eine Antwort

Creates a pool with disk encryption set for user subscription accounts

Beispielanforderung

Beispiel für eine Antwort

Creates a pool with dual stack networking

Beispielanforderung

Beispiel für eine Antwort

Creates a pool with mount drive specified

Beispielanforderung

Beispiel für eine Antwort

Creates a pool with SecurityProfile

Beispielanforderung

Beispiel für eine Antwort

Creates a VirtualMachineConfiguration pool

Beispielanforderung

Beispiel für eine Antwort

Creates a VirtualMachineConfiguration pool with containers

Beispielanforderung

Beispiel für eine Antwort

Creates a VirtualMachineConfiguration pool with extensions

Beispielanforderung

Beispiel für eine Antwort

Creates a VirtualMachineConfiguration pool with OS disk

Beispielanforderung

Beispiel für eine Antwort

Creates a VirtualMachineConfiguration pool with ServiceArtifactReference

Beispielanforderung

Beispiel für eine Antwort

Definitionen

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