az batch pool autoscale

管理 Batch 集區的自動調整。

命令

名稱	Description	類型	狀態
az batch pool autoscale disable	停用集區的自動調整。	核心	GA
az batch pool autoscale enable	啟用集區的自動調整。	核心	GA
az batch pool autoscale evaluate	取得評估集區上自動調整公式的結果。	核心	GA

az batch pool autoscale disable

停用集區的自動調整。

az batch pool autoscale disable --pool-id
                                [--account-endpoint]
                                [--account-key]
                                [--account-name]

必要參數

--pool-id

要停用自動調整的集區標識碼。 必須的。

選擇性參數

--account-endpoint

Batch 服務端點。 或者，由環境變數設定：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帳戶金鑰。 或者，由環境變數設定：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帳戶名稱。 或者，由環境變數設定：AZURE_BATCH_ACCOUNT。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

az batch pool autoscale enable

啟用集區的自動調整。

如果集區上的重設大小作業正在進行中，您無法在集區上啟用自動調整。 如果集區目前已停用自動調整，您必須在要求中指定有效的自動調整公式。 如果已經啟用集區自動調整，您可以指定新的自動調整公式和/或新的評估間隔。 您無法每隔 30 秒多次針對相同的集區呼叫此 API。

az batch pool autoscale enable --pool-id
                               [--account-endpoint]
                               [--account-key]
                               [--account-name]
                               [--auto-scale-evaluation-interval]
                               [--auto-scale-formula]
                               [--if-match]
                               [--if-modified-since]
                               [--if-none-match]
                               [--if-unmodified-since]

必要參數

--pool-id

要取得的集區標識碼。 必須的。

選擇性參數

--account-endpoint

Batch 服務端點。 或者，由環境變數設定：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帳戶金鑰。 或者，由環境變數設定：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帳戶名稱。 或者，由環境變數設定：AZURE_BATCH_ACCOUNT。

--auto-scale-evaluation-interval

根據自動調整公式自動調整集區大小的時間間隔。 預設值為15分鐘。 最小值和最大值分別為 5 分鐘和 168 小時。 如果您指定的值小於 5 分鐘或大於 168 小時，Batch 服務會拒絕要求，且屬性值錯誤無效;如果您直接呼叫 REST API，則 HTTP 狀態代碼為 400 （不正確的要求）。 如果您指定新的間隔，則會停止現有的自動調整評估排程，並啟動新的自動調整評估排程，其開始時間是發出此要求的時間。

--auto-scale-formula

集區中所需計算節點數目的公式。 公式在套用至集區之前，會先檢查其有效性。 如果公式無效，Batch 服務會以詳細的錯誤資訊拒絕要求。 如需指定此公式的詳細資訊，請參閱在 Azure Batch 集區中自動調整計算節點（https://learn.microsoft.com/azure/batch/batch-automatic-scaling）。

--if-match

與用戶端已知的資源版本相關聯的ETag值。 只有在服務上的資源目前的 ETag 完全符合用戶端指定的值時，才會執行此作業。

--if-modified-since

時間戳，指出用戶端已知的資源上次修改時間。 只有在服務上的資源自指定時間以來已修改時，才會執行此作業。

--if-none-match

與用戶端已知的資源版本相關聯的ETag值。 只有在服務的目前 ETag 不符合用戶端指定的值時，才會執行作業。

--if-unmodified-since

時間戳，指出用戶端已知的資源上次修改時間。 只有在服務上的資源自指定時間以來已修改時，才會執行此作業。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

az batch pool autoscale evaluate

取得評估集區上自動調整公式的結果。

此 API 主要是為了驗證自動調整公式，因為它只會傳回結果，而不需要將公式套用至集區。 集區必須啟用自動調整，才能評估公式。

az batch pool autoscale evaluate --pool-id
                                 [--account-endpoint]
                                 [--account-key]
                                 [--account-name]
                                 [--auto-scale-formula]
                                 [--json-file]

必要參數

--pool-id

要評估自動調整公式的集區標識碼。 必須的。

選擇性參數

--account-endpoint

Batch 服務端點。 或者，由環境變數設定：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帳戶金鑰。 或者，由環境變數設定：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帳戶名稱。 或者，由環境變數設定：AZURE_BATCH_ACCOUNT。

--auto-scale-formula

集區中所需計算節點數目的公式。 公式會經過驗證並計算其結果，但不會套用至集區。 若要將公式套用至集區，「在集區上啟用自動調整」。 如需指定此公式的詳細資訊，請參閱在 Azure Batch 集區中自動調整計算節點（https://azure.microsoft.com/en-us/documentation/articles/batch-automatic-scaling）。 必須的。

--json-file

包含 JSON 內容規格的檔案（格式化為符合個別 REST API 主體）。 如果指定此參數，則會忽略所有 『Content Arguments』。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。