az ml service

注意

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

管理可操作的服務。

命令

名稱	Description	類型	狀態
az ml service delete	從工作區刪除服務。	副檔名	GA
az ml service get-access-token	取得令牌以發出要求服務。	副檔名	GA
az ml service get-keys	取得針對服務發出要求的金鑰。	副檔名	GA
az ml service get-logs	取得服務的記錄。	副檔名	GA
az ml service list	列出工作區中的服務。	副檔名	GA
az ml service regen-key	重新產生服務的金鑰。	副檔名	GA
az ml service run	在工作區中執行服務。	副檔名	GA
az ml service show	在工作區中顯示服務的詳細數據。	副檔名	GA
az ml service update	更新工作區中的服務。	副檔名	GA

az ml service delete

從工作區刪除服務。

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

必要參數

--name -n

要刪除的服務名稱。

選擇性參數

--path

專案資料夾的路徑。 預設值：目前目錄。

--resource-group -g

對應至所提供工作區的資源群組。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

包含要刪除之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service get-access-token

取得令牌以發出要求服務。

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

必要參數

--name -n

服務名稱。

選擇性參數

--path

專案資料夾的路徑。 預設值：目前目錄。

--resource-group -g

對應至所提供工作區的資源群組。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

包含要顯示之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service get-keys

取得針對服務發出要求的金鑰。

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

必要參數

--name -n

服務名稱。

選擇性參數

--path

專案資料夾的路徑。 預設值：目前目錄。

--resource-group -g

對應至所提供工作區的資源群組。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

包含要顯示之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service get-logs

取得服務的記錄。

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

必要參數

--name -n

服務名稱。

選擇性參數

--init -i

取得 init 容器的記錄，而不是評分容器。

預設值: False

--num_lines -l

要從 tail 傳回的記錄行數目（預設值為 5000）。

預設值: 5000

--path

專案資料夾的路徑。 預設值：目前目錄。

--resource-group -g

對應至所提供工作區的資源群組。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

包含要顯示之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service list

列出工作區中的服務。

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

選擇性參數

--compute-type -c

如果提供，則只會顯示具有指定計算類型的服務。 （選項為 'ACI'、'AKS'）。

--image-digest

如果提供，則只會顯示具有指定影像摘要的服務。

--model-id

如果提供，則只會顯示具有指定模型標識符的服務。

--model-name

如果提供，則只會顯示具有指定模型名稱的服務。

--path

專案資料夾的路徑。 預設值：目前目錄。

--property

如果提供，則會根據提供的索引鍵/值（e.g. key或key=value）進行篩選。 您可以使用多個 --property 選項來指定多個屬性。

預設值: []

--resource-group -g

對應至所提供工作區的資源群組。

--subscription-id

指定訂用帳戶標識碼。

--tag

如果提供，則會根據提供的索引鍵/值（e.g. key或key=value）進行篩選。 您可以使用多個 --tag 選項來指定多個標籤。

預設值: []

--workspace-name -w

包含要列出之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service regen-key

重新產生服務的金鑰。

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

必要參數

--key -k

如果指定 regen，要重新產生哪一個索引鍵。 選項：主要、次要。

--name -n

服務名稱。

選擇性參數

--path

專案資料夾的路徑。 預設值：目前目錄。

--resource-group -g

對應至所提供工作區的資源群組。

--set-key -s

提供指定金鑰的驗證值。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

包含要顯示之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service run

在工作區中執行服務。

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

必要參數

--name -n

要評分的服務名稱。

選擇性參數

--input-data -d

要用於呼叫 Web 服務的數據。

--path

專案資料夾的路徑。 預設值：目前目錄。

--resource-group -g

對應至所提供工作區的資源群組。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

包含要執行之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service show

在工作區中顯示服務的詳細數據。

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

必要參數

--name -n

要顯示的 Web 服務名稱。

選擇性參數

--path

專案資料夾的路徑。 預設值：目前目錄。

--resource-group -g

對應至所提供工作區的資源群組。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

包含要顯示之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 service update

更新工作區中的服務。

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--compute-target]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--is-migration]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

必要參數

--name -n

要更新的服務名稱。

選擇性參數

--add-property

要加入的索引鍵/值屬性（e.g. key=value ）。 您可以使用多個 --add-property 選項來指定多個屬性。

預設值: []

--add-tag

要新增的索引鍵/值標記 （e.g. key=value ）。 您可以使用多個 --add-tag 選項來指定多個標籤。

預設值: []

--ae --auth-enabled

是否要啟用此 Web 服務的金鑰驗證。 預設為 False。

--ai --enable-app-insights

是否要為此 Web 服務啟用 AppInsights。 預設為 False。

--ar --autoscale-refresh-seconds

自動調整程式應該嘗試調整此 Web 服務的頻率。 預設值為 1。

--as --autoscale-enabled

是否要啟用此 Web 服務的自動調整。 如果num_replicas為 None，則預設值為 True。

--at --autoscale-target-utilization

自動調整程式應嘗試針對此 Webservice 維護目標使用率（以百分之 100 的百分比為單位）。 預設值為 70。

--autoscale-max-replicas --ma

自動調整此 Web 服務時要使用的容器數目上限。 預設值為 10。

--autoscale-min-replicas --mi

自動調整此 Web 服務時要使用的容器數目下限。 預設值為 1。

--base-image --bi

做為基底映像的自定義映像。 如果沒有提供基底映射，則會根據指定的運行時間參數來使用基底映射。

--base-image-registry --ir

包含基底映像的映像登錄。

--cc --cpu-cores

要配置給此 Webservice 的 CPU 核心數目。 可以是十進位。 預設值為 0.1。

--ccl --cpu-cores-limit

此 Webservice 允許使用此 Web 服務的最大 CPU 核心數目。 可以是十進位。

--cf --conda-file

本機檔案的路徑，其中包含要用於映像的 conda 環境定義。

--collect-model-data --md

是否要啟用此 Webservice 的模型數據收集。 預設為 False。

--compute-target

（預覽）指定已安裝 AzureML 擴充功能的計算目標，以裝載已移轉的 Kubernetes 在線端點和部署。

--cuda-version --cv

要針對需要 GPU 支援的映像安裝 CUDA 版本。 GPU 映射必須用於 Microsoft Azure 服務，例如 Azure 容器執行個體、Azure 機器學習 Compute、Azure 虛擬機器 和 Azure Kubernetes Service。 支援的版本為9.0、9.1和10.0。 如果已設定 『enable_gpu』，則預設為 『9.1』。

--dc --deploy-config-file

包含部署元數據的 JSON 檔案路徑。

--description -d

服務的描述。

--dn --dns-name-label

此 Webservice 的 DNS 名稱。

--ds --extra-docker-file-steps

本機檔案的路徑，其中包含設定映射時要執行的其他 Docker 步驟。

--ed --environment-directory

用於部署的 Azure 機器學習 環境目錄。 它與 『az ml environment scaffold』 命令中提供的目錄路徑相同。

--eg --enable-gpu

是否要在映像中啟用 GPU 支援。 GPU 映射必須用於 Microsoft Azure 服務，例如 Azure 容器執行個體、Azure 機器學習 Compute、Azure 虛擬機器 和 Azure Kubernetes Service。 預設為 False。

--entry-script --es

本機檔案的路徑，其中包含要針對服務執行的程式代碼（如果提供source_directory的相對路徑）。

--environment-name -e

用於部署的 Azure 機器學習 環境名稱。

--environment-version --ev

用於部署的現有 Azure 機器學習 環境版本。

--failure-threshold --ft

當 Pod 啟動時且即時性探查失敗時，Kubernetes 會在放棄之前先嘗試 --failure-threshold 時間。 預設值為 3。 最小值為 1。

--gb --memory-gb

要配置給此 Webservice 的記憶體數量（以 GB 為單位）。 可以是十進位。

--gbl --memory-gb-limit

允許此 Web 服務使用的記憶體數量上限（以 GB 為單位）。 可以是十進位。

--gc --gpu-cores

要配置給此 Webservice 的 GPU 核心數目。 預設為 1。

--ic --inference-config-file

包含推斷組態的 JSON 或 YAML 檔案路徑。

--id --initial-delay-seconds

在起始即時探查之前，容器啟動后的秒數。 預設值為310。

--is-migration

（預覽）是否要將 AKS Web 服務移轉至 Kubernetes 在線端點和部署。 預設為 False。

--kp --primary-key

要用於此 Webservice 的主要驗證金鑰。

--ks --secondary-key

要用於此 Webservice 的次要驗證金鑰。

--lo --location

要部署此 Webservice 的 Azure 區域。 如果未指定，則會使用工作區位置。 如需可用區域的詳細資訊，請參閱： ; https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all&products=container-instances。

--max-request-wait-time --mr

要求在傳回 503 錯誤之前，要求在佇列中停留的時間上限（以毫秒為單位）。 預設值為 500。

--model -m

要部署之模型的標識碼。 您可以使用其他 -m 自變數來指定多個模型。 模型必須先註冊。

預設值: []

--model-metadata-file -f

包含模型註冊元數據的 JSON 檔案路徑。 您可以使用多個 -f 參數來提供多個模型。

預設值: []

--no-wait

旗標不要等候異步呼叫。

--nr --num-replicas

要配置給這個 Webservice 的容器數目。 沒有預設值，如果未設定此參數，則預設會啟用自動調整程式。

--path

專案資料夾的路徑。 預設值：目前目錄。

--period-seconds --ps

執行活躍度探查的頻率（以秒為單位）。 預設為10秒。 最小值為 1。

--po --port

要公開服務 HTTP 端點的本機埠。

--remove-tag

要移除的標記索引鍵。 您可以使用多個 --remove-tag 選項來指定多個標籤。

預設值: []

--replica-max-concurrent-requests --rm

每個節點允許此 Webservice 的最大並行要求數目。 預設值為 1。

--resource-group -g

對應至所提供工作區的資源群組。

--rt --runtime

要用於映像的運行時間。 目前支持的運行時間是 'spark-py' 和 'python'spark-py|python|python-slim。

--sc --ssl-cname

如果已啟用 SSL，則為 的 cname。 僅適用於更新 ACI 服務時。

--scoring-timeout-ms --tm

要強制對這個 Webservice 進行評分呼叫的逾時。 預設值為 60000。

--sd --source-directory

包含要建立映像之所有檔案的資料夾路徑。

--se --ssl-enabled

是否要為此 Web 服務啟用 SSL。 預設為 False。

--sk --ssl-key-pem-file

如果已啟用 SSL，則需要的金鑰檔案。

--sp --ssl-cert-pem-file

如果已啟用 SSL，則需要的憑證檔案。

--st --success-threshold

在失敗之後，將即時度探查視為成功的最小連續成功。 預設值為 1。 最小值為 1。

--subscription-id

指定訂用帳戶標識碼。

--timeout-seconds --ts

存留時間探查逾時的秒數。預設為2秒。 最小值為 1。

--token-auth-enabled

是否要啟用此 Webservice 的令牌驗證。 僅適用於 AKS Web 服務。 預設為 False。

--workspace-name -w

包含要更新之服務的工作區名稱。

-v

詳細資訊旗標。

全域參數

--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 來取得完整偵錯記錄。