Microsoft.Batch batchAccounts/pools 2023-11-01
Bicep-Ressourcendefinition
Der Ressourcentyp "batchAccounts/pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Batch/batchAccounts/pools-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.
resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2023-11-01' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
name: 'string'
properties: {
applicationLicenses: [
'string'
]
applicationPackages: [
{
id: 'string'
version: 'string'
}
]
certificates: [
{
id: 'string'
storeLocation: 'string'
storeName: 'string'
visibility: [
'string'
]
}
]
deploymentConfiguration: {
cloudServiceConfiguration: {
osFamily: 'string'
osVersion: 'string'
}
virtualMachineConfiguration: {
containerConfiguration: {
containerImageNames: [
'string'
]
containerRegistries: [
{
identityReference: {
resourceId: 'string'
}
password: 'string'
registryServer: 'string'
username: 'string'
}
]
type: 'string'
}
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
diskEncryptionConfiguration: {
targets: [
'string'
]
}
extensions: [
{
autoUpgradeMinorVersion: bool
enableAutomaticUpgrade: bool
name: 'string'
protectedSettings: any(Azure.Bicep.Types.Concrete.AnyType)
provisionAfterExtensions: [
'string'
]
publisher: 'string'
settings: any(Azure.Bicep.Types.Concrete.AnyType)
type: 'string'
typeHandlerVersion: 'string'
}
]
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
nodePlacementConfiguration: {
policy: 'string'
}
osDisk: {
caching: 'string'
diskSizeGB: int
ephemeralOSDiskSettings: {
placement: 'CacheDisk'
}
managedDisk: {
storageAccountType: 'string'
}
writeAcceleratorEnabled: bool
}
securityProfile: {
encryptionAtHost: bool
securityType: 'trustedLaunch'
uefiSettings: {
secureBootEnabled: bool
vTpmEnabled: bool
}
}
serviceArtifactReference: {
id: 'string'
}
windowsConfiguration: {
enableAutomaticUpdates: bool
}
}
}
displayName: 'string'
interNodeCommunication: 'string'
metadata: [
{
name: 'string'
value: 'string'
}
]
mountConfiguration: [
{
azureBlobFileSystemConfiguration: {
accountKey: 'string'
accountName: 'string'
blobfuseOptions: 'string'
containerName: 'string'
identityReference: {
resourceId: 'string'
}
relativeMountPath: 'string'
sasKey: 'string'
}
azureFileShareConfiguration: {
accountKey: 'string'
accountName: 'string'
azureFileUrl: 'string'
mountOptions: 'string'
relativeMountPath: 'string'
}
cifsMountConfiguration: {
mountOptions: 'string'
password: 'string'
relativeMountPath: 'string'
source: 'string'
userName: 'string'
}
nfsMountConfiguration: {
mountOptions: 'string'
relativeMountPath: 'string'
source: 'string'
}
}
]
networkConfiguration: {
dynamicVnetAssignmentScope: 'string'
enableAcceleratedNetworking: bool
endpointConfiguration: {
inboundNatPools: [
{
backendPort: int
frontendPortRangeEnd: int
frontendPortRangeStart: int
name: 'string'
networkSecurityGroupRules: [
{
access: 'string'
priority: int
sourceAddressPrefix: 'string'
sourcePortRanges: [
'string'
]
}
]
protocol: 'string'
}
]
}
publicIPAddressConfiguration: {
ipAddressIds: [
'string'
]
provision: 'string'
}
subnetId: 'string'
}
resourceTags: {
{customized property}: 'string'
}
scaleSettings: {
autoScale: {
evaluationInterval: 'string'
formula: 'string'
}
fixedScale: {
nodeDeallocationOption: 'string'
resizeTimeout: 'string'
targetDedicatedNodes: int
targetLowPriorityNodes: int
}
}
startTask: {
commandLine: 'string'
containerSettings: {
containerRunOptions: 'string'
imageName: 'string'
registry: {
identityReference: {
resourceId: 'string'
}
password: 'string'
registryServer: 'string'
username: 'string'
}
workingDirectory: 'string'
}
environmentSettings: [
{
name: 'string'
value: 'string'
}
]
maxTaskRetryCount: int
resourceFiles: [
{
autoStorageContainerName: 'string'
blobPrefix: 'string'
fileMode: 'string'
filePath: 'string'
httpUrl: 'string'
identityReference: {
resourceId: 'string'
}
storageContainerUrl: 'string'
}
]
userIdentity: {
autoUser: {
elevationLevel: 'string'
scope: 'string'
}
userName: 'string'
}
waitForSuccess: bool
}
targetNodeCommunicationMode: 'string'
taskSchedulingPolicy: {
nodeFillType: 'string'
}
taskSlotsPerNode: int
userAccounts: [
{
elevationLevel: 'string'
linuxUserConfiguration: {
gid: int
sshPrivateKey: 'string'
uid: int
}
name: 'string'
password: 'string'
windowsUserConfiguration: {
loginMode: 'string'
}
}
]
vmSize: 'string'
}
}
Eigenschaftswerte
ApplicationPackageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die ID des zu installierenden Anwendungspakets. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Dies kann entweder ein Verweis auf eine bestimmte Version oder die Standardversion sein, falls vorhanden. | Zeichenfolge (erforderlich) |
| Version | Wenn dies nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences fehl. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 409. | Schnur |
AutoScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| evaluationInterval | Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 15 Minuten (PT15M). | Schnur |
| Formel | Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. | Zeichenfolge (erforderlich) |
AutoUserSpecification
| Name | Beschreibung | Wert |
|---|---|---|
| elevationLevel | Der Standardwert ist "nonAdmin". | "Administrator" 'NonAdmin' |
| Umfang | Der Standardwert ist Pool. Wenn der Pool Windows ausführt, sollte ein Wert der Aufgabe angegeben werden, wenn eine strengere Isolierung zwischen Vorgängen erforderlich ist. Wenn die Aufgabe z. B. die Registrierung auf eine Weise stummschaltet, die sich auf andere Aufgaben auswirken könnte, oder wenn Zertifikate auf dem Pool angegeben wurden, auf die nicht durch normale Aufgaben zugegriffen werden sollte, sondern durch Startaufgaben zugänglich sein sollte. | "Pool" "Vorgang" |
AzureBlobFileSystemConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accountKey | Diese Eigenschaft schließt sich gegenseitig mit sasKey und Identität aus; genau einer muss angegeben werden. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| accountName | Der Name des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| blobfuseOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| containerName | Der Name des Azure Blob Storage-Containers. | Zeichenfolge (erforderlich) |
| identityReference | Diese Eigenschaft schließt sich gegenseitig mit accountKey und sasKey aus. genau einer muss angegeben werden. | ComputeNodeIdentityReference- |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| sasKey | Diese Eigenschaft schließt sich gegenseitig mit AccountKey und Identität aus; genau einer muss angegeben werden. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
AzureFileShareConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accountKey | Der Azure Storage-Kontoschlüssel. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| accountName | Der Name des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| azureFileUrl | Dies ist das Format "https://{account}.file.core.windows.net/". | Zeichenfolge (erforderlich) |
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
BatchPoolIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Identitätstyp, der für den Batchpool verwendet wird. | 'None' "UserAssigned" (erforderlich) |
| userAssignedIdentities | Die Liste der Benutzeridentitäten, die dem Batchpool zugeordnet sind. | BatchPoolIdentityUserAssignedIdentities- |
BatchPoolIdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
CertificateReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die vollqualifizierte ID des Zertifikats, das im Pool installiert werden soll. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. | Zeichenfolge (erforderlich) |
| storeLocation | Der Standardwert ist currentUser. Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. | 'CurrentUser' "LocalMachine" |
| storeName | Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Allgemeine Store-Namen sind: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, but any custom store name can also be used. Der Standardwert ist "Mein". | Schnur |
| Sichtbarkeit | Welche Benutzerkonten auf dem Computeknoten Zugriff auf die privaten Daten des Zertifikats haben sollen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'RemoteUser' "StartTask" "Vorgang" |
CifsMountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| Passwort | Das Kennwort, das für die Authentifizierung im CIFS-Dateisystem verwendet werden soll. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| Quelle | Der URI des zu mountden Dateisystems. | Zeichenfolge (erforderlich) |
| Nutzername | Der Benutzer, der für die Authentifizierung gegen das CIFS-Dateisystem verwendet werden soll. | Zeichenfolge (erforderlich) |
CloudServiceConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| osFamily | 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 Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | Zeichenfolge (erforderlich) |
| osVersion | Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. | Schnur |
ComputeNodeIdentityReference
| Name | Beschreibung | Wert |
|---|---|---|
| resourceId | Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität. | Schnur |
ContainerConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| containerImageNames | Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben. Ein Image wird aus der Docker-Standardregistrierung stammen, es sei denn, das Image ist vollqualifizierte mit einer alternativen Registrierung. | string[] |
| containerRegistries | Wenn Bilder aus einer privaten Registrierung heruntergeladen werden müssen, die Anmeldeinformationen erfordert, müssen diese Anmeldeinformationen hier angegeben werden. | ContainerRegistry[] |
| Art | Die zu verwendende Containertechnologie. | 'CriCompatible' "DockerCompatible" (erforderlich) |
ContainerRegistry
| Name | Beschreibung | Wert |
|---|---|---|
| identityReference | Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet. | ComputeNodeIdentityReference- |
| Passwort | Das Kennwort für die Anmeldung beim Registrierungsserver. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| registryServer | Wenn nicht angegeben, lautet der Standardwert "docker.io". | Schnur |
| Nutzername | Der Benutzername, der sich beim Registrierungsserver anmeldet. | Schnur |
DataDisk
| Name | Beschreibung | Wert |
|---|---|---|
| Caching | Werte sind: none – Der Cachemodus für den Datenträger ist nicht aktiviert. readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt. readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt. Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
'None' 'ReadOnly' 'ReadWrite' |
| diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. | int (erforderlich) |
| lun | Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. Der Wert muss zwischen 0 und 63 (einschließlich) liegen. | int (erforderlich) |
| storageAccountType | Wenn nicht angegeben, lautet der Standardwert "Standard_LRS". Werte sind: Standard_LRS – Der Datenträger sollte standardmäßigen lokal redundanten Speicher verwenden. Premium_LRS – Der Datenträger sollte einen lokal redundanten Premiumspeicher verwenden. |
"Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
DeploymentConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| cloudServiceConfiguration | Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft erstellt wurde, die auf "UserSubscription" festgelegt ist. | CloudServiceConfiguration- |
| virtualMachineConfiguration | Diese Eigenschaft und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | VirtualMachineConfiguration |
DiffDiskSettings
| Name | Beschreibung | Wert |
|---|---|---|
| Platzierung | Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um auszuwählen, an welchem Speicherort sich das Betriebssystem befinden soll. z. B. Cachespeicherplatz für ephemerale Betriebssystemdatenträgerbereitstellung. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter Ephemeral Os Disk Size Requirements für Windows-VMs unter /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements and Linux VMs at /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | 'CacheDisk' |
DiskEncryptionConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Ziele | Unter Linux-Pool wird nur "TemporaryDisk" unterstützt; unter Windows-Pool muss "OsDisk" und "TemporaryDisk" angegeben werden. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'OsDisk' 'TemporaryDisk' |
EnvironmentSetting
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name der Umgebungsvariable. | Zeichenfolge (erforderlich) |
| Wert | Der Wert der Umgebungsvariable. | Schnur |
FixedScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| nodeDeallocationOption | Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Requeue". | 'Requeue' "RetainedData" "TaskCompletion" "Beenden" |
| resizeTimeout | Der Standardwert beträgt 15 Minuten. Timeoutwerte verwenden das ISO 8601-Format. Verwenden Sie z. B. PT10M für 10 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, lehnt der Batchdienst die Anforderung mit einem Fehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). | Schnur |
| targetDedicatedNodes | Mindestens einer von targetDedicatedNodes muss "targetLowPriorityNodes" festgelegt werden. | Int |
| targetLowPriorityNodes | Mindestens einer von targetDedicatedNodes muss "targetLowPriorityNodes" festgelegt werden. | Int |
ImageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Azure Compute Gallery Image muss Replikate in derselben Region wie das Azure Batch-Konto haben. Informationen zu den Firewalleinstellungen für den Batchknoten-Agent für die Kommunikation mit dem Batchdienst finden Sie unter "/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration". | Schnur |
| Angebot | Beispiel: UbuntuServer oder WindowsServer. | Schnur |
| Verlag | Beispiel: Canonical oder MicrosoftWindowsServer. | Schnur |
| Sku | Beispiel: 18.04-LTS oder 2022-Datacenter. | Schnur |
| Version | Ein Wert von "latest" kann angegeben werden, um die neueste Version eines Bilds auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest". | Schnur |
InboundNatPool
| Name | Beschreibung | Wert |
|---|---|---|
| backPort | 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 bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| frontendPortRangeEnd | Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| frontendPortRangeStart | Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| Name | Der Name muss innerhalb eines Batchpools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | Zeichenfolge (erforderlich) |
| networkSecurityGroupRules | Die maximale Anzahl von Regeln, die für alle Endpunkte in einem Batchpool angegeben werden können, ist 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | NetworkSecurityGroupRule[] |
| Protokoll | Das Protokoll des Endpunkts. | "TCP" "UDP" (erforderlich) |
LinuxUserConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| gid | Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt. | Int |
| sshPrivateKey | Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um die asymmetrische schlüsselbasierte Authentifizierung für SSH zwischen Knoten in einem Linux-Pool automatisch zu konfigurieren, wenn die Eigenschaft enableInterNodeCommunication des Pools wahr ist (wird ignoriert, wenn enableInterNodeCommunication false ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Wenn nicht angegeben, wird kennwortloses SSH nicht zwischen Knoten konfiguriert (es erfolgt keine Änderung des SSH-Verzeichnisses des Benutzers). | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| uid | Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt. | Int |
ManagedDisk
| Name | Beschreibung | Wert |
|---|---|---|
| storageAccountType | Der Speicherkontotyp zum Erstellen von Datenträgern oder Betriebssystemdatenträgern. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
MetadataItem
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name des Metadatenelements. | Zeichenfolge (erforderlich) |
| Wert | Der Wert des Metadatenelements. | Zeichenfolge (erforderlich) |
Microsoft.Batch/batchAccounts/pools
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Der Identitätstyp, der für den Batchpool verwendet wird. | BatchPoolIdentity- |
| Name | Der Ressourcenname | Schnur Zwänge: Min. Länge = 1 Max. Länge = 64 Pattern = ^[a-zA-Z0-9_-]+$ (erforderlich) |
| Elternteil | In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource. |
Symbolischer Name für Ressource des Typs: batchAccounts |
| Eigenschaften | Die dem Pool zugeordneten Eigenschaften. | PoolProperties- |
MountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| azureBlobFileSystemConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | AzureBlobFileSystemConfiguration |
| azureFileShareConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | AzureFileShareConfiguration- |
| cifsMountConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | CifsMountConfiguration |
| nfsMountConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | NFSMountConfiguration |
NetworkConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| dynamicVnetAssignmentScope | Der Umfang der dynamischen vnet-Zuordnung. | "Job" 'none' |
| enableAcceleratedNetworking | Das beschleunigte Netzwerk ermöglicht die einzelne E/A-Virtualisierung (SR-IOV) für einen virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter :/azure/virtual-network/accelerated-networking-overview. | Bool |
| endpointConfiguration | Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Diese Eigenschaft wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PublicIPAddressConfiguration- |
| subnetz-ID | Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure Batch-Konto befinden. Das angegebene Subnetz sollte über genügend freie IP-Adressen verfügen, um die Anzahl der Knoten im Pool aufzunehmen. Wenn das Subnetz nicht über genügend freie IP-Adressen verfügt, weist der Pool teilweise Computeknoten zu, und es tritt ein Fehler bei der Größenänderung auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss zulassen, dass die Kommunikation vom Azure Batch-Dienst Vorgänge auf den Computeknoten planen kann. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Computeknoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Wenn das angegebene VNet über eine zugeordnete Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden. Aktivieren Sie für Pools, die mit einer Konfiguration für virtuelle Computer erstellt wurden, 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, ports 10100, 20100 und 30100. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Für CloudServiceConfiguration-Pools werden nur klassische VNETs unterstützt. Weitere Informationen finden Sie unter :/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | Schnur |
NetworkSecurityGroupRule
| Name | Beschreibung | Wert |
|---|---|---|
| Zugang | Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll. | "Zulassen" "Verweigern" (erforderlich) |
| Priorität | Prioritäten innerhalb eines Pools müssen eindeutig sein und in der Reihenfolge der Priorität ausgewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 4096. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| sourceAddressPrefix | Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | Zeichenfolge (erforderlich) |
| sourcePortRanges | Gültige Werte sind '*' (für alle Ports 0 - 65535) oder Arrays von Ports oder Portbereichen (d. h. 100-200). Die Ports sollten im Bereich von 0 bis 65535 liegen, und die Portbereiche oder Ports können sich nicht überlappen. Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Der Standardwert ist *. | string[] |
NFSMountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| Quelle | Der URI des zu mountden Dateisystems. | Zeichenfolge (erforderlich) |
NodePlacementConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Politik | Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie. | "Regional" "Zonal" |
OSDisk
| Name | Beschreibung | Wert |
|---|---|---|
| Caching | Der Typ der Zwischenspeicherung, die für den Datenträger aktiviert werden soll. | 'None' 'ReadOnly' 'ReadWrite' |
| diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers. | Int |
| ephemeralOSDiskSettings | Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. | DiffDiskSettings |
| managedDisk | ManagedDisk- | |
| writeAcceleratorEnabled | Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll. | Bool |
PoolEndpointConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| inboundNatPools | 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 dem HTTP-Statuscode 400 fehl. Dies kann nicht angegeben werden, wenn der IPAddressProvisioningType NoPublicIPAddresses ist. | InboundNatPool-[] (erforderlich) |
PoolProperties
| Name | Beschreibung | Wert |
|---|---|---|
| applicationLicenses | Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl. | string[] |
| applicationPackages | Änderungen an Anwendungspaketverweise wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages aktualisiert werden. Es gibt maximal 10 Anwendungspaketverweise für einen bestimmten Pool. | ApplicationPackageReference[] |
| Atteste | Für Windows-Computeknoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung. |
CertificateReference-[] |
| deploymentConfiguration | Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet. | DeploymentConfiguration- |
| displayName | Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten. | Schnur |
| interNodeCommunication | Dadurch werden Einschränkungen auferlegt, denen dem Pool Knoten zugewiesen werden können. Durch Aktivieren dieses Werts kann die Wahrscheinlichkeit verringert werden, dass die angeforderte Anzahl von Knoten im Pool zugewiesen werden soll. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. | "Deaktiviert" "Aktiviert" |
| Metadaten | Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. | MetadataItem-[] |
| mountConfiguration | Dies unterstützt Azure Files, NFS, CIFS/SMB und Blobfuse. | MountConfiguration-[] |
| networkConfiguration | Die Netzwerkkonfiguration für einen Pool. | NetworkConfiguration- |
| resourceTags | Die benutzerdefinierten Tags, die dem Azure-Batchpool zugeordnet werden sollen. Wenn angegeben, werden diese Tags an die zugrunde stehenden Azure-Ressourcen verteilt, die dem Pool zugeordnet sind. Diese Eigenschaft kann nur angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt wurde. | PoolPropertiesResourceTags |
| scaleSettings | Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem die angeforderten targetDedicatedNodes angegeben sind, oder 'autoScale', die eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben ist, hat der Pool eine feste Skalierung mit 0 targetDedicatedNodes. | ScaleSettings- |
| startTask | In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um die Startaufgabe aus dem Pool zu entfernen. | StartTask- |
| targetNodeCommunicationMode | Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Default". | "Klassisch" 'Standard' "Vereinfacht" |
| taskSchedulingPolicy | Wenn nicht angegeben, wird die Standardeinstellung verteilt. | TaskSchedulingPolicy- |
| taskSlotsPerNode | Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256. | Int |
| userAccounts | Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen. | UserAccount[] |
| vmSize | Informationen zu 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 VM-Größen der Clouddienste mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (Pools, die mit virtualMachineConfiguration erstellt wurden) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie). | Schnur |
PoolPropertiesResourceTags
| Name | Beschreibung | Wert |
|---|
PublicIPAddressConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| ipAddressIds | Die hier angegebene Anzahl von IPs begrenzt die maximale Größe des Pools – 100 dedizierte Knoten oder 100 Spot/Low-Priority-Knoten können für jede öffentliche IP zugewiesen werden. Ein Pool, der 250 dedizierte VMs benötigt, benötigt beispielsweise mindestens 3 öffentliche IPs. Jedes Element dieser Auflistung weist das Format auf: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
| Vorsorge | Der Standardwert ist BatchManaged | "BatchManaged" 'NoPublicIPAddresses' "UserManaged" |
ResourceFile
| Name | Beschreibung | Wert |
|---|---|---|
| autoStorageContainerName | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. | Schnur |
| blobPrefix | Die Eigenschaft ist nur gültig, wenn autoStorageContainerName oder storageContainerUrl verwendet wird. Dieses Präfix kann ein teilweiser Dateiname oder ein Unterverzeichnis sein. Wenn kein Präfix angegeben ist, werden alle Dateien im Container heruntergeladen. | Schnur |
| fileMode | Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile angegeben wird, die auf einen Windows-Knoten heruntergeladen wird. Wenn diese Eigenschaft für einen Linux-Knoten nicht angegeben ist, wird auf die Datei ein Standardwert von 0770 angewendet. | Schnur |
| filePath | Wenn die httpUrl-Eigenschaft angegeben ist, ist der FilePath erforderlich und beschreibt den Pfad, in den die Datei heruntergeladen wird, einschließlich des Dateinamens. Andernfalls ist filePath optional, wenn die autoStorageContainerName- oder storageContainerUrl-Eigenschaft angegeben ist, und das Verzeichnis, in das die Dateien heruntergeladen werden sollen. Wenn FilePath als Verzeichnis verwendet wird, werden alle bereits den Eingabedaten zugeordneten Verzeichnisstruktur vollständig aufbewahrt und an das angegebene FilePath-Verzeichnis angefügt. Der angegebene relative Pfad kann nicht aus dem Arbeitsverzeichnis des Vorgangs (z. B. mit '.') herausbrechen. | Schnur |
| httpUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Wenn die URL auf Azure Blob Storage verweist, muss sie von Computeknoten gelesen werden. Es gibt drei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Leseberechtigungen für das Blob gewährt, eine verwaltete Identität mit Leseberechtigung verwenden oder die ACL für das Blob oder dessen Container so festlegen, dass der öffentliche Zugriff zulässig ist. | Schnur |
| identityReference | Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet. | ComputeNodeIdentityReference- |
| storageContainerUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss von Computeknoten lesbar und auflistenbar sein. Es gibt drei Möglichkeiten, eine solche URL für einen Container in Azure Storage abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Lese- und Listenberechtigungen für den Container gewährt, eine verwaltete Identität mit Lese- und Listenberechtigungen verwenden oder die ACL für den Container so festlegen, dass der öffentliche Zugriff zugelassen wird. | Schnur |
ScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| AutoScale | Diese Eigenschaft und fixedScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | AutoScaleSettings- |
| fixedScale | Diese Eigenschaft und autoScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | FixedScaleSettings- |
SecurityProfile
| Name | Beschreibung | Wert |
|---|---|---|
| encryptionAtHost | Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. | Bool |
| securityType | Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. | "trustedLaunch" |
| uefiSettings | Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. | UefiSettings- |
ServiceArtifactReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | Zeichenfolge (erforderlich) |
StartTask
| Name | Beschreibung | Wert |
|---|---|---|
| commandLine | Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Erforderlich, wenn andere Eigenschaften des startTask angegeben werden. | Schnur |
| containerSettings | Wenn dies angegeben wird, werden alle Verzeichnisse rekursiv unterhalb der AZ_BATCH_NODE_ROOT_DIR (der Stamm von Azure Batchverzeichnissen auf dem Knoten) dem Container zugeordnet, alle Aufgabenumgebungsvariablen werden dem Container zugeordnet, und die Aufgabenbefehlszeile wird im Container ausgeführt. | TaskContainerSettings- |
| environmentSettings | Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. | EnvironmentSetting[] |
| maxTaskRetryCount | Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 ist, versucht Batch den Vorgang bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst den Vorgang nicht erneut aus. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung. Der Standardwert ist 0. | Int |
| resourceFiles | Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. | ResourceFile-[] |
| userIdentity | Wenn sie weggelassen wird, wird die Aufgabe als nicht administrativer Benutzer ausgeführt, der für die Aufgabe eindeutig ist. | UserIdentity- |
| waitForSuccess | Wenn true und die Startaufgabe auf einem Computeknoten fehlschlägt, wiederholt der Batchdienst die Startaufgabe bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Computeknoten nicht mehr verwendbar, und er plant keine Vorgänge. Diese Bedingung kann über den Knotenstatus und das Planungsfehlerdetails erkannt werden. Wenn false, wartet der Batchdienst nicht, bis die Startaufgabe abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während die Startaufgabe noch ausgeführt wird. und auch wenn der Startvorgang fehlschlägt, werden neue Vorgänge weiterhin auf dem Knoten geplant. Der Standardwert ist "true". | Bool |
TaskContainerSettings
| Name | Beschreibung | Wert |
|---|---|---|
| containerRunOptions | Diese zusätzlichen Optionen werden zusätzlich zu den vom Batchdienst gesteuerten Befehlen als Argumente für den Befehl "docker create" bereitgestellt. | Schnur |
| imageName | Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben. Wenn kein Tag als Teil des Bildnamens angegeben wird, wird das Tag ":latest" als Standard verwendet. | Zeichenfolge (erforderlich) |
| Registrierung | Diese Einstellung kann weggelassen werden, wenn sie bereits bei der Poolerstellung bereitgestellt wurde. | ContainerRegistry- |
| workingDirectory | Ein Kennzeichen, das angibt, wo sich das Arbeitsverzeichnis der Containeraufgabe befindet. Der Standardwert ist "taskWorkingDirectory". | 'ContainerImageDefault' 'TaskWorkingDirectory' |
TaskSchedulingPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| nodeFillType | Wie Aufgaben über Computeknoten verteilt werden sollen. | "Pack" "Spread" (erforderlich) |
UefiSettings
| Name | Beschreibung | Wert |
|---|---|---|
| secureBootEnabled | Gibt an, ob der sichere Start auf dem virtuellen Computer aktiviert werden soll. | Bool |
| vTpmEnabled | Gibt an, ob vTPM auf dem virtuellen Computer aktiviert werden soll. | Bool |
UserAccount
| Name | Beschreibung | Wert |
|---|---|---|
| elevationLevel | nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". | "Administrator" 'NonAdmin' |
| linuxUserConfiguration | Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt. | LinuxUserConfiguration- |
| Name | Der Name des Benutzerkontos. Namen können bis zu einer maximalen Länge von 20 Unicode-Zeichen enthalten. | Zeichenfolge (erforderlich) |
| Passwort | Das Kennwort für das Benutzerkonto. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| windowsUserConfiguration | 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. | WindowsUserConfiguration- |
UserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
UserIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| autoUser | Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. | AutoUserSpecification- |
| Nutzername | Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. | Schnur |
VirtualMachineConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| containerConfiguration | Wenn angegeben, wird das Setup für jeden Knoten im Pool ausgeführt, damit Aufgaben in Containern ausgeführt werden können. Alle regulären Aufgaben und Auftragsverwaltungsaufgaben, die auf diesem Pool ausgeführt werden, müssen die eigenschaft containerSettings angeben, und alle anderen Aufgaben können sie angeben. | ContainerConfiguration- |
| dataDisks | Diese Eigenschaft muss angegeben werden, wenn die Computeknoten im Pool über leere Datenträger verfügen müssen, die an sie angefügt sind. | DataDisk-[] |
| diskEncryptionConfiguration | Wenn angegeben, wird die Verschlüsselung für jeden Knoten im Pool während der Knotenbereitstellung ausgeführt. | DiskEncryptionConfiguration |
| Erweiterungen | Wenn angegeben, werden die in dieser Konfiguration genannten Erweiterungen auf jedem Knoten installiert. | VMExtension-[] |
| imageReference | Ein Verweis auf ein Azure Virtual Machines Marketplace-Image oder die Azure Image-Ressource eines benutzerdefinierten virtuellen Computers. Informationen zum Abrufen der Liste aller imageReferences, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". | ImageReference- (erforderlich) |
| licenseType | Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollte nur verwendet werden, wenn Sie gültige lokale Lizenzen für die Knoten halten, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Werte sind: Windows_Server – Die lokale Lizenz gilt für Windows Server. Windows_Client – Die lokale Lizenz ist für Windows Client. |
Schnur |
| nodeAgentSkuId | Der Batchknoten-Agent ist ein Programm, das auf jedem Knoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Knoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Knoten-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Knoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Knoten-Agent-SKUs sowie deren Liste der überprüften Bildverweise finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". | Zeichenfolge (erforderlich) |
| nodePlacementConfiguration | Diese Konfiguration gibt Regeln für die physische Zuordnung von Knoten im Pool an. | NodePlacementConfiguration- |
| osDisk | Enthält die Konfiguration für kurzlebige OSDisk-Einstellungen. | OSDisk- |
| securityProfile | Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers an. | SecurityProfile- |
| serviceArtifactReference | Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | ServiceArtifactReference |
| windowsConfiguration | Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. | WindowsConfiguration- |
VMExtension
| Name | Beschreibung | Wert |
|---|---|---|
| autoUpgradeMinorVersion | Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist. | Bool |
| enableAutomaticUpgrade | Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. | Bool |
| Name | Der Name der Erweiterung des virtuellen Computers. | Zeichenfolge (erforderlich) |
| protectedSettings | Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. | jegliche |
| provisionAfterExtensions | Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss. | string[] |
| Verlag | Der Name des Herausgebers des Erweiterungshandlers. | Zeichenfolge (erforderlich) |
| Einstellungen | JSON-formatierte öffentliche Einstellungen für die Erweiterung. | jegliche |
| Art | Der Typ der Erweiterungen. | Zeichenfolge (erforderlich) |
| typeHandlerVersion | Die Version des Skripthandlers. | Schnur |
WindowsConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| enableAutomaticUpdates | Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true". | Bool |
WindowsUserConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| loginMode | Gibt den Anmeldemodus für den Benutzer an. Der Standardwert für VirtualMachineConfiguration-Pools ist der interaktive Modus und für CloudServiceConfiguration-Pools der Batchmodus. | "Batch" "Interaktiv" |
Schnellstartbeispiele
Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.
| Bicep-Datei | Beschreibung |
|---|---|
| Azure Batchpool ohne öffentliche IP-Adressen | Diese Vorlage erstellt einen vereinfachten Azure Batch-Knotenkommunikationspool ohne öffentliche IP-Adressen. |
ARM-Vorlagenressourcendefinition
Der Ressourcentyp "batchAccounts/pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Batch/batchAccounts/pools-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Batch/batchAccounts/pools",
"apiVersion": "2023-11-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"properties": {
"applicationLicenses": [ "string" ],
"applicationPackages": [
{
"id": "string",
"version": "string"
}
],
"certificates": [
{
"id": "string",
"storeLocation": "string",
"storeName": "string",
"visibility": [ "string" ]
}
],
"deploymentConfiguration": {
"cloudServiceConfiguration": {
"osFamily": "string",
"osVersion": "string"
},
"virtualMachineConfiguration": {
"containerConfiguration": {
"containerImageNames": [ "string" ],
"containerRegistries": [
{
"identityReference": {
"resourceId": "string"
},
"password": "string",
"registryServer": "string",
"username": "string"
}
],
"type": "string"
},
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"diskEncryptionConfiguration": {
"targets": [ "string" ]
},
"extensions": [
{
"autoUpgradeMinorVersion": "bool",
"enableAutomaticUpgrade": "bool",
"name": "string",
"protectedSettings": {},
"provisionAfterExtensions": [ "string" ],
"publisher": "string",
"settings": {},
"type": "string",
"typeHandlerVersion": "string"
}
],
"imageReference": {
"id": "string",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
},
"licenseType": "string",
"nodeAgentSkuId": "string",
"nodePlacementConfiguration": {
"policy": "string"
},
"osDisk": {
"caching": "string",
"diskSizeGB": "int",
"ephemeralOSDiskSettings": {
"placement": "CacheDisk"
},
"managedDisk": {
"storageAccountType": "string"
},
"writeAcceleratorEnabled": "bool"
},
"securityProfile": {
"encryptionAtHost": "bool",
"securityType": "trustedLaunch",
"uefiSettings": {
"secureBootEnabled": "bool",
"vTpmEnabled": "bool"
}
},
"serviceArtifactReference": {
"id": "string"
},
"windowsConfiguration": {
"enableAutomaticUpdates": "bool"
}
}
},
"displayName": "string",
"interNodeCommunication": "string",
"metadata": [
{
"name": "string",
"value": "string"
}
],
"mountConfiguration": [
{
"azureBlobFileSystemConfiguration": {
"accountKey": "string",
"accountName": "string",
"blobfuseOptions": "string",
"containerName": "string",
"identityReference": {
"resourceId": "string"
},
"relativeMountPath": "string",
"sasKey": "string"
},
"azureFileShareConfiguration": {
"accountKey": "string",
"accountName": "string",
"azureFileUrl": "string",
"mountOptions": "string",
"relativeMountPath": "string"
},
"cifsMountConfiguration": {
"mountOptions": "string",
"password": "string",
"relativeMountPath": "string",
"source": "string",
"userName": "string"
},
"nfsMountConfiguration": {
"mountOptions": "string",
"relativeMountPath": "string",
"source": "string"
}
}
],
"networkConfiguration": {
"dynamicVnetAssignmentScope": "string",
"enableAcceleratedNetworking": "bool",
"endpointConfiguration": {
"inboundNatPools": [
{
"backendPort": "int",
"frontendPortRangeEnd": "int",
"frontendPortRangeStart": "int",
"name": "string",
"networkSecurityGroupRules": [
{
"access": "string",
"priority": "int",
"sourceAddressPrefix": "string",
"sourcePortRanges": [ "string" ]
}
],
"protocol": "string"
}
]
},
"publicIPAddressConfiguration": {
"ipAddressIds": [ "string" ],
"provision": "string"
},
"subnetId": "string"
},
"resourceTags": {
"{customized property}": "string"
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "string",
"formula": "string"
},
"fixedScale": {
"nodeDeallocationOption": "string",
"resizeTimeout": "string",
"targetDedicatedNodes": "int",
"targetLowPriorityNodes": "int"
}
},
"startTask": {
"commandLine": "string",
"containerSettings": {
"containerRunOptions": "string",
"imageName": "string",
"registry": {
"identityReference": {
"resourceId": "string"
},
"password": "string",
"registryServer": "string",
"username": "string"
},
"workingDirectory": "string"
},
"environmentSettings": [
{
"name": "string",
"value": "string"
}
],
"maxTaskRetryCount": "int",
"resourceFiles": [
{
"autoStorageContainerName": "string",
"blobPrefix": "string",
"fileMode": "string",
"filePath": "string",
"httpUrl": "string",
"identityReference": {
"resourceId": "string"
},
"storageContainerUrl": "string"
}
],
"userIdentity": {
"autoUser": {
"elevationLevel": "string",
"scope": "string"
},
"userName": "string"
},
"waitForSuccess": "bool"
},
"targetNodeCommunicationMode": "string",
"taskSchedulingPolicy": {
"nodeFillType": "string"
},
"taskSlotsPerNode": "int",
"userAccounts": [
{
"elevationLevel": "string",
"linuxUserConfiguration": {
"gid": "int",
"sshPrivateKey": "string",
"uid": "int"
},
"name": "string",
"password": "string",
"windowsUserConfiguration": {
"loginMode": "string"
}
}
],
"vmSize": "string"
}
}
Eigenschaftswerte
ApplicationPackageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die ID des zu installierenden Anwendungspakets. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Dies kann entweder ein Verweis auf eine bestimmte Version oder die Standardversion sein, falls vorhanden. | Zeichenfolge (erforderlich) |
| Version | Wenn dies nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences fehl. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 409. | Schnur |
AutoScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| evaluationInterval | Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 15 Minuten (PT15M). | Schnur |
| Formel | Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. | Zeichenfolge (erforderlich) |
AutoUserSpecification
| Name | Beschreibung | Wert |
|---|---|---|
| elevationLevel | Der Standardwert ist "nonAdmin". | "Administrator" 'NonAdmin' |
| Umfang | Der Standardwert ist Pool. Wenn der Pool Windows ausführt, sollte ein Wert der Aufgabe angegeben werden, wenn eine strengere Isolierung zwischen Vorgängen erforderlich ist. Wenn die Aufgabe z. B. die Registrierung auf eine Weise stummschaltet, die sich auf andere Aufgaben auswirken könnte, oder wenn Zertifikate auf dem Pool angegeben wurden, auf die nicht durch normale Aufgaben zugegriffen werden sollte, sondern durch Startaufgaben zugänglich sein sollte. | "Pool" "Vorgang" |
AzureBlobFileSystemConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accountKey | Diese Eigenschaft schließt sich gegenseitig mit sasKey und Identität aus; genau einer muss angegeben werden. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| accountName | Der Name des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| blobfuseOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| containerName | Der Name des Azure Blob Storage-Containers. | Zeichenfolge (erforderlich) |
| identityReference | Diese Eigenschaft schließt sich gegenseitig mit accountKey und sasKey aus. genau einer muss angegeben werden. | ComputeNodeIdentityReference- |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| sasKey | Diese Eigenschaft schließt sich gegenseitig mit AccountKey und Identität aus; genau einer muss angegeben werden. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
AzureFileShareConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accountKey | Der Azure Storage-Kontoschlüssel. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| accountName | Der Name des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| azureFileUrl | Dies ist das Format "https://{account}.file.core.windows.net/". | Zeichenfolge (erforderlich) |
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
BatchPoolIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Identitätstyp, der für den Batchpool verwendet wird. | 'None' "UserAssigned" (erforderlich) |
| userAssignedIdentities | Die Liste der Benutzeridentitäten, die dem Batchpool zugeordnet sind. | BatchPoolIdentityUserAssignedIdentities- |
BatchPoolIdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
CertificateReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die vollqualifizierte ID des Zertifikats, das im Pool installiert werden soll. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. | Zeichenfolge (erforderlich) |
| storeLocation | Der Standardwert ist currentUser. Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. | 'CurrentUser' "LocalMachine" |
| storeName | Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Allgemeine Store-Namen sind: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, but any custom store name can also be used. Der Standardwert ist "Mein". | Schnur |
| Sichtbarkeit | Welche Benutzerkonten auf dem Computeknoten Zugriff auf die privaten Daten des Zertifikats haben sollen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'RemoteUser' "StartTask" "Vorgang" |
CifsMountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| Passwort | Das Kennwort, das für die Authentifizierung im CIFS-Dateisystem verwendet werden soll. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| Quelle | Der URI des zu mountden Dateisystems. | Zeichenfolge (erforderlich) |
| Nutzername | Der Benutzer, der für die Authentifizierung gegen das CIFS-Dateisystem verwendet werden soll. | Zeichenfolge (erforderlich) |
CloudServiceConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| osFamily | 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 Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | Zeichenfolge (erforderlich) |
| osVersion | Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. | Schnur |
ComputeNodeIdentityReference
| Name | Beschreibung | Wert |
|---|---|---|
| resourceId | Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität. | Schnur |
ContainerConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| containerImageNames | Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben. Ein Image wird aus der Docker-Standardregistrierung stammen, es sei denn, das Image ist vollqualifizierte mit einer alternativen Registrierung. | string[] |
| containerRegistries | Wenn Bilder aus einer privaten Registrierung heruntergeladen werden müssen, die Anmeldeinformationen erfordert, müssen diese Anmeldeinformationen hier angegeben werden. | ContainerRegistry[] |
| Art | Die zu verwendende Containertechnologie. | 'CriCompatible' "DockerCompatible" (erforderlich) |
ContainerRegistry
| Name | Beschreibung | Wert |
|---|---|---|
| identityReference | Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet. | ComputeNodeIdentityReference- |
| Passwort | Das Kennwort für die Anmeldung beim Registrierungsserver. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| registryServer | Wenn nicht angegeben, lautet der Standardwert "docker.io". | Schnur |
| Nutzername | Der Benutzername, der sich beim Registrierungsserver anmeldet. | Schnur |
DataDisk
| Name | Beschreibung | Wert |
|---|---|---|
| Caching | Werte sind: none – Der Cachemodus für den Datenträger ist nicht aktiviert. readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt. readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt. Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
'None' 'ReadOnly' 'ReadWrite' |
| diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. | int (erforderlich) |
| lun | Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. Der Wert muss zwischen 0 und 63 (einschließlich) liegen. | int (erforderlich) |
| storageAccountType | Wenn nicht angegeben, lautet der Standardwert "Standard_LRS". Werte sind: Standard_LRS – Der Datenträger sollte standardmäßigen lokal redundanten Speicher verwenden. Premium_LRS – Der Datenträger sollte einen lokal redundanten Premiumspeicher verwenden. |
"Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
DeploymentConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| cloudServiceConfiguration | Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft erstellt wurde, die auf "UserSubscription" festgelegt ist. | CloudServiceConfiguration- |
| virtualMachineConfiguration | Diese Eigenschaft und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | VirtualMachineConfiguration |
DiffDiskSettings
| Name | Beschreibung | Wert |
|---|---|---|
| Platzierung | Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um auszuwählen, an welchem Speicherort sich das Betriebssystem befinden soll. z. B. Cachespeicherplatz für ephemerale Betriebssystemdatenträgerbereitstellung. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter Ephemeral Os Disk Size Requirements für Windows-VMs unter /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements and Linux VMs at /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | 'CacheDisk' |
DiskEncryptionConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Ziele | Unter Linux-Pool wird nur "TemporaryDisk" unterstützt; unter Windows-Pool muss "OsDisk" und "TemporaryDisk" angegeben werden. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'OsDisk' 'TemporaryDisk' |
EnvironmentSetting
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name der Umgebungsvariable. | Zeichenfolge (erforderlich) |
| Wert | Der Wert der Umgebungsvariable. | Schnur |
FixedScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| nodeDeallocationOption | Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Requeue". | 'Requeue' "RetainedData" "TaskCompletion" "Beenden" |
| resizeTimeout | Der Standardwert beträgt 15 Minuten. Timeoutwerte verwenden das ISO 8601-Format. Verwenden Sie z. B. PT10M für 10 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, lehnt der Batchdienst die Anforderung mit einem Fehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). | Schnur |
| targetDedicatedNodes | Mindestens einer von targetDedicatedNodes muss "targetLowPriorityNodes" festgelegt werden. | Int |
| targetLowPriorityNodes | Mindestens einer von targetDedicatedNodes muss "targetLowPriorityNodes" festgelegt werden. | Int |
ImageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Azure Compute Gallery Image muss Replikate in derselben Region wie das Azure Batch-Konto haben. Informationen zu den Firewalleinstellungen für den Batchknoten-Agent für die Kommunikation mit dem Batchdienst finden Sie unter "/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration". | Schnur |
| Angebot | Beispiel: UbuntuServer oder WindowsServer. | Schnur |
| Verlag | Beispiel: Canonical oder MicrosoftWindowsServer. | Schnur |
| Sku | Beispiel: 18.04-LTS oder 2022-Datacenter. | Schnur |
| Version | Ein Wert von "latest" kann angegeben werden, um die neueste Version eines Bilds auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest". | Schnur |
InboundNatPool
| Name | Beschreibung | Wert |
|---|---|---|
| backPort | 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 bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| frontendPortRangeEnd | Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| frontendPortRangeStart | Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| Name | Der Name muss innerhalb eines Batchpools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | Zeichenfolge (erforderlich) |
| networkSecurityGroupRules | Die maximale Anzahl von Regeln, die für alle Endpunkte in einem Batchpool angegeben werden können, ist 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | NetworkSecurityGroupRule[] |
| Protokoll | Das Protokoll des Endpunkts. | "TCP" "UDP" (erforderlich) |
LinuxUserConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| gid | Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt. | Int |
| sshPrivateKey | Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um die asymmetrische schlüsselbasierte Authentifizierung für SSH zwischen Knoten in einem Linux-Pool automatisch zu konfigurieren, wenn die Eigenschaft enableInterNodeCommunication des Pools wahr ist (wird ignoriert, wenn enableInterNodeCommunication false ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Wenn nicht angegeben, wird kennwortloses SSH nicht zwischen Knoten konfiguriert (es erfolgt keine Änderung des SSH-Verzeichnisses des Benutzers). | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| uid | Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt. | Int |
ManagedDisk
| Name | Beschreibung | Wert |
|---|---|---|
| storageAccountType | Der Speicherkontotyp zum Erstellen von Datenträgern oder Betriebssystemdatenträgern. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
MetadataItem
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name des Metadatenelements. | Zeichenfolge (erforderlich) |
| Wert | Der Wert des Metadatenelements. | Zeichenfolge (erforderlich) |
Microsoft.Batch/batchAccounts/pools
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | '2023-11-01' |
| Identität | Der Identitätstyp, der für den Batchpool verwendet wird. | BatchPoolIdentity- |
| Name | Der Ressourcenname | Schnur Zwänge: Min. Länge = 1 Max. Länge = 64 Pattern = ^[a-zA-Z0-9_-]+$ (erforderlich) |
| Eigenschaften | Die dem Pool zugeordneten Eigenschaften. | PoolProperties- |
| Art | Der Ressourcentyp | "Microsoft.Batch/batchAccounts/pools" |
MountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| azureBlobFileSystemConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | AzureBlobFileSystemConfiguration |
| azureFileShareConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | AzureFileShareConfiguration- |
| cifsMountConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | CifsMountConfiguration |
| nfsMountConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | NFSMountConfiguration |
NetworkConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| dynamicVnetAssignmentScope | Der Umfang der dynamischen vnet-Zuordnung. | "Job" 'none' |
| enableAcceleratedNetworking | Das beschleunigte Netzwerk ermöglicht die einzelne E/A-Virtualisierung (SR-IOV) für einen virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter :/azure/virtual-network/accelerated-networking-overview. | Bool |
| endpointConfiguration | Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Diese Eigenschaft wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PublicIPAddressConfiguration- |
| subnetz-ID | Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure Batch-Konto befinden. Das angegebene Subnetz sollte über genügend freie IP-Adressen verfügen, um die Anzahl der Knoten im Pool aufzunehmen. Wenn das Subnetz nicht über genügend freie IP-Adressen verfügt, weist der Pool teilweise Computeknoten zu, und es tritt ein Fehler bei der Größenänderung auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss zulassen, dass die Kommunikation vom Azure Batch-Dienst Vorgänge auf den Computeknoten planen kann. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Computeknoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Wenn das angegebene VNet über eine zugeordnete Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden. Aktivieren Sie für Pools, die mit einer Konfiguration für virtuelle Computer erstellt wurden, 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, ports 10100, 20100 und 30100. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Für CloudServiceConfiguration-Pools werden nur klassische VNETs unterstützt. Weitere Informationen finden Sie unter :/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | Schnur |
NetworkSecurityGroupRule
| Name | Beschreibung | Wert |
|---|---|---|
| Zugang | Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll. | "Zulassen" "Verweigern" (erforderlich) |
| Priorität | Prioritäten innerhalb eines Pools müssen eindeutig sein und in der Reihenfolge der Priorität ausgewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 4096. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| sourceAddressPrefix | Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | Zeichenfolge (erforderlich) |
| sourcePortRanges | Gültige Werte sind '*' (für alle Ports 0 - 65535) oder Arrays von Ports oder Portbereichen (d. h. 100-200). Die Ports sollten im Bereich von 0 bis 65535 liegen, und die Portbereiche oder Ports können sich nicht überlappen. Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Der Standardwert ist *. | string[] |
NFSMountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| Quelle | Der URI des zu mountden Dateisystems. | Zeichenfolge (erforderlich) |
NodePlacementConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Politik | Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie. | "Regional" "Zonal" |
OSDisk
| Name | Beschreibung | Wert |
|---|---|---|
| Caching | Der Typ der Zwischenspeicherung, die für den Datenträger aktiviert werden soll. | 'None' 'ReadOnly' 'ReadWrite' |
| diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers. | Int |
| ephemeralOSDiskSettings | Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. | DiffDiskSettings |
| managedDisk | ManagedDisk- | |
| writeAcceleratorEnabled | Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll. | Bool |
PoolEndpointConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| inboundNatPools | 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 dem HTTP-Statuscode 400 fehl. Dies kann nicht angegeben werden, wenn der IPAddressProvisioningType NoPublicIPAddresses ist. | InboundNatPool-[] (erforderlich) |
PoolProperties
| Name | Beschreibung | Wert |
|---|---|---|
| applicationLicenses | Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl. | string[] |
| applicationPackages | Änderungen an Anwendungspaketverweise wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages aktualisiert werden. Es gibt maximal 10 Anwendungspaketverweise für einen bestimmten Pool. | ApplicationPackageReference[] |
| Atteste | Für Windows-Computeknoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung. |
CertificateReference-[] |
| deploymentConfiguration | Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet. | DeploymentConfiguration- |
| displayName | Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten. | Schnur |
| interNodeCommunication | Dadurch werden Einschränkungen auferlegt, denen dem Pool Knoten zugewiesen werden können. Durch Aktivieren dieses Werts kann die Wahrscheinlichkeit verringert werden, dass die angeforderte Anzahl von Knoten im Pool zugewiesen werden soll. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. | "Deaktiviert" "Aktiviert" |
| Metadaten | Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. | MetadataItem-[] |
| mountConfiguration | Dies unterstützt Azure Files, NFS, CIFS/SMB und Blobfuse. | MountConfiguration-[] |
| networkConfiguration | Die Netzwerkkonfiguration für einen Pool. | NetworkConfiguration- |
| resourceTags | Die benutzerdefinierten Tags, die dem Azure-Batchpool zugeordnet werden sollen. Wenn angegeben, werden diese Tags an die zugrunde stehenden Azure-Ressourcen verteilt, die dem Pool zugeordnet sind. Diese Eigenschaft kann nur angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt wurde. | PoolPropertiesResourceTags |
| scaleSettings | Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem die angeforderten targetDedicatedNodes angegeben sind, oder 'autoScale', die eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben ist, hat der Pool eine feste Skalierung mit 0 targetDedicatedNodes. | ScaleSettings- |
| startTask | In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um die Startaufgabe aus dem Pool zu entfernen. | StartTask- |
| targetNodeCommunicationMode | Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Default". | "Klassisch" 'Standard' "Vereinfacht" |
| taskSchedulingPolicy | Wenn nicht angegeben, wird die Standardeinstellung verteilt. | TaskSchedulingPolicy- |
| taskSlotsPerNode | Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256. | Int |
| userAccounts | Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen. | UserAccount[] |
| vmSize | Informationen zu 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 VM-Größen der Clouddienste mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (Pools, die mit virtualMachineConfiguration erstellt wurden) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie). | Schnur |
PoolPropertiesResourceTags
| Name | Beschreibung | Wert |
|---|
PublicIPAddressConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| ipAddressIds | Die hier angegebene Anzahl von IPs begrenzt die maximale Größe des Pools – 100 dedizierte Knoten oder 100 Spot/Low-Priority-Knoten können für jede öffentliche IP zugewiesen werden. Ein Pool, der 250 dedizierte VMs benötigt, benötigt beispielsweise mindestens 3 öffentliche IPs. Jedes Element dieser Auflistung weist das Format auf: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
| Vorsorge | Der Standardwert ist BatchManaged | "BatchManaged" 'NoPublicIPAddresses' "UserManaged" |
ResourceFile
| Name | Beschreibung | Wert |
|---|---|---|
| autoStorageContainerName | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. | Schnur |
| blobPrefix | Die Eigenschaft ist nur gültig, wenn autoStorageContainerName oder storageContainerUrl verwendet wird. Dieses Präfix kann ein teilweiser Dateiname oder ein Unterverzeichnis sein. Wenn kein Präfix angegeben ist, werden alle Dateien im Container heruntergeladen. | Schnur |
| fileMode | Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile angegeben wird, die auf einen Windows-Knoten heruntergeladen wird. Wenn diese Eigenschaft für einen Linux-Knoten nicht angegeben ist, wird auf die Datei ein Standardwert von 0770 angewendet. | Schnur |
| filePath | Wenn die httpUrl-Eigenschaft angegeben ist, ist der FilePath erforderlich und beschreibt den Pfad, in den die Datei heruntergeladen wird, einschließlich des Dateinamens. Andernfalls ist filePath optional, wenn die autoStorageContainerName- oder storageContainerUrl-Eigenschaft angegeben ist, und das Verzeichnis, in das die Dateien heruntergeladen werden sollen. Wenn FilePath als Verzeichnis verwendet wird, werden alle bereits den Eingabedaten zugeordneten Verzeichnisstruktur vollständig aufbewahrt und an das angegebene FilePath-Verzeichnis angefügt. Der angegebene relative Pfad kann nicht aus dem Arbeitsverzeichnis des Vorgangs (z. B. mit '.') herausbrechen. | Schnur |
| httpUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Wenn die URL auf Azure Blob Storage verweist, muss sie von Computeknoten gelesen werden. Es gibt drei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Leseberechtigungen für das Blob gewährt, eine verwaltete Identität mit Leseberechtigung verwenden oder die ACL für das Blob oder dessen Container so festlegen, dass der öffentliche Zugriff zulässig ist. | Schnur |
| identityReference | Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet. | ComputeNodeIdentityReference- |
| storageContainerUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss von Computeknoten lesbar und auflistenbar sein. Es gibt drei Möglichkeiten, eine solche URL für einen Container in Azure Storage abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Lese- und Listenberechtigungen für den Container gewährt, eine verwaltete Identität mit Lese- und Listenberechtigungen verwenden oder die ACL für den Container so festlegen, dass der öffentliche Zugriff zugelassen wird. | Schnur |
ScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| AutoScale | Diese Eigenschaft und fixedScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | AutoScaleSettings- |
| fixedScale | Diese Eigenschaft und autoScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | FixedScaleSettings- |
SecurityProfile
| Name | Beschreibung | Wert |
|---|---|---|
| encryptionAtHost | Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. | Bool |
| securityType | Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. | "trustedLaunch" |
| uefiSettings | Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. | UefiSettings- |
ServiceArtifactReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | Zeichenfolge (erforderlich) |
StartTask
| Name | Beschreibung | Wert |
|---|---|---|
| commandLine | Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Erforderlich, wenn andere Eigenschaften des startTask angegeben werden. | Schnur |
| containerSettings | Wenn dies angegeben wird, werden alle Verzeichnisse rekursiv unterhalb der AZ_BATCH_NODE_ROOT_DIR (der Stamm von Azure Batchverzeichnissen auf dem Knoten) dem Container zugeordnet, alle Aufgabenumgebungsvariablen werden dem Container zugeordnet, und die Aufgabenbefehlszeile wird im Container ausgeführt. | TaskContainerSettings- |
| environmentSettings | Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. | EnvironmentSetting[] |
| maxTaskRetryCount | Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 ist, versucht Batch den Vorgang bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst den Vorgang nicht erneut aus. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung. Der Standardwert ist 0. | Int |
| resourceFiles | Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. | ResourceFile-[] |
| userIdentity | Wenn sie weggelassen wird, wird die Aufgabe als nicht administrativer Benutzer ausgeführt, der für die Aufgabe eindeutig ist. | UserIdentity- |
| waitForSuccess | Wenn true und die Startaufgabe auf einem Computeknoten fehlschlägt, wiederholt der Batchdienst die Startaufgabe bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Computeknoten nicht mehr verwendbar, und er plant keine Vorgänge. Diese Bedingung kann über den Knotenstatus und das Planungsfehlerdetails erkannt werden. Wenn false, wartet der Batchdienst nicht, bis die Startaufgabe abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während die Startaufgabe noch ausgeführt wird. und auch wenn der Startvorgang fehlschlägt, werden neue Vorgänge weiterhin auf dem Knoten geplant. Der Standardwert ist "true". | Bool |
TaskContainerSettings
| Name | Beschreibung | Wert |
|---|---|---|
| containerRunOptions | Diese zusätzlichen Optionen werden zusätzlich zu den vom Batchdienst gesteuerten Befehlen als Argumente für den Befehl "docker create" bereitgestellt. | Schnur |
| imageName | Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben. Wenn kein Tag als Teil des Bildnamens angegeben wird, wird das Tag ":latest" als Standard verwendet. | Zeichenfolge (erforderlich) |
| Registrierung | Diese Einstellung kann weggelassen werden, wenn sie bereits bei der Poolerstellung bereitgestellt wurde. | ContainerRegistry- |
| workingDirectory | Ein Kennzeichen, das angibt, wo sich das Arbeitsverzeichnis der Containeraufgabe befindet. Der Standardwert ist "taskWorkingDirectory". | 'ContainerImageDefault' 'TaskWorkingDirectory' |
TaskSchedulingPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| nodeFillType | Wie Aufgaben über Computeknoten verteilt werden sollen. | "Pack" "Spread" (erforderlich) |
UefiSettings
| Name | Beschreibung | Wert |
|---|---|---|
| secureBootEnabled | Gibt an, ob der sichere Start auf dem virtuellen Computer aktiviert werden soll. | Bool |
| vTpmEnabled | Gibt an, ob vTPM auf dem virtuellen Computer aktiviert werden soll. | Bool |
UserAccount
| Name | Beschreibung | Wert |
|---|---|---|
| elevationLevel | nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". | "Administrator" 'NonAdmin' |
| linuxUserConfiguration | Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt. | LinuxUserConfiguration- |
| Name | Der Name des Benutzerkontos. Namen können bis zu einer maximalen Länge von 20 Unicode-Zeichen enthalten. | Zeichenfolge (erforderlich) |
| Passwort | Das Kennwort für das Benutzerkonto. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| windowsUserConfiguration | 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. | WindowsUserConfiguration- |
UserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
UserIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| autoUser | Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. | AutoUserSpecification- |
| Nutzername | Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. | Schnur |
VirtualMachineConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| containerConfiguration | Wenn angegeben, wird das Setup für jeden Knoten im Pool ausgeführt, damit Aufgaben in Containern ausgeführt werden können. Alle regulären Aufgaben und Auftragsverwaltungsaufgaben, die auf diesem Pool ausgeführt werden, müssen die eigenschaft containerSettings angeben, und alle anderen Aufgaben können sie angeben. | ContainerConfiguration- |
| dataDisks | Diese Eigenschaft muss angegeben werden, wenn die Computeknoten im Pool über leere Datenträger verfügen müssen, die an sie angefügt sind. | DataDisk-[] |
| diskEncryptionConfiguration | Wenn angegeben, wird die Verschlüsselung für jeden Knoten im Pool während der Knotenbereitstellung ausgeführt. | DiskEncryptionConfiguration |
| Erweiterungen | Wenn angegeben, werden die in dieser Konfiguration genannten Erweiterungen auf jedem Knoten installiert. | VMExtension-[] |
| imageReference | Ein Verweis auf ein Azure Virtual Machines Marketplace-Image oder die Azure Image-Ressource eines benutzerdefinierten virtuellen Computers. Informationen zum Abrufen der Liste aller imageReferences, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". | ImageReference- (erforderlich) |
| licenseType | Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollte nur verwendet werden, wenn Sie gültige lokale Lizenzen für die Knoten halten, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Werte sind: Windows_Server – Die lokale Lizenz gilt für Windows Server. Windows_Client – Die lokale Lizenz ist für Windows Client. |
Schnur |
| nodeAgentSkuId | Der Batchknoten-Agent ist ein Programm, das auf jedem Knoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Knoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Knoten-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Knoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Knoten-Agent-SKUs sowie deren Liste der überprüften Bildverweise finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". | Zeichenfolge (erforderlich) |
| nodePlacementConfiguration | Diese Konfiguration gibt Regeln für die physische Zuordnung von Knoten im Pool an. | NodePlacementConfiguration- |
| osDisk | Enthält die Konfiguration für kurzlebige OSDisk-Einstellungen. | OSDisk- |
| securityProfile | Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers an. | SecurityProfile- |
| serviceArtifactReference | Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | ServiceArtifactReference |
| windowsConfiguration | Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. | WindowsConfiguration- |
VMExtension
| Name | Beschreibung | Wert |
|---|---|---|
| autoUpgradeMinorVersion | Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist. | Bool |
| enableAutomaticUpgrade | Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. | Bool |
| Name | Der Name der Erweiterung des virtuellen Computers. | Zeichenfolge (erforderlich) |
| protectedSettings | Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. | jegliche |
| provisionAfterExtensions | Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss. | string[] |
| Verlag | Der Name des Herausgebers des Erweiterungshandlers. | Zeichenfolge (erforderlich) |
| Einstellungen | JSON-formatierte öffentliche Einstellungen für die Erweiterung. | jegliche |
| Art | Der Typ der Erweiterungen. | Zeichenfolge (erforderlich) |
| typeHandlerVersion | Die Version des Skripthandlers. | Schnur |
WindowsConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| enableAutomaticUpdates | Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true". | Bool |
WindowsUserConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| loginMode | Gibt den Anmeldemodus für den Benutzer an. Der Standardwert für VirtualMachineConfiguration-Pools ist der interaktive Modus und für CloudServiceConfiguration-Pools der Batchmodus. | "Batch" "Interaktiv" |
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
| Schablone | Beschreibung |
|---|---|
Azure Batchpool ohne öffentliche IP-Adressen
|
Diese Vorlage erstellt einen vereinfachten Azure Batch-Knotenkommunikationspool ohne öffentliche IP-Adressen. |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp "batchAccounts/pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Ressource "Microsoft.Batch/batchAccounts/pools" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Batch/batchAccounts/pools@2023-11-01"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
body = jsonencode({
properties = {
applicationLicenses = [
"string"
]
applicationPackages = [
{
id = "string"
version = "string"
}
]
certificates = [
{
id = "string"
storeLocation = "string"
storeName = "string"
visibility = [
"string"
]
}
]
deploymentConfiguration = {
cloudServiceConfiguration = {
osFamily = "string"
osVersion = "string"
}
virtualMachineConfiguration = {
containerConfiguration = {
containerImageNames = [
"string"
]
containerRegistries = [
{
identityReference = {
resourceId = "string"
}
password = "string"
registryServer = "string"
username = "string"
}
]
type = "string"
}
dataDisks = [
{
caching = "string"
diskSizeGB = int
lun = int
storageAccountType = "string"
}
]
diskEncryptionConfiguration = {
targets = [
"string"
]
}
extensions = [
{
autoUpgradeMinorVersion = bool
enableAutomaticUpgrade = bool
name = "string"
protectedSettings = ?
provisionAfterExtensions = [
"string"
]
publisher = "string"
settings = ?
type = "string"
typeHandlerVersion = "string"
}
]
imageReference = {
id = "string"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
}
licenseType = "string"
nodeAgentSkuId = "string"
nodePlacementConfiguration = {
policy = "string"
}
osDisk = {
caching = "string"
diskSizeGB = int
ephemeralOSDiskSettings = {
placement = "CacheDisk"
}
managedDisk = {
storageAccountType = "string"
}
writeAcceleratorEnabled = bool
}
securityProfile = {
encryptionAtHost = bool
securityType = "trustedLaunch"
uefiSettings = {
secureBootEnabled = bool
vTpmEnabled = bool
}
}
serviceArtifactReference = {
id = "string"
}
windowsConfiguration = {
enableAutomaticUpdates = bool
}
}
}
displayName = "string"
interNodeCommunication = "string"
metadata = [
{
name = "string"
value = "string"
}
]
mountConfiguration = [
{
azureBlobFileSystemConfiguration = {
accountKey = "string"
accountName = "string"
blobfuseOptions = "string"
containerName = "string"
identityReference = {
resourceId = "string"
}
relativeMountPath = "string"
sasKey = "string"
}
azureFileShareConfiguration = {
accountKey = "string"
accountName = "string"
azureFileUrl = "string"
mountOptions = "string"
relativeMountPath = "string"
}
cifsMountConfiguration = {
mountOptions = "string"
password = "string"
relativeMountPath = "string"
source = "string"
userName = "string"
}
nfsMountConfiguration = {
mountOptions = "string"
relativeMountPath = "string"
source = "string"
}
}
]
networkConfiguration = {
dynamicVnetAssignmentScope = "string"
enableAcceleratedNetworking = bool
endpointConfiguration = {
inboundNatPools = [
{
backendPort = int
frontendPortRangeEnd = int
frontendPortRangeStart = int
name = "string"
networkSecurityGroupRules = [
{
access = "string"
priority = int
sourceAddressPrefix = "string"
sourcePortRanges = [
"string"
]
}
]
protocol = "string"
}
]
}
publicIPAddressConfiguration = {
ipAddressIds = [
"string"
]
provision = "string"
}
subnetId = "string"
}
resourceTags = {
{customized property} = "string"
}
scaleSettings = {
autoScale = {
evaluationInterval = "string"
formula = "string"
}
fixedScale = {
nodeDeallocationOption = "string"
resizeTimeout = "string"
targetDedicatedNodes = int
targetLowPriorityNodes = int
}
}
startTask = {
commandLine = "string"
containerSettings = {
containerRunOptions = "string"
imageName = "string"
registry = {
identityReference = {
resourceId = "string"
}
password = "string"
registryServer = "string"
username = "string"
}
workingDirectory = "string"
}
environmentSettings = [
{
name = "string"
value = "string"
}
]
maxTaskRetryCount = int
resourceFiles = [
{
autoStorageContainerName = "string"
blobPrefix = "string"
fileMode = "string"
filePath = "string"
httpUrl = "string"
identityReference = {
resourceId = "string"
}
storageContainerUrl = "string"
}
]
userIdentity = {
autoUser = {
elevationLevel = "string"
scope = "string"
}
userName = "string"
}
waitForSuccess = bool
}
targetNodeCommunicationMode = "string"
taskSchedulingPolicy = {
nodeFillType = "string"
}
taskSlotsPerNode = int
userAccounts = [
{
elevationLevel = "string"
linuxUserConfiguration = {
gid = int
sshPrivateKey = "string"
uid = int
}
name = "string"
password = "string"
windowsUserConfiguration = {
loginMode = "string"
}
}
]
vmSize = "string"
}
})
}
Eigenschaftswerte
ApplicationPackageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die ID des zu installierenden Anwendungspakets. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. Dies kann entweder ein Verweis auf eine bestimmte Version oder die Standardversion sein, falls vorhanden. | Zeichenfolge (erforderlich) |
| Version | Wenn dies nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences fehl. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 409. | Schnur |
AutoScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| evaluationInterval | Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 15 Minuten (PT15M). | Schnur |
| Formel | Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. | Zeichenfolge (erforderlich) |
AutoUserSpecification
| Name | Beschreibung | Wert |
|---|---|---|
| elevationLevel | Der Standardwert ist "nonAdmin". | "Administrator" 'NonAdmin' |
| Umfang | Der Standardwert ist Pool. Wenn der Pool Windows ausführt, sollte ein Wert der Aufgabe angegeben werden, wenn eine strengere Isolierung zwischen Vorgängen erforderlich ist. Wenn die Aufgabe z. B. die Registrierung auf eine Weise stummschaltet, die sich auf andere Aufgaben auswirken könnte, oder wenn Zertifikate auf dem Pool angegeben wurden, auf die nicht durch normale Aufgaben zugegriffen werden sollte, sondern durch Startaufgaben zugänglich sein sollte. | "Pool" "Vorgang" |
AzureBlobFileSystemConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accountKey | Diese Eigenschaft schließt sich gegenseitig mit sasKey und Identität aus; genau einer muss angegeben werden. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| accountName | Der Name des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| blobfuseOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| containerName | Der Name des Azure Blob Storage-Containers. | Zeichenfolge (erforderlich) |
| identityReference | Diese Eigenschaft schließt sich gegenseitig mit accountKey und sasKey aus. genau einer muss angegeben werden. | ComputeNodeIdentityReference- |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| sasKey | Diese Eigenschaft schließt sich gegenseitig mit AccountKey und Identität aus; genau einer muss angegeben werden. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
AzureFileShareConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accountKey | Der Azure Storage-Kontoschlüssel. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| accountName | Der Name des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| azureFileUrl | Dies ist das Format "https://{account}.file.core.windows.net/". | Zeichenfolge (erforderlich) |
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
BatchPoolIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Identitätstyp, der für den Batchpool verwendet wird. | 'None' "UserAssigned" (erforderlich) |
| userAssignedIdentities | Die Liste der Benutzeridentitäten, die dem Batchpool zugeordnet sind. | BatchPoolIdentityUserAssignedIdentities- |
BatchPoolIdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
CertificateReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die vollqualifizierte ID des Zertifikats, das im Pool installiert werden soll. Dies muss sich innerhalb desselben Batchkontos wie der Pool befinden. | Zeichenfolge (erforderlich) |
| storeLocation | Der Standardwert ist currentUser. Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. | 'CurrentUser' "LocalMachine" |
| storeName | Diese Eigenschaft gilt nur für Pools, die mit Windows-Knoten konfiguriert sind (d. a. erstellt mit cloudServiceConfiguration oder mit virtualMachineConfiguration mithilfe eines Windows-Imageverweises). Allgemeine Store-Namen sind: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, but any custom store name can also be used. Der Standardwert ist "Mein". | Schnur |
| Sichtbarkeit | Welche Benutzerkonten auf dem Computeknoten Zugriff auf die privaten Daten des Zertifikats haben sollen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'RemoteUser' "StartTask" "Vorgang" |
CifsMountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| Passwort | Das Kennwort, das für die Authentifizierung im CIFS-Dateisystem verwendet werden soll. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| Quelle | Der URI des zu mountden Dateisystems. | Zeichenfolge (erforderlich) |
| Nutzername | Der Benutzer, der für die Authentifizierung gegen das CIFS-Dateisystem verwendet werden soll. | Zeichenfolge (erforderlich) |
CloudServiceConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| osFamily | 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 Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | Zeichenfolge (erforderlich) |
| osVersion | Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. | Schnur |
ComputeNodeIdentityReference
| Name | Beschreibung | Wert |
|---|---|---|
| resourceId | Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität. | Schnur |
ContainerConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| containerImageNames | Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben. Ein Image wird aus der Docker-Standardregistrierung stammen, es sei denn, das Image ist vollqualifizierte mit einer alternativen Registrierung. | string[] |
| containerRegistries | Wenn Bilder aus einer privaten Registrierung heruntergeladen werden müssen, die Anmeldeinformationen erfordert, müssen diese Anmeldeinformationen hier angegeben werden. | ContainerRegistry[] |
| Art | Die zu verwendende Containertechnologie. | 'CriCompatible' "DockerCompatible" (erforderlich) |
ContainerRegistry
| Name | Beschreibung | Wert |
|---|---|---|
| identityReference | Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet. | ComputeNodeIdentityReference- |
| Passwort | Das Kennwort für die Anmeldung beim Registrierungsserver. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| registryServer | Wenn nicht angegeben, lautet der Standardwert "docker.io". | Schnur |
| Nutzername | Der Benutzername, der sich beim Registrierungsserver anmeldet. | Schnur |
DataDisk
| Name | Beschreibung | Wert |
|---|---|---|
| Caching | Werte sind: none – Der Cachemodus für den Datenträger ist nicht aktiviert. readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt. readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt. Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
'None' 'ReadOnly' 'ReadWrite' |
| diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. | int (erforderlich) |
| lun | Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. Der Wert muss zwischen 0 und 63 (einschließlich) liegen. | int (erforderlich) |
| storageAccountType | Wenn nicht angegeben, lautet der Standardwert "Standard_LRS". Werte sind: Standard_LRS – Der Datenträger sollte standardmäßigen lokal redundanten Speicher verwenden. Premium_LRS – Der Datenträger sollte einen lokal redundanten Premiumspeicher verwenden. |
"Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
DeploymentConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| cloudServiceConfiguration | Diese Eigenschaft und virtualMachineConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. Diese Eigenschaft kann nicht angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft erstellt wurde, die auf "UserSubscription" festgelegt ist. | CloudServiceConfiguration- |
| virtualMachineConfiguration | Diese Eigenschaft und cloudServiceConfiguration schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | VirtualMachineConfiguration |
DiffDiskSettings
| Name | Beschreibung | Wert |
|---|---|---|
| Platzierung | Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um auszuwählen, an welchem Speicherort sich das Betriebssystem befinden soll. z. B. Cachespeicherplatz für ephemerale Betriebssystemdatenträgerbereitstellung. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter Ephemeral Os Disk Size Requirements für Windows-VMs unter /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements and Linux VMs at /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | 'CacheDisk' |
DiskEncryptionConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Ziele | Unter Linux-Pool wird nur "TemporaryDisk" unterstützt; unter Windows-Pool muss "OsDisk" und "TemporaryDisk" angegeben werden. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'OsDisk' 'TemporaryDisk' |
EnvironmentSetting
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name der Umgebungsvariable. | Zeichenfolge (erforderlich) |
| Wert | Der Wert der Umgebungsvariable. | Schnur |
FixedScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| nodeDeallocationOption | Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Requeue". | 'Requeue' "RetainedData" "TaskCompletion" "Beenden" |
| resizeTimeout | Der Standardwert beträgt 15 Minuten. Timeoutwerte verwenden das ISO 8601-Format. Verwenden Sie z. B. PT10M für 10 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, lehnt der Batchdienst die Anforderung mit einem Fehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). | Schnur |
| targetDedicatedNodes | Mindestens einer von targetDedicatedNodes muss "targetLowPriorityNodes" festgelegt werden. | Int |
| targetLowPriorityNodes | Mindestens einer von targetDedicatedNodes muss "targetLowPriorityNodes" festgelegt werden. | Int |
ImageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Azure Compute Gallery Image muss Replikate in derselben Region wie das Azure Batch-Konto haben. Informationen zu den Firewalleinstellungen für den Batchknoten-Agent für die Kommunikation mit dem Batchdienst finden Sie unter "/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration". | Schnur |
| Angebot | Beispiel: UbuntuServer oder WindowsServer. | Schnur |
| Verlag | Beispiel: Canonical oder MicrosoftWindowsServer. | Schnur |
| Sku | Beispiel: 18.04-LTS oder 2022-Datacenter. | Schnur |
| Version | Ein Wert von "latest" kann angegeben werden, um die neueste Version eines Bilds auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest". | Schnur |
InboundNatPool
| Name | Beschreibung | Wert |
|---|---|---|
| backPort | 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 bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| frontendPortRangeEnd | Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| frontendPortRangeStart | Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen eindeutig sein und können nicht überlappen. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| Name | Der Name muss innerhalb eines Batchpools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | Zeichenfolge (erforderlich) |
| networkSecurityGroupRules | Die maximale Anzahl von Regeln, die für alle Endpunkte in einem Batchpool angegeben werden können, ist 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | NetworkSecurityGroupRule[] |
| Protokoll | Das Protokoll des Endpunkts. | "TCP" "UDP" (erforderlich) |
LinuxUserConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| gid | Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt. | Int |
| sshPrivateKey | Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um die asymmetrische schlüsselbasierte Authentifizierung für SSH zwischen Knoten in einem Linux-Pool automatisch zu konfigurieren, wenn die Eigenschaft enableInterNodeCommunication des Pools wahr ist (wird ignoriert, wenn enableInterNodeCommunication false ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Wenn nicht angegeben, wird kennwortloses SSH nicht zwischen Knoten konfiguriert (es erfolgt keine Änderung des SSH-Verzeichnisses des Benutzers). | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| uid | Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt. | Int |
ManagedDisk
| Name | Beschreibung | Wert |
|---|---|---|
| storageAccountType | Der Speicherkontotyp zum Erstellen von Datenträgern oder Betriebssystemdatenträgern. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" |
MetadataItem
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name des Metadatenelements. | Zeichenfolge (erforderlich) |
| Wert | Der Wert des Metadatenelements. | Zeichenfolge (erforderlich) |
Microsoft.Batch/batchAccounts/pools
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Der Identitätstyp, der für den Batchpool verwendet wird. | BatchPoolIdentity- |
| Name | Der Ressourcenname | Schnur Zwänge: Min. Länge = 1 Max. Länge = 64 Pattern = ^[a-zA-Z0-9_-]+$ (erforderlich) |
| parent_id | Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. | ID für Ressource des Typs: batchAccounts |
| Eigenschaften | Die dem Pool zugeordneten Eigenschaften. | PoolProperties- |
| Art | Der Ressourcentyp | "Microsoft.Batch/batchAccounts/pools@2023-11-01" |
MountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| azureBlobFileSystemConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | AzureBlobFileSystemConfiguration |
| azureFileShareConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | AzureFileShareConfiguration- |
| cifsMountConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | CifsMountConfiguration |
| nfsMountConfiguration | Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus. | NFSMountConfiguration |
NetworkConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| dynamicVnetAssignmentScope | Der Umfang der dynamischen vnet-Zuordnung. | "Job" 'none' |
| enableAcceleratedNetworking | Das beschleunigte Netzwerk ermöglicht die einzelne E/A-Virtualisierung (SR-IOV) für einen virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter :/azure/virtual-network/accelerated-networking-overview. | Bool |
| endpointConfiguration | Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Diese Eigenschaft wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PublicIPAddressConfiguration- |
| subnetz-ID | Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure Batch-Konto befinden. Das angegebene Subnetz sollte über genügend freie IP-Adressen verfügen, um die Anzahl der Knoten im Pool aufzunehmen. Wenn das Subnetz nicht über genügend freie IP-Adressen verfügt, weist der Pool teilweise Computeknoten zu, und es tritt ein Fehler bei der Größenänderung auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss zulassen, dass die Kommunikation vom Azure Batch-Dienst Vorgänge auf den Computeknoten planen kann. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Computeknoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Wenn das angegebene VNet über eine zugeordnete Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden. Aktivieren Sie für Pools, die mit einer Konfiguration für virtuelle Computer erstellt wurden, 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, ports 10100, 20100 und 30100. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Für CloudServiceConfiguration-Pools werden nur klassische VNETs unterstützt. Weitere Informationen finden Sie unter :/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | Schnur |
NetworkSecurityGroupRule
| Name | Beschreibung | Wert |
|---|---|---|
| Zugang | Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll. | "Zulassen" "Verweigern" (erforderlich) |
| Priorität | Prioritäten innerhalb eines Pools müssen eindeutig sein und in der Reihenfolge der Priorität ausgewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 4096. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | int (erforderlich) |
| sourceAddressPrefix | Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | Zeichenfolge (erforderlich) |
| sourcePortRanges | Gültige Werte sind '*' (für alle Ports 0 - 65535) oder Arrays von Ports oder Portbereichen (d. h. 100-200). Die Ports sollten im Bereich von 0 bis 65535 liegen, und die Portbereiche oder Ports können sich nicht überlappen. Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. Der Standardwert ist *. | string[] |
NFSMountConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| mountOptions | Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux. | Schnur |
| relativeMountPath | Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann. | Zeichenfolge (erforderlich) |
| Quelle | Der URI des zu mountden Dateisystems. | Zeichenfolge (erforderlich) |
NodePlacementConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Politik | Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie. | "Regional" "Zonal" |
OSDisk
| Name | Beschreibung | Wert |
|---|---|---|
| Caching | Der Typ der Zwischenspeicherung, die für den Datenträger aktiviert werden soll. | 'None' 'ReadOnly' 'ReadWrite' |
| diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers. | Int |
| ephemeralOSDiskSettings | Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. | DiffDiskSettings |
| managedDisk | ManagedDisk- | |
| writeAcceleratorEnabled | Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll. | Bool |
PoolEndpointConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| inboundNatPools | 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 dem HTTP-Statuscode 400 fehl. Dies kann nicht angegeben werden, wenn der IPAddressProvisioningType NoPublicIPAddresses ist. | InboundNatPool-[] (erforderlich) |
PoolProperties
| Name | Beschreibung | Wert |
|---|---|---|
| applicationLicenses | Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl. | string[] |
| applicationPackages | Änderungen an Anwendungspaketverweise wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages aktualisiert werden. Es gibt maximal 10 Anwendungspaketverweise für einen bestimmten Pool. | ApplicationPackageReference[] |
| Atteste | Für Windows-Computeknoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis der Aufgabe gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR der Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von "remoteUser" wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) erstellt und Zertifikate in diesem Verzeichnis platziert. Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung. |
CertificateReference-[] |
| deploymentConfiguration | Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet. | DeploymentConfiguration- |
| displayName | Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten. | Schnur |
| interNodeCommunication | Dadurch werden Einschränkungen auferlegt, denen dem Pool Knoten zugewiesen werden können. Durch Aktivieren dieses Werts kann die Wahrscheinlichkeit verringert werden, dass die angeforderte Anzahl von Knoten im Pool zugewiesen werden soll. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. | "Deaktiviert" "Aktiviert" |
| Metadaten | Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. | MetadataItem-[] |
| mountConfiguration | Dies unterstützt Azure Files, NFS, CIFS/SMB und Blobfuse. | MountConfiguration-[] |
| networkConfiguration | Die Netzwerkkonfiguration für einen Pool. | NetworkConfiguration- |
| resourceTags | Die benutzerdefinierten Tags, die dem Azure-Batchpool zugeordnet werden sollen. Wenn angegeben, werden diese Tags an die zugrunde stehenden Azure-Ressourcen verteilt, die dem Pool zugeordnet sind. Diese Eigenschaft kann nur angegeben werden, wenn das Batchkonto mit der poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt wurde. | PoolPropertiesResourceTags |
| scaleSettings | Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem die angeforderten targetDedicatedNodes angegeben sind, oder 'autoScale', die eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben ist, hat der Pool eine feste Skalierung mit 0 targetDedicatedNodes. | ScaleSettings- |
| startTask | In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um die Startaufgabe aus dem Pool zu entfernen. | StartTask- |
| targetNodeCommunicationMode | Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "Default". | "Klassisch" 'Standard' "Vereinfacht" |
| taskSchedulingPolicy | Wenn nicht angegeben, wird die Standardeinstellung verteilt. | TaskSchedulingPolicy- |
| taskSlotsPerNode | Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256. | Int |
| userAccounts | Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen. | UserAccount[] |
| vmSize | Informationen zu 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 VM-Größen der Clouddienste mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (Pools, die mit virtualMachineConfiguration erstellt wurden) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie). | Schnur |
PoolPropertiesResourceTags
| Name | Beschreibung | Wert |
|---|
PublicIPAddressConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| ipAddressIds | Die hier angegebene Anzahl von IPs begrenzt die maximale Größe des Pools – 100 dedizierte Knoten oder 100 Spot/Low-Priority-Knoten können für jede öffentliche IP zugewiesen werden. Ein Pool, der 250 dedizierte VMs benötigt, benötigt beispielsweise mindestens 3 öffentliche IPs. Jedes Element dieser Auflistung weist das Format auf: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. | string[] |
| Vorsorge | Der Standardwert ist BatchManaged | "BatchManaged" 'NoPublicIPAddresses' "UserManaged" |
ResourceFile
| Name | Beschreibung | Wert |
|---|---|---|
| autoStorageContainerName | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. | Schnur |
| blobPrefix | Die Eigenschaft ist nur gültig, wenn autoStorageContainerName oder storageContainerUrl verwendet wird. Dieses Präfix kann ein teilweiser Dateiname oder ein Unterverzeichnis sein. Wenn kein Präfix angegeben ist, werden alle Dateien im Container heruntergeladen. | Schnur |
| fileMode | Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile angegeben wird, die auf einen Windows-Knoten heruntergeladen wird. Wenn diese Eigenschaft für einen Linux-Knoten nicht angegeben ist, wird auf die Datei ein Standardwert von 0770 angewendet. | Schnur |
| filePath | Wenn die httpUrl-Eigenschaft angegeben ist, ist der FilePath erforderlich und beschreibt den Pfad, in den die Datei heruntergeladen wird, einschließlich des Dateinamens. Andernfalls ist filePath optional, wenn die autoStorageContainerName- oder storageContainerUrl-Eigenschaft angegeben ist, und das Verzeichnis, in das die Dateien heruntergeladen werden sollen. Wenn FilePath als Verzeichnis verwendet wird, werden alle bereits den Eingabedaten zugeordneten Verzeichnisstruktur vollständig aufbewahrt und an das angegebene FilePath-Verzeichnis angefügt. Der angegebene relative Pfad kann nicht aus dem Arbeitsverzeichnis des Vorgangs (z. B. mit '.') herausbrechen. | Schnur |
| httpUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Wenn die URL auf Azure Blob Storage verweist, muss sie von Computeknoten gelesen werden. Es gibt drei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Leseberechtigungen für das Blob gewährt, eine verwaltete Identität mit Leseberechtigung verwenden oder die ACL für das Blob oder dessen Container so festlegen, dass der öffentliche Zugriff zulässig ist. | Schnur |
| identityReference | Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet. | ComputeNodeIdentityReference- |
| storageContainerUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss von Computeknoten lesbar und auflistenbar sein. Es gibt drei Möglichkeiten, eine solche URL für einen Container in Azure Storage abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Lese- und Listenberechtigungen für den Container gewährt, eine verwaltete Identität mit Lese- und Listenberechtigungen verwenden oder die ACL für den Container so festlegen, dass der öffentliche Zugriff zugelassen wird. | Schnur |
ScaleSettings
| Name | Beschreibung | Wert |
|---|---|---|
| AutoScale | Diese Eigenschaft und fixedScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | AutoScaleSettings- |
| fixedScale | Diese Eigenschaft und autoScale schließen sich gegenseitig aus, und eine der Eigenschaften muss angegeben werden. | FixedScaleSettings- |
SecurityProfile
| Name | Beschreibung | Wert |
|---|---|---|
| encryptionAtHost | Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. | Bool |
| securityType | Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. | "trustedLaunch" |
| uefiSettings | Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. | UefiSettings- |
ServiceArtifactReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | Zeichenfolge (erforderlich) |
StartTask
| Name | Beschreibung | Wert |
|---|---|---|
| commandLine | Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Erforderlich, wenn andere Eigenschaften des startTask angegeben werden. | Schnur |
| containerSettings | Wenn dies angegeben wird, werden alle Verzeichnisse rekursiv unterhalb der AZ_BATCH_NODE_ROOT_DIR (der Stamm von Azure Batchverzeichnissen auf dem Knoten) dem Container zugeordnet, alle Aufgabenumgebungsvariablen werden dem Container zugeordnet, und die Aufgabenbefehlszeile wird im Container ausgeführt. | TaskContainerSettings- |
| environmentSettings | Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. | EnvironmentSetting[] |
| maxTaskRetryCount | Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 ist, versucht Batch den Vorgang bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst den Vorgang nicht erneut aus. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung. Der Standardwert ist 0. | Int |
| resourceFiles | Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. | ResourceFile-[] |
| userIdentity | Wenn sie weggelassen wird, wird die Aufgabe als nicht administrativer Benutzer ausgeführt, der für die Aufgabe eindeutig ist. | UserIdentity- |
| waitForSuccess | Wenn true und die Startaufgabe auf einem Computeknoten fehlschlägt, wiederholt der Batchdienst die Startaufgabe bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Computeknoten nicht mehr verwendbar, und er plant keine Vorgänge. Diese Bedingung kann über den Knotenstatus und das Planungsfehlerdetails erkannt werden. Wenn false, wartet der Batchdienst nicht, bis die Startaufgabe abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während die Startaufgabe noch ausgeführt wird. und auch wenn der Startvorgang fehlschlägt, werden neue Vorgänge weiterhin auf dem Knoten geplant. Der Standardwert ist "true". | Bool |
TaskContainerSettings
| Name | Beschreibung | Wert |
|---|---|---|
| containerRunOptions | Diese zusätzlichen Optionen werden zusätzlich zu den vom Batchdienst gesteuerten Befehlen als Argumente für den Befehl "docker create" bereitgestellt. | Schnur |
| imageName | Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben. Wenn kein Tag als Teil des Bildnamens angegeben wird, wird das Tag ":latest" als Standard verwendet. | Zeichenfolge (erforderlich) |
| Registrierung | Diese Einstellung kann weggelassen werden, wenn sie bereits bei der Poolerstellung bereitgestellt wurde. | ContainerRegistry- |
| workingDirectory | Ein Kennzeichen, das angibt, wo sich das Arbeitsverzeichnis der Containeraufgabe befindet. Der Standardwert ist "taskWorkingDirectory". | 'ContainerImageDefault' 'TaskWorkingDirectory' |
TaskSchedulingPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| nodeFillType | Wie Aufgaben über Computeknoten verteilt werden sollen. | "Pack" "Spread" (erforderlich) |
UefiSettings
| Name | Beschreibung | Wert |
|---|---|---|
| secureBootEnabled | Gibt an, ob der sichere Start auf dem virtuellen Computer aktiviert werden soll. | Bool |
| vTpmEnabled | Gibt an, ob vTPM auf dem virtuellen Computer aktiviert werden soll. | Bool |
UserAccount
| Name | Beschreibung | Wert |
|---|---|---|
| elevationLevel | nonAdmin – Der automatische Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff. admin – Der automatische Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen. Der Standardwert ist "nonAdmin". | "Administrator" 'NonAdmin' |
| linuxUserConfiguration | Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt. | LinuxUserConfiguration- |
| Name | Der Name des Benutzerkontos. Namen können bis zu einer maximalen Länge von 20 Unicode-Zeichen enthalten. | Zeichenfolge (erforderlich) |
| Passwort | Das Kennwort für das Benutzerkonto. | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. (erforderlich) |
| windowsUserConfiguration | 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. | WindowsUserConfiguration- |
UserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
UserIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| autoUser | Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. | AutoUserSpecification- |
| Nutzername | Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben. | Schnur |
VirtualMachineConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| containerConfiguration | Wenn angegeben, wird das Setup für jeden Knoten im Pool ausgeführt, damit Aufgaben in Containern ausgeführt werden können. Alle regulären Aufgaben und Auftragsverwaltungsaufgaben, die auf diesem Pool ausgeführt werden, müssen die eigenschaft containerSettings angeben, und alle anderen Aufgaben können sie angeben. | ContainerConfiguration- |
| dataDisks | Diese Eigenschaft muss angegeben werden, wenn die Computeknoten im Pool über leere Datenträger verfügen müssen, die an sie angefügt sind. | DataDisk-[] |
| diskEncryptionConfiguration | Wenn angegeben, wird die Verschlüsselung für jeden Knoten im Pool während der Knotenbereitstellung ausgeführt. | DiskEncryptionConfiguration |
| Erweiterungen | Wenn angegeben, werden die in dieser Konfiguration genannten Erweiterungen auf jedem Knoten installiert. | VMExtension-[] |
| imageReference | Ein Verweis auf ein Azure Virtual Machines Marketplace-Image oder die Azure Image-Ressource eines benutzerdefinierten virtuellen Computers. Informationen zum Abrufen der Liste aller imageReferences, die von Azure Batch überprüft wurden, finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". | ImageReference- (erforderlich) |
| licenseType | Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollte nur verwendet werden, wenn Sie gültige lokale Lizenzen für die Knoten halten, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Werte sind: Windows_Server – Die lokale Lizenz gilt für Windows Server. Windows_Client – Die lokale Lizenz ist für Windows Client. |
Schnur |
| nodeAgentSkuId | Der Batchknoten-Agent ist ein Programm, das auf jedem Knoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Knoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Knoten-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Knoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Knoten-Agent-SKUs sowie deren Liste der überprüften Bildverweise finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs". | Zeichenfolge (erforderlich) |
| nodePlacementConfiguration | Diese Konfiguration gibt Regeln für die physische Zuordnung von Knoten im Pool an. | NodePlacementConfiguration- |
| osDisk | Enthält die Konfiguration für kurzlebige OSDisk-Einstellungen. | OSDisk- |
| securityProfile | Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers an. | SecurityProfile- |
| serviceArtifactReference | Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} | ServiceArtifactReference |
| windowsConfiguration | Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. | WindowsConfiguration- |
VMExtension
| Name | Beschreibung | Wert |
|---|---|---|
| autoUpgradeMinorVersion | Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist. | Bool |
| enableAutomaticUpgrade | Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. | Bool |
| Name | Der Name der Erweiterung des virtuellen Computers. | Zeichenfolge (erforderlich) |
| protectedSettings | Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. | jegliche |
| provisionAfterExtensions | Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss. | string[] |
| Verlag | Der Name des Herausgebers des Erweiterungshandlers. | Zeichenfolge (erforderlich) |
| Einstellungen | JSON-formatierte öffentliche Einstellungen für die Erweiterung. | jegliche |
| Art | Der Typ der Erweiterungen. | Zeichenfolge (erforderlich) |
| typeHandlerVersion | Die Version des Skripthandlers. | Schnur |
WindowsConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| enableAutomaticUpdates | Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true". | Bool |
WindowsUserConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| loginMode | Gibt den Anmeldemodus für den Benutzer an. Der Standardwert für VirtualMachineConfiguration-Pools ist der interaktive Modus und für CloudServiceConfiguration-Pools der Batchmodus. | "Batch" "Interaktiv" |