Microsoft.Batch batchAccounts/pools 2017-09-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@2017-09-01' = {
parent: resourceSymbolicName
name: 'string'
properties: {
applicationLicenses: [
'string'
]
applicationPackages: [
{
id: 'string'
version: 'string'
}
]
certificates: [
{
id: 'string'
storeLocation: 'string'
storeName: 'string'
visibility: [
'string'
]
}
]
deploymentConfiguration: {
cloudServiceConfiguration: {
currentOSVersion: 'string'
osFamily: 'string'
targetOSVersion: 'string'
}
virtualMachineConfiguration: {
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
osDisk: {
caching: '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'
environmentSettings: [
{
name: 'string'
value: 'string'
}
]
maxTaskRetryCount: int
resourceFiles: [
{
blobSource: 'string'
fileMode: 'string'
filePath: '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'
}
]
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 | pool – gibt an, dass die Aufgabe als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Knoten in einem Pool erstellt wird. task - gibt an, dass der Dienst einen neuen Benutzer für die Aufgabe erstellen soll. 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 | Werte sind: starttask – Das Benutzerkonto, unter dem die Startaufgabe ausgeführt wird. task – Die Konten, unter denen Auftragsaufgaben ausgeführt werden. remoteuser – Die Konten, unter denen Benutzer remote auf den Knoten zugreifen. Sie können in dieser Sammlung mehr als eine Sichtbarkeit angeben. Der Standardwert ist alle Konten. |
Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'RemoteUser' "StartTask" "Vorgang" |
CloudServiceConfiguration
Name | Beschreibung | Wert |
---|---|---|
currentOSVersion | Dies kann sich von targetOSVersion unterscheiden, wenn der Poolstatus "Upgrade" lautet. In diesem Fall befinden sich einige virtuelle Computer möglicherweise auf der targetOSVersion und einige befinden sich möglicherweise während des Upgradevorgangs auf dem currentOSVersion.In this case some virtual machines may be on the targetOSVersion and some may be on the currentOSVersion during the upgrade process. Sobald alle virtuellen Computer aktualisiert wurden, wird currentOSVersion so aktualisiert, dass sie mit targetOSVersion identisch ist. | Schnur |
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) |
targetOSVersion | Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. | Schnur |
DataDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Werte sind: none – Der Cachemodus für den Datenträger ist nicht aktiviert. readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt. readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt. Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
'None' 'ReadOnly' 'ReadWrite' |
diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. | int (erforderlich) |
lun | Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. | 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) |
OSDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Der Standardwert ist keine. | 'None' 'ReadOnly' 'ReadWrite' |
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 |
---|---|---|
blobSource | Diese URL muss 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. | Zeichenfolge (erforderlich) |
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 | Der Speicherort auf dem Computeknoten, in den die Datei heruntergeladen werden soll, relativ zum Arbeitsverzeichnis der Aufgabe. | Zeichenfolge (erforderlich) |
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 |
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 |
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) |
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 |
---|---|---|
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) |
osDisk | Einstellungen für den Betriebssystemdatenträger des virtuellen Computers. | OSDisk- |
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 |
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": "2017-09-01",
"name": "string",
"properties": {
"applicationLicenses": [ "string" ],
"applicationPackages": [
{
"id": "string",
"version": "string"
}
],
"certificates": [
{
"id": "string",
"storeLocation": "string",
"storeName": "string",
"visibility": [ "string" ]
}
],
"deploymentConfiguration": {
"cloudServiceConfiguration": {
"currentOSVersion": "string",
"osFamily": "string",
"targetOSVersion": "string"
},
"virtualMachineConfiguration": {
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"imageReference": {
"id": "string",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
},
"licenseType": "string",
"nodeAgentSkuId": "string",
"osDisk": {
"caching": "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",
"environmentSettings": [
{
"name": "string",
"value": "string"
}
],
"maxTaskRetryCount": "int",
"resourceFiles": [
{
"blobSource": "string",
"fileMode": "string",
"filePath": "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"
}
],
"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 | pool – gibt an, dass die Aufgabe als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Knoten in einem Pool erstellt wird. task - gibt an, dass der Dienst einen neuen Benutzer für die Aufgabe erstellen soll. 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 | Werte sind: starttask – Das Benutzerkonto, unter dem die Startaufgabe ausgeführt wird. task – Die Konten, unter denen Auftragsaufgaben ausgeführt werden. remoteuser – Die Konten, unter denen Benutzer remote auf den Knoten zugreifen. Sie können in dieser Sammlung mehr als eine Sichtbarkeit angeben. Der Standardwert ist alle Konten. |
Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'RemoteUser' "StartTask" "Vorgang" |
CloudServiceConfiguration
Name | Beschreibung | Wert |
---|---|---|
currentOSVersion | Dies kann sich von targetOSVersion unterscheiden, wenn der Poolstatus "Upgrade" lautet. In diesem Fall befinden sich einige virtuelle Computer möglicherweise auf der targetOSVersion und einige befinden sich möglicherweise während des Upgradevorgangs auf dem currentOSVersion.In this case some virtual machines may be on the targetOSVersion and some may be on the currentOSVersion during the upgrade process. Sobald alle virtuellen Computer aktualisiert wurden, wird currentOSVersion so aktualisiert, dass sie mit targetOSVersion identisch ist. | Schnur |
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) |
targetOSVersion | Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. | Schnur |
DataDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Werte sind: none – Der Cachemodus für den Datenträger ist nicht aktiviert. readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt. readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt. Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
'None' 'ReadOnly' 'ReadWrite' |
diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. | int (erforderlich) |
lun | Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. | 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 | '2017-09-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) |
OSDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Der Standardwert ist keine. | 'None' 'ReadOnly' 'ReadWrite' |
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 |
---|---|---|
blobSource | Diese URL muss 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. | Zeichenfolge (erforderlich) |
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 | Der Speicherort auf dem Computeknoten, in den die Datei heruntergeladen werden soll, relativ zum Arbeitsverzeichnis der Aufgabe. | Zeichenfolge (erforderlich) |
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 |
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 |
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) |
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 |
---|---|---|
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) |
osDisk | Einstellungen für den Betriebssystemdatenträger des virtuellen Computers. | OSDisk- |
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 |
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@2017-09-01"
name = "string"
body = jsonencode({
properties = {
applicationLicenses = [
"string"
]
applicationPackages = [
{
id = "string"
version = "string"
}
]
certificates = [
{
id = "string"
storeLocation = "string"
storeName = "string"
visibility = [
"string"
]
}
]
deploymentConfiguration = {
cloudServiceConfiguration = {
currentOSVersion = "string"
osFamily = "string"
targetOSVersion = "string"
}
virtualMachineConfiguration = {
dataDisks = [
{
caching = "string"
diskSizeGB = int
lun = int
storageAccountType = "string"
}
]
imageReference = {
id = "string"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
}
licenseType = "string"
nodeAgentSkuId = "string"
osDisk = {
caching = "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"
environmentSettings = [
{
name = "string"
value = "string"
}
]
maxTaskRetryCount = int
resourceFiles = [
{
blobSource = "string"
fileMode = "string"
filePath = "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"
}
]
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 | pool – gibt an, dass die Aufgabe als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Knoten in einem Pool erstellt wird. task - gibt an, dass der Dienst einen neuen Benutzer für die Aufgabe erstellen soll. 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 | Werte sind: starttask – Das Benutzerkonto, unter dem die Startaufgabe ausgeführt wird. task – Die Konten, unter denen Auftragsaufgaben ausgeführt werden. remoteuser – Die Konten, unter denen Benutzer remote auf den Knoten zugreifen. Sie können in dieser Sammlung mehr als eine Sichtbarkeit angeben. Der Standardwert ist alle Konten. |
Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'RemoteUser' "StartTask" "Vorgang" |
CloudServiceConfiguration
Name | Beschreibung | Wert |
---|---|---|
currentOSVersion | Dies kann sich von targetOSVersion unterscheiden, wenn der Poolstatus "Upgrade" lautet. In diesem Fall befinden sich einige virtuelle Computer möglicherweise auf der targetOSVersion und einige befinden sich möglicherweise während des Upgradevorgangs auf dem currentOSVersion.In this case some virtual machines may be on the targetOSVersion and some may be on the currentOSVersion during the upgrade process. Sobald alle virtuellen Computer aktualisiert wurden, wird currentOSVersion so aktualisiert, dass sie mit targetOSVersion identisch ist. | Schnur |
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) |
targetOSVersion | Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an. | Schnur |
DataDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Werte sind: none – Der Cachemodus für den Datenträger ist nicht aktiviert. readOnly – Der Cachemodus für den Datenträger ist schreibgeschützt. readWrite – Der Cachemodus für den Datenträger ist lese- und schreibgeschützt. Der Standardwert für die Zwischenspeicherung ist keine. Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
'None' 'ReadOnly' 'ReadWrite' |
diskSizeGB | Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Datenträgers. | int (erforderlich) |
lun | Die Lun wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn sie mehrere Datenträger anfügen, sollte jeder eine unterschiedliche Lun aufweisen. | 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@2017-09-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) |
OSDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Der Standardwert ist keine. | 'None' 'ReadOnly' 'ReadWrite' |
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 |
---|---|---|
blobSource | Diese URL muss 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. | Zeichenfolge (erforderlich) |
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 | Der Speicherort auf dem Computeknoten, in den die Datei heruntergeladen werden soll, relativ zum Arbeitsverzeichnis der Aufgabe. | Zeichenfolge (erforderlich) |
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 |
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 |
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) |
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 |
---|---|---|
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) |
osDisk | Einstellungen für den Betriebssystemdatenträger des virtuellen Computers. | OSDisk- |
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 |