

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

# Neptune ML モデル変換 API
<a name="data-api-dp-ml-transform"></a>

**モデル変換アクション:**
+ [StartMLModelTransformJob (アクション)](#StartMLModelTransformJob)
+ [ListMLModelTransformJobs (アクション)](#ListMLModelTransformJobs)
+ [GetMLModelTransformJob (アクション)](#GetMLModelTransformJob)
+ [CancelMLModelTransformJob (アクション)](#CancelMLModelTransformJob)

**モデル変換構造:**
+ [CustomModelTransformParameters (構造)](#CustomModelTransformParameters)

## StartMLModelTransformJob (アクション)
<a name="StartMLModelTransformJob"></a>

         この API の AWS CLI 名は `start-ml-model-transform-job` です。

新しいモデル変換ジョブを作成します。「[トレーニング済みモデルを使用して新しいモデルアーティファクトを生成する](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)」を参照してください。

IAM 認証が有効になっている Neptune クラスターでこの操作を呼び出すときには、リクエストを行う IAM ユーザーまたはロールに、そのクラスターで [neptune-db:StartMLModelTransformJob](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#startmlmodeltransformjob) IAM アクションを許可するポリシーがアタッチされている必要があります。

**[リクエスト**]
+ **baseProcessingInstanceType** (CLI では: `--base-processing-instance-type`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  ML モデルのトレーニングの準備と管理に使用される ML インスタンスのタイプ。これは、トレーニングデータとモデルの処理に必要なメモリに基づいて選択された ML コンピューティングインスタンスです。
+ **baseProcessingInstanceVolumeSizeInGB** (CLI では: `--base-processing-instance-volume-size-in-gb`) — タイプ `integer` の整数 (符号付き 32 ビット整数)。

  トレーニングインスタンスのディスクボリュームサイズ (ギガバイト単位)。デフォルトは 0 です。入力データと出力モデルの両方がディスクに保存されるため、ボリュームサイズは両方のデータセットを保持するのに十分な大きさでなければなりません。指定しなかった場合、または 0 の場合、Neptune ML はデータ処理ステップで生成された推奨に基づいてディスクボリュームサイズを選択します。
+ **customModelTransformParameters** (CLI では: `--custom-model-transform-parameters`) — [CustomModelTransformParameters](#CustomModelTransformParameters) オブジェクト。

  カスタムモデルを使用したモデル変換の構成情報。`customModelTransformParameters` オブジェクトには次のフィールドが含まれています。これらのフィールドには、トレーニングジョブの保存されたモデルパラメーターと互換性のある値が必要です。
+ **dataProcessingJobId** (CLI では: `--data-processing-job-id`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  完了したデータ処理ジョブのジョブ ID。`dataProcessingJobId` と `mlModelTrainingJobId` のいずれか、または `trainingJobName` を含める必要があります。
+ **id** (CLI では: `--id`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  新しいジョブの一意識別子。デフォルト値は、自動生成された UUID です。
+ **mlModelTrainingJobId** (CLI では: `--ml-model-training-job-id`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  完了したモデルトレーニングジョブのジョブ ID。`dataProcessingJobId` と `mlModelTrainingJobId` のいずれか、または `trainingJobName` を含める必要があります。
+ **modelTransformOutputS3Location** (CLI では: `--model-transform-output-s3-location`) — *必須:* `string` タイプの文字列 (UTF-8 でエンコードされた文字列)。

  モデルアーティファクトが保存される Amazon S3 内の場所。
+ **neptuneIamRoleArn** (CLI では: `--neptune-iam-role-arn`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  SageMaker および Amazon S3 リソースへの Neptune アクセスを提供する IAM ロールの ARN。これは DB クラスターパラメータグループに一覧表示されている必要があります。そうでない場合はエラーが発生します。
+ **s3OutputEncryptionKMSKey** (CLI では: `--s-3-output-encryption-kms-key`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  SageMaker が処理ジョブの出力を暗号化するために使用する Amazon キー管理サービス (KMS) キー。デフォルトは none です。
+ **sagemakerIamRoleArn** (CLI では: `--sagemaker-iam-role-arn`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  SageMaker 実行のための IAM ロールの ARN。これは DB クラスターパラメータグループに一覧表示されている必要があり、そうでない場合はエラーが発生します。
+ **securityGroupIds** (CLI では: `--security-group-ids`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  VPC セキュリティグループ ID。デフォルトは [なし] です。
+ **subnets** (CLI では: `--subnets`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  Neptune VPC 内のサブネットの ID。デフォルトは [なし] です。
+ **trainingJobName** (CLI では: `--training-job-name`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  完了した SageMaker トレーニングジョブの名前。`dataProcessingJobId` と `mlModelTrainingJobId` のいずれか、または `trainingJobName` を含める必要があります。
+ **volumeEncryptionKMSKey** (CLI では: `--volume-encryption-kms-key`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  トレーニングジョブを実行する ML コンピューティングインスタンスにアタッチされたストレージボリュームのデータを暗号化するために SageMaker が使用する Amazon キー管理サービス (KMS) キー。デフォルトは [なし] です。

**レスポンス**
+ **arn** — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  モデル変換ジョブの ARN。
+ **creationTimeInMillis** — `long` 型の長整数(符号付き 64 ビット整数)。

  モデル変換ジョブの作成時間 (ミリ秒単位)。
+ **id** — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  新しいモデル変換ジョブの一意 ID。

**エラー**
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)

## ListMLModelTransformJobs (アクション)
<a name="ListMLModelTransformJobs"></a>

         この API の AWS CLI 名は `list-ml-model-transform-jobs` です。

モデル変換ジョブ ID のリストを返します。「[トレーニング済みモデルを使用して新しいモデルアーティファクトを生成する](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)」を参照してください。

IAM 認証が有効になっている Neptune クラスターでこの操作を呼び出すときには、リクエストを行う IAM ユーザーまたはロールに、そのクラスターで [neptune-db:ListMLModelTransformJobs](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#listmlmodeltransformjobs) IAM アクションを許可するポリシーがアタッチされている必要があります。

**[リクエスト**]
+ **maxItems** (CLI では: `--max-items`) — ListMLModelTransformJobsInputMaxItemsInteger、タイプ `integer` (符号付き 32 ビット整数)、1 以上か 1024 以上？ st? s。

  返される項目の最大数 (1 ～ 1024、デフォルトは 10)。
+ **neptuneIamRoleArn** (CLI では: `--neptune-iam-role-arn`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  SageMaker および Amazon S3 リソースへの Neptune アクセスを提供する IAM ロールの ARN。これは DB クラスターパラメータグループに一覧表示されている必要があり、そうでない場合はエラーが発生します。

**レスポンス**
+ **ids** — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  モデル変換 ID のリストにあるページ。

**エラー**
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)

## GetMLModelTransformJob (アクション)
<a name="GetMLModelTransformJob"></a>

         この API の AWS CLI 名は `get-ml-model-transform-job` です。

指定されたモデル変換ジョブに関する情報を取得します。「[トレーニング済みモデルを使用して新しいモデルアーティファクトを生成する](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)」を参照してください。

IAM 認証が有効になっている Neptune クラスターでこの操作を呼び出すときには、リクエストを行う IAM ユーザーまたはロールに、そのクラスターで [neptune-db:GetMLModelTransformJobStatus](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getmlmodeltransformjobstatus) IAM アクションを許可するポリシーがアタッチされている必要があります。

**[リクエスト**]
+ **id** (CLI では: `--id`) — *必須:* `string` タイプの文字列 (UTF-8 でエンコードされた文字列)。

  取得されるモデル変換ジョブの一意識別子。
+ **neptuneIamRoleArn** (CLI では: `--neptune-iam-role-arn`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  SageMaker および Amazon S3 リソースへの Neptune アクセスを提供する IAM ロールの ARN。これは DB クラスターパラメータグループに一覧表示されている必要があり、そうでない場合はエラーが発生します。

**レスポンス**
+ **baseProcessingJob** – [MlResourceDefinition](data-api-dp-ml-data-processing.md#MlResourceDefinition) オブジェクト。

  基本データ処理ジョブ。
+ **id** — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  取得されるモデル変換ジョブの一意識別子。
+ **models** – [MlConfigDefinition](data-api-dp-ml-data-processing.md#MlConfigDefinition) オブジェクトの配列。

  使用されているモデルの設定情報のリスト。
+ **remoteModelTransformJob** – [MlResourceDefinition](data-api-dp-ml-data-processing.md#MlResourceDefinition) オブジェクト。

  リモートモデル変換ジョブ。
+ **status** — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  モデル変換ジョブのステータス。

**エラー**
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)

## CancelMLModelTransformJob (アクション)
<a name="CancelMLModelTransformJob"></a>

         この API の AWS CLI 名は `cancel-ml-model-transform-job` です。

指定されたモデル変換ジョブをキャンセルします。「[トレーニング済みモデルを使用して新しいモデルアーティファクトを生成する](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)」を参照してください。

IAM 認証が有効になっている Neptune クラスターでこの操作を呼び出すときには、リクエストを行う IAM ユーザーまたはロールに、そのクラスターで [neptune-db:CancelMLModelTransformJob](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#cancelmlmodeltransformjob) IAM アクションを許可するポリシーがアタッチされている必要があります。

**[リクエスト**]
+ **clean** (CLI では: `--clean`) — タイプ `boolean` のブール値 (ブール値 (真または偽) の値)。

  このフラグが `TRUE` に設定された場合、すべての Neptune ML S3 アーティファクトは、ジョブが停止したときに削除される必要があります。デフォルトは `FALSE` です。
+ **id** (CLI では: `--id`) — *必須:* `string` タイプの文字列 (UTF-8 でエンコードされた文字列)。

  キャンセルされるモデル変換ジョブの一意 ID。
+ **neptuneIamRoleArn** (CLI では: `--neptune-iam-role-arn`) — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  SageMaker および Amazon S3 リソースへの Neptune アクセスを提供する IAM ロールの ARN。これは DB クラスターパラメータグループに一覧表示されている必要があり、そうでない場合はエラーが発生します。

**レスポンス**
+ **status** — タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  キャンセルのステータス。

**エラー**
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)

## *モデル変換構造:*
<a name="data-api-dp-ml-transform-model-transform-structures-spacer"></a>

## CustomModelTransformParameters (構造)
<a name="CustomModelTransformParameters"></a>

カスタムモデル変換パラメータを含みます。「[トレーニング済みモデルを使用して新しいモデルアーティファクトを生成する](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-model-transform.html)」を参照してください。

**フィールド**
+ **sourceS3DirectoryPath** - これは *必須*です。タイプ `string` の文字列 (UTF-8 でエンコードされた文字列)。

  モデルを実装する Python モジュールがある Amazon S3 の場所へのパス。これは、少なくともトレーニングスクリプト、変換スクリプト、および `model-hpo-configuration.json` ファイルを含む有効な既存の Amazon S3 の場所を指定しなければなりません。
+ **transformEntryPointScript** — これはタイプ `string` の文字列です (UTF-8 でエンコードされた文字列)。

  モデルのデプロイに必要なモデルアーティファクトを計算するために、ハイパーパラメータ検索で最適なモデルが特定された後に実行されるスクリプトのモジュール内のエントリポイントの名前。コマンドライン引数なしで実行できるはずです。デフォルトは `transform.py` です。