az batch pool
Batchpools verwalten.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az batch pool autoscale |
Verwalten der automatischen Skalierung von Batchpools. |
Kern | GA |
| az batch pool autoscale disable |
Deaktiviert die automatische Skalierung für einen Pool. |
Kern | GA |
| az batch pool autoscale enable |
Aktiviert die automatische Skalierung für einen Pool. |
Kern | GA |
| az batch pool autoscale evaluate |
Ruft das Ergebnis der Auswertung einer automatischen Skalierungsformel im Pool ab. |
Kern | GA |
| az batch pool create |
Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus der Cloud Services-Konfiguration oder der Virtuellen Computerkonfiguration aus. |
Kern | GA |
| az batch pool delete |
Löscht einen Pool aus dem angegebenen Konto. |
Kern | GA |
| az batch pool list |
Listet alle Pools im angegebenen Konto auf. |
Kern | GA |
| az batch pool node-counts |
Abrufen der Knotenanzahl für Batchpools. |
Kern | GA |
| az batch pool node-counts list |
Ruft die Anzahl der Computeknoten in jedem Zustand ab, gruppiert nach Pool. |
Kern | GA |
| az batch pool reset |
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt. |
Kern | GA |
| az batch pool resize |
Ändern der Größe oder Beenden der Größe eines Batchpools |
Kern | GA |
| az batch pool set |
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Durch das Aktualisieren einer Eigenschaft in einer Untergruppe werden die nicht angegebenen Eigenschaften dieser Gruppe zurückgesetzt. |
Kern | GA |
| az batch pool show |
Ruft Informationen zum angegebenen Pool ab. |
Kern | GA |
| az batch pool supported-images |
Abfragen von Informationen zu VM-Images, die vom Azure Batch-Dienst unterstützt werden. |
Kern | GA |
| az batch pool supported-images list |
Listet alle virtuellen Computerimages auf, die vom Azure-Batchdienst unterstützt werden. |
Kern | GA |
| az batch pool usage-metrics |
Zeigen Sie Nutzungsmetriken von Batchpools an. |
Kern | GA |
| az batch pool usage-metrics list |
Listet die Nutzungsmetriken auf, aggregiert nach Pool über einzelne Zeitintervalle für das angegebene Konto. |
Kern | GA |
az batch pool create
Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus der Cloud Services-Konfiguration oder der Virtuellen Computerkonfiguration aus.
az batch pool create [--accelerated-networking {false, true}]
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--auto-scale-formula]
[--defer-os-rolling-upgrade {false, true}]
[--disable-auto-rollback {false, true}]
[--disk-encryption-targets]
[--enable-auto-os-upgrade {false, true}]
[--enable-cross-zone-upgrade {false, true}]
[--enable-inter-node-communication]
[--enable-secure-boot {false, true}]
[--enable-vtpm {false, true}]
[--enable-write-accel {false, true}]
[--encryption-at-host {false, true}]
[--id]
[--image]
[--json-file]
[--max-batch-instance-percent]
[--max-unhealthy-instance-percent]
[--max-unhealthy-upgraded-instance-percent]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--pause-time-between-batches]
[--placement]
[--policy]
[--prioritize-unhealthy-instances {false, true}]
[--resize-timeout]
[--resource-tags]
[--rollback-failed-instances-on-policy-breach {false, true}]
[--security-type]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
[--target-communication {classic, default, simplified}]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--upgrade-policy-mode]
[--use-rolling-upgrade-policy {false, true}]
[--vm-size]Optionale Parameter
Gibt an, ob dieser Pool beschleunigte Netzwerke aktivieren soll. Das beschleunigte Netzwerk ermöglicht die einzelne E/A-Virtualisierung (SR-IOV) für einen virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview. Legen Sie "true" fest, um den Wert zu aktivieren.
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Die Liste der Pakete, die auf jedem Computeknoten im Pool installiert werden sollen. Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). # pylint: disable=line-too-long Changes to Package references affect all new Nodes joining the Pool, but do not affect Compute Nodes that are already in the Pool until they are rebooted or reimaged. Es gibt maximal 10 Paketverweise für einen bestimmten Pool. Leerzeichentrennte Anwendungs-IDs mit optionaler Version im Format "id[#version]".
Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "false" festgelegt ist. Es ist erforderlich, wenn enableAutoScale auf "true" festgelegt ist. Die Formel wird vor der Erstellung des Pools auf Gültigkeit überprüft. Wenn die Formel ungültig ist, lehnt der Batchdienst die Anforderung mit detaillierten Fehlerinformationen ab. Weitere Informationen zum Angeben dieser Formel finden Sie unter "Automatisches Skalieren von Computeknoten in einem Azure-Batchpool" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
Verzögern Sie Betriebssystemupgrades auf tvMs, wenn sie Aufgaben ausführen. True, wenn die Kennzeichnung vorhanden ist.
Gibt an, ob das Rollbackfeature des Betriebssystemimages deaktiviert werden soll. True, wenn die Kennzeichnung vorhanden ist.
Eine durch Leerzeichen getrennte Liste von DiskEncryptionTargets. aktuelle mögliche Werte sind OsDisk und TemporaryDisk.
Gibt an, ob Betriebssystemupgrades automatisch auf Skalierungssatzinstanzen angewendet werden sollen, wenn eine neuere Version des Betriebssystemimages verfügbar wird. :code:<br />:code:<br /> Wenn dies für Windows-basierte Pools auf "true" festgelegt ist, kann WindowsConfiguration.enableAutomaticUpdates <https://learn.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#windowsconfiguration>_ nicht auf "true" festgelegt werden. True, wenn die Kennzeichnung vorhanden ist.
Zulassen, dass VMSS AZ-Grenzen beim Erstellen von Upgradebatches ignoriert. Berücksichtigen Sie die Updatedomäne und maxBatchInstancePercent, um die Batchgröße zu ermitteln. Dieses Feld kann nur bei Verwendung von NodePlacementConfiguration als Zonal auf "true" oder "false" festgelegt werden. True, wenn die Kennzeichnung vorhanden ist.
Gibt an, ob der Pool die direkte Kommunikation zwischen Computeknoten zulässt. Das Aktivieren der Kommunikation zwischen Knoten begrenzt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen auf den Computeknoten des Pools. Dies kann dazu führen, dass der Pool seine gewünschte Größe nicht erreicht. Der Standardwert ist "false". True, wenn die Kennzeichnung vorhanden ist.
Aktivieren sie den sicheren Start.
Aktivieren Sie vTPM.
Geben Sie an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.
Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. Das Standardverhalten lautet: Die Verschlüsselung auf dem Host wird deaktiviert, es sei denn, diese Eigenschaft ist für die Ressource auf "true" festgelegt.
Eine Zeichenfolge, die den Pool innerhalb des Kontos eindeutig identifiziert. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie verfügen möglicherweise nicht über zwei Pool-IDs innerhalb eines Kontos, die sich nur nach Groß-/Kleinschreibung unterscheiden). Erforderlich.
Referenz zu Betriebssystemimages. Dies kann entweder das Format "publisher:offer:sku[:version]" oder eine vollqualifizierte ARM-Bild-ID des Formulars "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}" sein. Wenn das Format "publisher:offer:sku[:version]" verwendet wird, ist die Version optional und wird verwendet, wenn sie nicht angegeben wird. Gültige Werte können über "az batchpool supported-images list" abgerufen werden. Beispiel: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".
Die Datei, die die Parameterspezifikation des Pools enthält, erstellt die Parameterspezifikation in JSON(formatiert für den Textkörper der REST-API-Anforderung). Wenn dieser Parameter angegeben ist, werden alle Parameterargumente für die Poolerstellung ignoriert. Siehe https://learn.microsoft.com/rest/api/batchservice/pool/add?tabs=HTTP#request-body.
Der maximale Prozentsatz der gesamten Instanzen des virtuellen Computers, die gleichzeitig durch das rollierende Upgrade in einem Batch aktualisiert werden. Da dies ein Maximum ist, können fehlerhafte Instanzen in früheren oder zukünftigen Batches dazu führen, dass der Prozentsatz der Instanzen in einem Batch verringert wird, um eine höhere Zuverlässigkeit sicherzustellen. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.
Der maximale Prozentsatz der Instanzen des virtuellen Computers im Skalierungssatz, der gleichzeitig fehlerhaft sein kann, entweder aufgrund eines Upgrades oder durch die Integritätsprüfungen des virtuellen Computers in einem fehlerhaften Zustand gefunden wird, bevor das Rollupgrade abgebrochen wird. Diese Einschränkung wird vor dem Starten eines Batches überprüft. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.
Der maximale Prozentsatz der aktualisierten Virtuellen Computerinstanzen, die sich in einem fehlerhaften Zustand befinden. Diese Überprüfung erfolgt, nachdem jeder Batch aktualisiert wurde. Wenn dieser Prozentsatz jemals überschritten wird, wird das rollierende Update abgebrochen. Der Wert dieses Felds sollte zwischen 0 und 100 (einschließlich) liegen.
Eine Liste von Name-Wert-Paaren, die dem Pool als Metadaten zugeordnet sind. Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. Leerzeichentrennte Werte im Format "key=value".
Die SKU des Batch-Computeknoten-Agents, der auf Computeknoten im Pool bereitgestellt werden soll. Der Batch Compute Node-Agent ist ein Programm, das auf jedem Computeknoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Computeknoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Compute Node-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Computeknoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten ComputeKnoten-Agent-SKUs sowie deren Liste der überprüften Imageverweise finden Sie unter "Liste unterstützter Computeknoten-Agent-SKUs". Erforderlich.
Geben Sie die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None, ReadOnly, ReadWrite. Die Standardwerte sind: Keine für den Standardspeicher. ReadOnly für Premium-Speicher.
Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers.
Die Wartezeit zwischen Abschluss des Updates für alle virtuellen Computer in einem Batch und starten den nächsten Batch. Die Zeitdauer sollte im ISO 8601-Format angegeben werden. Das erwartete Format ist eine ISO-8601-Dauer.
Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger für alle virtuellen Computer im Pool an. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, z. B. Cachespeicherplatz für die Bereitstellung ephemerer Betriebssystemdatenträger. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter ephemeren Betriebssystemgrößenanforderungen für Windows-VMs unter https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements und Linux-VMs unter https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. "cachedisk".
Knotenplatzierungsrichtlinientyp in Batchpools. Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie. Bekannte Werte sind: "regional" und "zonal".
Aktualisieren Sie alle fehlerhaften Instanzen in einem Skalierungssatz, bevor alle fehlerfreien Instanzen auftreten. True, wenn die Kennzeichnung vorhanden ist.
Das Timeout für die Zuordnung von Computeknoten zum Pool. Dieses Timeout gilt nur für die manuelle Skalierung; es hat keine Auswirkung, wenn enableAutoScale auf "true" festgelegt ist. Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). Das erwartete Format ist eine ISO-8601-Dauer.
Der Benutzer kann Ressourcentags für den Pool angeben. Alle ressourcen, die für den Pool erstellt wurden, werden dann auch mit den gleichen Ressourcentags markiert.
Fehler bei Rollbackinstanzen beim vorherigen Modell, wenn die Richtlinie für das Rollupgrade verletzt wird. True, wenn die Kennzeichnung vorhanden ist.
Geben Sie den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. Das Standardverhalten lautet: UefiSettings wird nur aktiviert, wenn diese Eigenschaft festgelegt ist.
Die Befehlszeile des StartTask. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis "Aufgabe") verwenden oder die vom Batch bereitgestellte Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) verwenden. Erforderlich.
Eine Liste der Umgebungsvariableneinstellungen für den StartTask. Leerzeichentrennte Werte im Format "key=value".
Die maximale Anzahl der Wiederholungsversuche des Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch die Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, wird der Batchdienst den Vorgang nicht wiederholen. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung, dies wird jedoch nicht für einen Startvorgang oder einen Vorgang empfohlen. Der Standardwert ist 0 (keine Wiederholungen).
Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Es gibt eine maximale Größe für die Liste der Ressourcendateien. Wenn die maximale Größe überschritten wird, schlägt die Anforderung fehl, und der Antwortfehlercode lautet "RequestEntityTooLarge". Wenn dies der Fall ist, muss die Sammlung von ResourceFiles in der Größe reduziert werden. Dies kann mithilfe von .zip Dateien, Anwendungspaketen oder Docker-Containern erreicht werden. Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Gibt an, ob der Batchdienst warten soll, bis der StartTask erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Aufgaben auf dem Computeknoten geplant werden. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, wiederholt der Batchdienst die StartTask bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn die Aufgabe nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten nicht verwendbar und plant keine Vorgänge. Diese Bedingung kann über den Computerknotenstatus und Fehlerinformationen erkannt werden. Wenn "false" lautet, wartet der Batchdienst nicht, bis der StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während der StartTask noch ausgeführt wird. und auch wenn der StartTask fehlschlägt, werden neue Aufgaben weiterhin auf dem Computeknoten geplant. Der Standardwert ist "true". True, wenn die Kennzeichnung vorhanden ist.
Der Speicherkontotyp für verwaltete Datenträger.
Der gewünschte Knotenkommunikationsmodus für den Pool. Wenn dieses Element vorhanden ist, wird das vorhandene targetNodeCommunicationMode-Objekt ersetzt, das im Pool konfiguriert ist. Wenn keine Angabe erfolgt, bleiben vorhandene Metadaten unverändert.
Die gewünschte Anzahl dedizierter Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
Die Liste der Datenträgerziele für den Batchdienst wird auf dem Computeknoten verschlüsselt. Ohne Angabe werden keine Datenträger auf den Computeknoten im Pool verschlüsselt. Unter Linux-Pool wird nur "TemporaryDisk" unterstützt; unter Windows-Pool muss "OsDisk" und "TemporaryDisk" angegeben werden. Getrennter Speicherplatz für Zu verschlüsselnde Zieldatenträger. Werte können osDisk oder TemporaryDisk sein.
Die Anzahl der Aufgabenplätze, die zum Ausführen gleichzeitiger Aufgaben auf einem einzelnen Computeknoten im Pool verwendet werden können. Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256.
Der Modus des Poolbetriebssystemupgrades.
Gibt an, ob die Rollupgraderichtlinie während des Automatischen Betriebssystemupgrades verwendet werden soll. Das automatische Betriebssystemupgrade wird auf die Standardrichtlinie zurückfallen, wenn keine Richtlinie für vmSS definiert ist. True, wenn die Kennzeichnung vorhanden ist.
Die Größe virtueller Computer im Pool. Alle virtuellen Computer in einem Pool haben die gleiche Größe. 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). Erforderlich.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch pool delete
Löscht einen Pool aus dem angegebenen Konto.
Wenn Sie anfordern, dass ein Pool gelöscht wird, treten die folgenden Aktionen auf: Der Poolstatus ist auf das Löschen festgelegt; alle laufenden Größenänderungsvorgänge im Pool werden beendet; Der Batchdienst startet die Größenänderung des Pools auf null Computeknoten; alle Aufgaben, die auf vorhandenen Computeknoten ausgeführt werden, werden beendet und erneut abgefragt (als ob ein Vorgang zur Größenänderung mit der Standardoption für die erneute Warteschlange angefordert wurde); schließlich wird der Pool aus dem System entfernt. Da die Ausführung von Aufgaben erneut abgefragt wird, kann der Benutzer diese Aufgaben erneut ausführen, indem er seinen Auftrag auf einen anderen Pool aktualisiert. Die Aufgaben können dann im neuen Pool ausgeführt werden. Wenn Sie das Verhalten der erneuten Warteschlange außer Kraft setzen möchten, sollten Sie die Größe des Pools explizit aufrufen, um die Größe des Pools auf null zu verkleinern, bevor Sie den Pool löschen. Wenn Sie eine Update-, Patch- oder Delete-API für einen Pool im Löschzustand aufrufen, schlägt sie mit dem HTTP-Statuscode 409 mit dem Fehlercode PoolBeingDeleted fehl.
az batch pool delete --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]Erforderliche Parameter
Die ID des abzurufenden Pools. Erforderlich.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Zur Bestätigung nicht auffordern.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch pool list
Listet alle Pools im angegebenen Konto auf.
az batch pool list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
Eine OData-$filter-Klausel. Weitere Informationen zum Erstellen dieses Filters finden Sie unter https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
Eine OData-$select-Klausel.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch pool reset
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt.
az batch pool reset --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]Erforderliche Parameter
Die ID des zu aktualisierenden Pools.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batchkontos. Nur erforderlich, festgelegt nach Umgebungsvariable: AZURE_BATCH_ACCOUNT.
Erforderlich. Die Liste ersetzt alle vorhandenen Anwendungspaketverweise im Pool. Änderungen an Anwendungspaketverweise wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages aktualisiert werden. Es gibt maximal 10 Anwendungspaketverweise für einen bestimmten Pool. Wenn Sie keine leere Auflistung angeben, werden alle vorhandenen Anwendungspaketeverweise aus dem Pool entfernt. Für einen bestimmten Pool können maximal 10 Verweise angegeben werden.
Die Datei, die die Parameterspezifikation für Poolaktualisierungseigenschaften in JSON(formatiert für den Textkörper der REST-API-Anforderung) enthält. Wenn dieser Parameter angegeben ist, werden alle Parameterargumente für poolupdates ignoriert.
Erforderlich. Diese Liste ersetzt alle vorhandenen Metadaten, die im Pool konfiguriert sind. Wenn sie ausgelassen werden oder wenn Sie eineempty-Auflistung angeben, werden vorhandene Metadaten aus dem Pool entfernt.
Die Befehlszeile der Startaufgabe. 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.
Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. Leerzeichentrennte Werte im Format "key=value".
Die maximale Anzahl der Wiederholungsversuche des Vorgangs.
Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Gibt an, ob der Batchdienst warten soll, bis die Startaufgabe erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Vorgänge auf dem Computeknoten geplant werden. True, wenn die Kennzeichnung vorhanden ist, andernfalls ist "False" standardmäßig festgelegt.
Der gewünschte Knotenkommunikationsmodus für den Pool. Wenn dieses Element vorhanden ist, wird das vorhandene targetNodeCommunicationMode-Objekt ersetzt, das im Pool konfiguriert ist. Wenn keine Angabe erfolgt, bleiben vorhandene Metadaten unverändert.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch pool resize
Ändern der Größe oder Beenden der Größe eines Batchpools
az batch pool resize --pool-id
[--abort]
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
[--resize-timeout]
[--target-dedicated-nodes]
[--target-low-priority-nodes]Erforderliche Parameter
Die ID des Pools.
Optionale Parameter
Beenden Sie den Vorgang zum Ändern der Größe des Pools.
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batchkontos. Nur erforderlich, festgelegt nach Umgebungsvariable: AZURE_BATCH_ACCOUNT.
Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource exakt mit dem angegebenen Wert übereinstimmt.
Der Vorgang wird nur ausgeführt, wenn die Ressource seit dem angegebenen Zeitstempel geändert wurde.
Der Vorgang wird nicht nur ausgeführt, wenn das aktuelle ETag der Ressource exakt mit dem angegebenen Wert übereinstimmt.
Der Vorgang wird nicht nur ausgeführt, wenn die Ressource seit dem angegebenen Zeitstempel geändert wurde.
Wenn Knoten möglicherweise aus dem Pool entfernt werden, wenn die Poolgröße abnimmt.
Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). ISO-8601-Dauerformat.
Die gewünschte Anzahl dedizierter Computeknoten im Pool.
Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch pool set
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Durch das Aktualisieren einer Eigenschaft in einer Untergruppe werden die nicht angegebenen Eigenschaften dieser Gruppe zurückgesetzt.
az batch pool set --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]Erforderliche Parameter
Die ID des abzurufenden Pools. Erforderlich.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Eine Liste der Pakete, die auf jedem Computeknoten im Pool installiert werden sollen. Änderungen an Paketverweise wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt wurden. Wenn dieses Element vorhanden ist, werden alle vorhandenen Paketverweise ersetzt. Wenn Sie eine leere Auflistung angeben, werden alle Paketverweise aus dem Pool entfernt. Ohne Angabe bleiben vorhandene Paketverweise unverändert. Leerzeichentrennte Anwendungs-IDs mit optionaler Version im Format "id[#version]".
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Eine Datei, die die Poolspezifikation in JSON enthält (formatiert mit dem jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle 'Poolargumente' ignoriert.
Eine Liste von Name-Wert-Paaren, die dem Pool als Metadaten zugeordnet sind. Wenn dieses Element vorhanden ist, ersetzt es vorhandene Metadaten, die im Pool konfiguriert sind. Wenn Sie eine leere Auflistung angeben, werden alle Metadaten aus dem Pool entfernt. Wenn keine Angabe erfolgt, bleiben vorhandene Metadaten unverändert. Leerzeichentrennte Werte im Format "key=value".
Die Befehlszeile des StartTask. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis "Aufgabe") verwenden oder die vom Batch bereitgestellte Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) verwenden. Erforderlich.
Eine Liste der Umgebungsvariableneinstellungen für den StartTask. Leerzeichentrennte Werte im Format "key=value".
Die maximale Anzahl der Wiederholungsversuche des Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Wiederholungen steuert. Der Batchdienst versucht die Aufgabe einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch die Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, wird der Batchdienst den Vorgang nicht wiederholen. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung, dies wird jedoch nicht für einen Startvorgang oder einen Vorgang empfohlen. Der Standardwert ist 0 (keine Wiederholungen).
Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Es gibt eine maximale Größe für die Liste der Ressourcendateien. Wenn die maximale Größe überschritten wird, schlägt die Anforderung fehl, und der Antwortfehlercode lautet "RequestEntityTooLarge". Wenn dies der Fall ist, muss die Sammlung von ResourceFiles in der Größe reduziert werden. Dies kann mithilfe von .zip Dateien, Anwendungspaketen oder Docker-Containern erreicht werden. Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Gibt an, ob der Batchdienst warten soll, bis der StartTask erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Aufgaben auf dem Computeknoten geplant werden. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, wiederholt der Batchdienst die StartTask bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn die Aufgabe nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten nicht verwendbar und plant keine Vorgänge. Diese Bedingung kann über den Computerknotenstatus und Fehlerinformationen erkannt werden. Wenn "false" lautet, wartet der Batchdienst nicht, bis der StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während der StartTask noch ausgeführt wird. und auch wenn der StartTask fehlschlägt, werden neue Aufgaben weiterhin auf dem Computeknoten geplant. Der Standardwert ist "true". True, wenn die Kennzeichnung vorhanden ist.
Der gewünschte Knotenkommunikationsmodus für den Pool. Wenn dieses Element vorhanden ist, wird das vorhandene targetNodeCommunicationMode-Objekt ersetzt, das im Pool konfiguriert ist. Wenn keine Angabe erfolgt, bleiben vorhandene Metadaten unverändert.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch pool show
Ruft Informationen zum angegebenen Pool ab.
az batch pool show --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]Erforderliche Parameter
Die ID des abzurufenden Pools. Erforderlich.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Eine OData-$select-Klausel.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
