functions 套件

包含封裝 Azure Machine Learning 模型以部署至Azure Functions的功能。

Azure Functions可讓您執行稱為「函式」的小型程式碼片段 () ，這些程式碼可由指定的事件觸發，例如資料變更，或在機器學習工作流程中視需要排程執行。 如需詳細資訊，請參閱Azure Functions簡介。

透過此套件中的函式，您可以從 Azure Machine Learning 工作區中註冊的模型建立Azure Functions應用程式。 每個函式都會傳 ModelPackage 回 物件，代表封裝模型及其相依性或 Dockerfile 建置內容的 Docker 映射。

如需使用機器學習Azure Functions的範例，請參閱教學課程：使用 Python 和 TensorFlow 在Azure Functions中套用機器學習模型和教學課程：使用 PyTorch 將預先定型的影像分類模型部署至Azure Functions。

函式

package

以 Docker 映射或 Dockerfile 建置內容的形式建立模型套件。

此函式會建立模型封裝，以用於具有指定 trigger 類型的Azure Functions。 此套件中的其他函式，為特定觸發程式類型建立模型套件。 如需詳細資訊，請參閱Azure Functions觸發程式和系結。

package(workspace, models, inference_config, generate_dockerfile=False, functions_enabled=False, trigger=None, **kwargs)

參數

名稱	Description
workspace 必要	Workspace 要在其中建立封裝的工作區。
models 必要	list[Model] 要包含在封裝中的 Model 物件清單。 可以是空的清單。
inference_config 必要	InferenceConfig 用來設定模型作業的 InferenceConfig 物件。 這必須包含 Environment 物件。
generate_dockerfile	bool 是否要建立可在本機執行的 Dockerfile，而不是建置映射。 預設值: False
functions_enabled	bool 是否應該在封裝的容器中啟用Azure Functions。 預設值: False
trigger	str 函式的選擇性觸發程式。 這些值可以是 「blob」、「HTTP」 或 「service_bus_queue」。 預設值: None
kwargs 必要	此課程模組中定義之特定封裝函式的任何引數。 例如，針對 方法，傳遞的 package_http 引數為 auth_level 。

傳回

類型	Description
ModelPackage	ModelPackage 物件。

例外狀況

類型	Description
WebserviceException	指定的觸發程式無效。

package_blob

使用 Blob 觸發程式，建立Azure Functions模型套件作為 Docker 映射或 Dockerfile 建置內容。

package_blob(workspace, models, inference_config, generate_dockerfile=False, input_path=None, output_path=None)

參數

名稱	Description
workspace 必要	Workspace 要在其中建立封裝的工作區。
models 必要	list[Model] 要包含在封裝中的 Model 物件清單。 可以是空的清單。
inference_config 必要	InferenceConfig 用來設定模型作業的 InferenceConfig 物件。 這必須包含 Environment 物件。
generate_dockerfile	bool 是否要建立可在本機執行的 Dockerfile，而不是建置映射。 預設值: False
input_path	str Blob 觸發程式選項的輸入路徑。 預設值: None
output_path	str Blob 觸發程式的輸出路徑。 預設值: None

傳回

類型	Description
ModelPackage	ModelPackage 物件。

例外狀況

類型	Description
WebserviceException	指定的觸發程式無效。

package_http

使用 HTTP 觸發程式，建立Azure Functions模型套件作為 Docker 映射或 Dockerfile 建置內容。

package_http(workspace, models, inference_config, generate_dockerfile=False, auth_level=None)

參數

名稱	Description
workspace 必要	Workspace 要在其中建立封裝的工作區。
models 必要	list[Model] 要包含在封裝中的 Model 物件清單。 可以是空的清單。
inference_config 必要	InferenceConfig 用來設定模型作業的 InferenceConfig 物件。 這必須包含 Environment 物件。
generate_dockerfile	bool 是否要建立可在本機執行的 Dockerfile，而不是建置映射。 預設值: False
auth_level	str 產生的 HTTP 函式的驗證層級。 預設值: None

傳回

類型	Description
ModelPackage	ModelPackage 物件。

例外狀況

類型	Description
WebserviceException	指定的觸發程式無效。

package_service_bus_queue

使用服務匯流排佇列觸發程式，建立Azure Functions模型套件作為 Docker 映射或 Dockerfile。

package_service_bus_queue(workspace, models, inference_config, generate_dockerfile=False, input_queue_name=None, output_queue_name=None)

參數

名稱	Description
workspace 必要	Workspace 要在其中建立封裝的工作區。
models 必要	list[Model] 要包含在封裝中的 Model 物件清單。 可以是空的清單。
inference_config 必要	InferenceConfig 用來設定模型作業的 InferenceConfig 物件。 這必須包含 Environment 物件。
generate_dockerfile	bool 是否要建立可在本機執行的 Dockerfile，而不是建置映射。 預設值: False
input_queue_name	str 佇列觸發程式選項的輸入佇列名稱。 預設值: None
output_queue_name	str 佇列觸發程式選項的輸出佇列名稱。 預設值: None

傳回

類型	Description
ModelPackage	ModelPackage 物件。

例外狀況

類型	Description
WebserviceException	指定的觸發程式無效。