Microsoft.Batch batchAccounts/pools 2018-12-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@2018-12-01' = {
parent: resourceSymbolicName
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: [
{
password: 'string'
registryServer: 'string'
username: 'string'
}
]
type: 'DockerCompatible'
}
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
windowsConfiguration: {
enableAutomaticUpdates: bool
}
}
}
displayName: 'string'
interNodeCommunication: 'string'
maxTasksPerNode: int
metadata: [
{
name: 'string'
value: 'string'
}
]
networkConfiguration: {
endpointConfiguration: {
inboundNatPools: [
{
backendPort: int
frontendPortRangeEnd: int
frontendPortRangeStart: int
name: 'string'
networkSecurityGroupRules: [
{
access: 'string'
priority: int
sourceAddressPrefix: 'string'
}
]
protocol: 'string'
}
]
}
subnetId: '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: {
password: 'string'
registryServer: 'string'
username: 'string'
}
}
environmentSettings: [
{
name: 'string'
value: 'string'
}
]
maxTaskRetryCount: int
resourceFiles: [
{
autoStorageContainerName: 'string'
blobPrefix: 'string'
fileMode: 'string'
filePath: 'string'
httpUrl: 'string'
storageContainerUrl: 'string'
}
]
userIdentity: {
autoUser: {
elevationLevel: 'string'
scope: 'string'
}
userName: 'string'
}
waitForSuccess: bool
}
taskSchedulingPolicy: {
nodeFillType: 'string'
}
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 | 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' |
| Umfang | Der Standardwert ist "Task". | "Pool" "Vorgang" |
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" |
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. 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 |
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. | "DockerCompatible" (erforderlich) |
ContainerRegistry
| Name | Beschreibung | Wert |
|---|---|---|
| Passwort | Das Kennwort für die Anmeldung beim Registrierungsserver. | Zeichenfolge (erforderlich) |
| registryServer | Wenn nicht angegeben, lautet der Standardwert "docker.io". | Schnur |
| Nutzername | Der Benutzername, der sich beim Registrierungsserver anmeldet. | Zeichenfolge (erforderlich) |
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. | 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" "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 |
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 targetLowPriority-Knoten festgelegt werden. | Int |
| targetLowPriorityNodes | Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. | Int |
ImageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Image des virtuellen Computers muss sich in derselben Region und demselben Abonnement wie das Azure Batch-Konto befinden. 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: 14.04.0-LTS oder 2012-R2-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, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | 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 |
| 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 |
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 |
|---|---|---|
| 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- |
NetworkConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| endpointConfiguration | Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PoolEndpointConfiguration |
| 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. Für Pools, die über virtualMachineConfiguration erstellt werden, muss das Batchkonto über poolAllocationMode userSubscription verfügen, um ein VNet verwenden zu können. 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. 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 3500. 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) |
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. | 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 Anwendungspaketen 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 neu erstellt werden. | 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. | 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" |
| maxTasksPerNode | Die maximale Anzahl von Aufgaben, die gleichzeitig auf einem einzelnen Computeknoten im Pool ausgeführt werden können. | Int |
| Metadaten | Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. | MetadataItem-[] |
| networkConfiguration | Die Netzwerkkonfiguration für einen Pool. | NetworkConfiguration- |
| 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- |
| taskSchedulingPolicy | Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen. | TaskSchedulingPolicy- |
| 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 |
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 es sich bei der URL um Azure Blob Storage handelt, muss sie mithilfe des anonymen Zugriffs lesbar sein. d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Leseberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. | Schnur |
| storageContainerUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss mithilfe des anonymen Zugriffs lesbar und auflistenbar sein. d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Lese- und Listenberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. | 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- |
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. | 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 "false". | 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- |
TaskSchedulingPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| nodeFillType | Wie Aufgaben über Computeknoten verteilt werden sollen. | "Pack" "Spread" (erforderlich) |
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. | Zeichenfolge (erforderlich) |
| Passwort | Das Kennwort für das Benutzerkonto. | Zeichenfolge (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- |
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-[] |
| 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) |
| windowsConfiguration | Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. | WindowsConfiguration- |
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": "2018-12-01",
"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": [
{
"password": "string",
"registryServer": "string",
"username": "string"
}
],
"type": "DockerCompatible"
},
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"imageReference": {
"id": "string",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
},
"licenseType": "string",
"nodeAgentSkuId": "string",
"windowsConfiguration": {
"enableAutomaticUpdates": "bool"
}
}
},
"displayName": "string",
"interNodeCommunication": "string",
"maxTasksPerNode": "int",
"metadata": [
{
"name": "string",
"value": "string"
}
],
"networkConfiguration": {
"endpointConfiguration": {
"inboundNatPools": [
{
"backendPort": "int",
"frontendPortRangeEnd": "int",
"frontendPortRangeStart": "int",
"name": "string",
"networkSecurityGroupRules": [
{
"access": "string",
"priority": "int",
"sourceAddressPrefix": "string"
}
],
"protocol": "string"
}
]
},
"subnetId": "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": {
"password": "string",
"registryServer": "string",
"username": "string"
}
},
"environmentSettings": [
{
"name": "string",
"value": "string"
}
],
"maxTaskRetryCount": "int",
"resourceFiles": [
{
"autoStorageContainerName": "string",
"blobPrefix": "string",
"fileMode": "string",
"filePath": "string",
"httpUrl": "string",
"storageContainerUrl": "string"
}
],
"userIdentity": {
"autoUser": {
"elevationLevel": "string",
"scope": "string"
},
"userName": "string"
},
"waitForSuccess": "bool"
},
"taskSchedulingPolicy": {
"nodeFillType": "string"
},
"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 | 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' |
| Umfang | Der Standardwert ist "Task". | "Pool" "Vorgang" |
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" |
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. 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 |
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. | "DockerCompatible" (erforderlich) |
ContainerRegistry
| Name | Beschreibung | Wert |
|---|---|---|
| Passwort | Das Kennwort für die Anmeldung beim Registrierungsserver. | Zeichenfolge (erforderlich) |
| registryServer | Wenn nicht angegeben, lautet der Standardwert "docker.io". | Schnur |
| Nutzername | Der Benutzername, der sich beim Registrierungsserver anmeldet. | Zeichenfolge (erforderlich) |
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. | 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" "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 |
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 targetLowPriority-Knoten festgelegt werden. | Int |
| targetLowPriorityNodes | Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. | Int |
ImageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Image des virtuellen Computers muss sich in derselben Region und demselben Abonnement wie das Azure Batch-Konto befinden. 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: 14.04.0-LTS oder 2012-R2-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, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | 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 |
| 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 |
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 | '2018-12-01' |
| 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" |
NetworkConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| endpointConfiguration | Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PoolEndpointConfiguration |
| 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. Für Pools, die über virtualMachineConfiguration erstellt werden, muss das Batchkonto über poolAllocationMode userSubscription verfügen, um ein VNet verwenden zu können. 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. 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 3500. 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) |
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. | 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 Anwendungspaketen 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 neu erstellt werden. | 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. | 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" |
| maxTasksPerNode | Die maximale Anzahl von Aufgaben, die gleichzeitig auf einem einzelnen Computeknoten im Pool ausgeführt werden können. | Int |
| Metadaten | Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. | MetadataItem-[] |
| networkConfiguration | Die Netzwerkkonfiguration für einen Pool. | NetworkConfiguration- |
| 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- |
| taskSchedulingPolicy | Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen. | TaskSchedulingPolicy- |
| 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 |
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 es sich bei der URL um Azure Blob Storage handelt, muss sie mithilfe des anonymen Zugriffs lesbar sein. d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Leseberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. | Schnur |
| storageContainerUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss mithilfe des anonymen Zugriffs lesbar und auflistenbar sein. d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Lese- und Listenberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. | 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- |
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. | 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 "false". | 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- |
TaskSchedulingPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| nodeFillType | Wie Aufgaben über Computeknoten verteilt werden sollen. | "Pack" "Spread" (erforderlich) |
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. | Zeichenfolge (erforderlich) |
| Passwort | Das Kennwort für das Benutzerkonto. | Zeichenfolge (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- |
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-[] |
| 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) |
| windowsConfiguration | Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. | WindowsConfiguration- |
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@2018-12-01"
name = "string"
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 = [
{
password = "string"
registryServer = "string"
username = "string"
}
]
type = "DockerCompatible"
}
dataDisks = [
{
caching = "string"
diskSizeGB = int
lun = int
storageAccountType = "string"
}
]
imageReference = {
id = "string"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
}
licenseType = "string"
nodeAgentSkuId = "string"
windowsConfiguration = {
enableAutomaticUpdates = bool
}
}
}
displayName = "string"
interNodeCommunication = "string"
maxTasksPerNode = int
metadata = [
{
name = "string"
value = "string"
}
]
networkConfiguration = {
endpointConfiguration = {
inboundNatPools = [
{
backendPort = int
frontendPortRangeEnd = int
frontendPortRangeStart = int
name = "string"
networkSecurityGroupRules = [
{
access = "string"
priority = int
sourceAddressPrefix = "string"
}
]
protocol = "string"
}
]
}
subnetId = "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 = {
password = "string"
registryServer = "string"
username = "string"
}
}
environmentSettings = [
{
name = "string"
value = "string"
}
]
maxTaskRetryCount = int
resourceFiles = [
{
autoStorageContainerName = "string"
blobPrefix = "string"
fileMode = "string"
filePath = "string"
httpUrl = "string"
storageContainerUrl = "string"
}
]
userIdentity = {
autoUser = {
elevationLevel = "string"
scope = "string"
}
userName = "string"
}
waitForSuccess = bool
}
taskSchedulingPolicy = {
nodeFillType = "string"
}
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 | 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' |
| Umfang | Der Standardwert ist "Task". | "Pool" "Vorgang" |
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" |
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. 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 |
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. | "DockerCompatible" (erforderlich) |
ContainerRegistry
| Name | Beschreibung | Wert |
|---|---|---|
| Passwort | Das Kennwort für die Anmeldung beim Registrierungsserver. | Zeichenfolge (erforderlich) |
| registryServer | Wenn nicht angegeben, lautet der Standardwert "docker.io". | Schnur |
| Nutzername | Der Benutzername, der sich beim Registrierungsserver anmeldet. | Zeichenfolge (erforderlich) |
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. | 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" "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 |
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 targetLowPriority-Knoten festgelegt werden. | Int |
| targetLowPriorityNodes | Mindestens einer von targetDedicatedNodes muss targetLowPriority-Knoten festgelegt werden. | Int |
ImageReference
| Name | Beschreibung | Wert |
|---|---|---|
| id | Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus. Das Image des virtuellen Computers muss sich in derselben Region und demselben Abonnement wie das Azure Batch-Konto befinden. 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: 14.04.0-LTS oder 2012-R2-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, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl. | 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 |
| 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 |
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 |
|---|---|---|
| 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@2018-12-01" |
NetworkConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| endpointConfiguration | Die Poolendpunktkonfiguration wird nur für Pools mit der virtualMachineConfiguration-Eigenschaft unterstützt. | PoolEndpointConfiguration |
| 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. Für Pools, die über virtualMachineConfiguration erstellt werden, muss das Batchkonto über poolAllocationMode userSubscription verfügen, um ein VNet verwenden zu können. 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. 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 3500. 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) |
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. | 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 Anwendungspaketen 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 neu erstellt werden. | 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. | 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" |
| maxTasksPerNode | Die maximale Anzahl von Aufgaben, die gleichzeitig auf einem einzelnen Computeknoten im Pool ausgeführt werden können. | Int |
| Metadaten | Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. | MetadataItem-[] |
| networkConfiguration | Die Netzwerkkonfiguration für einen Pool. | NetworkConfiguration- |
| 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- |
| taskSchedulingPolicy | Gibt an, wie Aufgaben über Computeknoten verteilt werden sollen. | TaskSchedulingPolicy- |
| 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 |
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 es sich bei der URL um Azure Blob Storage handelt, muss sie mithilfe des anonymen Zugriffs lesbar sein. d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Leseberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. | Schnur |
| storageContainerUrl | Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss mithilfe des anonymen Zugriffs lesbar und auflistenbar sein. d. h. der Batchdienst stellt beim Herunterladen des Blobs keine Anmeldeinformationen bereit. Es gibt zwei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Schließen Sie eine SAS (Shared Access Signature) ein, die Lese- und Listenberechtigungen für das Blob gewährt, oder legen Sie die ACL für das Blob oder dessen Container fest, um den öffentlichen Zugriff zu ermöglichen. | 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- |
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. | 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 "false". | 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- |
TaskSchedulingPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| nodeFillType | Wie Aufgaben über Computeknoten verteilt werden sollen. | "Pack" "Spread" (erforderlich) |
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. | Zeichenfolge (erforderlich) |
| Passwort | Das Kennwort für das Benutzerkonto. | Zeichenfolge (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- |
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-[] |
| 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) |
| windowsConfiguration | Diese Eigenschaft darf nicht angegeben werden, wenn das imageReference ein Linux-Betriebssystemimage angibt. | WindowsConfiguration- |
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" |