翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SageMaker Edge Manager のデプロイ API を使用してモデルパッケージを直接デプロイする
<a name="edge-deployment-plan-api"></a>

SageMaker Edge Manager にはデプロイ API が用意されており、 AWS IoT Greengrassを利用せずにモデルをデバイスターゲットにデプロイできます。ファームウェアのアップデートまたはアプリケーションのデプロイメカニズムとは別にモデルを更新する場合に便利です。モデルの正確性を検証したら、API を使用して、エッジデプロイを CI/CD ワークフローに統合し、モデルを自動的にデプロイできます。API には便利なロールバックオプションとステージングされたロールアウトオプションも用意されており、広範囲にロールアウトする前にモデルが特定の環境で適切に機能することを確認できます。

Edge Manager の デプロイ API を使用するには、まずモデルをコンパイルしてパッケージ化します。モデルのコンパイルとパッケージの方法については、「[デプロイのためにモデルを準備する](edge-getting-started-step2.md)」を参照してください。本ガイドの以下のセクションでは、モデルをコンパイルしてパッケージ化した後、SageMaker API を使用してエッジデプロイを作成する方法を示します。

**Topics**
+ [エッジデプロイ計画を作成する](#create-edge-deployment-plan)
+ [エッジデプロイを開始する](#start-edge-deployment-stage)
+ [デプロイのステータスを確認する](#describe-edge-deployment-status)

## エッジデプロイ計画を作成する
<a name="create-edge-deployment-plan"></a>

[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateEdgeDeploymentPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateEdgeDeploymentPlan.html) API を使用してエッジデプロイ計画を作成できます。デプロイ計画は複数のステージで構成されます。エッジデバイスのサブセットにデプロイをロールアウトするように各ステージを設定できます (割合またはデバイス名で)。また、各ステージでのロールアウトの失敗の処理方法も設定できます。

次のコードスニペットは、コンパイルされパッケージ化されたモデルを 2 つの特定の Edge デバイスにデプロイするための第 1 ステージのエッジデプロイ計画を作成する方法を示しています。

```
import boto3

client = boto3.client("sagemaker")

client.create_edge_deployment_plan(
    EdgeDeploymentPlanName="edge-deployment-plan-name",
    DeviceFleetName="device-fleet-name",
    ModelConfigs=[
        {
            "EdgePackagingJobName": "edge-packaging-job-name",
            "ModelHandle": "model-handle"
        }
    ],
    Stages=[
        {
            "StageName": "stage-name",
            "DeviceSelectionConfig": {
                "DeviceSubsetType": "SELECTION",
                "DeviceNames": ["device-name-1", "device-name-2"]
            },
            "DeploymentConfig": {
                "FailureHandlingPolicy": "ROLLBACK_ON_FAILURE"
            }
        }
    ]
)
```

特定のデバイスの代わりに、フリート内の一定の割合のデバイスにデプロイする場合は、上の例で `DeviceSubsetType` の値を `"PERCENTAGE"` に設定し、`"DeviceNames": ["device-name-1", "device-name-2"]` を `"Percentage": desired-percentage` に置き換えます。

テストロールアウトが成功したことを確認した後に新しいステージのロールアウトを開始する場合は、[CreateEdgeDeploymentStage API](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateEdgeDeploymentStage.html) を使用してデプロイ計画を作成した後にステージを追加できます。デプロイステージの詳細については、「[ デプロイステージ](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeploymentStage.html)」を参照してください。

## エッジデプロイを開始する
<a name="start-edge-deployment-stage"></a>

デプロイ計画とデプロイステージを作成したら、[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_StartEdgeDeploymentStage.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_StartEdgeDeploymentStage.html) API を使用してデプロイを開始できます。

```
client.start_edge_deployment_stage(
    EdgeDeploymentPlanName="edge-deployment-plan-name",
    StageName="stage-name"
)
```

## デプロイのステータスを確認する
<a name="describe-edge-deployment-status"></a>

[DescribeEdgeDeploymentPlan](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeEdgeDeploymentPlan.html) API を使用してエッジデプロイのステータスを確認できます。

```
client.describe_edge_deployment_plan(
    EdgeDeploymentPlanName="edge-deployment-plan-name"
)
```