functions パッケージ

Azure Functions にデプロイする Azure Machine Learning モデルをパッケージ化する機能が含まれています。

Azure Functions では、指定したイベント (データの変更など) や、機械学習のワークフローでしばしば必要になるスケジュールでトリガーされる小さなコード ("関数") を実行できます。 詳細については、Azure Functions の概要に関するページを参照してください。

このパッケージの関数を使用すると、Azure Machine Learning のワークスペースに登録されているモデルから Azure Functions アプリケーションを作成できます。 各関数は、モデルとその依存関係をカプセル化する Docker イメージまたは Dockerfile ビルド コンテキストを表す ModelPackage オブジェクトを返します。

機械学習に Azure Functions を使用する例については、「チュートリアル: Python および TensorFlow を使用して Azure Functions で機械学習モデルを適用する」と「チュートリアル: PyTorch を使用して事前トレーニング済みの画像分類モデルを Azure Functions にデプロイする」を参照してください。

関数

package

Docker イメージまたは Dockerfile ビルド コンテキストの形式でモデル パッケージを作成します。

この関数は、Azure Functions で使用するモデル パッケージを指定した trigger の種類で作成 します。 このパッケージの他の関数では、特定のトリガーの種類のモデル パッケージを作成します。 詳細については、Azure Functions でのトリガーとバインドについての記事をご覧ください。

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

パラメーター

名前	説明
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 です。

戻り値

型	説明
ModelPackage	ModelPackage オブジェクト。

例外

型	説明
WebserviceException	無効なトリガーが指定されました。

package_blob

BLOB トリガーを持つ Docker イメージまたは Dockerfile ビルド コンテキストとして、Azure Functions モデル パッケージを作成します。

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

パラメーター

名前	説明
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

戻り値

型	説明
ModelPackage	ModelPackage オブジェクト。

例外

型	説明
WebserviceException	無効なトリガーが指定されました。

package_http

HTTP トリガーを持つ Docker イメージまたは Dockerfile ビルド コンテキストとして、Azure Functions モデル パッケージを作成します。

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

パラメーター

名前	説明
workspace 必須	Workspace パッケージを作成するワークスペース。
models 必須	list[Model] パッケージに含める Model オブジェクトのリスト。 空のリストにすることができます。
inference_config 必須	InferenceConfig モデルの操作を構成する InferenceConfig オブジェクト。 これには Environment オブジェクトが含まれる必要があります。
generate_dockerfile	bool イメージをビルドする代わりにローカルで実行できる Dockerfile を作成するかどうか。 規定値: False
auth_level	str 生成された HTTP 関数の認証レベル。 規定値: None

戻り値

型	説明
ModelPackage	ModelPackage オブジェクト。

例外

型	説明
WebserviceException	無効なトリガーが指定されました。

package_service_bus_queue

サービス バス キュー トリガーを持つ Docker イメージまたは Dockerfile として、Azure Functions モデル パッケージを作成します。

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

パラメーター

名前	説明
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

戻り値

型	説明
ModelPackage	ModelPackage オブジェクト。

例外

型	説明
WebserviceException	無効なトリガーが指定されました。