機械学習 API

• TransformParameters 構造

• EvaluationMetrics 構造

• MLTransform 構造

• FindMatchesParameters 構造

• FindMatchesMetrics 構造

• ConfusionMatrix 構造

• GlueTable 構造

• TaskRun 構造

• TransformFilterCriteria 構造

• TransformSortCriteria 構造

• TaskRunFilterCriteria 構造

• TaskRunSortCriteria 構造

• TaskRunProperties 構造

• FindMatchesTaskRunProperties 構造

• ImportLabelsTaskRunProperties 構造

• ExportLabelsTaskRunProperties 構造

• LabelingSetGenerationTaskRunProperties 構造

• SchemaColumn 構造

• TransformEncryption 構造

• MLUserDataEncryption 構造

• ColumnImportance 構造

フィールド

• TransformType – 必須: UTF-8 文字列 (有効な値: FIND_MATCHES)。

  機械学習変換のタイプ。

  機械学習変換のタイプの詳細については、「機械学習変換の作成」を参照してください。

• FindMatchesParameters – FindMatchesParameters オブジェクト。

  一致検索アルゴリズムのパラメータ。

フィールド

• TransformType – 必須: UTF-8 文字列 (有効な値: FIND_MATCHES)。

  機械学習変換のタイプ。

• FindMatchesMetrics – FindMatchesMetrics オブジェクト。

  「一致の検索」アルゴリズムの評価メトリクス。

フィールド

• TransformId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  機械学習変換用に生成される一意の変換 ID。ID は一意であることが保証されており、変更されません。

• Name – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  機械学習変換のユーザー定義名。名前は一意であることが保証されておらず、いつでも変更される可能性があります。

• Description – 説明文字列、2048 バイト長以下、URI address multi-line string pattern に一致。

  機械学習変換に対する長い形式のユーザー定義による説明。説明は一意であることが保証されておらず、いつでも変更される可能性があります。

• Status – UTF-8 文字列 (有効な値: NOT_READY | READY | DELETING)。

  機械学習変換の現在のステータス。

• CreatedOn – タイムスタンプ。

  タイムスタンプ。この機械学習変換の作成日時。

• LastModifiedOn – タイムスタンプ。

  タイムスタンプ。この機械学習変換の最終変更日時。

• InputRecordTables – GlueTable オブジェクトの配列。構造体 10 個以下。

  変換で使用される AWS Glue テーブル定義のリスト。

• Parameters – TransformParameters オブジェクト。

  TransformParameters オブジェクト。パラメータを使用して機械学習変換の動作を調整 (カスタマイズ) できます。そのために、変換に学習させる要素と、さまざまなトレードオフ (適合率と再現率、精度とコストなど) の選好を指定します。

• EvaluationMetrics – EvaluationMetrics オブジェクト。

  EvaluationMetrics オブジェクト。評価メトリクスは、機械学習変換の品質を推定します。

• LabelCount – 数値 (整数)。

  この変換のために AWS Glue で生成されるラベリングファイルのカウント識別子。より適切な変換を作成する場合、ラベリングファイルのダウンロード、ラベル付け、アップロードを繰り返すことができます。

• Schema – SchemaColumn オブジェクトの配列。構造体 100 個以下。

  この変換の実行対象となる列とデータ型を表すキーバリューペアのマップ。100 列が上限です。

• Role – UTF-8 文字列。

  必要なアクセス許可を持つ IAM ロールの Amazon リソースネーム (ARN) の名前。必要なアクセス許可には、AWS Glue リソースに対する AWS Glue サービスロールのアクセス許可と、変換に必要な Amazon S3 アクセス許可の両方が含まれます。

  • このロールには、AWS Glue のリソースへのアクセスを許可する AWS Glue サービスロールのアクセス許可が必要です。「Attach a Policy to IAM Users That Access AWS Glue」を参照してください。

  • このロールは、この変換のタスク実行で使用される Amazon Simple Storage Service (Amazon S3) のソース、ターゲット、一時ディレクトリ、スクリプト、およびライブラリへのアクセス許可を必要とします。

• GlueVersion – UTF-8 文字列、1～255 バイト長、Custom string pattern #20 に一致。

  この値により、この機械学習変換と互換性がある AWS Glue のバージョンが決定します。ほとんどのお客様に、Glue 1.0 が推奨されます。値が設定されていない場合、Glue の互換性はデフォルトで Glue 0.9 に設定されます。詳細については、デベロッパーガイドの「AWS Glue Versions」を参照してください。

• MaxCapacity – 数値 (double)。

  この変換のタスク実行に割り当てられる AWS Glue データ処理ユニット (DPU) の数。DPU は、2～100 の範囲で割り当てることができます。デフォルトは 10 です。DPU は処理能力を相対的に測定するもので、4 個の vCPU のコンピューティング性能と 16 GB のメモリで構成されています。詳細については、「AWS Glue 料金表ページ」を参照してください。

  MaxCapacity は、 NumberOfWorkers と WorkerType との相互排他的なオプションです 。

  • NumberOfWorkers または WorkerType のいずれかが設定されている場合、 MaxCapacity は設定できません。

  • MaxCapacity が設定されている場合、NumberOfWorkers または WorkerType は設定できません。

  • WorkerType が設定されている場合、NumberOfWorkers は必須です（逆も同様です）。

  • MaxCapacity と NumberOfWorkers は両方とも少なくとも 1 である必要があります。

  WorkerType フィールドを Standard 以外の値に設定すると、MaxCapacity フィールドが自動的に設定され、読み取り専用になります。

• WorkerType – UTF-8 文字列 (有効な値: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  この変換のタスク実行時に割り当てられる事前定義済みワーカーのタイプ。使用できる値は、Standard、G.1X、または G.2X です。

  • Standard ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、50 GB のディスク、ワーカーあたり 2 個のエグゼキュターを提供します。

  • G.1X ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、64 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

  • G.2X ワーカータイプでは、各ワーカーは 8 vCPU、32 GB のメモリ、128 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

  MaxCapacity は、 NumberOfWorkers と WorkerType との相互排他的なオプションです 。

  • NumberOfWorkers または WorkerType のいずれかが設定されている場合、 MaxCapacity は設定できません。

  • MaxCapacity が設定されている場合、NumberOfWorkers または WorkerType は設定できません。

  • WorkerType が設定されている場合、NumberOfWorkers は必須です（逆も同様です）。

  • MaxCapacity と NumberOfWorkers は両方とも少なくとも 1 である必要があります。

• NumberOfWorkers – 数値 (整数)。

  変換のタスク実行時に割り当てられる定義済み workerType のワーカー数。

  WorkerType が設定されている場合、NumberOfWorkers は必須です（逆も同様です）。

• Timeout - 数値 (整数)。1 以上。

  機械学習変換のタイムアウト (分単位)。

• MaxRetries – 数値 (整数)。

  機械学習変換の MLTaskRun が失敗した後の最大再試行回数。

• TransformEncryption – TransformEncryption オブジェクト。

  ユーザーデータへのアクセスに適用される変換の、保管時の暗号化設定。機械学習の変換では、KMS を使用して Amazon S3 で暗号化されたユーザーデータにアクセスできます。

フィールド

• PrimaryKeyColumnName – UTF-8 文字列。1～1024 バイト長。Single-line string pattern に一致。

  ソーステーブルの行を一意に識別する列の名前。一致するレコードを識別するために使用します。

• PrecisionRecallTradeoff – 数値 (double)。1.0 以下。

  変換を調整して適合率と再現率のバランスを取るときに選択する値。値 0.5 は指定なし、値 1.0 は純粋な適合率寄りとなり、値 0.0 は再現率寄りであることを意味します。これはトレードオフの関係にあるため、1.0 に近い値を選択すると、再現率が非常に低くなります。0.0 に近い値を選択すると、適合率が非常に低くなります。

  適合率メトリクスは、モデルが一致を推定して、その推定が正確である度合いを示します。

  再現率メトリクスは、実際の一致件数に対して、モデルが一致を推定した件数を示します。

• AccuracyCostTradeoff – 数値 (double)。1.0 以下。

  変換を調整して精度とコストのバランスを取るときに選択する値。値 0.5 は、システムが精度とコスト懸念のバランスを取っていることを意味します。値 1.0 は完全な精度を意味し、通常、コストが高くなります。著しく高くなる場合もあります。値 0.0 は、完全なコスト優先を意味し、FindMatches 変換の精度が低くなります。精度が許容できないレベルになる場合もあります。

  精度は、変換が真陽性と真陰性を正確に検索する度合いを測定します。精度を高めるには、マシンリソースとコストを増やす必要があります。ただし、再現率も高くなります。

  コストは、変換を実行するために消費されるコンピューティングリソースの数およびそれに伴う金額を測定します。

• EnforceProvidedLabels – ブール。

  ユーザーから指定されたラベルに出力を一致させるためにオン/オフを切り替える値。値が True の場合、find matches 変換は指定されたラベルに出力を一致させます。この結果は通常の合成結果より優先されます。値が False の場合、 find matches 変換は、すべての指定されたラベルを優先するとは限らず、結果はトレーニングされたモデルに依存します。

  この値を true に設定すると、合成の実行時間が長くなる場合があります。

フィールド

• AreaUnderPRCurve – 数値 (double)。1.0 以下。

  適合率/再現率曲線の下の部分の面積 (AUPRC) は、変換の品質全体を測定するための単一の数値です。適合率と再現率のために行われた選択とは関係ありません。値が高いほど、適合率と再現率のトレードオフが適切であることを示します。

  詳細については、Wikipedia の「 適合率と再現率」を参照してください。

• Precision – 数値 (double)。1.0 以下。

  適合率メトリクスは、変換が一致を推定したときに、その推定が正しい度合いを示します。具体的には、真陽性の総数に対して、変換が実際に検索した真陽性の割合を測定します。

  詳細については、Wikipedia の「 適合率と再現率」を参照してください。

• Recall – 数値 (double)。1.0 以下。

  再現率メトリクスは、実際の一致件数に対して、変換が推定した一致件数の割合です。具体的には、ソースデータのレコード総数に対して、変換が検索した真陽性の件数の割合です。

  詳細については、Wikipedia の「 適合率と再現率」を参照してください。

• F1 – 数値 (double)。1.0 以下。

  最大の F1 メトリクスは、変換の精度 (1～0) を示します。値 1 は最適な精度です。

  詳細については、Wikipedia の「F1 スコア」を参照してください。

• ConfusionMatrix – ConfusionMatrix オブジェクト。

  混同行列は、変換が何を正確に推定しているか、どのような種類のエラーを犯しているかを示します。

  詳細については、Wikipedia の「混同行列」を参照してください。

• ColumnImportances – ColumnImportance オブジェクトの配列。構造体 100 個以下。

  重要度の降順でソートされている列重要度メトリクスを含む ColumnImportance 構造のリスト。

フィールド

• NumTruePositives – 数値 (long 型)。

  変換の混同行列において、変換が正確に検索したデータ内の一致の数。

• NumFalsePositives – 数値 (long 型)。

  変換の混同行列において、変換が間違って一致として分類したデータ内の不一致の数。

• NumTrueNegatives – 数値 (long 型)。

  変換の混同行列において、変換が正しく拒否したデータ内の不一致の数。

• NumFalseNegatives – 数値 (long 型)。

  変換の混同行列において、変換が検索しなかったデータ内の一致の数。

フィールド

• DatabaseName – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  AWS Glue Data Catalog のデータベース名。

• TableName – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  AWS Glue Data Catalog のテーブル名。

• CatalogId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  AWS Glue Data Catalog 用の一意の識別子。

• ConnectionName – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  AWS Glue Data Catalog への接続の名前。

• AdditionalOptions – キーと値のペアのマップ配列。1～10 個のペア。

  各キーは UTF-8 文字列、1～255 バイト長で、Single-line string pattern に一致します。

  各値は説明文字列であり、2048 バイト長以下で、URI address multi-line string pattern に一致します。

  テーブルの追加オプション。現在、次の 2 つのキーがサポートされています。

  • pushDownPredicate: データセットのすべてのファイルを一覧表示して読み込むことなく、パーティションをフィルタリングするためのキー。

  • catalogPartitionPredicate: AWS Glue Data Catalog のパーティションインデックスを使用して、サーバー側のパーティションプルーニングを使用するためのキー。

フィールド

• TransformId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  変換に対する一意の識別子。

• TaskRunId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  このタスク実行に対する一意の識別子。

• Status – UTF-8 文字列 (有効な値: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  リクエストされたタスク実行の現在のステータス。

• LogGroupName – UTF-8 文字列。

  このタスク実行に関連付けられている、安全なログ記録用のロググループの名前。

• Properties – TaskRunProperties オブジェクト。

  このタスク実行に関連付けられている設定プロパティを指定します。

• ErrorString – UTF-8 文字列。

  このタスク実行に関連付けられているエラー文字列のリスト。

• StartedOn – タイムスタンプ。

  このタスク実行の開始日時。

• LastModifiedOn – タイムスタンプ。

  リクエストされたタスク実行の最終更新日時。

• CompletedOn – タイムスタンプ。

  リクエストされたタスク実行の最終完了日時。

• ExecutionTime – 数値 (整数)。

  タスク実行でリソースを消費した時間 (秒)。

フィールド

• Name – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  機械学習変換のフィルタリングに使用する一意の変換名。

• TransformType – UTF-8 文字列 (有効な値: FIND_MATCHES)。

  機械学習変換のフィルタリングに使用する機械学習変換のタイプ。

• Status – UTF-8 文字列 (有効な値: NOT_READY | READY | DELETING)。

  変換の直近の既知のステータスを使用して機械学習変換のリストをフィルタリングします (変換が使用可能かどうかを示します)。有効な値は「NOT_READY」、「READY」、または「DELETING」です。

• GlueVersion – UTF-8 文字列、1～255 バイト長、Custom string pattern #20 に一致。

  この値により、この機械学習変換と互換性がある AWS Glue のバージョンが決定します。ほとんどのお客様に、Glue 1.0 が推奨されます。値が設定されていない場合、Glue の互換性はデフォルトで Glue 0.9 に設定されます。詳細については、デベロッパーガイドの「AWS Glue Versions」を参照してください。

• CreatedBefore – タイムスタンプ。

  この日時より前に作成された変換をフィルタリングします。

• CreatedAfter – タイムスタンプ。

  この日時より後に作成された変換をフィルタリングします。

• LastModifiedBefore – タイムスタンプ。

  この日付より前に最終変更された変換をフィルタリングします。

• LastModifiedAfter – タイムスタンプ。

  この日付より後に最終更新された変換をフィルタリングします。

• Schema – SchemaColumn オブジェクトの配列。構造体 100 個以下。

  特定のスキーマを持つデータセットをフィルタリングします。Map<Column, Type> オブジェクトは、この変換で使用できるスキーマを表すキーと値のペアの配列です。Column は列名、Type はデータ型 (整数や文字列など) です。100 列が上限です。

フィールド

• Column – 必須: UTF-8 文字列 (有効な値: NAME | TRANSFORM_TYPE | STATUS | CREATED | LAST_MODIFIED)。

  機械学習変換に関連付けられている並べ替え基準で使用する列。

• SortDirection – 必須: UTF-8 文字列 (有効な値: DESCENDING | ASCENDING)。

  機械学習変換に関連付けられている並べ替え基準で使用する並べ替え方向。

フィールド

• TaskRunType – UTF-8 文字列 (有効な値: EVALUATION | LABELING_SET_GENERATION | IMPORT_LABELS | EXPORT_LABELS | FIND_MATCHES)。

  タスク実行のタイプ。

• Status – UTF-8 文字列 (有効な値: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  タスク実行の現在のステータス。

• StartedBefore – タイムスタンプ。

  この日付より前に開始されたタスク実行をフィルタリングします。

• StartedAfter – タイムスタンプ。

  この日付より後に開始されたタスク実行をフィルタリングします。

フィールド

• Column – 必須: UTF-8 文字列 (有効な値: TASK_RUN_TYPE | STATUS | STARTED)。

  機械学習変換のタスク実行リストを並べ替えるために使用する列。

• SortDirection – 必須: UTF-8 文字列 (有効な値: DESCENDING | ASCENDING)。

  機械学習変換のタスク実行リストを並べ替えるために使用する並べ替え方向。

フィールド

• TaskType – UTF-8 文字列 (有効な値: EVALUATION | LABELING_SET_GENERATION | IMPORT_LABELS | EXPORT_LABELS | FIND_MATCHES)。

  タスク実行のタイプ。

• ImportLabelsTaskRunProperties – ImportLabelsTaskRunProperties オブジェクト。

  「ラベルのインポート」タスク実行の設定プロパティ。

• ExportLabelsTaskRunProperties – ExportLabelsTaskRunProperties オブジェクト。

  「ラベルのエクスポート」タスク実行の設定プロパティ。

• LabelingSetGenerationTaskRunProperties – LabelingSetGenerationTaskRunProperties オブジェクト。

  「ラベリングセットの生成」タスク実行の設定プロパティ。

• FindMatchesTaskRunProperties – FindMatchesTaskRunProperties オブジェクト。

  「一致検索」タスク実行の設定プロパティ。

フィールド

• JobId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  「一致検索」タスク実行のジョブ ID。

• JobName – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  「一致検索」タスク実行のジョブに割り当てられた名前。

• JobRunId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  「一致検索」タスク実行のジョブ実行 ID。

フィールド

• InputS3Path – UTF-8 文字列。

  ラベルをインポートする元の Amazon Simple Storage Service (Amazon S3) のパス。

• Replace – ブール。

  既存のラベルを上書きするかどうかを示します。

フィールド

• OutputS3Path – UTF-8 文字列。

  ラベルをエクスポートする先の Amazon Simple Storage Service (Amazon S3) のパス。

フィールド

• OutputS3Path – UTF-8 文字列。

  ラベリングセットを生成する Amazon Simple Storage Service (Amazon S3) のパス。

フィールド

• Name – UTF-8 文字列。1～1024 バイト長。Single-line string pattern に一致。

  列の名前。

• DataType - UTF-8 文字列。131,072 バイト長以下。Single-line string pattern に一致。

  列のデータ型。

フィールド

• MlUserDataEncryption – MLUserDataEncryption オブジェクト。

  暗号化モードとお客様が用意した KMS キー ID MLUserDataEncryption を含むオブジェクト。

• TaskRunSecurityConfigurationName – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  セキュリティ構成の名前。

フィールド

• MlUserDataEncryptionMode – 必須: UTF-8 文字列 (有効な値: DISABLED | SSE-KMS="SSEKMS")。

  ユーザーデータに適用される暗号化モード。有効な値は次のとおりです。

  • DISABLED: 暗号化は無効です

  • SSEKMS: Simple Storage Service (Amazon S3) に保存されたユーザーデータに、AWS Key Management Service (SSE-KMS) によるサーバー側暗号化を使用します。

• KmsKeyId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  ユーザーが用意した KMS キーの ID。

フィールド

• ColumnName – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  列の名前。

• Importance – 数値 (double)。1.0 以下。

  列の列重要度スコア (10 進数)。

• CreateMLTransform アクション (Python: create_ml_transform)

• UpdateMLTransform アクション (Python: update_ml_transform)

• DeleteMLTransform アクション (Python: delete_ml_transform)

• GetMLTransform アクション (Python: get_ml_transform)

• GetMLTransforms アクション (Python: get_ml_transforms)

• ListMLTransforms アクション(Python: list_ml_transforms)

• StartMLEvaluationTaskRun アクション (Python: start_ml_evaluation_task_run)

• StartMLLabelingSetGenerationTaskRun アクション (Python: start_ml_labeling_set_generation_task_run)

• GetMLTaskRun アクション (Python: get_ml_task_run)

• GetMLTaskRuns アクション (Python: get_ml_task_runs)

• CancelMLTaskRun アクション (Python: cancel_ml_task_run)

• StartExportLabelsTaskRun アクション (Python: start_export_labels_task_run)

• StartImportLabelsTaskRun アクション (Python: start_import_labels_task_run)

リクエスト

• Name – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  変換の作成時に変換に付ける一意の名前。

• Description – 説明文字列、2048 バイト長以下、URI address multi-line string pattern に一致。

  定義する機械学習変換の説明。デフォルトは空の文字列です。

• InputRecordTables – 必須: GlueTable オブジェクトの配列。構造 10 個以下。

  変換で使用される AWS Glue テーブル定義のリスト。

• Parameters – 必須: TransformParameters オブジェクト。

  使用する変換タイプに固有のアルゴリズムパラメータ。条件付きで変換タイプに依存します。

• Role – 必須: UTF-8 文字列。

  必要なアクセス許可を持つ IAM ロールの Amazon リソースネーム (ARN) の名前。必要なアクセス許可には、AWS Glue リソースに対する AWS Glue サービスロールのアクセス許可と、変換に必要な Amazon S3 アクセス許可の両方が含まれます。

  • このロールには、AWS Glue のリソースへのアクセスを許可する AWS Glue サービスロールのアクセス許可が必要です。「Attach a Policy to IAM Users That Access AWS Glue」を参照してください。

  • このロールは、この変換のタスク実行で使用される Amazon Simple Storage Service (Amazon S3) のソース、ターゲット、一時ディレクトリ、スクリプト、およびライブラリへのアクセス許可を必要とします。

• GlueVersion – UTF-8 文字列、1～255 バイト長、Custom string pattern #20 に一致。

  この値により、この機械学習変換と互換性がある AWS Glue のバージョンが決定します。ほとんどのお客様に、Glue 1.0 が推奨されます。値が設定されていない場合、Glue の互換性はデフォルトで Glue 0.9 に設定されます。詳細については、デベロッパーガイドの「AWS Glue Versions」を参照してください。

• MaxCapacity – 数値 (double)。

  この変換のタスク実行に割り当てられる AWS Glue データ処理ユニット (DPU) の数。DPU は、2～100 の範囲で割り当てることができます。デフォルトは 10 です。DPU は処理能力を相対的に測定するもので、4 個の vCPU のコンピューティング性能と 16 GB のメモリで構成されています。詳細については、「AWS Glue 料金表ページ」を参照してください。

  MaxCapacity は、 NumberOfWorkers と WorkerType との相互排他的なオプションです 。

  • NumberOfWorkers または WorkerType のいずれかが設定されている場合、 MaxCapacity は設定できません。

  • MaxCapacity が設定されている場合、NumberOfWorkers または WorkerType は設定できません。

  • WorkerType が設定されている場合、NumberOfWorkers は必須です（逆も同様です）。

  • MaxCapacity と NumberOfWorkers は両方とも少なくとも 1 である必要があります。

  WorkerType フィールドを Standard 以外の値に設定すると、MaxCapacity フィールドが自動的に設定され、読み取り専用になります。

  WorkerType フィールドを Standard 以外の値に設定すると、MaxCapacity フィールドが自動的に設定され、読み取り専用になります。

• WorkerType – UTF-8 文字列 (有効な値: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  このタスクの実行時に割り当てられる事前定義済みワーカーのタイプ。使用できる値は、Standard、G.1X、または G.2X です。

  • Standard ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、50 GB のディスク、ワーカーあたり 2 個のエグゼキュターを提供します。

  • G.1X ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、64 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

  • G.2X ワーカータイプでは、各ワーカーは 8 vCPU、32 GB のメモリ、128 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

  MaxCapacity は、 NumberOfWorkers と WorkerType との相互排他的なオプションです 。

  • NumberOfWorkers または WorkerType のいずれかが設定されている場合、 MaxCapacity は設定できません。

  • MaxCapacity が設定されている場合、NumberOfWorkers または WorkerType は設定できません。

  • WorkerType が設定されている場合、NumberOfWorkers は必須です（逆も同様です）。

  • MaxCapacity と NumberOfWorkers は両方とも少なくとも 1 である必要があります。

• NumberOfWorkers – 数値 (整数)。

  このタスクの実行時に割り当てられる定義済み workerType のワーカー数。

  WorkerType が設定されている場合、NumberOfWorkers は必須です（逆も同様です）。

• Timeout - 数値 (整数)。1 以上。

  この変換のタスク実行のタイムアウト (分単位)。これは、この変換のタスク実行が終了して TIMEOUT ステータスに入るまでに、タスク実行がリソースを消費できる最大時間です。デフォルト値は 2,880 分 (48 時間) です。

• MaxRetries – 数値 (整数)。

  タスク実行の失敗後に、この変換のタスクを再試行する最大回数。

• Tags – キーと値のペアのマップ配列。50 ペア以下。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、256 バイト長以下です。

  この機械学習変換で使用するタグ。タグを使用して、機械学習変換へのアクセスを制限できます。AWS Glue のタグの詳細については、デベロッパーガイドの「AWS Tags in AWS Glue」を参照してください。

• TransformEncryption – TransformEncryption オブジェクト。

  ユーザーデータへのアクセスに適用される変換の、保管時の暗号化設定。機械学習の変換では、KMS を使用して Amazon S3 で暗号化されたユーザーデータにアクセスできます。

レスポンス

• TransformId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  変換用に生成された一意の識別子。

エラー

• AlreadyExistsException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• AccessDeniedException

• ResourceNumberLimitExceededException

• IdempotentParameterMismatchException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  変換の作成時に生成された一意の識別子。

• Name – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  変換の作成時に付けた一意の変換名。

• Description – 説明文字列、2048 バイト長以下、URI address multi-line string pattern に一致。

  変換の説明。デフォルトは空の文字列です。

• Parameters – TransformParameters オブジェクト。

  使用する変換タイプ (アルゴリズム) に固有の設定パラメータ。条件付きで変換タイプに依存します。

• Role – UTF-8 文字列。

  必要なアクセス許可を持つ IAM ロールの Amazon リソースネーム (ARN) の名前。

• GlueVersion – UTF-8 文字列、1～255 バイト長、Custom string pattern #20 に一致。

  この値により、この機械学習変換と互換性がある AWS Glue のバージョンが決定します。ほとんどのお客様に、Glue 1.0 が推奨されます。値が設定されていない場合、Glue の互換性はデフォルトで Glue 0.9 に設定されます。詳細については、デベロッパーガイドの「AWS Glue Versions」を参照してください。

• MaxCapacity – 数値 (double)。

  この変換のタスク実行に割り当てられる AWS Glue データ処理ユニット (DPU) の数。DPU は、2～100 の範囲で割り当てることができます。デフォルトは 10 です。DPU は処理能力を相対的に測定するもので、4 個の vCPU のコンピューティング性能と 16 GB のメモリで構成されています。詳細については、「AWS Glue 料金表ページ」を参照してください。

  WorkerType フィールドを Standard 以外の値に設定すると、MaxCapacity フィールドが自動的に設定され、読み取り専用になります。

• WorkerType – UTF-8 文字列 (有効な値: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  このタスクの実行時に割り当てられる事前定義済みワーカーのタイプ。使用できる値は、Standard、G.1X、または G.2X です。

  • Standard ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、50 GB のディスク、ワーカーあたり 2 個のエグゼキュターを提供します。

  • G.1X ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、64 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

  • G.2X ワーカータイプでは、各ワーカーは 8 vCPU、32 GB のメモリ、128 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

• NumberOfWorkers – 数値 (整数)。

  このタスクの実行時に割り当てられる定義済み workerType のワーカー数。

• Timeout - 数値 (整数)。1 以上。

  この変換のタスク実行のタイムアウト (分単位)。これは、この変換のタスク実行が終了して TIMEOUT ステータスに入るまでに、タスク実行がリソースを消費できる最大時間です。デフォルト値は 2,880 分 (48 時間) です。

• MaxRetries – 数値 (整数)。

  タスク実行の失敗後に、この変換のタスクを再試行する最大回数。

レスポンス

• TransformId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  更新された変換の一意の識別子。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• AccessDeniedException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  削除する変換の一意の識別子。

レスポンス

• TransformId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  削除した変換の一意の識別子。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  変換の一意の識別子。変換の作成時に生成されます。

レスポンス

• TransformId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  変換の一意の識別子。変換の作成時に生成されます。

• Name – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  変換の作成時に付けた一意の変換名。

• Description – 説明文字列、2048 バイト長以下、URI address multi-line string pattern に一致。

  変換の説明。

• Status – UTF-8 文字列 (有効な値: NOT_READY | READY | DELETING)。

  変換の直近の既知のステータス (変換が使用可能かどうかを示します)。有効な値は「NOT_READY」、「READY」、または「DELETING」です。

• CreatedOn – タイムスタンプ。

  変換の作成日時。

• LastModifiedOn – タイムスタンプ。

  変換の最終変更日時。

• InputRecordTables – GlueTable オブジェクトの配列。構造体 10 個以下。

  変換で使用される AWS Glue テーブル定義のリスト。

• Parameters – TransformParameters オブジェクト。

  使用するアルゴリズムに固有の設定パラメータ。

• EvaluationMetrics – EvaluationMetrics オブジェクト。

  最新の評価メトリクス。

• LabelCount – 数値 (整数)。

  この変換に使用できるラベルの数。

• Schema – SchemaColumn オブジェクトの配列。構造体 100 個以下。

  この変換で使用できるスキーマを表す Map<Column, Type> オブジェクト。100 列が上限です。

• Role – UTF-8 文字列。

  必要なアクセス許可を持つ IAM ロールの Amazon リソースネーム (ARN) の名前。

• GlueVersion – UTF-8 文字列、1～255 バイト長、Custom string pattern #20 に一致。

  この値により、この機械学習変換と互換性がある AWS Glue のバージョンが決定します。ほとんどのお客様に、Glue 1.0 が推奨されます。値が設定されていない場合、Glue の互換性はデフォルトで Glue 0.9 に設定されます。詳細については、デベロッパーガイドの「AWS Glue Versions」を参照してください。

• MaxCapacity – 数値 (double)。

  この変換のタスク実行に割り当てられる AWS Glue データ処理ユニット (DPU) の数。DPU は、2～100 の範囲で割り当てることができます。デフォルトは 10 です。DPU は処理能力を相対的に測定するもので、4 個の vCPU のコンピューティング性能と 16 GB のメモリで構成されています。詳細については、「AWS Glue 料金表ページ」を参照してください。

  WorkerType フィールドを Standard 以外の値に設定すると、MaxCapacity フィールドが自動的に設定され、読み取り専用になります。

• WorkerType – UTF-8 文字列 (有効な値: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

  このタスクの実行時に割り当てられる事前定義済みワーカーのタイプ。使用できる値は、Standard、G.1X、または G.2X です。

  • Standard ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、50 GB のディスク、ワーカーあたり 2 個のエグゼキュターを提供します。

  • G.1X ワーカータイプでは、各ワーカーは 4 vCPU、16 GB のメモリ、64 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

  • G.2X ワーカータイプでは、各ワーカーは 8 vCPU、32 GB のメモリ、128 GB のディスク、ワーカーあたり 1 個のエグゼキュターを提供します。

• NumberOfWorkers – 数値 (整数)。

  このタスクの実行時に割り当てられる定義済み workerType のワーカー数。

• Timeout - 数値 (整数)。1 以上。

  この変換のタスク実行のタイムアウト (分単位)。これは、この変換のタスク実行が終了して TIMEOUT ステータスに入るまでに、タスク実行がリソースを消費できる最大時間です。デフォルト値は 2,880 分 (48 時間) です。

• MaxRetries – 数値 (整数)。

  タスク実行の失敗後に、この変換のタスクを再試行する最大回数。

• TransformEncryption – TransformEncryption オブジェクト。

  ユーザーデータへのアクセスに適用される変換の、保管時の暗号化設定。機械学習の変換では、KMS を使用して Amazon S3 で暗号化されたユーザーデータにアクセスできます。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• NextToken – UTF-8 文字列。

  結果をオフセットするページ分割されたトークン。

• MaxResults – 1～1000 の数値 (整数)。

  返される結果の最大数。

• Filter – TransformFilterCriteria オブジェクト。

  フィルター変換基準。

• Sort – TransformSortCriteria オブジェクト。

  並べ替え基準。

レスポンス

• Transforms – 必須: MLTransform オブジェクトの配列。

  機械学習変換のリスト。

• NextToken – UTF-8 文字列。

  ページ分割トークン (さらに結果がある場合)。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• NextToken – UTF-8 文字列。

  継続トークン (これが継続リクエストの場合)。

• MaxResults – 1～1000 の数値 (整数)。

  返されるリストの最大サイズ。

• Filter – TransformFilterCriteria オブジェクト。

  機械学習変換のフィルタ処理に使用される TransformFilterCriteria。

• Sort – TransformSortCriteria オブジェクト。

  機械学習変換のソートに使用される TransformSortCriteria。

• Tags – キーと値のペアのマップ配列。50 ペア以下。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、256 バイト長以下です。

  これらのタグ付きリソースのみを返すように指定します。

レスポンス

• TransformIds – 必須: UTF-8 文字列の配列。

  アカウントのすべての機械学習変換、または指定したタグの付いた機械学習変換の識別子。

• NextToken – UTF-8 文字列。

  継続トークン (戻されたリストに最後に使用可能なメトリクスが含まれていない場合)。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

レスポンス

• TaskRunId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  この実行に関連付けられた一意の識別子。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ConcurrentRunsExceededException

• MLTransformNotReadyException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

• OutputS3Path – 必須: UTF-8 文字列。

  ラベリングセットを生成する Amazon Simple Storage Service (Amazon S3) のパス。

レスポンス

• TaskRunId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  このタスクに関連付けられている一意の実行識別子。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ConcurrentRunsExceededException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

• TaskRunId – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  タスク実行の一意の識別子。

レスポンス

• TransformId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  タスク実行の一意の識別子。

• TaskRunId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  この実行に関連付けられた一意の実行識別子。

• Status – UTF-8 文字列 (有効な値: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  このタスク実行のステータス。

• LogGroupName – UTF-8 文字列。

  タスク実行に関連付けられているロググループの名前。

• Properties – TaskRunProperties オブジェクト。

  タスク実行に関連付けられているプロパティのリスト。

• ErrorString – UTF-8 文字列。

  タスク実行に関連付けられているエラー文字列。

• StartedOn – タイムスタンプ。

  このタスク実行の開始日時。

• LastModifiedOn – タイムスタンプ。

  このタスク実行の最終変更日時。

• CompletedOn – タイムスタンプ。

  このタスク実行の完了日時。

• ExecutionTime – 数値 (整数)。

  タスク実行でリソースを消費した時間 (秒)。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

• NextToken – UTF-8 文字列。

  結果をページ分割するためのトークン。デフォルトは空です。

• MaxResults – 1～1000 の数値 (整数)。

  返される結果の最大数。

• Filter – TaskRunFilterCriteria オブジェクト。

  タスク実行のフィルタリング基準 (TaskRunFilterCriteria 構造)。

• Sort – TaskRunSortCriteria オブジェクト。

  タスク実行の並べ替え基準件 (TaskRunSortCriteria 構造)。

応答

• TaskRuns – TaskRun オブジェクトの配列。

  変換に関連付けられているタスク実行のリスト。

• NextToken – UTF-8 文字列。

  ページ分割トークン (さらに結果がある場合)。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

• TaskRunId – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  タスク実行に対する一意の識別子。

レスポンス

• TransformId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

• TaskRunId – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  タスク実行の一意の識別子。

• Status – UTF-8 文字列 (有効な値: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT)。

  この実行のステータス。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

• OutputS3Path – 必須: UTF-8 文字列。

  ラベルをエクスポートする先となる Simple Storage Service (Amazon S3) へのパス。

レスポンス

• TaskRunId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  タスク実行の一意の識別子。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

リクエスト

• TransformId – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  機械学習変換の一意の識別子。

• InputS3Path – 必須: UTF-8 文字列。

  ラベルをインポートする元となる Amazon Simple Storage Service (Amazon S3) へのパス。

• ReplaceAllLabels – ブール。

  既存のラベルを上書きするかどうかを示します。

レスポンス

• TaskRunId – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  タスク実行の一意の識別子。

エラー

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• InternalServiceException