Pool - Add

Fügt dem angegebenen Konto einen Pool hinzu.
Vermeiden Sie beim Benennen von Pools vertrauliche Informationen wie Benutzernamen oder geheime Projektnamen. Diese Informationen können in Telemetrieprotokollen enthalten sein, auf die Microsoft-Supporttechniker zugreifen können.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
batchUrl
path True

string

Die Basis-URL für alle Azure Batch-Dienstanforderungen.

api-version
query True

string

Client-API-Version.

timeout
query

integer

int32

Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden aufwenden kann. Der Standardwert ist 30 Sekunden.

Anforderungsheader

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

Name Erforderlich Typ Beschreibung
client-request-id

string

uuid

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

Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. explizit festlegen, 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 alphanumerischer Zeichen enthalten, einschließlich Bindestrichen und Unterstrichen, 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ß- und Kleinschreibung unterscheiden).

vmSize True

string

Die Größe der virtuellen Computer im Pool. Alle virtuellen Computer in einem Pool haben dieselbe Größe.
Informationen zu den verfügbaren Größen virtueller Computer für Cloud Services Pools (mit cloudServiceConfiguration erstellte Pools) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle Cloud Services VM-Größen mit Ausnahme von ExtraSmall, A1V2 und A2V2. Informationen zu 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 Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure-VM-Größen mit Ausnahme von STANDARD_A0 und solchen mit Storage Premium (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).

applicationLicenses

string[]

Die Liste der Anwendungslizenzen, die der Batch-Dienst auf jedem Computeknoten im Pool verfügbar macht.
Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batch-Dienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl.

applicationPackageReferences

ApplicationPackageReference[]

Die Liste der Pakete, die auf jedem Computeknoten im Pool installiert werden sollen.
Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets voll qualifiziert 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, aber nicht auf Computeknoten, die sich bereits im Pool befinden, bis sie neu gestartet oder neu erstellt werden. Es gibt maximal 10 Paketverweise in einem bestimmten Pool.

autoScaleEvaluationInterval

string

Das Zeitintervall, in dem die Poolgröße gemäß der Formel für die automatische Skalierung automatisch angepasst werden soll.
Der Standardwert beträgt 15 Minuten. Der Mindest- und Höchstwert beträgt 5 Minuten bzw. 168 Stunden. Wenn Sie einen Wert kleiner als 5 Minuten oder mehr als 168 Stunden angeben, gibt der Batch-Dienst einen Fehler zurück. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-status Code 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. Dies ist erforderlich, wenn enableAutoScale auf true festgelegt ist. Die Formel wird auf Gültigkeit überprüft, bevor der Pool erstellt wird. Wenn die Formel ungültig ist, lehnt der Batch-Dienst die Anforderung mit detaillierten Fehlerinformationen ab. Weitere Informationen zum Angeben dieser Formel finden Sie unter Automatisches Skalieren von Computeknoten in einem Azure Batch Pool (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Die Liste der Zertifikate, die auf jedem Computeknoten im Pool installiert werden sollen.
Für Windows-Knoten installiert der Batch-Dienst die Zertifikate im angegebenen Zertifikatspeicher und Speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis innerhalb des Arbeitsverzeichnisses Task gespeichert, und eine Umgebungsvariable, AZ_BATCH_CERTIFICATES_DIR für den Task bereitgestellt wird, um diesen Speicherort abzufragen. Bei Zertifikaten mit sichtbarkeit von "remoteUser" wird im Basisverzeichnis des Benutzers (z. B. /home/{benutzername}/certs) ein Verzeichnis "certs" erstellt, und Zertifikate werden in diesem Verzeichnis platziert.

Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung .

cloudServiceConfiguration

CloudServiceConfiguration

Die Clouddienstkonfiguration für den Pool.
Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batch-Konto mit der poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt wurde.

displayName

string

Der Anzeigename für den Pool.
Der Anzeigename muss nicht eindeutig sein und kann 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 einer von targetDedicatedNodes und targetLowPriorityNodes angegeben werden. Wenn true, ist die autoScaleFormula-Eigenschaft erforderlich, und der Pool ändert die Größe automatisch gemäß der Formel. Der Standardwert ist „FALSE“.

enableInterNodeCommunication

boolean

Gibt an, ob der Pool eine direkte Kommunikation zwischen Computeknoten zulässt.
Die Aktivierung der Kommunikation zwischen Knoten schränkt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen für die Computeknoten des Pools ein. Dies kann dazu führen, dass der Pool die gewünschte Größe nicht erreicht. Der Standardwert ist „FALSE“.

metadata

MetadataItem[]

Eine Liste von Name-Wert-Paaren, die dem Pool als Metadaten zugeordnet sind.
Der Batch-Dienst weist Metadaten keine Bedeutung zu. es dient ausschließlich der Verwendung von Benutzercode.

mountConfiguration

MountConfiguration[]

Bereitstellen von Speicher mithilfe des angegebenen Dateisystems für die gesamte Lebensdauer des Pools.
Einbinden des Speichers mithilfe von Azure-Dateifreigaben, NFS, CIFS oder Blobfuse-basierten Dateisystemen.

networkConfiguration

NetworkConfiguration

Die Netzwerkkonfiguration für den Pool.
Die Netzwerkkonfiguration für einen Pool.

resizeTimeout

string

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 Batch-Dienst einen Fehler zurück. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-status Code 400 (Ungültige Anforderung).

resourceTags

object

Die benutzerdefinierten Tags, die dem Pool zugeordnet sind.
Die benutzerdefinierten Tags, die dem Azure Batch Pool zugeordnet werden sollen. Bei Angabe werden diese Tags an die dem Pool zugeordneten unterstützenden Azure-Ressourcen weitergegeben. Diese Eigenschaft kann nur angegeben werden, wenn das Batch-Konto mit der poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt wurde.

startTask

StartTask

Ein Task, der für die Ausführung auf jedem Computeknoten angegeben ist, während er dem Pool beitritt.
Der Task wird ausgeführt, wenn der Computeknoten dem Pool hinzugefügt wird oder wenn der Computeknoten neu gestartet wird.

targetDedicatedNodes

integer

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 beide festlegen.

targetLowPriorityNodes

integer

Die gewünschte Anzahl von Computeknoten mit spot/low-priority 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 beide festlegen.

targetNodeCommunicationMode

NodeCommunicationMode

Der gewünschte Knotenkommunikationsmodus für den Pool.
Wenn nicht angegeben, lautet der Standardwert Default.

taskSchedulingPolicy

TaskSchedulingPolicy

Wie Aufgaben auf Computeknoten in einem Pool verteilt werden
Wenn nicht angegeben, ist der Standardwert Spread.

taskSlotsPerNode

integer

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 der 4-fache der Anzahl der Kerne der vmSize des Pools oder 256.

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 und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden.

Antworten

Name Typ Beschreibung
201 Created

Die Anforderung an den Batch-Dienst war erfolgreich.

Headers

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

BatchError

Der Fehler vom Batch-Dienst.

Sicherheit

azure_auth

Microsoft Entra OAuth 2.0-Authentifizierungscodeflow

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

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Authorization

Type: apiKey
In: header

Beispiele

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

Add a CloudServiceConfiguration pool

Sample Request

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



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

Sample Response

Add a pool with accelerated networking

Sample Request

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



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

Sample Response

Add a pool with mount drive specified

Sample Request

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


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

Sample Response

Add a pool with SecurityProfile

Sample Request

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



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

Sample Response

Add a simple pool with resourceTags

Sample Request

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



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

Sample Response

Add a VirtualMachineConfiguration pool

Sample Request

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



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

Sample Response

Add a VirtualMachineConfiguration pool with containers

Sample Request

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



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

Sample Response

Add a VirtualMachineConfiguration pool with extensions

Sample Request

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



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

Sample Response

Add a VirtualMachineConfiguration pool with OS disk

Sample Request

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



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

Sample Response

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Sample Request

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



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

Sample Response

Definitionen

Name Beschreibung
ApplicationPackageReference

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

AutoUserScope

Der Bereich für den automatischen Benutzer

AutoUserSpecification

Gibt die Parameter für den automatischen Benutzer an, der einen Task im Batch-Dienst 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-Dateifreigabe verwendet werden.

BatchError

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

BatchErrorDetail

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

CachingType

Der Typ der Zwischenspeicherung, die für den Datenträger aktiviert werden soll.

CertificateReference

Ein Verweis auf ein Zertifikat, das auf Computeknoten in einem Pool installiert werden soll.

CertificateStoreLocation

Der Speicherort des Zertifikatspeichers auf dem Computeknoten, in dem das Zertifikat installiert werden soll.

CertificateVisibility

Welche Benutzerkonten auf dem Computeknoten sollten Zugriff auf die privaten Daten des Zertifikats haben.

CIFSMountConfiguration

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

CloudServiceConfiguration

Die Konfiguration für Computeknoten in einem Pool basierend auf der Azure Cloud Services-Plattform.

ComputeNodeFillType

Wie Aufgaben auf Computeknoten in einem Pool verteilt werden

ComputeNodeIdentityReference

Der Verweis auf eine benutzerseitig zugewiesene Identität, die dem Batch-Pool zugeordnet ist, den ein Computeknoten verwendet.

ContainerConfiguration

Die Konfiguration für containerfähige Pools.

ContainerRegistry

Eine private Containerregistrierung.

ContainerType

Die zu verwendende Containertechnologie.

ContainerWorkingDirectory

Der Speicherort des Arbeitsverzeichnisses des Containertasks.

DataDisk

Einstellungen, die von den Datenträgern verwendet werden, die Computeknoten im Pool zugeordnet sind. Wenn Sie die angefügten Datenträger verwenden, müssen Sie sie innerhalb eines virtuellen Computers einbinden und formatieren, um sie zu verwenden.

DiffDiskPlacement

Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger für alle Computeknoten (VMs) im Pool an.

DiffDiskSettings

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

DiskEncryptionConfiguration

Die Datenträgerverschlüsselungskonfiguration, die auf Computeknoten im Pool angewendet wird. Die Konfiguration der Datenträgerverschlüsselung wird in Linux-Pools, die mit dem Azure Compute Gallery-Image erstellt wurden, nicht unterstützt.

DiskEncryptionTarget

Die Liste der Datenträgerziele Der Batch-Dienst verschlüsselt auf dem Computeknoten.

DynamicVNetAssignmentScope

Der Bereich der dynamischen VNET-Zuweisung.

ElevationLevel

Die Höhenebene des Benutzers.

EnvironmentSetting

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

ErrorMessage

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

ImageReference

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 werden, finden Sie im Vorgang "Unterstützte Bilder auflisten".

InboundEndpointProtocol

Das Protokoll des Endpunkts.

InboundNATPool

Ein NAT-Pool für eingehenden Datenverkehr, der verwendet werden kann, um bestimmte Ports auf Computeknoten in einem Batchpool extern zu adressieren.

IPAddressProvisioningType

Der Bereitstellungstyp für öffentliche IP-Adressen für den Pool.

LinuxUserConfiguration

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

LoginMode

Der Anmeldemodus für den Benutzer

ManagedDisk
MetadataItem

Ein Name-Wert-Paar, das einer Batch-Dienstressource zugeordnet ist.

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

Die Aktion, die für eine angegebene IP-Adresse, einen subnetzspezifischen Bereich oder ein tag ausgeführt werden soll.

NFSMountConfiguration

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

NodeCommunicationMode

Bestimmt, wie ein Pool mit dem Batch-Dienst kommuniziert.

NodePlacementConfiguration

Knotenplatzierungskonfiguration für einen Pool.

NodePlacementPolicyType

Die Platzierungsrichtlinie zum Zuweisen von Knoten im Pool.

OSDisk

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

PoolAddParameter

Ein Pool im hinzuzufügenden Azure Batch-Dienst.

PoolEndpointConfiguration

Die Endpunktkonfiguration für einen Pool.

PublicIPAddressConfiguration

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

ResourceFile

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

SecurityProfile

Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die VM-Skalierungsgruppe an.

SecurityTypes

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

ServiceArtifactReference

Gibt die Referenz-ID des Dienstartefakts an, die verwendet wird, um dieselbe Imageversion für alle virtuellen Computer in der Skalierungsgruppe festzulegen, wenn die neueste Imageversion verwendet wird.

StartTask

Eine Aufgabe, die ausgeführt wird, wenn ein Knoten einen Pool im Azure Batch-Dienst hinzuschließt oder wenn der Computeknoten neu gestartet oder neu erstellt wird.

StorageAccountType

Der Speicherkontotyp zum Erstellen von Datenträgern oder Betriebssystemdatenträgern.

TaskContainerSettings

Die Containereinstellungen für einen Task.

TaskSchedulingPolicy

Gibt an, wie Tasks auf Computeknoten verteilt werden sollen.

UefiSettings

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

UserAccount

Eigenschaften, die zum Erstellen eines Benutzers zum Ausführen von Aufgaben auf einem Azure Batch Computeknoten verwendet werden.

UserIdentity

Die Definition der Benutzeridentität, unter der der Task ausgeführt wird.

VirtualMachineConfiguration

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

VMExtension

Die Konfiguration für VM-Erweiterungen.

WindowsConfiguration

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

WindowsUserConfiguration

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

ApplicationPackageReference

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

Name Typ Beschreibung
applicationId

string

Die ID der bereitzustellenden Anwendung.
Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets voll qualifiziert sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

version

string

Die Version der bereitzustellenden Anwendung. Wenn sie nicht angegeben wird, wird die Standardversion bereitgestellt.
Wenn dies in einem Pool ausgelassen wird und keine Standardversion für diese Anwendung angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences und HTTP status Code 409 fehl. Wenn dies für einen Task ausgelassen wird und keine Standardversion für diese Anwendung angegeben ist, schlägt der Task mit einem Vorverarbeitungsfehler fehl.

AutoUserScope

Der Bereich für den automatischen Benutzer

Name Typ Beschreibung
pool

string

Gibt an, dass der Task als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Computeknoten in einem Pool erstellt wird.

task

string

Gibt an, dass der Dienst einen neuen Benutzer für den Task erstellen soll.

AutoUserSpecification

Gibt die Parameter für den automatischen Benutzer an, der einen Task im Batch-Dienst ausführt.

Name Typ Beschreibung
elevationLevel

ElevationLevel

Die Höhenebene des automatischen Benutzers.
Der Standardwert ist nonAdmin.

scope

AutoUserScope

Der Bereich für den automatischen Benutzer
Der Standardwert ist pool. Wenn im Pool Windows ausgeführt wird, sollte ein Wert von Task angegeben werden, wenn eine strengere Isolation zwischen Aufgaben erforderlich ist. Beispielsweise, wenn die Aufgabe die Registrierung auf eine Weise mutiert, die sich auf andere Aufgaben auswirken könnte, oder wenn Zertifikate für den Pool angegeben wurden, auf die nicht für normale Aufgaben zugegriffen werden sollte, sondern von StartTasks zugänglich sein sollte.

AzureBlobFileSystemConfiguration

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

Name Typ Beschreibung
accountKey

string

Der Schlüssel des Azure-Speicherkontos.
Diese Eigenschaft schließt sich mit sasKey und identity gegenseitig aus. genau eins muss angegeben werden.

accountName

string

Der Name des Azure Storage-Kontos.

blobfuseOptions

string

Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen.
Dies sind "Net Use"-Optionen in Windows und "Mount"-Optionen unter Linux.

containerName

string

Der Azure Blob Storage Containername.

identityReference

ComputeNodeIdentityReference

Der Verweis auf die vom Benutzer zugewiesene Identität, die für den Zugriff auf containerName verwendet werden soll.
Diese Eigenschaft schließt sich mit accountKey und sasKey gegenseitig aus. genau eins muss angegeben werden.

relativeMountPath

string

Der relative Pfad auf dem Computeknoten, auf 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

Das Azure Storage-SAS-Token.
Diese Eigenschaft schließt sich mit accountKey und identity gegenseitig aus. genau eins muss angegeben werden.

AzureFileShareConfiguration

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

Name Typ Beschreibung
accountKey

string

Der Azure Storage-Kontoschlüssel

accountName

string

Der Name des Azure Storage-Kontos.

azureFileUrl

string

Die Azure Files-URL.
Dies hat die Form "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 unter Linux.

relativeMountPath

string

Der relative Pfad auf dem Computeknoten, auf 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.

BatchError

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden.

message

ErrorMessage

Eine Meldung, die den Fehler beschreibt, die für die Anzeige in einer Benutzeroberfläche geeignet sein soll.

values

BatchErrorDetail[]

Eine Auflistung von Schlüssel-Wert-Paaren mit zusätzlichen Details zum Fehler.

BatchErrorDetail

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.

CachingType

Der Typ der Zwischenspeicherung, die für den Datenträger aktiviert werden soll.

Name Typ Beschreibung
none

string

Der Zwischenspeichermodus für den Datenträger ist nicht aktiviert.

readonly

string

Der Cachemodus für den Datenträger ist schreibgeschützter.

readwrite

string

Der Zwischenspeichermodus für den Datenträger ist Lese- und Schreibzugriff.

CertificateReference

Ein Verweis auf ein Zertifikat, das auf Computeknoten in einem Pool installiert werden soll.

Name Typ Beschreibung
storeLocation

CertificateStoreLocation

Der Speicherort des Zertifikatspeichers auf dem Computeknoten, in dem das Zertifikat installiert werden soll.
Der Standardwert ist currentuser. Diese Eigenschaft gilt nur für Pools, die mit Windows-Computeknoten (d. a. mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe einer Windows-Imagereferenz erstellt wurden). Für Linux-Computeknoten werden die Zertifikate in einem Verzeichnis innerhalb des Arbeitsverzeichnisses Task gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird für den Task bereitgestellt, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird im Basisverzeichnis des Benutzers (z. B. /home/{benutzername}/certs) ein Verzeichnis "certs" erstellt, und Zertifikate werden in diesem Verzeichnis platziert.

storeName

string

Der Name des Zertifikatspeichers auf dem Computeknoten, in dem das Zertifikat installiert werden soll.
Diese Eigenschaft gilt nur für Pools, die mit Windows-Computeknoten (d. a. mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe einer Windows-Imagereferenz erstellt wurden). Allgemeine Speichernamen sind: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, aber auch ein beliebiger benutzerdefinierter Speichername kann verwendet werden. Der Standardwert ist My.

thumbprint

string

Der Fingerabdruck des Zertifikats.

thumbprintAlgorithm

string

Der Algorithmus, dem der Fingerabdruck zugeordnet ist. Dies muss sha1 sein.

visibility

CertificateVisibility[]

Welche Benutzerkonten auf dem Computeknoten Zugriff auf die privaten Daten des Zertifikats haben sollen.
Sie können mehr als eine Sichtbarkeit in dieser Sammlung angeben. Der Standardwert ist "Alle Konten".

CertificateStoreLocation

Der Speicherort des Zertifikatspeichers auf dem Computeknoten, in dem das Zertifikat installiert werden soll.

Name Typ Beschreibung
currentuser

string

Zertifikate sollten im CurrentUser-Zertifikatspeicher installiert werden.

localmachine

string

Zertifikate sollten im LocalMachine-Zertifikatspeicher installiert werden.

CertificateVisibility

Welche Benutzerkonten auf dem Computeknoten sollten Zugriff auf die privaten Daten des Zertifikats haben.

Name Typ Beschreibung
remoteuser

string

Das Zertifikat sollte für die Benutzerkonten sichtbar sein, unter denen Benutzer remote auf den Computeknoten zugreifen.

starttask

string

Das Zertifikat sollte für das Benutzerkonto sichtbar sein, unter dem der StartTask ausgeführt wird. Beachten Sie, dass dieses Zertifikat auch für den Task sichtbar ist, wenn der AutoUser-Bereich sowohl für startTask als auch für einen Task pool ist.

task

string

Das Zertifikat sollte für die Benutzerkonten sichtbar sein, unter denen Auftragsaufgaben ausgeführt werden.

CIFSMountConfiguration

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 unter Linux.

password

string

Das Kennwort, das für die Authentifizierung beim CIFS-Dateisystem verwendet werden soll.

relativeMountPath

string

Der relative Pfad auf dem Computeknoten, auf 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 dateisystems, das eingebunden werden soll.

username

string

Der Benutzer, der für die Authentifizierung beim CIFS-Dateisystem verwendet werden soll.

CloudServiceConfiguration

Die Konfiguration für Computeknoten in einem Pool basierend auf der Azure Cloud Services-Plattform.

Name Typ Beschreibung
osFamily

string

Die Azure-Gastbetriebssystemfamilie, die auf den virtuellen Computern im Pool installiert werden soll.
Mögliche Werte sind: 2 – Betriebssystemfamilie 2, entspricht Windows Server 2008 R2 SP1. 3 : Betriebssystemfamilie 3, entspricht Windows Server 2012. 4 : Betriebssystemfamilie 4, entspricht Windows Server 2012 R2. 5 : Betriebssystemfamilie 5, entspricht Windows Server 2016. 6 : Betriebssystemfamilie 6, entspricht Windows Server 2019. Weitere Informationen finden Sie unter Azure-Gastbetriebssystemversionen (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

osVersion

string

Die Azure-Gastbetriebssystemversion, die auf den virtuellen Computern im Pool installiert werden soll.
Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an.

ComputeNodeFillType

Wie Aufgaben auf Computeknoten in einem Pool verteilt werden

Name Typ Beschreibung
pack

string

Jedem Computeknoten im Pool sollten so viele Tasks wie möglich (taskSlotsPerNode) zugewiesen werden, bevor aufgaben dem nächsten Computeknoten im Pool zugewiesen werden.

spread

string

Aufgaben sollten gleichmäßig auf allen Computeknoten im Pool zugewiesen werden.

ComputeNodeIdentityReference

Der Verweis auf eine benutzerseitig zugewiesene Identität, die dem Batch-Pool zugeordnet ist, den ein Computeknoten verwendet.

Name Typ Beschreibung
resourceId

string

Die ARM-Ressourcen-ID der benutzerseitig zugewiesenen Identität.

ContainerConfiguration

Die Konfiguration für containerfähige Pools.

Name Typ Beschreibung
containerImageNames

string[]

Die Auflistung der Containerimagenamen.
Dies ist der vollständige Imageverweis, wie für "docker pull" angegeben wird. Ein Image wird aus der Docker-Standardregistrierung bezogen, es sei denn, das Image ist vollständig mit einer alternativen Registrierung qualifiziert.

containerRegistries

ContainerRegistry[]

Zusätzliche private Registrierungen, aus denen Container abgerufen werden können.
Wenn Images aus einer privaten Registrierung heruntergeladen werden müssen, die Anmeldeinformationen erfordert, müssen diese Anmeldeinformationen hier angegeben werden.

type

ContainerType

Die zu verwendende Containertechnologie.

ContainerRegistry

Eine private Containerregistrierung.

Name Typ Beschreibung
identityReference

ComputeNodeIdentityReference

Der Verweis auf die vom Benutzer zugewiesene Identität, die für den Zugriff auf eine Azure Container Registry anstelle von Benutzername und Kennwort verwendet werden soll.
Der Verweis auf eine benutzerseitig zugewiesene Identität, die dem Batch-Pool zugeordnet ist, den ein Computeknoten verwendet.

password

string

Das Kennwort für die Anmeldung beim Registrierungsserver.

registryServer

string

Die Registrierungs-URL
Wenn die Angabe weggelassen wird, ist der Standardwert "docker.io".

username

string

Der Benutzername, der beim Registrierungsserver angemeldet werden soll.

ContainerType

Die zu verwendende Containertechnologie.

Name Typ Beschreibung
criCompatible

string

Zum Starten der Container wird eine CRI-basierte Technologie verwendet.

dockerCompatible

string

Zum Starten der Container wird eine Docker-kompatible Containertechnologie verwendet.

ContainerWorkingDirectory

Der Speicherort des Arbeitsverzeichnisses des Containertasks.

Name Typ Beschreibung
containerImageDefault

string

Verwenden Sie das im Containerimage definierte Arbeitsverzeichnis. Achten Sie darauf, dass dieses Verzeichnis die von Batch heruntergeladenen Ressourcendateien nicht enthält.

taskWorkingDirectory

string

Verwenden Sie das Standardmäßige Arbeitsverzeichnis Batch-Diensttask, das die Aufgabenressourcendateien enthält, die von Batch aufgefüllt werden.

DataDisk

Einstellungen, die von den Datenträgern verwendet werden, die Computeknoten im Pool zugeordnet sind. Wenn Sie die angefügten Datenträger verwenden, müssen Sie sie innerhalb eines virtuellen Computers einbinden 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 Zwischenspeicheroptionen finden Sie unter . https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/

diskSizeGB

integer

Die anfängliche Datenträgergröße in Gigabyte.

lun

integer

Die Nummer der logischen Einheit.
Die lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn Sie mehrere Datenträger anfügen, sollte jeder über eine eigene Lun verfügen. Der Wert muss zwischen 0 und 63 (einschließlich) liegen.

storageAccountType

StorageAccountType

Der Speicherkontotyp, der für den Datenträger verwendet werden soll.
Wenn nicht angegeben, ist der Standardwert "standard_lrs".

DiffDiskPlacement

Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger für alle Computeknoten (VMs) im Pool an.

Name Typ Beschreibung
CacheDisk

string

Der kurzlebige Betriebssystemdatenträger wird im VM-Cache gespeichert.

DiffDiskSettings

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 VMs im Pool an.
Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, z. B. zwischenspeichern des Speicherplatzes für die kurzlebige Betriebssystemdatenträgerbereitstellung. Weitere Informationen zu den Anforderungen für kurzlebige Betriebssystemdatenträger finden Sie unter Anforderungen an kurzlebige Betriebssystemdatenträgergröße für Windows-VMs unter https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements und Linux-VMs unter https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

Die Datenträgerverschlüsselungskonfiguration, die auf Computeknoten im Pool angewendet wird. Die Konfiguration der Datenträgerverschlüsselung wird in Linux-Pools, die mit dem Azure Compute Gallery-Image erstellt wurden, nicht unterstützt.

Name Typ Beschreibung
targets

DiskEncryptionTarget[]

Die Liste der Datenträgerziele Der Batch-Dienst verschlüsselt auf dem Computeknoten.
Wenn sie nicht angegeben wird, werden keine Datenträger auf den Computeknoten im Pool verschlüsselt. Im Linux-Pool wird nur "TemporaryDisk" unterstützt. im Windows-Pool müssen "OsDisk" und "TemporaryDisk" angegeben werden.

DiskEncryptionTarget

Die Liste der Datenträgerziele Der Batch-Dienst verschlüsselt auf dem Computeknoten.

Name Typ Beschreibung
osdisk

string

Der Betriebssystemdatenträger auf dem Computeknoten ist verschlüsselt.

temporarydisk

string

Der temporäre Datenträger auf dem Computeknoten wird verschlüsselt. Unter Linux gilt diese Verschlüsselung für andere Partitionen (z. B. auf eingebundenen Datenträgern), wenn die Verschlüsselung zum Startzeitpunkt erfolgt.

DynamicVNetAssignmentScope

Der Bereich der dynamischen VNET-Zuweisung.

Name Typ Beschreibung
job

string

Die dynamische VNET-Zuweisung erfolgt auftragsbezogen.

none

string

Es ist keine dynamische VNET-Zuweisung aktiviert.

ElevationLevel

Die Höhenebene des Benutzers.

Name Typ Beschreibung
admin

string

Der Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen.

nonadmin

string

Der Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff.

EnvironmentSetting

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

Name Typ Beschreibung
name

string

Der Name der Umgebungsvariablen.

value

string

Der Wert der Umgebungsvariablen.

ErrorMessage

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

Name Typ Beschreibung
lang

string

Der Sprachcode der Fehlermeldung

value

string

Der Text der Meldung.

ImageReference

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 werden, finden Sie im Vorgang "Unterstützte Bilder auflisten".

Name Typ Beschreibung
exactVersion

string

Die spezifische Version des Plattformimages oder Marketplace-Images, das zum Erstellen des Knotens verwendet wird. Dieses schreibgeschützte Feld unterscheidet sich von "version" nur, wenn der Wert für "version" bei der Erstellung des Pools "latest" angegeben wurde.

offer

string

Der Angebotstyp des Azure Virtual Machines Marketplace-Images.
Beispiel: UbuntuServer oder WindowsServer.

publisher

string

Der Herausgeber des Azure Virtual Machines Marketplace-Images.
Beispiel: Canonical oder MicrosoftWindowsServer.

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.
Der Wert "latest" kann angegeben werden, um die neueste Version eines Images auszuwählen. Wenn die Angabe weggelassen wird, ist der Standardwert "latest".

virtualMachineImageId

string

Der ARM-Ressourcenbezeichner des Azure Compute Gallery-Images. Computeknoten im Pool werden mit dieser Image-ID erstellt. Dies hat das Format /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} für immer die neueste Imageversion.
Diese Eigenschaft schließt sich mit anderen ImageReference-Eigenschaften gegenseitig aus. Das Azure Compute Gallery-Image muss Über Replikate in derselben Region verfügen und sich im selben Abonnement wie das Azure Batch-Konto befinden. Wenn die Imageversion nicht in der imageId angegeben ist, wird die neueste Version verwendet. Informationen zu den Firewalleinstellungen für den Batch Compute Node-Agent für die Kommunikation mit dem Batch-Dienst finden Sie unter https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Das Protokoll des Endpunkts.

Name Typ Beschreibung
tcp

string

Verwenden Sie TCP für den Endpunkt.

udp

string

Verwenden Sie UDP für den Endpunkt.

InboundNATPool

Ein NAT-Pool für eingehenden Datenverkehr, der verwendet werden kann, um bestimmte Ports auf Computeknoten in einem Batchpool extern zu adressieren.

Name Typ Beschreibung
backendPort

integer

Die Portnummer auf dem Computeknoten.
Dies muss innerhalb eines Batchpools eindeutig sein. Zulässige Werte liegen zwischen 1 und 65535, mit Ausnahme von 22, 3389, 29876 und 29877, da diese reserviert sind. Wenn reservierte Werte angegeben werden, schlägt die Anforderung mit HTTP-status Code 400 fehl.

frontendPortRangeEnd

integer

Die letzte Portnummer im Bereich der externen Ports, die verwendet wird, um eingehenden Zugriff auf den back-EndPort auf einzelnen Computeknoten zu ermöglichen.
Zulässige Werte liegen zwischen 1 und 65534, mit Ausnahme von Ports von 50000 bis 55000, die vom Batch-Dienst reserviert werden. Alle Bereiche innerhalb eines Pools müssen unterschiedlich sein und dürfen sich nicht überschneiden. Jeder Bereich muss mindestens 40 Ports enthalten. Wenn reservierte oder überlappende Werte angegeben werden, schlägt die Anforderung mit HTTP-status Code 400 fehl.

frontendPortRangeStart

integer

Die erste Portnummer im Bereich externer Ports, die verwendet wird, um eingehenden Zugriff auf den back-EndPort auf einzelnen Computeknoten zu ermöglichen.
Zulässige Werte liegen zwischen 1 und 65534, mit Ausnahme der reservierten Ports zwischen 50000 und 55000. Alle Bereiche innerhalb eines Pools müssen unterschiedlich sein und dürfen sich nicht überschneiden. Jeder Bereich muss mindestens 40 Ports enthalten. Wenn reservierte oder überlappende Werte angegeben werden, schlägt die Anforderung mit HTTP-status Code 400 fehl.

name

string

Der Name des Endpunkts.
Der Name muss innerhalb eines Batchpools eindeutig sein und kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen nicht länger als 77 Zeichen sein. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit HTTP-status Code 400 fehl.

networkSecurityGroupRules

NetworkSecurityGroupRule[]

Eine Liste von Netzwerksicherheitsgruppenregeln, die auf den Endpunkt angewendet werden.
Die maximale Anzahl von Regeln, die für alle Endpunkte in einem Batchpool angegeben werden können, beträgt 25. Wenn keine Netzwerksicherheitsgruppenregeln angegeben werden, wird eine Standardregel erstellt, um eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit HTTP-status Code 400 fehl.

protocol

InboundEndpointProtocol

Das Protokoll des Endpunkts.

IPAddressProvisioningType

Der Bereitstellungstyp für öffentliche IP-Adressen für den Pool.

Name Typ Beschreibung
batchmanaged

string

Eine öffentliche IP-Adresse wird von Batch erstellt und verwaltet. Abhängig von der Größe des Pools können mehrere öffentliche IP-Adressen vorhanden sein.

nopublicipaddresses

string

Es wird keine öffentliche IP-Adresse erstellt.

usermanaged

string

Öffentliche IP-Adressen werden vom Benutzer bereitgestellt und zum Bereitstellen der Computeknoten verwendet.

LinuxUserConfiguration

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

Name Typ Beschreibung
gid

integer

Die Gruppen-ID für das Benutzerkonto.
Die Eigenschaften uid und gid müssen zusammen oder gar nicht angegeben werden. Wenn nicht angegeben, wählt das zugrunde liegende Betriebssystem den Gid aus.

sshPrivateKey

string

Der private SSH-Schlüssel für das Benutzerkonto.
Der private Schlüssel darf nicht kennwortgeschützter sein. Der private Schlüssel wird verwendet, um die asymmetrische Schlüsselbasierte Authentifizierung für SSH zwischen Computeknoten in einem Linux-Pool automatisch zu konfigurieren, wenn die Eigenschaft enableInterNodeCommunication des Pools true ist (sie wird ignoriert, wenn enableInterNodeCommunication false ist). Dazu wird das Schlüsselpaar im SSH-Verzeichnis des Benutzers platziert. Wenn nicht angegeben, wird ssh ohne Kennwort nicht zwischen Computeknoten konfiguriert (es erfolgt keine Änderung des SSH-Verzeichnisses des Benutzers).

uid

integer

Die Benutzer-ID des Benutzerkontos.
Die Eigenschaften uid und gid müssen zusammen oder gar nicht angegeben werden. Wenn nicht angegeben, wählt das zugrunde liegende Betriebssystem die UID aus.

LoginMode

Der Anmeldemodus für den Benutzer

Name Typ Beschreibung
batch

string

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

interactive

string

Der LOGON32_LOGON_INTERACTIVE Win32-Anmeldemodus. UAC ist für Windows VirtualMachineConfiguration Pools aktiviert. Wenn diese Option mit einer Benutzeridentität mit erhöhten Rechten 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 immer Administratorrechte erforderlich sind oder immer maximale Berechtigungen erforderlich sind.

ManagedDisk

Name Typ Beschreibung
storageAccountType

StorageAccountType

Der Speicherkontotyp für verwaltete Datenträger.

MetadataItem

Ein Name-Wert-Paar, das einer Batch-Dienstressource zugeordnet ist.

Name Typ Beschreibung
name

string

Der Name des Metadatenelements.

value

string

Der Wert des Metadatenelements.

MountConfiguration

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 mit allen anderen Eigenschaften gegenseitig aus.

azureFileShareConfiguration

AzureFileShareConfiguration

Die Azure-Dateifreigabe, die auf jedem Knoten bereitgestellt werden soll.
Diese Eigenschaft schließt sich mit allen anderen Eigenschaften gegenseitig aus.

cifsMountConfiguration

CIFSMountConfiguration

Das CIFS/SMB-Dateisystem, das auf jedem Knoten bereitgestellt werden soll.
Diese Eigenschaft schließt sich mit allen anderen Eigenschaften gegenseitig aus.

nfsMountConfiguration

NFSMountConfiguration

Das NFS-Dateisystem, das auf jedem Knoten bereitgestellt werden soll.
Diese Eigenschaft schließt sich mit allen anderen Eigenschaften gegenseitig aus.

NetworkConfiguration

Die Netzwerkkonfiguration für einen Pool.

Name Typ Beschreibung
dynamicVNetAssignmentScope

DynamicVNetAssignmentScope

Der Bereich der dynamischen VNET-Zuweisung.

enableAcceleratedNetworking

boolean

Gibt an, ob dieser Pool beschleunigtes Netzwerk aktivieren soll.
Beschleunigter Netzwerkbetrieb ermöglicht die Single-Root-E/A-Virtualisierung (SR-IOV) für einen virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

endpointConfiguration

PoolEndpointConfiguration

Die Konfiguration für Endpunkte auf Computeknoten im Batchpool.
Die Konfiguration des Poolendpunkts wird nur für Pools mit der eigenschaft virtualMachineConfiguration unterstützt.

publicIPAddressConfiguration

PublicIPAddressConfiguration

Die Öffentliche IPAddress-Konfiguration für Computeknoten im Batch-Pool.
Die Eigenschaft der öffentlichen IP-Konfiguration wird nur in Pools mit der eigenschaft virtualMachineConfiguration unterstützt.

subnetId

string

Der ARM-Ressourcenbezeichner des Subnetzes des virtuellen Netzwerks, dem die Computeknoten des Pools beitreten. Dies hat das Format /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.
Das virtuelle Netzwerk muss sich in derselben Region und demselben Abonnement wie das Azure Batch-Konto befinden. Das angegebene Subnetz sollte über genügend freie IP-Adressen verfügen, um die Anzahl der Computeknoten im Pool zu berücksichtigen. Wenn das Subnetz nicht über genügend freie IP-Adressen verfügt, weist der Pool Knoten teilweise zu, und es tritt ein Fehler beim Ändern der Größe auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Mitwirkender virtueller klassischer Computer" Role-Based Access Control (RBAC) für das angegebene VNET verfügen. Das angegebene Subnetz muss die Kommunikation vom Azure Batch Dienst zulassen, damit Aufgaben auf den Knoten geplant werden können. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNET über netzwerksicherheitsgruppen (NSG) verfügt. Wenn die Kommunikation mit den Knoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batch-Dienst den Zustand der Computeknoten auf unbrauchbar fest. Für Pools, die mit virtualMachineConfiguration erstellt wurden, werden nur virtuelle ARM-Netzwerke ('Microsoft.Network/virtualNetworks') unterstützt, aber für Pools, die mit cloudServiceConfiguration erstellt wurden, werden sowohl ARM als auch klassische virtuelle Netzwerke unterstützt. Falls dem angegebenen VNET Netzwerksicherheitsgruppen (NSGs) zugeordnet sind, müssen einige reservierte Systemports für die eingehende Kommunikation aktiviert werden. Aktivieren Sie für Pools, die mit einer VM-Konfiguration erstellt wurden, die Ports 29876 und 29877 sowie Port 22 für Linux und Port 3389 für Windows. Aktivieren Sie für Pools, die mit einer Clouddienstkonfiguration erstellt wurden, die Ports 10100, 20100 und 30100. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage an Port 443. Weitere Informationen finden Sie unter: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

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 subnetzspezifischen Bereich oder ein tag ausgeführt werden soll.

priority

integer

Die Priorität für diese Regel.
Prioritäten innerhalb eines Pools müssen eindeutig sein und in der Reihenfolge der Priorität bewertet werden. Je niedriger die Nummer ist, desto höher ist die Priorität. Beispielsweise könnten Regeln mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit der Reihenfolge 250. Zulässige Prioritäten sind 150 bis 4096. Wenn reservierte oder doppelte Werte angegeben werden, schlägt die Anforderung mit HTTP-status Code 400 fehl.

sourceAddressPrefix

string

Das Quelladresseprä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 angegeben werden, schlägt die Anforderung mit HTTP-status Code 400 fehl.

sourcePortRanges

string[]

Der Quellportbereich, der für die Regel entspricht.
Gültige Werte sind "" (für alle Ports 0 - 65535), einen bestimmten Port (d. h. 22) oder einen Portbereich (d. h. 100-200). Die Ports müssen im Bereich von 0 bis 65535 liegen. Jeder Eintrag in dieser Auflistung darf keinen anderen Eintrag (weder einen Bereich noch einen einzelnen Port) überlappen. Wenn andere Werte angegeben werden, schlägt die Anforderung mit HTTP-status Code 400 fehl. Der Standardwert ist "".

NetworkSecurityGroupRuleAccess

Die Aktion, die für eine angegebene IP-Adresse, einen subnetzspezifischen Bereich oder ein tag ausgeführt werden soll.

Name Typ Beschreibung
allow

string

Zugriff zulassen.

deny

string

Zugriff verweigern.

NFSMountConfiguration

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 unter Linux.

relativeMountPath

string

Der relative Pfad auf dem Computeknoten, auf 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 dateisystems, das eingebunden werden soll.

NodeCommunicationMode

Bestimmt, wie ein Pool mit dem Batch-Dienst kommuniziert.

Name Typ Beschreibung
classic

string

Knoten, die den klassischen Kommunikationsmodus verwenden, erfordern eingehende TCP-Kommunikation an den Ports 29876 und 29877 aus dem BatchNodeManagement. {region}" Diensttag und ausgehende TCP-Kommunikation an Port 443 zu "Storage.region" und "BatchNodeManagement. {region}"-Diensttags.

default

string

Der Knotenkommunikationsmodus wird automatisch vom Batch-Dienst festgelegt.

simplified

string

Knoten, die den vereinfachten Kommunikationsmodus verwenden, benötigen ausgehende TCP-Kommunikation an Port 443 an das "BatchNodeManagement. {region}"-Diensttag. Es sind keine offenen eingehenden Ports erforderlich.

NodePlacementConfiguration

Knotenplatzierungskonfiguration für einen Pool.

Name Typ Beschreibung
policy

NodePlacementPolicyType

Knotenplatzierungsrichtlinientyp für Batchpools.
Zuordnungsrichtlinie, die vom Batch-Dienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalpolitik.

NodePlacementPolicyType

Die Platzierungsrichtlinie zum Zuweisen von Knoten im Pool.

Name Typ Beschreibung
regional

string

Alle Knoten im Pool werden in derselben Region zugeordnet.

zonal

string

Knoten im Pool werden auf verschiedene Verfügbarkeitszonen verteilt, wobei ein Optimalaufwand ausgeglichen wird.

OSDisk

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

Name Typ Beschreibung
caching

CachingType

Gibt die Cacheanforderungen an. Mögliche Werte sind: None, ReadOnly, ReadWrite. Die Standardwerte sind: Keine für Standardspeicher. ReadOnly für Storage Premium.
Der Standardwert für die Zwischenspeicherung ist none. 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

Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers.

ephemeralOSDiskSettings

DiffDiskSettings

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.

PoolAddParameter

Ein Pool im hinzuzufügenden Azure Batch-Dienst.

Name Typ Beschreibung
applicationLicenses

string[]

Die Liste der Anwendungslizenzen, die der Batch-Dienst auf jedem Computeknoten im Pool zur Verfügung stellt.
Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batch-Dienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl.

applicationPackageReferences

ApplicationPackageReference[]

Die Liste der Pakete, die auf jedem Computeknoten im Pool installiert werden sollen.
Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets voll qualifiziert sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Änderungen an Paketverweisen 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 ein erneutes Image erstellt werden. Es gibt maximal 10 Paketverweise für einen bestimmten Pool.

autoScaleEvaluationInterval

string

Das Zeitintervall, in dem die Poolgröße gemäß der Formel für die autoskalierte Skalierung automatisch angepasst werden soll.
Der Standardwert beträgt 15 Minuten. Der Mindest- und Höchstwert 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 Batch-Dienst einen Fehler zurück. Wenn Sie die REST-API direkt aufrufen, ist der HTTP-status Code 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. Dies ist erforderlich, wenn enableAutoScale auf true festgelegt ist. Die Formel wird auf Gültigkeit überprüft, bevor der Pool erstellt wird. Wenn die Formel ungültig ist, lehnt der Batch-Dienst die Anforderung mit detaillierten Fehlerinformationen ab. Weitere Informationen zum Angeben dieser Formel finden Sie unter Automatisches Skalieren von Computeknoten in einem Azure Batch Pool (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Die Liste der Zertifikate, die auf jedem Computeknoten im Pool installiert werden sollen.
Für Windows-Knoten installiert der Batch-Dienst die Zertifikate im angegebenen Zertifikatspeicher und Speicherort. Für Linux-Computeknoten werden die Zertifikate in einem Verzeichnis innerhalb des Arbeitsverzeichnisses Task gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird für den Task bereitgestellt, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird im Basisverzeichnis des Benutzers (z. B. /home/{benutzername}/certs) ein Verzeichnis "certs" erstellt, und Zertifikate werden in diesem Verzeichnis platziert.

Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung .

cloudServiceConfiguration

CloudServiceConfiguration

Die Clouddienstkonfiguration für den Pool.
Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batch-Konto mit der poolAllocationMode-Eigenschaft erstellt wurde, die auf "UserSubscription" festgelegt ist.

displayName

string

Der Anzeigename für den Pool.
Der Anzeigename muss nicht eindeutig sein und kann 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.
Bei false muss mindestens einer von targetDedicatedNodes und targetLowPriorityNodes angegeben werden. Wenn true, ist die autoScaleFormula-Eigenschaft erforderlich, und der Pool ändert die Größe automatisch gemäß der Formel. Der Standardwert ist „FALSE“.

enableInterNodeCommunication

boolean

Gibt an, ob der Pool die direkte Kommunikation zwischen Computeknoten zulässt.
Das Aktivieren der Knotenkommunikation schränkt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen für die Computeknoten des Pools ein. 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 von 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 wird 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

MetadataItem[]

Eine Liste von Name-Wert-Paaren, die dem Pool als Metadaten zugeordnet sind.
Der Batch-Dienst weist Metadaten keine Bedeutung zu. es dient ausschließlich der Verwendung von Benutzercode.

mountConfiguration

MountConfiguration[]

Binden Sie Speicher mithilfe des angegebenen Dateisystems für die gesamte Lebensdauer des Pools ein.
Binden Sie den Speicher mithilfe des auf Azure-Dateifreigabe, NFS, CIFS oder Blobfuse basierenden Dateisystems ein.

networkConfiguration

NetworkConfiguration

Die Netzwerkkonfiguration für den Pool.
Die Netzwerkkonfiguration für einen Pool.

resizeTimeout

string

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 Batch-Dienst einen Fehler zurück. Wenn Sie die REST-API direkt aufrufen, ist der HTTP-status Code 400 (ungültige Anforderung).

resourceTags

object

Die benutzerdefinierten Tags, die dem Pool zugeordnet sind.
Die benutzerdefinierten Tags, die dem Azure Batch Pool zugeordnet werden sollen. Wenn sie angegeben sind, werden diese Tags an die dem Pool zugeordneten, untergeordneten Azure-Ressourcen weitergegeben. Diese Eigenschaft kann nur angegeben werden, wenn das Batch-Konto erstellt wurde, wobei die poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt ist.

startTask

StartTask

Ein Task, der auf jedem Computeknoten ausgeführt werden soll, wenn er dem Pool beitritt.
Der Task wird ausgeführt, wenn der Computeknoten dem Pool hinzugefügt wird oder wenn der Computeknoten neu gestartet wird.

targetDedicatedNodes

integer

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

Die gewünschte Anzahl von Computeknoten mit spot/low-priority 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.

targetNodeCommunicationMode

NodeCommunicationMode

Der kommunikationsmodus für den gewünschten Knoten für den Pool.
Wenn der Wert nicht angegeben wird, lautet der Standardwert Default.

taskSchedulingPolicy

TaskSchedulingPolicy

Wie Aufgaben auf Computeknoten in einem Pool verteilt werden.
Wenn nicht angegeben, ist der Standardwert spread.

taskSlotsPerNode

integer

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 der 4-fache der Anzahl der Kerne des vmSize-Pools oder 256.

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 und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden.

vmSize

string

Die Größe der virtuellen Computer im Pool. Alle virtuellen Computer in einem Pool haben die gleiche Größe.
Informationen zu verfügbaren Größen von virtuellen Computern für Cloud Services Pools (mit cloudServiceConfiguration erstellte Pools) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle Cloud Services VM-Größen außer ExtraSmall, A1V2 und A2V2. Informationen zu verfügbaren VM-Größen für Pools mit Images aus dem Virtual Machines Marketplace (mit virtualMachineConfiguration erstellte Pools) finden Sie unter Größen für Virtual Machines (Linux)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ oder Größen für Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure-VM-Größen mit Ausnahme von STANDARD_A0 und Premium-Speicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).

PoolEndpointConfiguration

Die Endpunktkonfiguration für einen Pool.

Name Typ Beschreibung
inboundNATPools

InboundNATPool[]

Eine Liste eingehender NAT-Pools, die verwendet werden können, um bestimmte Ports auf einem einzelnen Computeknoten extern zu adressieren.
Die maximale Anzahl eingehender NAT-Pools pro Batchpool beträgt 5. Wenn die maximale Anzahl eingehender NAT-Pools überschritten wird, schlägt die Anforderung mit HTTP-status Code 400 fehl. Dies kann nicht angegeben werden, wenn IPAddressProvisioningType NoPublicIPAddresses ist.

PublicIPAddressConfiguration

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

Name Typ Beschreibung
ipAddressIds

string[]

Die Liste der öffentlichen IP-Adressen, die der Batch-Dienst bei der Bereitstellung von Computeknoten verwendet.
Die hier angegebene Anzahl von IP-Adressen schränkt die maximale Größe des Pools ein: 100 dedizierte Knoten oder 100 Spot-/Low-Priority-Knoten können für jede öffentliche IP-Adresse zugewiesen werden. Für einen Pool, der 250 dedizierte VMs benötigt, werden beispielsweise mindestens 3 öffentliche IP-Adressen angegeben. Jedes Element dieser Sammlung hat das Folgende: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

IPAddressProvisioningType

Der Bereitstellungstyp für öffentliche IP-Adressen für den Pool.
Der Standardwert ist BatchManaged.

ResourceFile

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

Name Typ Beschreibung
autoStorageContainerName

string

Der Name des Speichercontainers im Konto des automatischen Speichers.
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 partieller Dateiname oder ein Unterverzeichnis sein. Wenn kein Präfix angegeben wird, werden alle Dateien im Container heruntergeladen.

fileMode

string

Das Attribut des Dateiberechtigungsmodus im oktalen Format.
Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile-Datei angegeben wird, die auf einen Windows-Computeknoten heruntergeladen wird. Wenn diese Eigenschaft nicht für einen Linux-Computeknoten angegeben ist, wird der Standardwert 0770 auf die Datei angewendet.

filePath

string

Der Speicherort auf dem Computeknoten, in den die Datei(en) heruntergeladen werden sollen, relativ zum Arbeitsverzeichnis des Tasks.
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 und das Verzeichnis, in das die Dateien heruntergeladen werden sollen, wenn die Eigenschaft autoStorageContainerName oder storageContainerUrl angegeben wird. Für den Fall, dass filePath als Verzeichnis verwendet wird, wird jede Verzeichnisstruktur, die den Eingabedaten bereits zugeordnet ist, vollständig beibehalten und an das angegebene FilePath-Verzeichnis angefügt. Der angegebene relative Pfad kann nicht aus dem Arbeitsverzeichnis der Aufgabe herausbrechen (z. B. mithilfe von "..").

httpUrl

string

Die URL der herunterzuladenden Bilds.
Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Wenn die URL auf Azure Blob Storage zeigt, muss sie von Computeknoten gelesen werden. Es gibt drei Möglichkeiten, eine solche URL für ein Blob in Azure Storage abzurufen: Beispielsweise eine SAS (Shared Access Signature), die Leseberechtigungen für das Blob gewährt, eine verwaltete Identität mit Leseberechtigung verwenden oder die ACL für das Blob oder seinen Container festlegen, um den öffentlichen Zugriff zuzulassen.

identityReference

ComputeNodeIdentityReference

Der Verweis auf die benutzerseitig zugewiesene Identität, die für den Zugriff auf Azure Blob Storage verwendet werden soll, der durch storageContainerUrl oder httpUrl angegeben wird.
Der Verweis auf eine benutzerseitig zugewiesene Identität, die dem Batch-Pool zugeordnet ist, den ein Computeknoten verwendet.

storageContainerUrl

string

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: Beispielsweise eine SAS (Shared Access Signature), 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 festlegen, um den öffentlichen Zugriff zuzulassen.

SecurityProfile

Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die VM-Skalierungsgruppe 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 VM-Skalierungsgruppe zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger aktiviert, einschließlich ressourcen-/temporärer Datenträger auf dem Host selbst.

securityType

SecurityTypes

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

uefiSettings

UefiSettings

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

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

Name Typ Beschreibung
trustedLaunch

string

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

ServiceArtifactReference

Gibt die Referenz-ID des Dienstartefakts an, die verwendet wird, um dieselbe Imageversion für alle virtuellen Computer in der Skalierungsgruppe festzulegen, wenn die neueste Imageversion verwendet wird.

Name Typ Beschreibung
id

string

Die Referenz-ID des Dienstartefakts von ServiceArtifactReference
Die Dienstartefaktverweis-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StartTask

Eine Aufgabe, die ausgeführt wird, wenn ein Knoten einen Pool im Azure Batch-Dienst hinzuschließt oder wenn der Computeknoten neu gestartet oder neu erstellt wird.

Name Typ Beschreibung
commandLine

string

Die Befehlszeile von StartTask.
Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher keine Shellfeatures wie die Erweiterung von Umgebungsvariablen nutzen. Wenn Sie solche Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder mit "/bin/sh -c MyCommand" unter Linux. Wenn die Befehlszeile auf Dateipfade verweist, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis Task) verwenden oder die von Batch bereitgestellte Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) verwenden.

containerSettings

TaskContainerSettings

Die Einstellungen für den Container, unter dem startTask ausgeführt wird.
Wenn dies angegeben ist, werden alle Verzeichnisse, die sich rekursiv unterhalb des AZ_BATCH_NODE_ROOT_DIR befinden (der Stamm der Azure Batch Verzeichnisse auf dem Knoten) dem Container zugeordnet, alle Umgebungsvariablen der Aufgabe werden dem Container zugeordnet, und die Task-Befehlszeile wird im Container ausgeführt. Dateien, die im Container außerhalb von AZ_BATCH_NODE_ROOT_DIR erstellt werden, werden möglicherweise nicht auf dem Hostdatenträger angezeigt, was bedeutet, dass Batch-Datei-APIs nicht auf diese Dateien zugreifen können.

environmentSettings

EnvironmentSetting[]

Eine Liste der Umgebungsvariableneinstellungen für startTask.

maxTaskRetryCount

integer

Die maximale Anzahl von Wiederholungsversuchen für den Vorgang.
Der Batch-Dienst versucht einen Vorgang erneut, wenn sein Exitcode nicht zero ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batch-Dienst versucht den Task einmal und kann dann bis zu diesem Grenzwert wiederholen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 beträgt, versucht Batch den Vorgang bis zu vier Mal (ein erster Versuch und 3 Wiederholungen). Wenn die maximale Wiederholungsanzahl 0 ist, versucht der Batch-Dienst den Vorgang nicht erneut. Wenn die maximale Wiederholungsanzahl -1 beträgt, wiederholt der Batch-Dienst den Vorgang ohne Einschränkung. Dies wird jedoch nicht für einen Startvorgang oder eine beliebige Aufgabe empfohlen. Der Standardwert ist 0 (keine Wiederholungsversuche).

resourceFiles

ResourceFile[]

Eine Liste der Dateien, die der Batch-Dienst vor dem Ausführen der Befehlszeile auf den Computeknoten lädt. 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. In diesem Fall muss die Auflistung von ResourceFiles verkleinert werden. Dies kann mit .zip-Dateien, Anwendungspaketen oder Docker-Containern erreicht werden.
Die unter diesem Element aufgeführten Dateien befinden sich im Arbeitsverzeichnis des Tasks.

userIdentity

UserIdentity

Die Benutzeridentität, unter der startTask ausgeführt wird.
Wenn er nicht angegeben wird, wird der Task als nicht administrativer Benutzer ausgeführt, der für den Task eindeutig ist.

waitForSuccess

boolean

Gibt an, ob der Batch-Dienst warten soll, bis der StartTask erfolgreich abgeschlossen wurde (d. h. mit Exitcode 0 beendet wird), bevor Aufgaben auf dem Computeknoten geplant werden.
Wenn true und der StartTask auf einem Knoten fehlschlägt, führt der Batch-Dienst die StartTask erneut auf die maximale Wiederholungsanzahl (maxTaskRetryCount) aus. Wenn der Task nach allen Wiederholungen immer noch nicht erfolgreich abgeschlossen wurde, markiert der Batch-Dienst den Knoten als unbrauchbar und plant keine Aufgaben dafür. Diese Bedingung kann über die Details zu Status und Fehlerinformationen des Computeknotens erkannt werden. Bei false wartet der Batch-Dienst nicht auf den Abschluss von StartTask. In diesem Fall können andere Tasks mit der Ausführung auf dem Computeknoten beginnen, während startTask noch ausgeführt wird. Und selbst wenn startTask fehlschlägt, werden neue Tasks weiterhin auf dem Computeknoten geplant. Der Standardwert ist „true“.

StorageAccountType

Der Speicherkontotyp zum Erstellen von Datenträgern oder Betriebssystemdatenträgern.

Name Typ Beschreibung
premium_lrs

string

Der Datenträger/Betriebssystemdatenträger sollte lokal redundanten Premium-Speicher verwenden.

standard_lrs

string

Der Datenträger/Betriebssystemdatenträger sollte lokal redundanten Standardspeicher verwenden.

standardssd_lrs

string

Der Datenträger/Betriebssystemdatenträger sollte lokal redundanten SSD-Standardspeicher verwenden.

TaskContainerSettings

Die Containereinstellungen für einen Task.

Name Typ Beschreibung
containerRunOptions

string

Zusätzliche Optionen für den Befehl container create.
Diese zusätzlichen Optionen werden zusätzlich zu den vom Batch-Dienst gesteuerten Optionen als Argumente für den Befehl "docker create" bereitgestellt.

imageName

string

Das Image, das zum Erstellen des Containers verwendet werden soll, in dem der Task ausgeführt wird.
Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben wird. Wenn kein Tag als Teil des Imagenamens angegeben wird, wird das Tag ":latest" als Standard verwendet.

registry

ContainerRegistry

Die private Registrierung, die das Containerimage enthält.
Diese Einstellung kann weggelassen werden, wenn bereits bei der Poolerstellung angegeben wurde.

workingDirectory

ContainerWorkingDirectory

Der Speicherort des Arbeitsverzeichnisses des Containertasks.
Der Standardwert ist "taskWorkingDirectory".

TaskSchedulingPolicy

Gibt an, wie Tasks auf Computeknoten verteilt werden sollen.

Name Typ Beschreibung
nodeFillType

ComputeNodeFillType

Wie Aufgaben auf Computeknoten in einem Pool verteilt werden.
Wenn nicht angegeben, ist der Standardwert spread.

UefiSettings

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.

UserAccount

Eigenschaften, die zum Erstellen eines Benutzers zum Ausführen von Aufgaben auf einem Azure Batch Computeknoten verwendet werden.

Name Typ Beschreibung
elevationLevel

ElevationLevel

Die Höhenstufe des Benutzerkontos.
Der Standardwert ist nonAdmin.

linuxUserConfiguration

LinuxUserConfiguration

Die Linux-spezifische Benutzerkonfiguration für das Benutzerkonto.
Diese Eigenschaft wird ignoriert, wenn sie für einen Windows-Pool angegeben wird. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt.

name

string

Der Name des Benutzerkontos. Namen können beliebige Unicode-Zeichen bis zu einer maximalen Länge von 20 enthalten.

password

string

Das Kennwort für das Benutzerkonto.

windowsUserConfiguration

WindowsUserConfiguration

Die Windows-spezifische Benutzerkonfiguration für das Benutzerkonto.
Diese Eigenschaft kann nur angegeben werden, wenn sich der Benutzer in einem Windows-Pool befindet. Wenn nicht angegeben und in einem Windows-Pool, wird der Benutzer mit den Standardoptionen erstellt.

UserIdentity

Die Definition der Benutzeridentität, unter der der Task ausgeführt wird.

Name Typ Beschreibung
autoUser

AutoUserSpecification

Der automatische Benutzer, unter dem der Task ausgeführt wird.
Die Eigenschaften userName und autoUser schließen sich gegenseitig aus. Sie müssen eine angeben, aber nicht beide.

username

string

Der Name der Benutzeridentität, unter der der Task ausgeführt wird.
Die Eigenschaften userName und autoUser schließen sich gegenseitig aus. Sie müssen eine angeben, aber nicht beide.

VirtualMachineConfiguration

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

Name Typ Beschreibung
containerConfiguration

ContainerConfiguration

Die Containerkonfiguration für den Pool.
Falls angegeben, wird das Setup für jeden Computeknoten im Pool ausgeführt, damit Tasks in Containern ausgeführt werden können. Alle regulären Tasks und Auftrags-Manager-Aufgaben, die in diesem Pool ausgeführt werden, müssen die containerSettings-Eigenschaft angeben, und alle anderen Tasks können sie angeben.

dataDisks

DataDisk[]

Die Konfiguration für Datenträger, die an die Computeknoten im Pool angefügt sind.
Diese Eigenschaft muss angegeben werden, wenn für die Computeknoten im Pool leere Datenträger angefügt sein müssen. Dies kann nicht aktualisiert werden. Jeder Computeknoten erhält einen eigenen Datenträger (der Datenträger ist keine Dateifreigabe). Vorhandene Datenträger können nicht angefügt werden, da jeder angefügte Datenträger leer ist. Wenn der Computeknoten aus dem Pool entfernt wird, werden auch der Datenträger und alle zugeordneten Daten gelöscht. Der Datenträger ist nach dem Anfügen nicht formatiert. Er muss vor der Verwendung formatiert werden. Weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux und https://docs.microsoft.com/en-us/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.
Falls angegeben, wird die Verschlüsselung für jeden Knoten im Pool während der Knotenbereitstellung durchgeführt.

extensions

VMExtension[]

Die VM-Erweiterung für den Pool.
Falls angegeben, werden die in dieser Konfiguration genannten Erweiterungen auf jedem Knoten installiert.

imageReference

ImageReference

Ein Verweis auf das Azure Virtual Machines Marketplace-Image oder das zu verwendende benutzerdefinierte VM-Image.

licenseType

string

Der Typ der lokalen Lizenz, die bei der Bereitstellung des Betriebssystems verwendet werden soll.
Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollte nur verwendet werden, wenn Sie über gültige lokale Lizenzen für die Computeknoten verfügen, die bereitgestellt werden. Wenn nicht angegeben, wird kein lokaler Lizenzierungsrabatt angewendet. Gültige Werte:

Windows_Server: Die lokale Lizenz gilt für Windows Server. Windows_Client: Die lokale Lizenz gilt für den Windows-Client.

nodeAgentSKUId

string

Die SKU des Batch Compute Node-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 Batch-Dienst bereitstellt. Es gibt verschiedene Implementierungen des Compute Node-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Compute Node-Agent-SKU angeben, die der ausgewählten Imagereferenz entspricht. Informationen zum Abrufen der Liste der unterstützten Serverknoten-Agent-SKUs sowie deren Liste der überprüften Imageverweise finden Sie im Vorgang "Auflisten unterstützter Serverknoten-Agent-SKUs".

nodePlacementConfiguration

NodePlacementConfiguration

Die Knotenplatzierungskonfiguration für den Pool.
Diese Konfiguration gibt Regeln für die physische Zuordnung von Knoten im Pool an.

osDisk

OSDisk

Einstellungen für den Betriebssystemdatenträger des virtuellen Computers.

securityProfile

SecurityProfile

Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die VM-Skalierungsgruppe an.
Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die VM-Skalierungsgruppe an.

serviceArtifactReference

ServiceArtifactReference

Gibt die Referenz-ID des Dienstartefakts an, die verwendet wird, um dieselbe Imageversion für alle virtuellen Computer in der Skalierungsgruppe festzulegen, wenn die neueste Imageversion verwendet wird.
Die Dienstartefaktverweis-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{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-Betriebssystemimage angibt.

VMExtension

Die Konfiguration für VM-Erweiterungen.

Name Typ Beschreibung
autoUpgradeMinorVersion

boolean

Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zum Zeitpunkt der Bereitstellung verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst 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 VM-Erweiterung.

protectedSettings

object

Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten.

provisionAfterExtensions

string[]

Die Auflistung von Erweiterungsnamen.
Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss.

publisher

string

Der Name des Erweiterungshandlerherausgebers.

settings

object

Im JSON-Format formatierte öffentliche Einstellungen für die Erweiterung.

type

string

Der Typ der Erweiterung.

typeHandlerVersion

string

Die Version des Skripthandlers.

WindowsConfiguration

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 sie nicht angegeben wird, ist der Standardwert true.

WindowsUserConfiguration

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

Name Typ Beschreibung
loginMode

LoginMode

Der Anmeldemodus für den Benutzer
Der Standardwert für VirtualMachineConfiguration-Pools ist "batch" und für CloudServiceConfiguration-Pools "interaktiv".