az ml schedule

注意

此參考是 Azure CLI 的 ml 延伸模組的一部分(2.15.0 版或更高版本)。 擴充功能會在您第一次執行 az ml schedule 命令時自動安裝。 深入了解擴充功能。

管理 Azure ML 排程資源。

Azure ML 排程會定義如何定期觸發作業,讓定型模型保持在最新狀態、定期執行和下載推斷結果,以及許多其他案例,您可以使用 cron 表達式和週期來定義觸發程式模式。

命令

名稱 Description 類型 狀態
az ml schedule create

建立排程。

副檔名 GA
az ml schedule delete

刪除排程。 將不會刪除先前觸發的作業。

副檔名 GA
az ml schedule disable

停用排程,使其停止觸發作業。

副檔名 GA
az ml schedule enable

啟用排程,讓它繼續觸發作業。

副檔名 GA
az ml schedule list

列出工作區中的排程。

副檔名 GA
az ml schedule show

顯示排程的詳細數據。

副檔名 GA
az ml schedule trigger

觸發排程一次。

副檔名 GA
az ml schedule update

更新排程。

副檔名 GA

az ml schedule create

建立排程。

az ml schedule create --file
                      --resource-group
                      [--name]
                      [--no-wait]
                      [--set]
                      [--workspace-name]

範例

從 YAML 規格檔案建立排程

az ml schedule create --file schedule.yml --resource-group my-resource-group --workspace-name my-workspace

必要參數

--file -f

包含 Azure ML 排程規格之 YAML 檔案的本機路徑。 如需排程的 YAML 參考檔,請參閱: https://aka.ms/ml-cli-v2-schedule-yaml-reference

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--name -n

排程的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--set

指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

全域參數
--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 ml schedule delete

刪除排程。 將不會刪除先前觸發的作業。

az ml schedule delete --name
                      --resource-group
                      --workspace-name
                      [--no-wait]

必要參數

--name -n

排程的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
全域參數
--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 ml schedule disable

停用排程,使其停止觸發作業。

az ml schedule disable --name
                       --resource-group
                       --workspace-name
                       [--no-wait]

必要參數

--name -n

排程的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
全域參數
--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 ml schedule enable

啟用排程,讓它繼續觸發作業。

az ml schedule enable --name
                      --resource-group
                      --workspace-name
                      [--no-wait]

必要參數

--name -n

排程的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
全域參數
--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 ml schedule list

列出工作區中的排程。

az ml schedule list --resource-group
                    [--disabled-only]
                    [--include-disabled]
                    [--max-results]
                    [--workspace-name]

範例

使用 --query 自變數列出工作區中的所有排程,以在命令結果上執行 JMESPath 查詢。

az ml schedule list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--disabled-only

僅列出停用的排程。

預設值: False
--include-disabled

列出已停用的排程和已啟用的排程。

預設值: False
--max-results -r

要傳回的結果數目上限。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

全域參數
--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 ml schedule show

顯示排程的詳細數據。

az ml schedule show --name
                    --resource-group
                    [--workspace-name]

範例

顯示排程的詳細數據

az ml schedule show --name my-schedule --resource-group my-resource-group --workspace-name my-workspace

必要參數

--name -n

排程的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

全域參數
--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 ml schedule trigger

觸發排程一次。

az ml schedule trigger --name
                       --resource-group
                       --workspace-name

範例

觸發排程一次。

az ml schedule trigger --name my-schedule --resource-group my-resource-group --workspace-name my-workspace

必要參數

--name -n

排程的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

全域參數
--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 ml schedule update

更新排程。

az ml schedule update --name
                      --resource-group
                      --workspace-name
                      [--add]
                      [--force-string]
                      [--no-wait]
                      [--remove]
                      [--set]

範例

更新現有的標籤或為排程新增標籤

az ml schedule update --name my-schedule --set tags.key1=value1 tags.key2=value2 --resource-group my-resource-group --workspace-name my-workspace

必要參數

--name -n

排程的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>

選擇性參數

--add

藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value, string or JSON string>

預設值: []
--force-string

使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。

預設值: False
--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--remove

從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove>--remove propertyToRemove

預設值: []
--set

指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=<value>

預設值: []
全域參數
--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 來取得完整偵錯記錄。