時系列データのエンドポイントリクエストと応答を事前チェックする - Amazon SageMaker AI

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

時系列データのエンドポイントリクエストと応答を事前チェックする

モデルを SageMaker AI リアルタイム推論エンドポイントにデプロイし、エンドポイントにリクエストを送信することをお勧めします。リクエストと応答を手動で調べ、この両方が「時系列データのエンドポイントリクエスト」セクションと「時系列データのエンドポイント応答」セクションの要件に準拠していることを確認します。モデルコンテナがバッチリクエストをサポートしている場合は、単一のレコードリクエストから始めて、その後複数のレコードを試すことができます。

次のコマンドは、 AWS CLIを使用して応答をリクエストする方法を示しています。 AWS CLI は Studio および SageMaker Notebook インスタンスにプリインストールされています。をインストールするには AWS CLI、インストールガイドに従います。

aws sagemaker-runtime invoke-endpoint \ --endpoint-name $ENDPOINT_NAME \ --content-type $CONTENT_TYPE \ --accept $ACCEPT_TYPE \ --body $REQUEST_DATA \ $CLI_BINARY_FORMAT \ /dev/stderr 1>/dev/null

パラメータの定義は次のとおりです。

  • $ENDPOINT NAME — エンドポイントの名前

  • $CONTENT_TYPE — リクエストの MIME タイプ (モデルコンテナ入力)

  • $ACCEPT_TYPE — レスポンスの MIME タイプ (モデルコンテナ出力)

  • $REQUEST_DATA — リクエストされたペイロード文字列

  • $CLI_BINARY_FORMAT — コマンドラインインターフェイス (CLI) のパラメータの形式 v1 AWS CLI の場合、このパラメータは空白のままにする必要があります。v2 では、このパラメータは --cli-binary-format raw-in-base64-out に設定する必要があります。

注記

AWS CLI v2 は、デフォルトでバイナリパラメータを base64 でエンコードされた文字列として渡します。エンドポイントとの間で送受信される次のリクエストとレスポンスの例では、v1 AWS CLI を使用します。

Example 1

次のサンプルコードでは、リクエストが単一のレコードで構成されています。

aws sagemaker-runtime invoke-endpoint \ --endpoint-name test-endpoint-json \ --content-type application/json \ --accept application/json \ --body '{"target": [1, 2, 3, 4, 5], "start": "2024-01-01 01:00:00"}' \ /dev/stderr 1>/dev/null

次のスニペットは、対応する応答出力を示しています。

{'predictions': {'mean': [1, 2, 3, 4, 5]}
Example 2

次のサンプルコードでは、リクエストに 2 つのレコードが含まれています。

aws sagemaker-runtime invoke-endpoint \ --endpoint-name test-endpoint-json-2 \ --content-type application/json \ --accept application/json \ --body $'{"instances": [{"target":[1, 2, 3], "start":"2024-01-01 01:00:00", "dynamic_feat":[[1, 2, 3, 4, 5], [1, 2, 3, 4, 5]]}], {"target":[1, 2, 3], "start":"2024-01-02 01:00:00", "dynamic_feat":[[1, 2, 3, 4, 5], [1, 2, 3, 4, 5]]}]}' \ dev/stderr 1>/dev/null

応答出力は、次のとおりです。

{'predictions': [{'mean': [1, 2, 3, 4, 5]}, {'mean': [1, 2, 3, 4, 5]}]}