AksServiceDeploymentConfiguration 類別

代表部署在 Azure Kubernetes Service 上之服務的部署組態資訊。

使用 deploy_configuration 類別的 AksWebservice 方法建立 AksServiceDeploymentConfiguration 物件。

初始化組態物件，以部署至 AKS 計算目標。

建構函式

AksServiceDeploymentConfiguration(autoscale_enabled, autoscale_min_replicas, autoscale_max_replicas, autoscale_refresh_seconds, autoscale_target_utilization, collect_model_data, auth_enabled, cpu_cores, memory_gb, enable_app_insights, scoring_timeout_ms, replica_max_concurrent_requests, max_request_wait_time, num_replicas, primary_key, secondary_key, tags, properties, description, gpu_cores, period_seconds, initial_delay_seconds, timeout_seconds, success_threshold, failure_threshold, namespace, token_auth_enabled, compute_target_name, cpu_cores_limit, memory_gb_limit, blobfuse_enabled=None)

參數

名稱	Description
cpu_cores_limit 必要	此 Webservice 允許使用此 Web 服務的最大 CPU 核心數目。 可以是十進位。
memory_gb_limit 必要	允許此 Web 服務使用的記憶體數量上限（以 GB 為單位）。 可以是十進位。
autoscale_enabled 必要	bool 指出是否要啟用此 Web 服務的自動調整。 如果 num_replicas 為 None，則預設為 True。
autoscale_min_replicas 必要	int 自動調整此 Web 服務時要使用的容器數目下限。 預設值為 1。
autoscale_max_replicas 必要	int 自動調整此 Web 服務時要使用的容器數目上限。 預設值為 10
autoscale_refresh_seconds 必要	int 自動調整程式應該嘗試調整此 Web 服務的頻率。 預設值為 1。
autoscale_target_utilization 必要	int 自動調整程式應嘗試針對此 Webservice 維護目標使用率（以百分之 100 的百分比為單位）。 預設值為 70。
collect_model_data 必要	bool 是否要啟用此 Webservice 的模型數據收集。 預設為 False。
auth_enabled 必要	bool 是否要啟用此 Web 服務的驗證。 預設值為 True。
cpu_cores 必要	float 要配置給此 Webservice 的 CPU 核心數目。 可以是十進位。 預設值為 0.1
memory_gb 必要	float 要配置給此 Webservice 的記憶體數量（以 GB 為單位）。 可以是十進位。 預設值為 0.5
enable_app_insights 必要	bool 是否要啟用此 Web 服務的 Application Insights 記錄。 預設為 False
scoring_timeout_ms 必要	int 要強制對這個 Webservice 進行評分呼叫的逾時。 預設值為 60000。
replica_max_concurrent_requests 必要	int 每個復本允許此 Webservice 的最大並行要求數目。 預設值為 1。 除非Microsoft技術支援或 Azure Machine Learning 小組的成員指示，否則請勿從預設值 1 變更此設定。
max_request_wait_time 必要	int 要求在傳回 503 錯誤之前，要求在佇列中停留的時間上限（以毫秒為單位）。 預設值為 500。
num_replicas 必要	int 要配置給這個 Webservice 的容器數目。 沒有預設值，如果未設定此參數，則預設會啟用自動調整程式。
primary_key 必要	str 要用於此 Webservice 的主要驗證金鑰。
secondary_key 必要	str 要用於此 Webservice 的次要驗證金鑰。
tags 必要	dict[str, str] 索引鍵值標記的字典，以提供這個 Webservice。
properties 必要	dict[str, str] 要提供此 Webservice 的索引鍵值屬性字典。 部署之後就無法變更這些屬性，但是可以新增新的索引鍵值組。
description 必要	str 提供此 Webservice 的描述。
gpu_cores 必要	int 要配置給此 Webservice 的 GPU 核心數目。 預設值為 0。
period_seconds 必要	int 執行活躍度探查的頻率 (以秒為單位)。 預設為10秒。 最小值為 1。
initial_delay_seconds 必要	int 在起始即時探查之前，容器啟動后的秒數。 預設值為310。
timeout_seconds 必要	int 存留時間探查逾時的秒數。預設為2秒。 最小值為 1。
success_threshold 必要	int 失敗之後，會將活躍度探查的最小連續成功次數視為成功。 預設值為 1。 最小值為 1。
failure_threshold 必要	int 當 Pod 啟動時，且活躍度探查失敗時，Kubernetes 會在放棄之前嘗試 failureThreshold 時間。 預設值為 3。 最小值為 1。
namespace 必要	str 用來部署此 Webservice 的 Kubernetes 命名空間：最多 63 個小寫英數位元 （'a'-'z'， '0'-'9'） 和連字元 （'-'） 字元。 第一個字元和最後一個字元不能是連字元。
token_auth_enabled 必要	bool 是否要啟用此 Web 服務的 Azure Active Directory 驗證。 如果啟用此功能，使用者可以使用其 Azure Active Directory 認證來擷取存取令牌，以存取此 Web 服務。 預設為 False。
cpu_cores_limit 必要	此 Webservice 允許使用此 Web 服務的最大 CPU 核心數目。 可以是十進位。
memory_gb_limit 必要	允許此 Web 服務使用的記憶體數量上限（以 GB 為單位）。 可以是十進位。
blobfuse_enabled	bool 是否要針對此 Webservice 啟用模型下載的 Blobfuse。 預設值為 True 預設值: None
autoscale_enabled 必要	bool 指出是否要啟用此 Web 服務的自動調整。 如果 num_replicas 為 None，則預設為 True。
autoscale_min_replicas 必要	int 自動調整此 Web 服務時要使用的容器數目下限。 預設值為 1。
autoscale_max_replicas 必要	int 自動調整此 Web 服務時要使用的容器數目上限。 預設值為 10
autoscale_refresh_seconds 必要	int 自動調整程式應該嘗試調整此 Web 服務的頻率。 預設值為 1。
autoscale_target_utilization 必要	int 自動調整程式應嘗試針對此 Webservice 維護目標使用率（以百分之 100 的百分比為單位）。 預設值為 70。
collect_model_data 必要	bool 是否要啟用此 Webservice 的模型數據收集。 預設為 False。
auth_enabled 必要	bool 是否要啟用此 Web 服務的驗證。 預設值為 True。
cpu_cores 必要	float 要配置給此 Webservice 的 CPU 核心數目。 可以是十進位。 預設值為 0.1
memory_gb 必要	float 要配置給此 Webservice 的記憶體數量（以 GB 為單位）。 可以是十進位。 預設值為 0.5
enable_app_insights 必要	bool 是否要啟用此 Web 服務的 Application Insights 記錄。 預設為 False
scoring_timeout_ms 必要	int 要強制對這個 Webservice 進行評分呼叫的逾時。 預設值為 60000。
replica_max_concurrent_requests 必要	int 每個復本允許此 Webservice 的最大並行要求數目。 預設值為 1。 除非Microsoft技術支援或 Azure Machine Learning 小組的成員指示，否則請勿從預設值 1 變更此設定。
max_request_wait_time 必要	int 要求在傳回 503 錯誤之前，要求在佇列中停留的時間上限（以毫秒為單位）。 預設值為 500。
num_replicas 必要	int 要配置給這個 Webservice 的容器數目。 沒有預設值，如果未設定此參數，則預設會啟用自動調整程式。
primary_key 必要	str 要用於此 Webservice 的主要驗證金鑰。
secondary_key 必要	str 要用於此 Webservice 的次要驗證金鑰。
tags 必要	dict[str, str] 索引鍵值標記的字典，以提供這個 Webservice。
properties 必要	dict[str, str] 要提供此 Webservice 的索引鍵值屬性字典。 部署之後就無法變更這些屬性，但是可以新增新的索引鍵值組。
description 必要	str 提供此 Webservice 的描述。
gpu_cores 必要	int 要配置給此 Webservice 的 GPU 核心數目。 預設值為 0。
period_seconds 必要	int 執行活躍度探查的頻率 (以秒為單位)。 預設為10秒。 最小值為 1。
initial_delay_seconds 必要	int 在起始即時探查之前，容器啟動后的秒數。 預設值為310。
timeout_seconds 必要	int 存留時間探查逾時的秒數。預設為2秒。 最小值為 1。
success_threshold 必要	int 失敗之後，會將活躍度探查的最小連續成功次數視為成功。 預設值為 1。 最小值為 1。
failure_threshold 必要	int 當 Pod 啟動時，且活躍度探查失敗時，Kubernetes 會在放棄之前嘗試 failureThreshold 時間。 預設值為 3。 最小值為 1。
namespace 必要	str 用來部署此 Webservice 的 Kubernetes 命名空間：最多 63 個小寫英數位元 （'a'-'z'， '0'-'9'） 和連字元 （'-'） 字元。 第一個字元和最後一個字元不能是連字元。
token_auth_enabled 必要	bool 是否要啟用此 Web 服務的 Azure Active Directory 驗證。 如果啟用此功能，使用者可以使用其 Azure Active Directory 認證來擷取存取令牌，以存取此 Web 服務。 預設為 False。
compute_target_name 必要	str 要部署至的計算目標名稱
cpu_cores_limit 必要	float 此 Webservice 允許使用此 Web 服務的最大 CPU 核心數目。 可以是十進位。
memory_gb_limit 必要	float 允許此 Web 服務使用的記憶體數量上限（以 GB 為單位）。 可以是十進位。
blobfuse_enabled 必要	bool 是否要針對此 Webservice 啟用模型下載的 Blobfuse。 預設值為 True

變數

名稱	Description
autoscale_enabled	bool 指出是否要啟用此 Web 服務的自動調整。 如果 num_replicas 為 None，則預設為 True。
autoscale_min_replicas	int 自動調整此 Web 服務時要使用的容器數目下限。 預設值為 1。
autoscale_max_replicas	int 自動調整此 Web 服務時要使用的容器數目上限。 預設值為 10
autoscale_refresh_seconds	int 自動調整程式應該嘗試調整此 Web 服務的頻率。 預設值為 1。
autoscale_target_utilization	int 自動調整程式應嘗試針對此 Webservice 維護目標使用率（以百分之 100 的百分比為單位）。 預設值為 70。
collect_model_data	bool 是否要啟用此 Webservice 的模型數據收集。 預設為 False。
auth_enabled	bool 是否要啟用此 Web 服務的驗證。 預設值為 True。
cpu_cores	float 要配置給此 Webservice 的 CPU 核心數目。 可以是十進位。 預設值為 0.1
memory_gb	float 要配置給此 Webservice 的記憶體數量（以 GB 為單位）。 可以是十進位。 預設值為 0.5
enable_app_insights	bool 是否要啟用此 Web 服務的 Application Insights 記錄。 預設為 False
scoring_timeout_ms	int 要強制對這個 Webservice 進行評分呼叫的逾時。 預設值為 60000。
replica_max_concurrent_requests	int 每個復本允許此 Webservice 的最大並行要求數目。 預設值為 1。 除非Microsoft技術支援或 Azure Machine Learning 小組的成員指示，否則請勿從預設值 1 變更此設定。
max_request_wait_time	int 要求在傳回 503 錯誤之前，要求在佇列中停留的時間上限（以毫秒為單位）。 預設值為 500。
num_replicas	int 要配置給這個 Webservice 的容器數目。 沒有預設值，如果未設定此參數，則預設會啟用自動調整程式。
primary_key	str 要用於此 Webservice 的主要驗證金鑰。
secondary_key	str 要用於此 Webservice 的次要驗證金鑰。
azureml.core.webservice.AksServiceDeploymentConfiguration.tags	索引鍵值標記的字典，以提供這個 Webservice。
azureml.core.webservice.AksServiceDeploymentConfiguration.properties	要提供此 Webservice 的索引鍵值屬性字典。 部署之後就無法變更這些屬性，但是可以新增新的索引鍵值組。
azureml.core.webservice.AksServiceDeploymentConfiguration.description	提供此 Webservice 的描述。
gpu_cores	int 要配置給此 Webservice 的 GPU 核心數目。 預設值為 0。
period_seconds	int 執行活躍度探查的頻率 (以秒為單位)。 預設為10秒。 最小值為 1。
initial_delay_seconds	int 在起始即時探查之前，容器啟動后的秒數。 預設值為310。
timeout_seconds	int 存留時間探查逾時的秒數。預設為2秒。 最小值為 1。
success_threshold	int 失敗之後，會將活躍度探查的最小連續成功次數視為成功。 預設值為 1。 最小值為 1。
failure_threshold	int 當 Pod 啟動時，且活躍度探查失敗時，Kubernetes 會在放棄之前嘗試 failureThreshold 時間。 預設值為 3。 最小值為 1。
azureml.core.webservice.AksServiceDeploymentConfiguration.namespace	用來部署此 Webservice 的 Kubernetes 命名空間：最多 63 個小寫英數位元 （'a'-'z'， '0'-'9'） 和連字元 （'-'） 字元。 第一個字元和最後一個字元不能是連字元。
token_auth_enabled	bool 是否要啟用此 Web 服務的 Azure Active Directory 驗證。 如果啟用此功能，使用者可以使用其 Azure Active Directory 認證來擷取存取令牌，以存取此 Web 服務。 預設為 False。

方法

print_deploy_configuration	列印部署組態。
validate_configuration	檢查指定的組態值是否有效。 如果驗證失敗，將會引發 WebserviceException。

print_deploy_configuration

列印部署組態。

print_deploy_configuration()

validate_configuration

檢查指定的組態值是否有效。

如果驗證失敗，將會引發 WebserviceException。

validate_configuration()

例外狀況

類型	Description
WebserviceException