翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # API リファレンスこのセクションでは、Amazon Personalize API の操作に関するドキュメントを提供します。リージョンごとの Amazon Personalize のエンドポイントのリストについては、*AWS 全般のリファレンス*の「[AWS リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/personalize.html)」を参照してください。 **Topics** + [アクション](API_Operations.md) + [データ型](API_Types.md) + [共通エラー](CommonErrors.md) + [共通パラメータ](CommonParameters.md) # アクション次のアクションは、Amazon Personalize でサポートされています。 + [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) + [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) + [CreateCampaign](API_CreateCampaign.md) + [CreateDataDeletionJob](API_CreateDataDeletionJob.md) + [CreateDataset](API_CreateDataset.md) + [CreateDatasetExportJob](API_CreateDatasetExportJob.md) + [CreateDatasetGroup](API_CreateDatasetGroup.md) + [CreateDatasetImportJob](API_CreateDatasetImportJob.md) + [CreateEventTracker](API_CreateEventTracker.md) + [CreateFilter](API_CreateFilter.md) + [CreateMetricAttribution](API_CreateMetricAttribution.md) + [CreateRecommender](API_CreateRecommender.md) + [CreateSchema](API_CreateSchema.md) + [CreateSolution](API_CreateSolution.md) + [CreateSolutionVersion](API_CreateSolutionVersion.md) + [DeleteCampaign](API_DeleteCampaign.md) + [DeleteDataset](API_DeleteDataset.md) + [DeleteDatasetGroup](API_DeleteDatasetGroup.md) + [DeleteEventTracker](API_DeleteEventTracker.md) + [DeleteFilter](API_DeleteFilter.md) + [DeleteMetricAttribution](API_DeleteMetricAttribution.md) + [DeleteRecommender](API_DeleteRecommender.md) + [DeleteSchema](API_DeleteSchema.md) + [DeleteSolution](API_DeleteSolution.md) + [DescribeAlgorithm](API_DescribeAlgorithm.md) + [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) + [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) + [DescribeCampaign](API_DescribeCampaign.md) + [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) + [DescribeDataset](API_DescribeDataset.md) + [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) + [DescribeDatasetGroup](API_DescribeDatasetGroup.md) + [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) + [DescribeEventTracker](API_DescribeEventTracker.md) + [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) + [DescribeFilter](API_DescribeFilter.md) + [DescribeMetricAttribution](API_DescribeMetricAttribution.md) + [DescribeRecipe](API_DescribeRecipe.md) + [DescribeRecommender](API_DescribeRecommender.md) + [DescribeSchema](API_DescribeSchema.md) + [DescribeSolution](API_DescribeSolution.md) + [DescribeSolutionVersion](API_DescribeSolutionVersion.md) + [GetSolutionMetrics](API_GetSolutionMetrics.md) + [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) + [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) + [ListCampaigns](API_ListCampaigns.md) + [ListDataDeletionJobs](API_ListDataDeletionJobs.md) + [ListDatasetExportJobs](API_ListDatasetExportJobs.md) + [ListDatasetGroups](API_ListDatasetGroups.md) + [ListDatasetImportJobs](API_ListDatasetImportJobs.md) + [ListDatasets](API_ListDatasets.md) + [ListEventTrackers](API_ListEventTrackers.md) + [ListFilters](API_ListFilters.md) + [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) + [ListMetricAttributions](API_ListMetricAttributions.md) + [ListRecipes](API_ListRecipes.md) + [ListRecommenders](API_ListRecommenders.md) + [ListSchemas](API_ListSchemas.md) + [ListSolutions](API_ListSolutions.md) + [ListSolutionVersions](API_ListSolutionVersions.md) + [ListTagsForResource](API_ListTagsForResource.md) + [StartRecommender](API_StartRecommender.md) + [StopRecommender](API_StopRecommender.md) + [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateCampaign](API_UpdateCampaign.md) + [UpdateDataset](API_UpdateDataset.md) + [UpdateMetricAttribution](API_UpdateMetricAttribution.md) + [UpdateRecommender](API_UpdateRecommender.md) + [UpdateSolution](API_UpdateSolution.md) 次のアクションは、Amazon Personalize Events でサポートされています。 + [PutActionInteractions](API_UBS_PutActionInteractions.md) + [PutActions](API_UBS_PutActions.md) + [PutEvents](API_UBS_PutEvents.md) + [PutItems](API_UBS_PutItems.md) + [PutUsers](API_UBS_PutUsers.md) 次のアクションは、Amazon Personalize Runtime でサポートされています。 + [GetActionRecommendations](API_RS_GetActionRecommendations.md) + [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) + [GetRecommendations](API_RS_GetRecommendations.md) # Amazon Personalize 次のアクションは、Amazon Personalize でサポートされています。 + [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) + [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) + [CreateCampaign](API_CreateCampaign.md) + [CreateDataDeletionJob](API_CreateDataDeletionJob.md) + [CreateDataset](API_CreateDataset.md) + [CreateDatasetExportJob](API_CreateDatasetExportJob.md) + [CreateDatasetGroup](API_CreateDatasetGroup.md) + [CreateDatasetImportJob](API_CreateDatasetImportJob.md) + [CreateEventTracker](API_CreateEventTracker.md) + [CreateFilter](API_CreateFilter.md) + [CreateMetricAttribution](API_CreateMetricAttribution.md) + [CreateRecommender](API_CreateRecommender.md) + [CreateSchema](API_CreateSchema.md) + [CreateSolution](API_CreateSolution.md) + [CreateSolutionVersion](API_CreateSolutionVersion.md) + [DeleteCampaign](API_DeleteCampaign.md) + [DeleteDataset](API_DeleteDataset.md) + [DeleteDatasetGroup](API_DeleteDatasetGroup.md) + [DeleteEventTracker](API_DeleteEventTracker.md) + [DeleteFilter](API_DeleteFilter.md) + [DeleteMetricAttribution](API_DeleteMetricAttribution.md) + [DeleteRecommender](API_DeleteRecommender.md) + [DeleteSchema](API_DeleteSchema.md) + [DeleteSolution](API_DeleteSolution.md) + [DescribeAlgorithm](API_DescribeAlgorithm.md) + [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) + [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) + [DescribeCampaign](API_DescribeCampaign.md) + [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) + [DescribeDataset](API_DescribeDataset.md) + [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) + [DescribeDatasetGroup](API_DescribeDatasetGroup.md) + [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) + [DescribeEventTracker](API_DescribeEventTracker.md) + [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) + [DescribeFilter](API_DescribeFilter.md) + [DescribeMetricAttribution](API_DescribeMetricAttribution.md) + [DescribeRecipe](API_DescribeRecipe.md) + [DescribeRecommender](API_DescribeRecommender.md) + [DescribeSchema](API_DescribeSchema.md) + [DescribeSolution](API_DescribeSolution.md) + [DescribeSolutionVersion](API_DescribeSolutionVersion.md) + [GetSolutionMetrics](API_GetSolutionMetrics.md) + [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) + [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) + [ListCampaigns](API_ListCampaigns.md) + [ListDataDeletionJobs](API_ListDataDeletionJobs.md) + [ListDatasetExportJobs](API_ListDatasetExportJobs.md) + [ListDatasetGroups](API_ListDatasetGroups.md) + [ListDatasetImportJobs](API_ListDatasetImportJobs.md) + [ListDatasets](API_ListDatasets.md) + [ListEventTrackers](API_ListEventTrackers.md) + [ListFilters](API_ListFilters.md) + [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) + [ListMetricAttributions](API_ListMetricAttributions.md) + [ListRecipes](API_ListRecipes.md) + [ListRecommenders](API_ListRecommenders.md) + [ListSchemas](API_ListSchemas.md) + [ListSolutions](API_ListSolutions.md) + [ListSolutionVersions](API_ListSolutionVersions.md) + [ListTagsForResource](API_ListTagsForResource.md) + [StartRecommender](API_StartRecommender.md) + [StopRecommender](API_StopRecommender.md) + [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateCampaign](API_UpdateCampaign.md) + [UpdateDataset](API_UpdateDataset.md) + [UpdateMetricAttribution](API_UpdateMetricAttribution.md) + [UpdateRecommender](API_UpdateRecommender.md) + [UpdateSolution](API_UpdateSolution.md) # CreateBatchInferenceJob Amazon S3 に保存されているアイテムまたはユーザーのリストに基づいてバッチレコメンデーションを生成し、レコメンデーションを Amazon S3 バケットにエクスポートします。バッチレコメンデーションを生成するには、ソリューションバージョンの ARN と、入出力データの Amazon S3 URI を指定します。ユーザーパーソナライズ、人気アイテム、パーソナライズされたランキングソリューションの場合、バッチ推論ジョブによって入力ファイル内のユーザー ID ごとに推奨アイテムのリストが生成されます。関連アイテムソリューションの場合、ジョブによって入力ファイル内のアイテム ID ごとに推奨アイテムのリストが生成されます。詳細については、「[バッチ推論ジョブの作成](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html)」を参照してください。 Similar-Items レシピを使用する場合、Amazon Personalize はバッチレコメンデーションにわかりやすいテーマを追加できます。テーマを生成するには、ジョブのモードを `THEME_GENERATION` に設定し、入力データの項目名を含むフィールド名を指定します。テーマの生成の詳細については、「[Batch recommendations with themes from Content Generator](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html)」を参照してください。 Trending-Now レシピまたは Next-Best-Action レシピではバッチレコメンデーションを取得することはできません。 ## リクエストの構文 ``` { "batchInferenceJobConfig": { "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number } }, "batchInferenceJobMode": "string", "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ], "themeGenerationConfig": { "fieldsForThemeGeneration": { "itemName": "string" } } } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) ** バッチ推論ジョブの設定の詳細。型: [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) オブジェクト必須: いいえ ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) ** バッチ推論ジョブのモード。類似アイテムのグループを説明するテーマを生成するには、ジョブモードを `THEME_GENERATION` に設定します。テーマを生成しない場合は、デフォルトの `BATCH_INFERENCE` を使用します。テーマ付きバッチレコメンデーションを取得すると、追加コストが発生します。詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。型: 文字列有効な値：`BATCH_INFERENCE | THEME_GENERATION` 必須：いいえ ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) ** バッチ推論ジョブに適用するフィルターの ARN。フィルターの使用の詳細については、「[バッチのレコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) ** レコメンデーションのベースとなる入力ファイルの格納場所への Amazon S3 パス。入力資料は JSON 形式である必要があります。型: [BatchInferenceJobInput](API_BatchInferenceJobInput.md) オブジェクト必須: はい ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) ** 作成するバッチ推論ジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [jobOutput](#API_CreateBatchInferenceJob_RequestSyntax) ** ジョブの出力が保存される Amazon S3 バケットへのパス。型: [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) オブジェクト必須: はい ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) ** 取得するレコメンデーションの数。タイプ: 整数必須: いいえ ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) ** 入力および出力 Amazon S3 バケットに対してそれぞれ読み取りおよび書き込みを実行するための許可を持つ Amazon Identity and Access Management ロールの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: はい ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) ** バッチ推論レコメンデーションの生成に使用するソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) ** バッチ推論ジョブに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) ** テーマ生成ジョブでは、各アイテムの名前を含むアイテムデータセット内の列の名前を指定します。型: [ThemeGenerationConfig](API_ThemeGenerationConfig.md) オブジェクト必須: いいえ ## レスポンスの構文 ``` { "batchInferenceJobArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_ResponseSyntax) ** バッチ推論ジョブの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob) # CreateBatchSegmentJob バッチセグメントジョブを作成します。この操作は最大 5,000 万レコードを処理でき、入力ファイルは JSON 形式である必要があります。詳細については、「[バッチレコメンデーションとユーザーセグメントの取得](https://docs.aws.amazon.com/personalize/latest/dg/recommendations-batch.html)」を参照してください。 ## リクエストの構文 ``` { "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [filterArn](#API_CreateBatchSegmentJob_RequestSyntax) ** バッチセグメントジョブに適用するフィルターの ARN。フィルターの使用についての詳細は、「[バッチのレコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [jobInput](#API_CreateBatchSegmentJob_RequestSyntax) ** バッチセグメントジョブの生成に使用される入力データの Amazon S3 パス。型: [BatchSegmentJobInput](API_BatchSegmentJobInput.md) オブジェクト必須: はい ** [jobName](#API_CreateBatchSegmentJob_RequestSyntax) ** 作成するバッチセグメントジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [jobOutput](#API_CreateBatchSegmentJob_RequestSyntax) ** ジョブの出力が保存されるバケットの Amazon S3 パス。型: [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) オブジェクト必須: はい ** [numResults](#API_CreateBatchSegmentJob_RequestSyntax) ** 入力データの各行のバッチセグメントジョブによって生成された予測ユーザーの数。セグメントあたりのユーザーの最大数は 500 万人です。タイプ: 整数必須: いいえ ** [roleArn](#API_CreateBatchSegmentJob_RequestSyntax) ** 入力および出力 Amazon S3 バケットに対してそれぞれ読み取りおよび書き込みを実行するための許可を持つ Amazon Identity and Access Management ロールの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: はい ** [solutionVersionArn](#API_CreateBatchSegmentJob_RequestSyntax) ** バッチセグメントジョブでバッチセグメントを生成するために使用するソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [tags](#API_CreateBatchSegmentJob_RequestSyntax) ** バッチセグメントジョブに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "batchSegmentJobArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [batchSegmentJobArn](#API_CreateBatchSegmentJob_ResponseSyntax) ** バッチセグメントジョブの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchSegmentJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchSegmentJob) # CreateCampaign **重要** キャンペーンがアクティブになっている間は、キャンペーンコストが発生します。不要なコストを避けるため、完了したらキャンペーンを削除します。キャンペーンのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。ソリューションバージョンをデプロイするキャンペーンを作成します。クライアントが [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) および [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) API を呼び出すと、キャンペーンがリクエストで指定されます。 **最小プロビジョンド TPS およびオートスケーリング** **重要** `minProvisionedTPS` の値を高く設定するとコストが増加します。最初は `minProvisionedTPS` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。 Amazon Personalize のキャンペーンを作成する場合、キャンペーンの 1 秒あたりのプロビジョニングされる最小トランザクション数 (`minProvisionedTPS`) を指定できます。これは Amazon Personalize によってプロビジョニングされたキャンペーンのベースライントランザクションスループットです。キャンペーンがアクティブである間の最低請求額を設定します。トランザクションは単一の `GetRecommendations` または `GetPersonalizedRanking` リクエストです。デフォルト `minProvisionedTPS` は 1 です。 TPS が `minProvisionedTPS` を超えて増加した場合、Amazon Personalize はプロビジョンド容量を自動スケーリングしますが、`minProvisionedTPS` を下回ることはありません。容量が引き上げられている間に短時間の遅延が生じます。これにより、トランザクションの損失が生じる可能性があります。トラフィックが減少すると、容量は `minProvisionedTPS` に戻ります。プロビジョニングされた最小 TPS、またはリクエストが `minProvisionedTPS` を超える場合は実際の TPS に対して課金されます。実際の TPS は、行ったレコメンデーションリクエストの総数です。低い `minProvisionedTPS` から始めて、Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げることをお勧めします。キャンペーンのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。 **ステータス** キャンペーンは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS キャンペーンのステータスを取得するには、[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) を呼び出します。 **注記** キャンペーンの `status` が `ACTIVE` になるまで待ってから、キャンペーンにレコメンデーションを尋ねます。 **関連 API** + [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) + [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) + [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) + [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) ## リクエストの構文 ``` { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** キャンペーンの設定の詳細。型: [CampaignConfig](API_CampaignConfig.md) オブジェクト必須: いいえ ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** Amazon Personalize がサポートする、リクエストされた 1 秒あたりの最小プロビジョンドトランザクション (推奨) を指定します。`minProvisionedTPS` を高く設定すると請求額が増加します。最初は `minProvisionedTPS` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。タイプ: 整数有効な範囲: 最小値は 1 です。必須: いいえ ** [name](#API_CreateCampaign_RequestSyntax) ** 新しいキャンペーンの名前。キャンペーン名はアカウント内で一意でなければなりません。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** キャンペーンでデプロイするトレーニング済みモデルの Amazon リソースネーム (ARN)。ソリューションの最新バージョンを指定するには、*ソリューション*の ARN を `SolutionArn/$LATEST` 形式で指定します。[CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html) で `syncWithLatestSolutionVersion` を `True` に設定する場合は、この形式を使用する必要があります。ソリューションの最新バージョンではないモデルをデプロイするには、ソリューションバージョンの ARN を指定します。キャンペーンの自動更新の詳細については、「[キャンペーンの自動更新を有効にする](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [tags](#API_CreateCampaign_RequestSyntax) ** 関数に適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "campaignArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [campaignArn](#API_CreateCampaign_ResponseSyntax) ** キャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateCampaign) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign) # CreateDataDeletionJob Amazon Personalize データセットグループから特定のユーザーへのすべての参照をバッチで削除するバッチジョブを作成します。Amazon S3 バケットの userId の CSV ファイルで削除するユーザーを指定します。ジョブが完了すると、Amazon Personalize はユーザーのデータをトレーニングしなくなり、ユーザーセグメントの生成時にユーザーを考慮しなくなります。データ削除ジョブの作成の詳細については、「[ユーザーの削除](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)」を参照してください。 + 入力ファイルは、ユーザー ID を一覧表示する USER\$1ID 列を持つ CSV ファイルである必要があります。CSV ファイルの準備の詳細については、「[データ削除ファイルの準備と Amazon S3 へのアップロード](https://docs.aws.amazon.com/personalize/latest/dg/prepare-deletion-input-file.html)」を参照してください。 + userId の入力 CSV ファイルにアクセスするアクセス許可を Amazon Personalize に付与するには、データソースから読み取るアクセス許可を持つ IAM サービスロールを指定する必要があります。このロールには、バケットとコンテンツの `GetObject` と `ListBucket` アクセス許可が必要です。これらのアクセス許可は、データのインポートと同じです。Amazon S3 バケットへのアクセスを許可する方法については、「[Amazon Personalize に Amazon S3 リソースへのアクセスを許可する](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html)」を参照してください。ジョブを作成した後、データセットとモデルからユーザーへのすべての参照を削除するまでに最大 1 日かかる場合があります。ジョブが完了するまで、Amazon Personalize はトレーニング時に引き続きデータを使用します。また、ユーザーセグメンテーションレシピを使用すると、ユーザーがユーザーセグメントに表示されることがあります。 **ステータス** データ削除ジョブのステータスは、次のいずれかです。 + PENDING > IN\$1PROGRESS > COMPLETED または FAILED データ削除ジョブのステータスを取得するには、[DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) API オペレーションを呼び出し、ジョブの Amazon リソースネーム (ARN) を指定します。ステータスが FAILED の場合、レスポンスには、ジョブが失敗した理由を記述する `failureReason` キーが含まれています。 **関連 API** + [ListDataDeletionJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDataDeletionJobs.html) + [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) ## リクエストの構文 ``` { "datasetGroupArn": "string", "dataSource": { "dataLocation": "string" }, "jobName": "string", "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_CreateDataDeletionJob_RequestSyntax) ** レコードを削除するレコードのあるデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [dataSource](#API_CreateDataDeletionJob_RequestSyntax) ** 削除するユーザーの userId のリストを含む Amazon S3 バケット。型: [DataSource](API_DataSource.md) オブジェクト必須: はい ** [jobName](#API_CreateDataDeletionJob_RequestSyntax) ** データ削除ジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [roleArn](#API_CreateDataDeletionJob_RequestSyntax) ** Amazon S3 データソースから読み取るための許可を持つ IAM ロールの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: はい ** [tags](#API_CreateDataDeletionJob_RequestSyntax) ** データ削除ジョブに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "dataDeletionJobArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [dataDeletionJobArn](#API_CreateDataDeletionJob_ResponseSyntax) ** データ削除ジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataDeletionJob) # CreateDataset 空のデータセットを作成し、指定したデータセットグループに追加します。[CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html) を使用してトレーニングデータをデータセットにインポートします。データセットには次の 5 つのタイプがあります。 + アイテムインタラクション + 項目 + [ユーザー] + Action インタラクション + アクション各データセットタイプには、必須のフィールドタイプに関連付けられたスキーマがあります。モデルのトレーニング (ソリューションの作成とも呼ばれます) に必要なのは、`Item interactions` データセットのみです。データセットは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS データセットのステータスを取得するには、[DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) を呼び出します。 **関連 API** + [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) + [ListDatasets](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html) + [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) + [DeleteDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html) ## リクエストの構文 ``` { "datasetGroupArn": "string", "datasetType": "string", "name": "string", "schemaArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_CreateDataset_RequestSyntax) ** データセットを追加するデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [datasetType](#API_CreateDataset_RequestSyntax) ** データセットのタイプ。次の値のいずれか (大文字と小文字は区別されません): + インタラクション + 項目 + [ユーザー] + アクション + Action\$1Interactions タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `^[A-Za-z_]+$` 必須: はい ** [name](#API_CreateDataset_RequestSyntax) ** データセットの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [schemaArn](#API_CreateDataset_RequestSyntax) ** データセットに関連付けるスキーマの ARN。スキーマはデータセットフィールドを定義します。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [tags](#API_CreateDataset_RequestSyntax) ** データセットに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "datasetArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetArn](#API_CreateDataset_ResponseSyntax) ** データセットの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDataset) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataset) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataset) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataset) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataset) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataset) # CreateDatasetExportJob データセットから Amazon S3 バケットにデータをエクスポートするジョブを作成します。Amazon Personalize がトレーニングデータをエクスポートできるようにするには、Amazon S3 バケットについての `PutObject` の許可を Amazon Personalize に付与する、サービスにリンクされた IAM ロールを指定する必要があります。詳細については、Amazon Personalize デベロッパーガイドの「[データセットのエクスポート](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html)」を参照してください。 **ステータス** データセットのエクスポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED エクスポートジョブのステータスを取得するには、[DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html) を呼び出し、データセットのエクスポートジョブの Amazon リソースネーム (ARN) を指定します。ステータスが ACTIVE と表示されると、データセットのエクスポートが完了します。ステータスが CREATE FAILED と表示されている場合、レスポンスには、ジョブが失敗した理由を記述する `failureReason` キーが含まれています。 ## リクエストの構文 ``` { "datasetArn": "string", "ingestionMode": "string", "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) ** エクスポートするデータを含むデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) ** エクスポートするデータ (データをインポートした方法に基づく)。データセットのインポートジョブを使用してインポートした `BULK` データのみ、(コンソール、PutEvents、PutUsers、および PutItems 操作を使用して) 増分的にインポートした `PUT` データのみ、または両方のタイプの `ALL` をエクスポートすることを選択できます。デフォルト値は `PUT` です。型: 文字列有効な値：`BULK | PUT | ALL` 必須：いいえ ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) ** データセットのエクスポートジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) ** ジョブの出力が保存される Amazon S3 バケットへのパス。型: [DatasetExportJobOutput](API_DatasetExportJobOutput.md) オブジェクト必須: はい ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) ** 出力 Amazon S3 バケットにデータを追加するための許可を持つ IAM サービスロールの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: はい ** [tags](#API_CreateDatasetExportJob_RequestSyntax) ** データセットのエクスポートジョブに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "datasetExportJobArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) ** データセットのエクスポートジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetExportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetExportJob) # CreateDatasetGroup 空のデータセットグループを作成します。データセットグループは、Amazon Personalize のリソースのコンテナです。データセットグループには、データセットのタイプごとに 1 つずつ、最大 3 つのデータセットを含めることができます。 + アイテムインタラクション + 項目 + [ユーザー] + アクション + Action インタラクションデータセットグループは、ドメインを指定してレコメンダーなどの事前設定されたリソースを使用するドメインデータセットグループ、または、キャンペーンでデプロイするカスタムリソースを使用するカスタムデータセットグループ (ソリューションバージョンを使用したソリューションなど) にすることができます。ドメインデータセットグループで始める場合でも、カスタムユースケースのレシピでトレーニングされ、キャンペーンでデプロイされたソリューションやソリューションバージョンなどのカスタムリソースを追加できます。データセットグループは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING データセットグループのステータスを取得するには、[DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) を呼び出します。ステータスが CREATE FAILED と表示されている場合、レスポンスには、作成が失敗した理由を記述する `failureReason` キーが含まれています。 **注記** データセットをグループに追加する前に、データセットグループの `status` が `ACTIVE` になるまで待つ必要があります。 AWS Key Management Service (KMS) キーを指定して、グループ内のデータセットを暗号化できます。KMS キーを指定する場合は、キーにアクセスするための許可を持つ AWS Identity and Access Management (IAM) ロールも含める必要があります。 **リクエストでデータセットグループ ARN を必要とする API** + [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) + [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) + [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) **関連 API** + [ListDatasetGroups](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) + [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) + [DeleteDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) ## リクエストの構文 ``` { "domain": "string", "kmsKeyArn": "string", "name": "string", "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [domain](#API_CreateDatasetGroup_RequestSyntax) ** データセットグループのドメイン。ドメインを指定して、ドメインデータセットグループを作成します。指定するドメインによって、データセットのデフォルトスキーマと、レコメンダーが利用できるユースケースが決まります。ドメインを指定しない場合は、キャンペーンでデプロイするソリューションバージョンを使用してカスタムデータセットグループを作成します。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) ** データセットの暗号化に使用される (KMS) キーの Amazon リソースネーム AWS Key Management Service (ARN)。タイプ: 文字列長さの制約: 最大長は 2,048 です。パターン: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 必須: いいえ ** [name](#API_CreateDatasetGroup_RequestSyntax) ** 新しいデータセットグループの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) ** AWS Identity and Access Management (KMS) キーへのアクセス許可を持つ AWS Key Management Service (IAM) ロールの ARN。IAM ロールの指定は、KMS キーも指定する場合にのみ有効です。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: いいえ ** [tags](#API_CreateDatasetGroup_RequestSyntax) ** データセットグループに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "datasetGroupArn": "string", "domain": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) ** 新しいデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ** [domain](#API_CreateDatasetGroup_ResponseSyntax) ** 新しいドメインデータセットグループのドメイン。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetGroup) # CreateDatasetImportJob データソース (Amazon S3 バケット) から Amazon Personalize データセットにトレーニングデータをインポートするジョブを作成します。Amazon Personalize がトレーニングデータをインポートできるようにするには、Amazon Personalize がデータのコピーを作成して内部で処理するため、データソースからの読み取り許可を持つ IAM サービスロールを指定する必要があります。Amazon S3 バケットへのアクセスを許可する方法については、「[Amazon Personalize に Amazon S3 リソースへのアクセスを許可する](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html)」を参照してください。レコメンダーをすでに作成しているか、キャンペーンでカスタムソリューションバージョンをデプロイしている場合、新しいバルクレコードがレコメンデーションにどのように影響するかは、使用するドメインのユースケースまたはレシピによって異なります。詳細については、「[新しいデータがリアルタイムのレコメンデーションに与える影響](https://docs.aws.amazon.com/personalize/latest/dg/how-new-data-influences-recommendations.html)」を参照してください。 **重要** デフォルトでは、データセットのインポートジョブは、一括でインポートしたデータセット内の既存のデータを置き換えます。既存のデータを置き換えずに新しいレコードを追加するには、CreateDatasetImportJob オペレーションのインポートモードに INCREMENTAL を指定します。 **ステータス** データセットのインポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED インポートジョブのステータスを取得するには、[DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) を呼び出し、データセットのインポートジョブの Amazon リソースネーム (ARN) を指定します。ステータスが ACTIVE と表示されると、データセットのインポートが完了します。ステータスが CREATE FAILED と表示されている場合、レスポンスには、ジョブが失敗した理由を記述する `failureReason` キーが含まれています。 **注記** インポートには時間がかかります。ステータスが ACTIVE になるまで待ってから、データセットを使用してモデルをトレーニングしてください。 **関連 API** + [ListDatasetImportJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetImportJobs.html) + DescribeDatasetImportJob ## リクエストの構文 ``` { "datasetArn": "string", "dataSource": { "dataLocation": "string" }, "importMode": "string", "jobName": "string", "publishAttributionMetricsToS3": boolean, "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetArn](#API_CreateDatasetImportJob_RequestSyntax) ** インポートされたデータを受け取るデータセットの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [dataSource](#API_CreateDatasetImportJob_RequestSyntax) ** インポートするトレーニングデータを含む Amazon S3 バケット。型: [DataSource](API_DataSource.md) オブジェクト必須: はい ** [importMode](#API_CreateDatasetImportJob_RequestSyntax) ** 新しいレコードを既存のデータセットに追加する方法を指定します。デフォルトのインポートモードは `FULL` です。以前にデータセットに一括レコードをインポートしたことがない場合は、`FULL` を指定することしかできません。 + データセット内の既存のバルクデータをすべて上書きするように `FULL` を指定します。個別にインポートしたデータは置き換えられません。 + データセット内の既存のデータに新しいレコードを追加するように `INCREMENTAL` を指定します。Amazon Personalize は、同じ ID のレコードをすべて新しいレコードに置き換えます。型: 文字列有効な値：`FULL | INCREMENTAL` 必須：いいえ ** [jobName](#API_CreateDatasetImportJob_RequestSyntax) ** データセットのインポートジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [publishAttributionMetricsToS3](#API_CreateDatasetImportJob_RequestSyntax) ** メトリクス属性を作成した場合は、このインポートジョブのメトリクスを Amazon S3 に発行するかどうかを指定します。タイプ: ブール値必須: いいえ ** [roleArn](#API_CreateDatasetImportJob_RequestSyntax) ** Amazon S3 データソースから読み取るための許可を持つ IAM ロールの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: いいえ ** [tags](#API_CreateDatasetImportJob_RequestSyntax) ** データセットのインポートジョブに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "datasetImportJobArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetImportJobArn](#API_CreateDatasetImportJob_ResponseSyntax) ** データセットのインポートジョブの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetImportJob) # CreateEventTracker [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API を使用して、指定したデータセットグループにイベントデータを追加するときに使用するイベントトラッカーを作成します。 **注記** データセットグループに関連付けることができるイベントトラッカーは 1 つのみです。既存のイベントトラッカーと同じデータセットグループを使用して `CreateEventTracker` を呼び出すと、エラーが発生します。イベントトラッカーを作成すると、レスポンスには追跡 ID が含まれます。これは、[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) 操作を使用するときにパラメータとして渡します。その後、Amazon Personalize は、イベントトラッカーで指定したデータセットグループのアイテムインタラクションデータセットにイベントデータを追加します。イベントトラッカーは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS イベントトラッカーのステータスを取得するには、[DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) を呼び出します。 **注記** 追跡 ID を使用する前に、イベントトラッカーが ACTIVE 状態になっている必要があります。 **関連 API** + [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html) + [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) + [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html) ## リクエストの構文 ``` { "datasetGroupArn": "string", "name": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) ** イベントデータを受け取るデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [name](#API_CreateEventTracker_RequestSyntax) ** イベントトラッカーの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [tags](#API_CreateEventTracker_RequestSyntax) ** イベントトラッカーに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "eventTrackerArn": "string", "trackingId": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) ** イベントトラッカーの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ** [trackingId](#API_CreateEventTracker_ResponseSyntax) ** イベントトラッカーの ID。この ID を [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API へのリクエストに含めます。タイプ: 文字列長さの制約: 最大長は 256 です。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker) # CreateFilter レコメンデーションフィルターを作成します。詳細については、「[レコメンデーションとユーザーセグメントのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "filterExpression": "string", "name": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_CreateFilter_RequestSyntax) ** フィルターが属するデータセットグループの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [filterExpression](#API_CreateFilter_RequestSyntax) ** フィルター式は、レコメンデーションに含める、またはレコメンデーションから除外するアイテムを定義します。フィルター式は、特定のフォーマットルールに従う必要があります。フィルター式の構造と構文については、「[フィルター式](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2500 です。必須: はい ** [name](#API_CreateFilter_RequestSyntax) ** 作成するフィルターの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [tags](#API_CreateFilter_RequestSyntax) ** フィルターに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "filterArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [filterArn](#API_CreateFilter_ResponseSyntax) ** 新しいフィルターの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateFilter) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateFilter) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateFilter) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateFilter) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateFilter) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateFilter) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateFilter) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateFilter) # CreateMetricAttribution メトリクス属性を作成します。メトリクス属性は、Amazon Personalize にインポートしたデータに関するレポートを作成します。データをインポートした方法に応じて Amazon CloudWatch または Amazon S3 でレポートを表示できます。詳細については、「[レコメンデーションの影響の測定](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)」を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "metrics": [ { "eventType": "string", "expression": "string", "metricName": "string" } ], "metricsOutputConfig": { "roleArn": "string", "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "name": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_CreateMetricAttribution_RequestSyntax) ** メトリクス属性に対する宛先ドメインデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [metrics](#API_CreateMetricAttribution_RequestSyntax) ** メトリクス属性のメトリクス属性のリスト。各メトリクス属性は、追跡するイベントタイプと関数を指定します。使用できる関数は、`SUM()` または `SAMPLECOUNT()` です。SUM() 関数では、データセットのタイプ (インタラクションまたはアイテム) と合計する列をパラメーターとして指定します。例えば、SUM(Items.PRICE) などです。型: [MetricAttribute](API_MetricAttribute.md) オブジェクトの配列配列メンバー: 最大数は 10 項目です。必須: はい ** [metricsOutputConfig](#API_CreateMetricAttribution_RequestSyntax) ** メトリクス属性の出力設定の詳細。型: [MetricAttributionOutput](API_MetricAttributionOutput.md) オブジェクト必須: はい ** [name](#API_CreateMetricAttribution_RequestSyntax) ** メトリクス属性の名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ## レスポンスの構文 ``` { "metricAttributionArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [metricAttributionArn](#API_CreateMetricAttribution_ResponseSyntax) ** 新しいメトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateMetricAttribution) # CreateRecommender 指定したレシピ (ドメインデータセットグループのユースケース) を使用してレコメンダーを作成します。ドメインデータセットグループのレコメンダーを作成し、[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) リクエストを実行するときにレコメンダーの Amazon リソースネーム (ARN) を指定します。 **1 秒あたりの最小レコメンデーションリクエスト数** **重要** `minRecommendationRequestsPerSecond` を高く設定すると請求額が増加します。最初は `minRecommendationRequestsPerSecond` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minRecommendationRequestsPerSecond` を引き上げることをお勧めします。レコメンダーを作成する際、レコメンダーの 1 秒あたりの最小レコメンデーションリクエスト数を設定できます。1 秒あたりの最小レコメンデーションリクエスト数 (`minRecommendationRequestsPerSecond`) は、Amazon Personalize によってプロビジョニングされるベースラインレコメンデーションリクエストスループットを指定します。デフォルトの minRecommendationRequestsPerSecond は `1` です。レコメンデーションリクエストは 1 回の `GetRecommendations` 操作です。リクエストスループットは 1 秒あたりのリクエスト数で測定されます。Amazon Personalize は 1 秒あたりのリクエスト数を使用して、1 時間あたりのリクエスト数とレコメンダーの使用量を算出します。 1 秒あたりのリクエスト数が `minRecommendationRequestsPerSecond` を超えて増加した場合、Amazon Personalize はプロビジョンド容量を自動的にスケールアップまたはスケールダウンしますが、`minRecommendationRequestsPerSecond` を下回ることはありません。容量が引き上げられている間に短時間の遅延が生じます。これにより、リクエストの損失が生じる可能性があります。請求額は、1 時間あたりの最小リクエスト数 (minRecommendationRequestSperSecond に基づく) または実際のリクエスト数のどちらか大きい方です。実際に使用されるリクエストのスループットは、5 分間のウィンドウ内の平均リクエスト数/秒として計算されます。低い `minRecommendationRequestsPerSecond` から始めて、Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minRecommendationRequestsPerSecond` を引き上げることをお勧めします。 **ステータス** レコメンダーは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS レコメンダーのステータスを取得するには、[DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) を呼び出します。 **注記** レコメンダーの `status` が `ACTIVE` になるまで待ってから、レコメンダーにレコメンデーションを尋ねます。 **関連 API** + [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) + [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) + [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) + [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) ## リクエストの構文 ``` { "datasetGroupArn": "string", "name": "string", "recipeArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) ** レコメンダーの宛先ドメインデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [name](#API_CreateRecommender_RequestSyntax) ** レコメンダーの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [recipeArn](#API_CreateRecommender_RequestSyntax) ** レコメンダーが使用するレシピの Amazon リソースネーム (ARN)。レコメンダーについて、レシピはドメインデータセットグループのユースケースです。レコメンダーを作成する際、ドメインデータセットグループのユースケースのみを使用できます。ユースケースの詳細については、「[レコメンダーのユースケースの選択](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** レコメンダーの設定の詳細。型: [RecommenderConfig](API_RecommenderConfig.md) オブジェクト必須: いいえ ** [tags](#API_CreateRecommender_RequestSyntax) ** レコメンダーに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "recommenderArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) ** レコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender) # CreateSchema 指定されたスキーマ文字列から Amazon Personalize スキーマを作成します。作成するスキーマは Avro JSON 形式である必要があります。 Amazon Personalize は、3 つのスキーマバリアントを認識します。各スキーマはデータセットタイプに関連付けられており、必須フィールドとキーワードのセットを備えています。ドメインデータセットグループ内のデータセットのスキーマを作成する場合は、ドメインデータセットグループのドメインを指定します。[CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) を呼び出すときにスキーマを指定します。スキーマの詳細については、「[データセットとスキーマ](https://docs.aws.amazon.com/personalize/latest/dg/how-it-works-dataset-schema.html)」を参照してください。 **関連 API** + [ListSchemas](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSchemas.html) + [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) + [DeleteSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSchema.html) ## リクエストの構文 ``` { "domain": "string", "name": "string", "schema": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [domain](#API_CreateSchema_RequestSyntax) ** スキーマのドメイン。ドメインデータセットグループ内のデータセットのスキーマを作成する場合は、ドメインデータセットグループを作成したときに選択したドメインを指定します。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** [name](#API_CreateSchema_RequestSyntax) ** スキーマの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [schema](#API_CreateSchema_RequestSyntax) ** Avro JSON 形式のスキーマ。タイプ: 文字列長さの制限: 最大長は 20,000 です。必須: はい ## レスポンスの構文 ``` { "schemaArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [schemaArn](#API_CreateSchema_ResponseSyntax) ** 作成したスキーマの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSchema) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSchema) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSchema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSchema) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSchema) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSchema) # CreateSolution **重要** デフォルトでは、すべての新しいソリューションで自動トレーニングが使用されます。自動トレーニングでは、ソリューションがアクティブな間はトレーニングコストが発生します。不要なコストを避けるために、完了したら[ソリューションを更新](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html)して自動トレーニングを無効にすることができます。トレーニングのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。モデルをトレーニングするための設定 (ソリューションバージョンの作成) を作成します。この設定には、モデルトレーニングに使用するレシピと、トレーニングや機能変換パラメータで使用する列などのオプションのトレーニング設定が含まれます。ソリューションの設定の詳細については、「[ソリューションの作成と構成](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)」を参照してください。デフォルトでは、新しいソリューションは自動トレーニングを使用して 7 日ごとにソリューションバージョンを作成します。トレーニング頻度は変更できます。自動ソリューションバージョンの作成は、ソリューションが ACTIVE になってから 1 時間以内に開始されます。1 時間以内にソリューションバージョンを手動で作成した場合、ソリューションは最初の自動トレーニングをスキップします。詳細については、「[自動トレーニングの設定](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)」を参照してください。自動トレーニングを無効にするには、`performAutoTraining` を false に設定します。自動トレーニングをオフにする場合は、[CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) オペレーションを呼び出して、ソリューションバージョンを手動で作成する必要があります。トレーニングが開始されると、[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API オペレーションを使用してソリューションバージョンの Amazon リソースネーム (ARN) を取得できます。ステータスを取得するには、[DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) を使用します。トレーニングが完了したら、[GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html) を呼び出してモデルの精度を評価できます。ソリューションバージョンに問題がなければ、[CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) を使用してデプロイします。キャンペーンは、[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) API を介してクライアントにレコメンデーションを提供します。 **注記** 現時点では、Amazon Personalize は、ソリューションのハイパーパラメータ最適化のためん、`hpoObjective` の設定をサポートしていません。 **ステータス** ソリューションは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS ソリューションのステータスを取得するには、[DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) を呼び出します。手動トレーニングを使用する場合は、`CreateSolutionVersion` を呼び出す前にステータスが ACTIVE である必要があります。 **関連 API** + [UpdateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) + [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) + [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) + [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) + [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) + [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) + [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) ## リクエストの構文 ``` { "datasetGroupArn": "string", "eventType": "string", "name": "string", "performAutoML": boolean, "performAutoTraining": boolean, "performHPO": boolean, "performIncrementalUpdate": boolean, "recipeArn": "string", "solutionConfig": { "algorithmHyperParameters": { "string" : "string" }, "autoMLConfig": { "metricName": "string", "recipeList": [ "string" ] }, "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] }, "eventValueThreshold": "string", "featureTransformationParameters": { "string" : "string" }, "hpoConfig": { "algorithmHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ] }, "hpoObjective": { "metricName": "string", "metricRegex": "string", "type": "string" }, "hpoResourceConfig": { "maxNumberOfTrainingJobs": "string", "maxParallelTrainingJobs": "string" } }, "optimizationObjective": { "itemAttribute": "string", "objectiveSensitivity": "string" }, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) ** トレーニングデータを提供するデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [eventType](#API_CreateSolution_RequestSyntax) ** (`EVENT_TYPE` スキーマフィールドを使用して) 複数のイベントタイプがある場合、このパラメータは、モデルのトレーニングに使用されるイベントタイプ (例えば、「クリック」または「いいね」) を指定します。 `eventType` を指定しない場合、Amazon Personalize は、タイプにかかわらず、同じ重みでトレーニングするためにすべてのインタラクションを使用します。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** [name](#API_CreateSolution_RequestSyntax) ** ソリューションの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: はい ** [performAutoML](#API_CreateSolution_RequestSyntax) ** 自動機械学習の有効化は推奨されません。代わりに、利用可能な Amazon Personalize のレシピにユースケースをマッチさせます。詳細については、の「[Choosing a recipe](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html)」を参照してください。自動機械学習 (AutoML) を実行するかどうか。デフォルトは `false` です。この場合、`recipeArn` を指定する必要があります。 `true` に設定すると、Amazon Personalize はトレーニングデータを分析し、最適な USER\$1PERSONALIZATION レシピとハイパーパラメータを選択します。この場合、`recipeArn` を省略する必要があります。Amazon Personalize は、ハイパーパラメータにさまざまな値を使用してテストを実行することにより、最適なレシピを決定します。AutoML では、特定のレシピを選択する場合と比較して、トレーニングプロセスに長時間を要します。タイプ: ブール値必須: いいえ ** [performAutoTraining](#API_CreateSolution_RequestSyntax) ** ソリューションが自動トレーニングを使用して新しいソリューションバージョン (トレーニング済みモデル) を作成するかどうか。デフォルトは `True` で、ソリューションは 7 日ごとに新しいソリューションバージョンを自動的に作成します。ソリューション設定の一部として `AutoTrainingConfig` で `schedulingExpression` を指定することで、トレーニング頻度を変更できます。自動トレーニングの詳細については、「[自動トレーニングの設定](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)」を参照してください。自動ソリューションバージョンの作成は、ソリューションが ACTIVE になってから 1 時間以内に開始されます。1 時間以内にソリューションバージョンを手動で作成した場合、ソリューションは最初の自動トレーニングをスキップします。トレーニングが開始されると、[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API オペレーションを使用してソリューションバージョンの Amazon リソースネーム (ARN) を取得できます。ステータスを取得するには、[DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) を使用します。タイプ: ブール値必須: いいえ ** [performHPO](#API_CreateSolution_RequestSyntax) ** 指定または選択したレシピでハイパーパラメータ最適化 (HPO) を実行するかどうか。デフォルトは `false` です。 AutoML を実行する場合、このパラメータは常に `true` となります。`false` に設定しないでください。タイプ: ブール値必須: いいえ ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) ** モデルで増分トレーニング更新を実行するかどうか。これにより、モデルは完全な再トレーニングを必要とせずに新しいデータからより頻繁に学習できるため、ほぼリアルタイムのパーソナライゼーションが可能になります。このパラメータは、セマンティック類似度レシピを使用するソリューションでのみサポートされます。タイプ: ブール値必須: いいえ ** [recipeArn](#API_CreateSolution_RequestSyntax) ** モデルトレーニングに使用するレシピの Amazon リソースネーム (ARN)。これは、`performAutoML` が false の場合に必要です。Amazon Personalize のさまざまなレシピとその ARN の詳細については、「[Choosing a recipe](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [solutionConfig](#API_CreateSolution_RequestSyntax) ** ソリューションの設定プロパティ。`performAutoML` が true に設定されている場合、Amazon Personalize はソリューション設定の `autoMLConfig` セクションのみを評価します。現時点では、Amazon Personalize は `hpoObjective` の設定をサポートしていません。型: [SolutionConfig](API_SolutionConfig.md) オブジェクト必須: いいえ ** [tags](#API_CreateSolution_RequestSyntax) ** ソリューションに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "solutionArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [solutionArn](#API_CreateSolution_ResponseSyntax) ** ソリューションの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution) # CreateSolutionVersion カスタムデータセットグループでアクティブなソリューションをトレーニングまたは再トレーニングします。ソリューションは [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 操作を使用して作成され、`CreateSolutionVersion` を呼び出す前に ACTIVE 状態となっている必要があります。この操作を呼び出すたびに、ソリューションの新しいバージョンが作成されます。 **ステータス** ソリューションバージョンは、次のいずれかの状態になります。 + CREATE PENDING + CREATE IN\$1PROGRESS + アクティブ + CREATE FAILED + CREATE STOPPING + CREATE STOPPED バージョンのステータスを取得するには、[DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) を呼び出します。ステータスが ACTIVE と表示されるまで待ってから、`CreateCampaign` を呼び出します。ステータスが CREATE FAILED と表示されている場合、レスポンスには、ジョブが失敗した理由を記述する `failureReason` キーが含まれています。 **関連 API** + [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) + [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) + [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) + [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) + [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) + [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) ## リクエストの構文 ``` { "name": "string", "solutionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ], "trainingMode": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [name](#API_CreateSolutionVersion_RequestSyntax) ** ソリューションバージョンの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** [solutionArn](#API_CreateSolutionVersion_RequestSyntax) ** トレーニング設定情報を含むソリューションの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [tags](#API_CreateSolutionVersion_RequestSyntax) ** ソリューションバージョンに適用する[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ** [trainingMode](#API_CreateSolutionVersion_RequestSyntax) ** ソリューションバージョンを作成するときに実行するトレーニングの範囲。デフォルトは `FULL` です。これにより、データセットグループ内のデータセットからのトレーニングデータ全体に基づいて、完全に新しいモデルが作成されます。 [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html)を使用する場合は、`UPDATE` のトレーニングモードを指定できます。これによりモデルが更新され、新しい項目をレコメンデーションの対象として検討するようになります。これは完全な再トレーニングではありません。それでも、毎週完全な再トレーニングを完了する必要があります。`UPDATE` を指定した場合、Amazon Personalize はソリューションバージョンの自動更新を停止します。更新を再開するには、トレーニングモードを `FULL` に設定して新しいソリューションを作成し、キャンペーンにデプロイします。自動更新の詳細については、「[自動更新](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#maintaining-with-automatic-updates)」を参照してください。 `UPDATE` オプションは、`FULL` オプションを使用して入力ソリューションから作成されたアクティブなソリューションバージョンが既にあり、入力ソリューションが [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) レシピまたは [HRNN-Coldstart](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html) レシピでトレーニングされている場合にのみ使用できます。型: 文字列有効な値：`FULL | UPDATE | AUTOTRAIN` 必須：いいえ ## レスポンスの構文 ``` { "solutionVersionArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [solutionVersionArn](#API_CreateSolutionVersion_ResponseSyntax) ** 新しいソリューションバージョンの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolutionVersion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolutionVersion) # DeleteCampaign ソリューションのデプロイを削除して、キャンペーンを削除します。キャンペーンのベースとなっているソリューションは削除されず、必要に応じて再デプロイできます。削除されたキャンペーンは、[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) リクエストで指定できなくなりました。キャンペーンの作成については、「[CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html)」を参照してください。 ## リクエストの構文 ``` { "campaignArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [campaignArn](#API_DeleteCampaign_RequestSyntax) ** 削除するキャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteCampaign) # DeleteDataset データセットを削除します。関連付けられた `DatasetImportJob` または `SolutionVersion` が CREATE PENDING または IN PROGRESS 状態にある場合、データセットを削除することはできません。データセットの削除の詳細については、「[データセットの削除](https://docs.aws.amazon.com/personalize/latest/dg/delete-dataset.html)」を参照してください。 ## リクエストの構文 ``` { "datasetArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetArn](#API_DeleteDataset_RequestSyntax) ** 削除するデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteDataset) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDataset) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDataset) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDataset) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDataset) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDataset) # DeleteDatasetGroup データセットグループを削除します。データセットグループを削除する前に、以下を削除する必要があります。 + すべての関連付けられたイベントトラッカー。 + すべての関連付けられたソリューション。 + データセットグループのすべてのデータセット。 ## リクエストの構文 ``` { "datasetGroupArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_DeleteDatasetGroup_RequestSyntax) ** 削除するデータセットグループの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDatasetGroup) # DeleteEventTracker イベントトラッカーを削除します。データセットグループからデータセットを削除しません。イベントトラッカーについての詳細は、「[CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)」を参照してください。 ## リクエストの構文 ``` { "eventTrackerArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [eventTrackerArn](#API_DeleteEventTracker_RequestSyntax) ** 削除するイベントトラッカーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteEventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteEventTracker) # DeleteFilter フィルターを削除します。 ## リクエストの構文 ``` { "filterArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [filterArn](#API_DeleteFilter_RequestSyntax) ** 削除するフィルターの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteFilter) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteFilter) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteFilter) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteFilter) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteFilter) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteFilter) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteFilter) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteFilter) # DeleteMetricAttribution メトリクス属性を削除します。 ## リクエストの構文 ``` { "metricAttributionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [metricAttributionArn](#API_DeleteMetricAttribution_RequestSyntax) ** メトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteMetricAttribution) # DeleteRecommender レコメンダーを非アクティブにして削除します。削除されたレコメンダーは、[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) リクエストで指定できなくなりました。 ## リクエストの構文 ``` { "recommenderArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [recommenderArn](#API_DeleteRecommender_RequestSyntax) ** 削除するレコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteRecommender) # DeleteSchema スキーマを削除します。スキーマを削除する前に、そのスキーマを参照しているすべてのデータセットを削除する必要があります。スキーマについての詳細は、「[CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html)」を参照してください。 ## リクエストの構文 ``` { "schemaArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [schemaArn](#API_DeleteSchema_RequestSyntax) ** 削除するスキーマの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteSchema) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSchema) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSchema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSchema) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSchema) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSchema) # DeleteSolution ソリューションのすべてのバージョンと `Solution` オブジェクト自体を削除します。ソリューションを削除する前に、そのソリューションに基づくすべてのキャンペーンを削除する必要があります。ソリューションを使用しているキャンペーンを決定するには、[ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) を呼び出して、ソリューションの Amazon リソースネーム (ARN) を提供します。関連付けられた `SolutionVersion` が CREATE PENDING または IN PROGRESS 状態にある場合、ソリューションを削除することはできません。詳細については、「[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)」を参照してください。 ## リクエストの構文 ``` { "solutionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [solutionArn](#API_DeleteSolution_RequestSyntax) ** 削除するソリューションの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteSolution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSolution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSolution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSolution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSolution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSolution) # DescribeAlgorithm 特定のアルゴリズムを記述します。 ## リクエストの構文 ``` { "algorithmArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [algorithmArn](#API_DescribeAlgorithm_RequestSyntax) ** 記述するアルゴリズムの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "algorithm": { "algorithmArn": "string", "algorithmImage": { "dockerURI": "string", "name": "string" }, "creationDateTime": number, "defaultHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "isTunable": boolean, "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "isTunable": boolean, "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "isTunable": boolean, "maxValue": number, "minValue": number, "name": "string" } ] }, "defaultHyperParameters": { "string" : "string" }, "defaultResourceConfig": { "string" : "string" }, "lastUpdatedDateTime": number, "name": "string", "roleArn": "string", "trainingInputMode": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [algorithm](#API_DescribeAlgorithm_ResponseSyntax) ** アルゴリズムのプロパティのリスト。型: [Algorithm](API_Algorithm.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeAlgorithm) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeAlgorithm) # DescribeBatchInferenceJob 名前、Amazon リソースネーム (ARN)、ステータス、入力と出力の設定、およびレコメンデーションの生成に使用されたソリューションバージョンの ARN を含むバッチ推論ジョブのプロパティを取得します。 ## リクエストの構文 ``` { "batchInferenceJobArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [batchInferenceJobArn](#API_DescribeBatchInferenceJob_RequestSyntax) ** 記述するバッチ推論ジョブの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "batchInferenceJob": { "batchInferenceJobArn": "string", "batchInferenceJobConfig": { "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number } }, "batchInferenceJobMode": "string", "creationDateTime": number, "failureReason": "string", "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "lastUpdatedDateTime": number, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "status": "string", "themeGenerationConfig": { "fieldsForThemeGeneration": { "itemName": "string" } } } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [batchInferenceJob](#API_DescribeBatchInferenceJob_ResponseSyntax) ** 指定されたバッチ推論ジョブに関する情報。型: [BatchInferenceJob](API_BatchInferenceJob.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchInferenceJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchInferenceJob) # DescribeBatchSegmentJob 名前、Amazon リソースネーム (ARN)、ステータス、入力と出力の設定、およびセグメントの生成に使用されたソリューションバージョンの ARN を含むバッチセグメントジョブのプロパティを取得します。 ## リクエストの構文 ``` { "batchSegmentJobArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [batchSegmentJobArn](#API_DescribeBatchSegmentJob_RequestSyntax) ** 記述するバッチセグメントジョブの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "batchSegmentJob": { "batchSegmentJobArn": "string", "creationDateTime": number, "failureReason": "string", "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "lastUpdatedDateTime": number, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [batchSegmentJob](#API_DescribeBatchSegmentJob_ResponseSyntax) ** 指定されたバッチセグメントジョブに関する情報。型: [BatchSegmentJob](API_BatchSegmentJob.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchSegmentJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchSegmentJob) # DescribeCampaign ステータスを含む、特定のキャンペーンを記述します。キャンペーンは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS `status` が `CREATE FAILED` の場合、レスポンスには理由を記述する `failureReason` キーが含まれます。キャンペーンの作成の詳細については、「[CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html)」を参照してください。 ## リクエストの構文 ``` { "campaignArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [campaignArn](#API_DescribeCampaign_RequestSyntax) ** キャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "campaign": { "campaignArn": "string", "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "latestCampaignUpdate": { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "minProvisionedTPS": number, "solutionVersionArn": "string", "status": "string" }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [campaign](#API_DescribeCampaign_ResponseSyntax) ** `latestCampaignUpdate` フィールドは、キャンペーンで少なくとも 1 回の `UpdateCampaign` 呼び出しがあった場合にのみ返されます。キャンペーンのプロパティ。 `latestCampaignUpdate` フィールドは、キャンペーンで少なくとも 1 回の `UpdateCampaign` 呼び出しがあった場合にのみ返されます。型: [Campaign](API_Campaign.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeCampaign) # DescribeDataDeletionJob [CreateDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataDeletionJob.html) によって作成されたデータ削除ジョブについて、ジョブのステータスを含めて説明します。 ## リクエストの構文 ``` { "dataDeletionJobArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [dataDeletionJobArn](#API_DescribeDataDeletionJob_RequestSyntax) ** データ削除ジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "dataDeletionJob": { "creationDateTime": number, "dataDeletionJobArn": "string", "datasetGroupArn": "string", "dataSource": { "dataLocation": "string" }, "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "numDeleted": number, "roleArn": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [dataDeletionJob](#API_DescribeDataDeletionJob_ResponseSyntax) ** ステータスを含む、データ削除ジョブに関する情報。ステータスは、次のいずれかの値です。 + 保留中 + IN\$1PROGRESS + COMPLETED + FAILED 型: [DataDeletionJob](API_DataDeletionJob.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataDeletionJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataDeletionJob) # DescribeDataset 特定のデータセットの記述を表示します。データセットについての詳細は、「[CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)」を参照してください。 ## リクエストの構文 ``` { "datasetArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetArn](#API_DescribeDataset_RequestSyntax) ** 記述するデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "dataset": { "creationDateTime": number, "datasetArn": "string", "datasetGroupArn": "string", "datasetType": "string", "lastUpdatedDateTime": number, "latestDatasetUpdate": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "schemaArn": "string", "status": "string" }, "name": "string", "schemaArn": "string", "status": "string", "trackingId": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [dataset](#API_DescribeDataset_ResponseSyntax) ** データセットのプロパティのリスト。型: [Dataset](API_Dataset.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDataset) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataset) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataset) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataset) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataset) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataset) # DescribeDatasetExportJob [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html) によって作成されたデータセットのエクスポートジョブについて、エクスポートジョブのステータスを含めて記述します。 ## リクエストの構文 ``` { "datasetExportJobArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetExportJobArn](#API_DescribeDatasetExportJob_RequestSyntax) ** 記述するデータセットのエクスポートジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "datasetExportJob": { "creationDateTime": number, "datasetArn": "string", "datasetExportJobArn": "string", "failureReason": "string", "ingestionMode": "string", "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "lastUpdatedDateTime": number, "roleArn": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetExportJob](#API_DescribeDatasetExportJob_ResponseSyntax) ** ステータスを含む、データセットのエクスポートジョブに関する情報。ステータスは、次のいずれかの値です。 + CREATE PENDING + CREATE IN\$1PROGRESS + アクティブ + CREATE FAILED 型: [DatasetExportJob](API_DatasetExportJob.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetExportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetExportJob) # DescribeDatasetGroup 特定のデータセットグループを記述します。データセットグループについての詳細は、「[CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html)」を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_DescribeDatasetGroup_RequestSyntax) ** 記述するデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "datasetGroup": { "creationDateTime": number, "datasetGroupArn": "string", "domain": "string", "failureReason": "string", "kmsKeyArn": "string", "lastUpdatedDateTime": number, "name": "string", "roleArn": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetGroup](#API_DescribeDatasetGroup_ResponseSyntax) ** データセットグループのプロパティのリスト。型: [DatasetGroup](API_DatasetGroup.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetGroup) # DescribeDatasetImportJob [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html) によって作成されたデータセットのインポートジョブについて、インポートジョブのステータスを含めて記述します。 ## リクエストの構文 ``` { "datasetImportJobArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetImportJobArn](#API_DescribeDatasetImportJob_RequestSyntax) ** 記述するデータセットのインポートジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "datasetImportJob": { "creationDateTime": number, "datasetArn": "string", "datasetImportJobArn": "string", "dataSource": { "dataLocation": "string" }, "failureReason": "string", "importMode": "string", "jobName": "string", "lastUpdatedDateTime": number, "publishAttributionMetricsToS3": boolean, "roleArn": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetImportJob](#API_DescribeDatasetImportJob_ResponseSyntax) ** ステータスを含む、データセットのインポートジョブに関する情報。ステータスは、次のいずれかの値です。 + CREATE PENDING + CREATE IN\$1PROGRESS + アクティブ + CREATE FAILED 型: [DatasetImportJob](API_DatasetImportJob.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetImportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetImportJob) # DescribeEventTracker イベントトラッカーの説明を記述します。レスポンスには、イベントトラッカーの `trackingId` と `status` が含まれます。イベントトラッカーについての詳細は、「[CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)」を参照してください。 ## リクエストの構文 ``` { "eventTrackerArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [eventTrackerArn](#API_DescribeEventTracker_RequestSyntax) ** 記述するイベントトラッカーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "eventTracker": { "accountId": "string", "creationDateTime": number, "datasetGroupArn": "string", "eventTrackerArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string", "trackingId": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [eventTracker](#API_DescribeEventTracker_ResponseSyntax) ** イベントトラッカーを記述するオブジェクトです。型: [EventTracker](API_EventTracker.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeEventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeEventTracker) # DescribeFeatureTransformation 特定の特徴変換を記述します。 ## リクエストの構文 ``` { "featureTransformationArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [featureTransformationArn](#API_DescribeFeatureTransformation_RequestSyntax) ** 記述する特徴変換の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "featureTransformation": { "creationDateTime": number, "defaultParameters": { "string" : "string" }, "featureTransformationArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [featureTransformation](#API_DescribeFeatureTransformation_ResponseSyntax) ** FeatureTransformation プロパティのリスト。型: [FeatureTransformation](API_FeatureTransformation.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFeatureTransformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFeatureTransformation) # DescribeFilter フィルターのプロパティを記述します。 ## リクエストの構文 ``` { "filterArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [filterArn](#API_DescribeFilter_RequestSyntax) ** 記述するフィルターの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "filter": { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "filterArn": "string", "filterExpression": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [filter](#API_DescribeFilter_ResponseSyntax) ** フィルターの詳細。型: [Filter](API_Filter.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeFilter) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFilter) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFilter) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFilter) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFilter) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFilter) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFilter) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFilter) # DescribeMetricAttribution メトリクス属性について説明します。 ## リクエストの構文 ``` { "metricAttributionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [metricAttributionArn](#API_DescribeMetricAttribution_RequestSyntax) ** メトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "metricAttribution": { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "lastUpdatedDateTime": number, "metricAttributionArn": "string", "metricsOutputConfig": { "roleArn": "string", "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "name": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [metricAttribution](#API_DescribeMetricAttribution_ResponseSyntax) ** メトリックス属性の詳細。型: [MetricAttribution](API_MetricAttribution.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeMetricAttribution) # DescribeRecipe レシピを説明を記述します。レシピには 3 つのアイテムが含まれています。 + モデルをトレーニングするアルゴリズム。 + トレーニングを統制するハイパーパラメータ。 + トレーニング前に入力データを変更するための特徴変換に関する情報。 Amazon Personalize は、事前定義された一連のレシピを提供します。[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) API を使用してソリューションを作成するときに、レシピを指定します。`CreateSolution` は、指定されたレシピのアルゴリズムとトレーニングデータセットを使用してモデルをトレーニングします。ソリューションをキャンペーンとしてデプロイすると、[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) API を使用してレコメンデーションを提供できます。 ## リクエストの構文 ``` { "recipeArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [recipeArn](#API_DescribeRecipe_RequestSyntax) ** 記述するレシピの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "recipe": { "algorithmArn": "string", "creationDateTime": number, "description": "string", "featureTransformationArn": "string", "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "recipeType": "string", "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [recipe](#API_DescribeRecipe_ResponseSyntax) ** レシピを記述するオブジェクト。型: [Recipe](API_Recipe.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecipe) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecipe) # DescribeRecommender ステータスを含む、特定のレコメンダーを記述します。レコメンダーは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS `status` が `CREATE FAILED` の場合、レスポンスには理由を記述する `failureReason` キーが含まれます。レコメンダーを作成または削除しているときは、`modelMetrics` キーは null になります。レコメンダーの詳細については、[CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html) を参照してください。 ## リクエストの構文 ``` { "recommenderArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [recommenderArn](#API_DescribeRecommender_RequestSyntax) ** 記述するレコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "recommender": { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "lastUpdatedDateTime": number, "latestRecommenderUpdate": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" }, "modelMetrics": { "string" : number }, "name": "string", "recipeArn": "string", "recommenderArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [recommender](#API_DescribeRecommender_ResponseSyntax) ** レコメンダーのプロパティ。型: [Recommender](API_Recommender.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecommender) # DescribeSchema スキーマの説明を記述します。スキーマについての詳細は、「[CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html)」を参照してください。 ## リクエストの構文 ``` { "schemaArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [schemaArn](#API_DescribeSchema_RequestSyntax) ** 取得するスキーマの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "schema": { "creationDateTime": number, "domain": "string", "lastUpdatedDateTime": number, "name": "string", "schema": "string", "schemaArn": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [schema](#API_DescribeSchema_ResponseSyntax) ** リクエストされたスキーマ。型: [DatasetSchema](API_DatasetSchema.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSchema) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSchema) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSchema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSchema) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSchema) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSchema) # DescribeSolution ソリューションの説明を記述します。詳細については、「[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)」を参照してください。 ## リクエストの構文 ``` { "solutionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [solutionArn](#API_DescribeSolution_RequestSyntax) ** 記述するソリューションの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "solution": { "autoMLResult": { "bestRecipeArn": "string" }, "creationDateTime": number, "datasetGroupArn": "string", "eventType": "string", "lastUpdatedDateTime": number, "latestSolutionUpdate": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "performAutoTraining": boolean, "performIncrementalUpdate": boolean, "solutionUpdateConfig": { "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] } }, "status": "string" }, "latestSolutionVersion": { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string", "trainingMode": "string", "trainingType": "string" }, "name": "string", "performAutoML": boolean, "performAutoTraining": boolean, "performHPO": boolean, "performIncrementalUpdate": boolean, "recipeArn": "string", "solutionArn": "string", "solutionConfig": { "algorithmHyperParameters": { "string" : "string" }, "autoMLConfig": { "metricName": "string", "recipeList": [ "string" ] }, "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] }, "eventValueThreshold": "string", "featureTransformationParameters": { "string" : "string" }, "hpoConfig": { "algorithmHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ] }, "hpoObjective": { "metricName": "string", "metricRegex": "string", "type": "string" }, "hpoResourceConfig": { "maxNumberOfTrainingJobs": "string", "maxParallelTrainingJobs": "string" } }, "optimizationObjective": { "itemAttribute": "string", "objectiveSensitivity": "string" }, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [solution](#API_DescribeSolution_ResponseSyntax) ** ソリューションを記述するオブジェクト。型: [Solution](API_Solution.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSolution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolution) # DescribeSolutionVersion ソリューションの特定のバージョンを記述します。詳細については、「[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)」を参照してください。 ## リクエストの構文 ``` { "solutionVersionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [solutionVersionArn](#API_DescribeSolutionVersion_RequestSyntax) ** ソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "solutionVersion": { "creationDateTime": number, "datasetGroupArn": "string", "eventType": "string", "failureReason": "string", "lastUpdatedDateTime": number, "name": "string", "performAutoML": boolean, "performHPO": boolean, "performIncrementalUpdate": boolean, "recipeArn": "string", "solutionArn": "string", "solutionConfig": { "algorithmHyperParameters": { "string" : "string" }, "autoMLConfig": { "metricName": "string", "recipeList": [ "string" ] }, "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] }, "eventValueThreshold": "string", "featureTransformationParameters": { "string" : "string" }, "hpoConfig": { "algorithmHyperParameterRanges": { "categoricalHyperParameterRanges": [ { "name": "string", "values": [ "string" ] } ], "continuousHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ], "integerHyperParameterRanges": [ { "maxValue": number, "minValue": number, "name": "string" } ] }, "hpoObjective": { "metricName": "string", "metricRegex": "string", "type": "string" }, "hpoResourceConfig": { "maxNumberOfTrainingJobs": "string", "maxParallelTrainingJobs": "string" } }, "optimizationObjective": { "itemAttribute": "string", "objectiveSensitivity": "string" }, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "solutionVersionArn": "string", "status": "string", "trainingHours": number, "trainingMode": "string", "trainingType": "string", "tunedHPOParams": { "algorithmHyperParameters": { "string" : "string" } } } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [solutionVersion](#API_DescribeSolutionVersion_ResponseSyntax) ** ソリューションバージョン。型: [SolutionVersion](API_SolutionVersion.md) オブジェクト ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolutionVersion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolutionVersion) # GetSolutionMetrics 指定されたソリューションバージョンのメトリクスを取得します。 ## リクエストの構文 ``` { "solutionVersionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [solutionVersionArn](#API_GetSolutionMetrics_RequestSyntax) ** メトリクスを取得するソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "metrics": { "string" : number }, "solutionVersionArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [metrics](#API_GetSolutionMetrics_ResponseSyntax) ** ソリューションバージョンのメトリクス。詳細については、[[メトリクスを使用してソリューションバージョンを評価する](https://docs.aws.amazon.com/personalize/latest/dg/working-with-training-metrics.html)]を参照してください。タイプ: ダブルマップへの文字列。マップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。 ** [solutionVersionArn](#API_GetSolutionMetrics_ResponseSyntax) ** リクエストで指定されたものと同じソリューションバージョン ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/GetSolutionMetrics) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/GetSolutionMetrics) # ListBatchInferenceJobs ソリューションバージョンから実行されたバッチ推論ジョブのリストを取得します。 ## リクエストの構文 ``` { "maxResults": number, "nextToken": "string", "solutionVersionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [maxResults](#API_ListBatchInferenceJobs_RequestSyntax) ** 各ページで返されるバッチ推論ジョブの結果の最大数。デフォルト値は 100 です。型: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListBatchInferenceJobs_RequestSyntax) ** 次の結果ページを要求するためのトークン。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ** [solutionVersionArn](#API_ListBatchInferenceJobs_RequestSyntax) ** バッチ推論ジョブが作成されたソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## レスポンスの構文 ``` { "batchInferenceJobs": [ { "batchInferenceJobArn": "string", "batchInferenceJobMode": "string", "creationDateTime": number, "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [batchInferenceJobs](#API_ListBatchInferenceJobs_ResponseSyntax) ** 返される各ジョブに関する情報を含むリスト。型: [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListBatchInferenceJobs_ResponseSyntax) ** 次の結果ページの取得に使用するトークン。返される結果がそれ以上存在しない場合、値は `null` になります。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchInferenceJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchInferenceJobs) # ListBatchSegmentJobs 指定したソリューションバージョンから実行されたバッチセグメントジョブのリストを取得します。 ## リクエストの構文 ``` { "maxResults": number, "nextToken": "string", "solutionVersionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [maxResults](#API_ListBatchSegmentJobs_RequestSyntax) ** 各ページで返されるバッチセグメントジョブの結果の最大数。デフォルト値は 100 です。型: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListBatchSegmentJobs_RequestSyntax) ** 次の結果ページを要求するためのトークン。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ** [solutionVersionArn](#API_ListBatchSegmentJobs_RequestSyntax) ** バッチセグメントジョブがバッチセグメントを生成するために使用したソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## レスポンスの構文 ``` { "batchSegmentJobs": [ { "batchSegmentJobArn": "string", "creationDateTime": number, "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [batchSegmentJobs](#API_ListBatchSegmentJobs_ResponseSyntax) ** 返される各ジョブに関する情報を含むリスト。型: [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListBatchSegmentJobs_ResponseSyntax) ** 次の結果ページの取得に使用するトークン。返される結果がそれ以上存在しない場合、値は `null` になります。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchSegmentJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchSegmentJobs) # ListCampaigns 特定のソリューションを使用するキャンペーンのリストを返します。ソリューションが指定されていない場合、アカウントに関連付けられているすべてのキャンペーンが一覧表示されます。レスポンスは、Amazon リソースネーム (ARN) など、各キャンペーンのプロパティを提供します。キャンペーンの作成の詳細については、「[CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html)」を参照してください。 ## リクエストの構文 ``` { "maxResults": number, "nextToken": "string", "solutionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [maxResults](#API_ListCampaigns_RequestSyntax) ** 返されるキャンペーンの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListCampaigns_RequestSyntax) ** キャンペーンの次のセットを取得するために、[ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) に対する前の呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ** [solutionArn](#API_ListCampaigns_RequestSyntax) ** キャンペーンを一覧表示するソリューションの Amazon リソースネーム (ARN)。ソリューションが指定されていない場合、アカウントに関連付けられているすべてのキャンペーンが一覧表示されます。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## レスポンスの構文 ``` { "campaigns": [ { "campaignArn": "string", "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [campaigns](#API_ListCampaigns_ResponseSyntax) ** キャンペーンのリスト。型: [CampaignSummary](API_CampaignSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListCampaigns_ResponseSyntax) ** キャンペーンの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListCampaigns) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListCampaigns) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListCampaigns) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListCampaigns) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListCampaigns) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListCampaigns) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListCampaigns) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListCampaigns) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListCampaigns) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListCampaigns) # ListDataDeletionJobs データセットグループのデータ削除ジョブのリストを、作成時刻順に新しいものから順に返します。データセットグループが指定されていない場合、アカウントに関連付けられているすべてのデータ削除ジョブが一覧表示されます。レスポンスは、Amazon リソースネーム (ARN) など、各ジョブのプロパティを提供します。データ削除ジョブの詳細については、「[ユーザーの削除](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)」を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_ListDataDeletionJobs_RequestSyntax) ** データ削除ジョブを一覧表示するデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListDataDeletionJobs_RequestSyntax) ** 返されるデータセットのデータ削除ジョブの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListDataDeletionJobs_RequestSyntax) ** ジョブの次のセットを取得するために、前の `ListDataDeletionJobs` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "dataDeletionJobs": [ { "creationDateTime": number, "dataDeletionJobArn": "string", "datasetGroupArn": "string", "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [dataDeletionJobs](#API_ListDataDeletionJobs_ResponseSyntax) ** データ削除ジョブのリスト。型: [DataDeletionJobSummary](API_DataDeletionJobSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListDataDeletionJobs_ResponseSyntax) ** データ削除ジョブの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDataDeletionJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDataDeletionJobs) # ListDatasetExportJobs 特定のデータセットを使用するデータセットのエクスポートジョブのリストを返します。データセットが指定されていない場合、アカウントに関連付けられているすべてのデータセットのエクスポートジョブが一覧表示されます。レスポンスは、Amazon リソースネーム (ARN) など、データセットの各エクスポートジョブのプロパティを提供します。データセットのエクスポートジョブについての詳細は、「[CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html)」を参照してください。詳細については、[[CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)]を参照してください。 ## リクエストの構文 ``` { "datasetArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetArn](#API_ListDatasetExportJobs_RequestSyntax) ** データセットのエクスポートジョブを一覧表示するデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListDatasetExportJobs_RequestSyntax) ** 返されるデータセットのエクスポートジョブの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListDatasetExportJobs_RequestSyntax) ** データセットのエクスポートジョブの次のセットを取得するために、前の `ListDatasetExportJobs` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "datasetExportJobs": [ { "creationDateTime": number, "datasetExportJobArn": "string", "failureReason": "string", "jobName": "string", "lastUpdatedDateTime": number, "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetExportJobs](#API_ListDatasetExportJobs_ResponseSyntax) ** データセットのエクスポートジョブのリスト。型: [DatasetExportJobSummary](API_DatasetExportJobSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListDatasetExportJobs_ResponseSyntax) ** データセットのエクスポートジョブの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetExportJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetExportJobs) # ListDatasetGroups データセットグループのリストを返します。レスポンスは、Amazon リソースネーム (ARN) など、各データセットグループのプロパティを提供します。データセットグループとデータセットの作成については、「[CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html)」を参照してください。 ## リクエストの構文 ``` { "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [maxResults](#API_ListDatasetGroups_RequestSyntax) ** 返されるデータセットグループの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListDatasetGroups_RequestSyntax) ** データセットグループの次のセットを取得するために、前の `ListDatasetGroups` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "datasetGroups": [ { "creationDateTime": number, "datasetGroupArn": "string", "domain": "string", "failureReason": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetGroups](#API_ListDatasetGroups_ResponseSyntax) ** データセットグループのリスト。型: [DatasetGroupSummary](API_DatasetGroupSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListDatasetGroups_ResponseSyntax) ** データセットグループの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetGroups) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetGroups) # ListDatasetImportJobs 特定のデータセットを使用するデータセットのインポートジョブのリストを返します。データセットが指定されていない場合、アカウントに関連付けられているすべてのデータセットのインポートジョブが一覧表示されます。レスポンスは、Amazon リソースネーム (ARN) など、データセットの各インポートジョブのプロパティを提供します。データセットのインポートジョブについての詳細は、「[CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)」を参照してください。詳細については、「[CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)」を参照してください。 ## リクエストの構文 ``` { "datasetArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetArn](#API_ListDatasetImportJobs_RequestSyntax) ** データセットのインポートジョブを一覧表示するデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListDatasetImportJobs_RequestSyntax) ** 返されるデータセットのインポートジョブの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListDatasetImportJobs_RequestSyntax) ** データセットのインポートジョブの次のセットを取得するために、前の `ListDatasetImportJobs` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "datasetImportJobs": [ { "creationDateTime": number, "datasetImportJobArn": "string", "failureReason": "string", "importMode": "string", "jobName": "string", "lastUpdatedDateTime": number, "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetImportJobs](#API_ListDatasetImportJobs_ResponseSyntax) ** データセットのインポートジョブのリスト。型: [DatasetImportJobSummary](API_DatasetImportJobSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListDatasetImportJobs_ResponseSyntax) ** データセットのインポートジョブの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetImportJobs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetImportJobs) # ListDatasets 特定のデータセットグループに含まれるデータセットのリストを返します。レスポンスは、Amazon リソースネーム (ARN) など、各データセットのプロパティを提供します。詳細については、「[CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)」を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_ListDatasets_RequestSyntax) ** 一覧表示するデータセットを含むデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListDatasets_RequestSyntax) ** 返されるデータセットの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListDatasets_RequestSyntax) ** データセットのインポートジョブの次のセットを取得するために、前の `ListDatasets` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "datasets": [ { "creationDateTime": number, "datasetArn": "string", "datasetType": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasets](#API_ListDatasets_ResponseSyntax) ** `Dataset` オブジェクトの配列。各オブジェクトはメタデータ情報を提供します。型: [DatasetSummary](API_DatasetSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListDatasets_ResponseSyntax) ** データセットの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasets) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasets) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasets) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasets) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasets) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasets) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasets) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasets) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasets) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasets) # ListEventTrackers アカウントに関連付けられているイベントトラッカーのリストを返します。レスポンスは、Amazon リソースネーム (ARN) や追跡 ID など、各イベントトラッカーのプロパティを提供します。イベントトラッカーについての詳細は、「[CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)」を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_ListEventTrackers_RequestSyntax) ** レスポンスのフィルタリングに使用されるデータセットグループの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListEventTrackers_RequestSyntax) ** 返されるイベントトラッカーの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListEventTrackers_RequestSyntax) ** イベントトラッカーの次のセットを取得するために、前の `ListEventTrackers` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "eventTrackers": [ { "creationDateTime": number, "eventTrackerArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [eventTrackers](#API_ListEventTrackers_ResponseSyntax) ** イベントトラッカーのリスト。型: [EventTrackerSummary](API_EventTrackerSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListEventTrackers_ResponseSyntax) ** イベントトラッカーの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListEventTrackers) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListEventTrackers) # ListFilters 特定のデータセットグループに属するすべてのフィルターを一覧表示します。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_ListFilters_RequestSyntax) ** フィルターを含むデータセットグループの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListFilters_RequestSyntax) ** 返されるフィルターの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListFilters_RequestSyntax) ** フィルターの次のセットを取得するために、前の `ListFilters` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "Filters": [ { "creationDateTime": number, "datasetGroupArn": "string", "failureReason": "string", "filterArn": "string", "lastUpdatedDateTime": number, "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Filters](#API_ListFilters_ResponseSyntax) ** 返されたフィルターのリスト。型: [FilterSummary](API_FilterSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListFilters_ResponseSyntax) ** フィルターの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListFilters) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListFilters) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListFilters) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListFilters) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListFilters) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListFilters) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListFilters) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListFilters) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListFilters) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListFilters) # ListMetricAttributionMetrics メトリクス属性のメトリクスを一覧表示します。 ## リクエストの構文 ``` { "maxResults": number, "metricAttributionArn": "string", "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [maxResults](#API_ListMetricAttributionMetrics_RequestSyntax) ** 結果の 1 ページで返されるメトリクスの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [metricAttributionArn](#API_ListMetricAttributionMetrics_RequestSyntax) ** 属性を取得するメトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [nextToken](#API_ListMetricAttributionMetrics_RequestSyntax) ** 次のページの結果を取得する以前のリクエストによって返される、ページ分割トークンを指定します。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "metrics": [ { "eventType": "string", "expression": "string", "metricName": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [metrics](#API_ListMetricAttributionMetrics_ResponseSyntax) ** 指定されたメトリクス属性のメトリクス。型: [MetricAttribute](API_MetricAttribute.md) オブジェクトの配列配列メンバー: 最大数は 10 項目です。 ** [nextToken](#API_ListMetricAttributionMetrics_ResponseSyntax) ** 次のページの結果を取得する以前の `ListMetricAttributionMetricsResponse` リクエストによって返される、ページ分割トークンを指定します。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributionMetrics) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributionMetrics) # ListMetricAttributions メトリクス属性を一覧表示します。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_ListMetricAttributions_RequestSyntax) ** メトリクス属性のデータセットグループ Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListMetricAttributions_RequestSyntax) ** 結果の 1 ページで返されるメトリクス属性の最大数です。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListMetricAttributions_RequestSyntax) ** 次のページの結果を取得する以前のリクエストによって返される、ページ分割トークンを指定します。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "metricAttributions": [ { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "metricAttributionArn": "string", "name": "string", "status": "string" } ], "nextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [metricAttributions](#API_ListMetricAttributions_ResponseSyntax) ** メトリクス属性のリスト。型: [MetricAttributionSummary](API_MetricAttributionSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ** [nextToken](#API_ListMetricAttributions_ResponseSyntax) ** 次のページの結果を取得する以前のリクエストによって返される、ページ分割トークンを指定します。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributions) # ListRecipes 利用可能なレシピのリストを返します。レスポンスは、レシピの Amazon リソースネーム (ARN) など、各レシピのプロパティを提供します。 ## リクエストの構文 ``` { "domain": "string", "maxResults": number, "nextToken": "string", "recipeProvider": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [domain](#API_ListRecipes_RequestSyntax) ** ドメインデータセットグループのドメインごとに返されたレシピをフィルタリングします。このドメインのレシピ (ドメインデータセットグループのユースケース) のみがレスポンスに含まれます。ドメインを指定しない場合、すべてのレシピが返されます。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** [maxResults](#API_ListRecipes_RequestSyntax) ** 返されるレシピの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListRecipes_RequestSyntax) ** レシピの次のセットを取得するために、前の `ListRecipes` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ** [recipeProvider](#API_ListRecipes_RequestSyntax) ** デフォルトは `SERVICE` です。型: 文字列有効な値：`SERVICE` 必須：いいえ ## レスポンスの構文 ``` { "nextToken": "string", "recipes": [ { "creationDateTime": number, "domain": "string", "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "status": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [nextToken](#API_ListRecipes_ResponseSyntax) ** 次のレシピセットを取得するためのトークン。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ** [recipes](#API_ListRecipes_ResponseSyntax) ** 使用可能なレシピのリスト。型: [RecipeSummary](API_RecipeSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListRecipes) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecipes) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecipes) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecipes) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecipes) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecipes) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecipes) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecipes) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecipes) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecipes) # ListRecommenders 特定のドメインデータセットグループ内のレコメンダーのリストを返します。ドメインデータセットグループが指定されていない場合、アカウントに関連付けられているすべてのレコメンダーが一覧表示されます。レスポンスは、Amazon リソースネーム (ARN) など、各レコメンダーのプロパティを提供します。レコメンダーの詳細については、[CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html) を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_ListRecommenders_RequestSyntax) ** レコメンダーを一覧表示するドメインデータセットグループの Amazon リソースネーム (ARN)。ドメインデータセットグループが指定されていない場合、アカウントに関連付けられているすべてのレコメンダーが一覧表示されます。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListRecommenders_RequestSyntax) ** 返されるレコメンダーの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListRecommenders_RequestSyntax) ** レコメンダーの次のセットを取得するために、前の `ListRecommenders` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "nextToken": "string", "recommenders": [ { "creationDateTime": number, "datasetGroupArn": "string", "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "recommenderArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [nextToken](#API_ListRecommenders_ResponseSyntax) ** レコメンダーの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ** [recommenders](#API_ListRecommenders_ResponseSyntax) ** レコメンダーのリスト。型: [RecommenderSummary](API_RecommenderSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListRecommenders) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecommenders) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecommenders) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecommenders) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecommenders) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecommenders) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecommenders) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecommenders) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecommenders) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecommenders) # ListSchemas アカウントに関連付けられているスキーマのリストを返します。レスポンスは、Amazon リソースネーム (ARN) など、各スキーマのプロパティを提供します。スキーマについての詳細は、「[CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html)」を参照してください。 ## リクエストの構文 ``` { "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [maxResults](#API_ListSchemas_RequestSyntax) ** 返されるスキーマの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListSchemas_RequestSyntax) ** スキーマの次のセットを取得するために、前の `ListSchemas` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "nextToken": "string", "schemas": [ { "creationDateTime": number, "domain": "string", "lastUpdatedDateTime": number, "name": "string", "schemaArn": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [nextToken](#API_ListSchemas_ResponseSyntax) ** スキーマの次のセットを取得するために使用するトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ** [schemas](#API_ListSchemas_ResponseSyntax) ** スキーマのリスト。型: [DatasetSchemaSummary](API_DatasetSchemaSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ## エラー ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSchemas) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSchemas) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSchemas) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSchemas) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSchemas) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSchemas) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSchemas) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSchemas) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSchemas) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSchemas) # ListSolutions 特定のデータセットグループのソリューションのリストを返します。データセットグループが指定されていない場合、アカウントに関連付けられているすべてのソリューションが一覧表示されます。レスポンスは、Amazon リソースネーム (ARN) など、各ソリューションのプロパティを提供します。詳細については、「[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)」を参照してください。 ## リクエストの構文 ``` { "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetGroupArn](#API_ListSolutions_RequestSyntax) ** データセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [maxResults](#API_ListSolutions_RequestSyntax) ** 返されるソリューションの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListSolutions_RequestSyntax) ** ソリューションの次のセットを取得するために、前の `ListSolutions` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ## レスポンスの構文 ``` { "nextToken": "string", "solutions": [ { "creationDateTime": number, "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "solutionArn": "string", "status": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [nextToken](#API_ListSolutions_ResponseSyntax) ** ソリューションの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ** [solutions](#API_ListSolutions_ResponseSyntax) ** 現在のソリューションのリスト。型: [SolutionSummary](API_SolutionSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSolutions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutions) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutions) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutions) # ListSolutionVersions 特定のソリューションのソリューションバージョンのリストを返します。ソリューションが指定されていない場合、アカウントに関連付けられているすべてのソリューションバージョンが一覧表示されます。レスポンスは、Amazon リソースネーム (ARN) など、各ソリューションバージョンのプロパティを提供します。 ## リクエストの構文 ``` { "maxResults": number, "nextToken": "string", "solutionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [maxResults](#API_ListSolutionVersions_RequestSyntax) ** 返されるソリューションバージョンの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [nextToken](#API_ListSolutionVersions_RequestSyntax) ** ソリューションバージョンの次のセットを取得するために、前の `ListSolutionVersions` に対する呼び出しから返されたトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` 必須: いいえ ** [solutionArn](#API_ListSolutionVersions_RequestSyntax) ** ソリューションの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## レスポンスの構文 ``` { "nextToken": "string", "solutionVersions": [ { "creationDateTime": number, "failureReason": "string", "lastUpdatedDateTime": number, "solutionVersionArn": "string", "status": "string", "trainingMode": "string", "trainingType": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [nextToken](#API_ListSolutionVersions_ResponseSyntax) ** ソリューションバージョンの次のセットを取得するためのトークン (存在する場合)。タイプ: 文字列長さの制限: 最大長は 1500 です。パターン: `\p{ASCII}{0,1500}` ** [solutionVersions](#API_ListSolutionVersions_ResponseSyntax) ** バージョンのプロパティを記述するソリューションバージョンのリスト。型: [SolutionVersionSummary](API_SolutionVersionSummary.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** InvalidNextTokenException ** トークンが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutionVersions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutionVersions) # ListTagsForResource リソースに添付されている[タグ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)のリストを取得します。 ## リクエストの構文 ``` { "resourceArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) ** リソースの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [tags](#API_ListTagsForResource_ResponseSyntax) ** リソースのタグ。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListTagsForResource) # StartRecommender 非アクティブなレコメンダーを起動します。レコメンダーを起動しても新しいモデルは作成されませんが、レコメンダーへの請求と自動再トレーニングが再開されます。 ## リクエストの構文 ``` { "recommenderArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [recommenderArn](#API_StartRecommender_RequestSyntax) ** 起動するレコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "recommenderArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [recommenderArn](#API_StartRecommender_ResponseSyntax) ** 起動したレコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StartRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StartRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StartRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StartRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StartRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StartRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StartRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StartRecommender) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StartRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StartRecommender) # StopRecommender アクティブなレコメンダーを停止します。レコメンダーを停止すると、レコメンダーへの請求と自動再トレーニングが停止します。 ## リクエストの構文 ``` { "recommenderArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [recommenderArn](#API_StopRecommender_RequestSyntax) ** 停止するレコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "recommenderArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [recommenderArn](#API_StopRecommender_ResponseSyntax) ** 停止したレコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StopRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopRecommender) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopRecommender) # StopSolutionVersionCreation CREATE\$1PENDING または CREATE IN\$1PROGRESS の状態にあるソリューションバージョンの作成を停止します。ソリューションバージョンの現在の状態に応じて、ソリューションバージョンの状態は次のように変化します。 + CREATE\$1PENDING > CREATE\$1STOPPED または + CREATE\$1IN\$1PROGRESS > CREATE\$1STOPPING > CREATE\$1STOPPED ソリューションバージョンの作成を停止するまでに完了したすべてのトレーニングについて請求されます。停止したソリューションバージョンの作成を再開することはできません。 ## リクエストの構文 ``` { "solutionVersionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [solutionVersionArn](#API_StopSolutionVersionCreation_RequestSyntax) ** 作成を停止するソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopSolutionVersionCreation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopSolutionVersionCreation) # TagResource リソースにタグのリストを追加します。 ## リクエストの構文 ``` { "resourceArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [resourceArn](#API_TagResource_RequestSyntax) ** リソースの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [tags](#API_TagResource_RequestSyntax) ** リソースに適用するタグ。詳細については、「[Amazon Personalize のリソースにタグ付けする](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)」を参照してください。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagsException ** このリソースに適用できるタグの最大数を超過しています。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/TagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/TagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/TagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/TagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/TagResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TagResource) # UntagResource リソースにアタッチされている指定したタグを削除します。詳細については、「[Amazon Personalize リソースからタグを削除する](https://docs.aws.amazon.com/personalize/latest/dg/tags-remove.html)」を参照してください。 ## リクエストの構文 ``` { "resourceArn": "string", "tagKeys": [ "string" ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [resourceArn](#API_UntagResource_RequestSyntax) ** リソースの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [tagKeys](#API_UntagResource_RequestSyntax) ** 削除するタグのキー。型: 文字列の配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。長さの制限：最小長 1、最大長は 128 です。パターン: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ** TooManyTagKeysException ** リクエストには、リソースに関連付けることができる数よりも多くのタグキーが含まれています (リソースごとに 50 個のタグキー)。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UntagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UntagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UntagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UntagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UntagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UntagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UntagResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UntagResource) # UpdateCampaign 既存のキャンペーンで再トレーニングされたソリューションバージョンをデプロイするためにキャンペーンを更新し、キャンペーンの `minProvisionedTPS` を変更し、またはキャンペーンの構成を変更します。例えば、既存のキャンペーンに対して `enableMetadataWithRecommendations` を true に設定できます。最新のソリューションバージョンを使用してキャンペーンを自動的に開始するように更新するには、以下を指定します。 + `SolutionVersionArn` パラメータには、ソリューションの Amazon リソースネーム (ARN) を `SolutionArn/$LATEST` 形式で指定します。 + `campaignConfig` で、`syncWithLatestSolutionVersion` を `true` に設定します。キャンペーンを更新するには、キャンペーンのステータスが ACTIVE または CREATE FAILED である必要があります。[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) オペレーションを使用してキャンペーンのステータスを確認します。 **注記** 更新の進行中でも、キャンペーンからレコメンデーションを取得できます。最新のキャンペーン更新ステータスが `Active` になるまで、キャンペーンは以前のソリューションバージョンとキャンペーン設定を使用してレコメンデーションを生成します。コードサンプルなど、キャンペーンの更新について詳しくは、「[キャンペーンの更新](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html)」を参照してください。キャンペーンの作成について詳細は、「キャンペーンの作成」を参照してください。 ## リクエストの構文 ``` { "campaignArn": "string", "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "solutionVersionArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [campaignArn](#API_UpdateCampaign_RequestSyntax) ** キャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) ** キャンペーンの設定の詳細。型: [CampaignConfig](API_CampaignConfig.md) オブジェクト必須: いいえ ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) ** Amazon Personalize がサポートする、リクエストされた 1 秒あたりの最小プロビジョンドトランザクション (推奨) を指定します。`minProvisionedTPS` を高く設定すると請求額が増加します。最初は `minProvisionedTPS` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。タイプ: 整数有効な範囲: 最小値は 1 です。必須: いいえ ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) ** デプロイする新しいモデルの Amazon リソースネーム (ARN)。ソリューションの最新バージョンを指定するには、*ソリューション*の ARN を `SolutionArn/$LATEST` 形式で指定します。[CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html) で `syncWithLatestSolutionVersion` を `True` に設定する場合は、この形式を使用する必要があります。ソリューションの最新バージョンではないモデルをデプロイするには、ソリューションバージョンの ARN を指定します。キャンペーンの自動更新の詳細については、「[キャンペーンの自動更新を有効にする](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## レスポンスの構文 ``` { "campaignArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) ** リクエストで指定されたものと同じキャンペーン ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign) # UpdateDataset データセットを更新して、そのスキーマを新しいスキーマまたは既存のスキーマに置き換えます。詳細については、「[データセットのスキーマの置き換え](https://docs.aws.amazon.com/personalize/latest/dg/updating-dataset-schema.html)」を参照してください。 ## リクエストの構文 ``` { "datasetArn": "string", "schemaArn": "string" } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [datasetArn](#API_UpdateDataset_RequestSyntax) ** 更新するデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [schemaArn](#API_UpdateDataset_RequestSyntax) ** 使用するデータセットのAmazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` { "datasetArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [datasetArn](#API_UpdateDataset_ResponseSyntax) ** 更新したデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateDataset) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateDataset) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateDataset) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateDataset) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateDataset) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateDataset) # UpdateMetricAttribution メトリクス属性を更新します。 ## リクエストの構文 ``` { "addMetrics": [ { "eventType": "string", "expression": "string", "metricName": "string" } ], "metricAttributionArn": "string", "metricsOutputConfig": { "roleArn": "string", "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "removeMetrics": [ "string" ] } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [addMetrics](#API_UpdateMetricAttribution_RequestSyntax) ** メトリクス属性に新しいメトリック属性を追加します。型: [MetricAttribute](API_MetricAttribute.md) オブジェクトの配列配列メンバー: 最大数は 10 項目です。必須: いいえ ** [metricAttributionArn](#API_UpdateMetricAttribution_RequestSyntax) ** 更新するメトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [metricsOutputConfig](#API_UpdateMetricAttribution_RequestSyntax) ** メトリクス属性の出力設定。型: [MetricAttributionOutput](API_MetricAttributionOutput.md) オブジェクト必須: いいえ ** [removeMetrics](#API_UpdateMetricAttribution_RequestSyntax) ** メトリクス属性からメトリクス属性を削除します。型: 文字列の配列配列メンバー: 最大数は 10 項目です。長さの制約: 最大長は 256 です。必須: いいえ ## レスポンスの構文 ``` { "metricAttributionArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [metricAttributionArn](#API_UpdateMetricAttribution_ResponseSyntax) ** 更新するメトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** 指定したリソースはすでに存在しています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateMetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateMetricAttribution) # UpdateRecommender レコメンダーを更新して、レコメンダーの設定を変更します。レコメンダーを更新してトレーニングに使用した列を変更すると、Amazon Personalize はレコメンダーを裏付けるモデルの完全な再トレーニングを自動的に開始します。更新が完了しても、レコメンダーからレコメンデーションを取得できます。レコメンダーは、更新が完了するまで以前の設定を使用します。この更新のステータスを追跡するには、[DescribeRecommender ](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) オペレーションで返された `latestRecommenderUpdate` を使用します。 ## リクエストの構文 ``` { "recommenderArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } } } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [recommenderArn](#API_UpdateRecommender_RequestSyntax) ** 変更するレコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [recommenderConfig](#API_UpdateRecommender_RequestSyntax) ** レコメンダーの設定の詳細。型: [RecommenderConfig](API_RecommenderConfig.md) オブジェクト必須: はい ## レスポンスの構文 ``` { "recommenderArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [recommenderArn](#API_UpdateRecommender_ResponseSyntax) ** リクエストで指定されたものと同じレコメンダー Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateRecommender) # UpdateSolution Amazon Personalize ソリューションを更新して、別の自動トレーニング設定を使用します。ソリューションを更新するときに、ソリューションが自動トレーニングを使用するかどうかを変更したり、トレーニング頻度を変更したりできます。ソリューションの更新の詳細については、「[ソリューションの更新](https://docs.aws.amazon.com/personalize/latest/dg/updating-solution.html)」を参照してください。ソリューションの更新は、次に示す状態のいずれかになります。 CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED ソリューションの更新のステータスを取得するには、[DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API オペレーションを呼び出し、`latestSolutionUpdate` でステータスを確認します。 ## リクエストの構文 ``` { "performAutoTraining": boolean, "performIncrementalUpdate": boolean, "solutionArn": "string", "solutionUpdateConfig": { "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] } } } ``` ## リクエストパラメーターリクエストは以下のデータを JSON 形式で受け入れます。 ** [performAutoTraining](#API_UpdateSolution_RequestSyntax) ** ソリューションが自動トレーニングを使用して新しいソリューションバージョン (トレーニング済みモデル) を作成するかどうか。ソリューション設定の一部として `AutoTrainingConfig` で `schedulingExpression` を指定することで、トレーニング頻度を変更できます。自動トレーニングを有効にすると、ソリューションの更新が完了してから 1 時間以内に最初の自動トレーニングが開始されます。1 時間以内にソリューションバージョンを手動で作成した場合、ソリューションは最初の自動トレーニングをスキップします。自動トレーニングの詳細については、「[自動トレーニングの設定](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)」を参照してください。トレーニングが開始されると、[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API オペレーションを使用してソリューションバージョンの Amazon リソースネーム (ARN) を取得できます。ステータスを取得するには、[DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) を使用します。タイプ: ブール値必須: いいえ ** [performIncrementalUpdate](#API_UpdateSolution_RequestSyntax) ** モデルで増分トレーニング更新を実行するかどうか。これにより、モデルは完全な再トレーニングを必要とせずに新しいデータからより頻繁に学習できるため、ほぼリアルタイムのパーソナライゼーションが可能になります。このパラメータは、セマンティック類似度レシピを使用するソリューションでのみサポートされます。タイプ: ブール値必須: いいえ ** [solutionArn](#API_UpdateSolution_RequestSyntax) ** 更新するソリューションの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [solutionUpdateConfig](#API_UpdateSolution_RequestSyntax) ** ソリューションの新しい設定の詳細。型: [SolutionUpdateConfig](API_SolutionUpdateConfig.md) オブジェクト必須: いいえ ## レスポンスの構文 ``` { "solutionArn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [solutionArn](#API_UpdateSolution_ResponseSyntax) ** リクエストで指定されたものと同じソリューション Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** LimitExceededException ** 1 秒あたりのリクエスト数の上限を超えています。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateSolution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateSolution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateSolution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateSolution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateSolution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateSolution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateSolution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateSolution) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateSolution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateSolution) # Amazon Personalize Events 次のアクションは、Amazon Personalize Events でサポートされています。 + [PutActionInteractions](API_UBS_PutActionInteractions.md) + [PutActions](API_UBS_PutActions.md) + [PutEvents](API_UBS_PutEvents.md) + [PutItems](API_UBS_PutItems.md) + [PutUsers](API_UBS_PutUsers.md) # PutActionInteractions アクションインタラクションのイベントデータを記録します。アクションインタラクションイベントは、ユーザーとアクションの間のインタラクションです。****例えば、ユーザーがメンバーシッププログラムへの登録やアプリのダウンロードなどのアクションを実行する場合です。アクションインタラクションの記録の詳細については、「[アクションインタラクションイベントの記録](https://docs.aws.amazon.com/personalize/latest/dg/recording-action-interaction-events.html)」を参照してください。アクションデータセット内のアクションの詳細については、「[Actions dataset](https://docs.aws.amazon.com/personalize/latest/dg/actions-datasets.html)」を参照してください。 ## リクエストの構文 ``` POST /action-interactions HTTP/1.1 Content-type: application/json { "actionInteractions": [ { "actionId": "string", "eventId": "string", "eventType": "string", "impression": [ "string" ], "properties": "string", "recommendationId": "string", "sessionId": "string", "timestamp": number, "userId": "string" } ], "trackingId": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [actionInteractions](#API_UBS_PutActionInteractions_RequestSyntax) ** セッションからのアクションインタラクションのイベントのリスト。型: [ActionInteraction](API_UBS_ActionInteraction.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。最大数は 10 項目です。必須: はい ** [trackingId](#API_UBS_PutActionInteractions_RequestSyntax) ** アクションインタラクションイベントトラッカーの ID。Action インタラクションデータセットを作成すると、Amazon Personalize は自動的にアクションインタラクションイベントトラッカーを作成します。詳細については、「[Action interaction event tracker ID](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-tracker-id.html)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActionInteractions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActionInteractions) # PutActions 1 つ以上のアクションを Actions データセットに追加します。詳細については、「[Importing actions individually](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html)」を参照してください。 ## リクエストの構文 ``` POST /actions HTTP/1.1 Content-type: application/json { "actions": [ { "actionId": "string", "properties": "string" } ], "datasetArn": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [actions](#API_UBS_PutActions_RequestSyntax) ** アクションデータのリスト。型: [Action](API_UBS_Action.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。最大数は 10 項目です。必須: はい ** [datasetArn](#API_UBS_PutActions_RequestSyntax) ** 1 つまたは複数のアクションを追加する Actions データセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutActions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActions) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActions) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActions) # PutEvents アイテムインタラクションのイベントデータを記録します。詳細については、「[Recording item interaction events](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html)」を参照してください。 **注記** AWS Lambda 関数を使用して PutEvents オペレーションを呼び出す場合、関数の実行ロールには、 `Resource`要素`*`のワイルドカードを使用して`personalize:PutEvents`アクションを実行するアクセス許可が必要です。 ## リクエストの構文 ``` POST /events HTTP/1.1 Content-type: application/json { "eventList": [ { "eventId": "string", "eventType": "string", "eventValue": number, "impression": [ "string" ], "itemId": "string", "metricAttribution": { "eventAttributionSource": "string" }, "properties": "string", "recommendationId": "string", "sentAt": number } ], "sessionId": "string", "trackingId": "string", "userId": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [eventList](#API_UBS_PutEvents_RequestSyntax) ** セッションからのイベントデータのリスト。型: [Event](API_UBS_Event.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。最大数は 10 項目です。必須: はい ** [sessionId](#API_UBS_PutEvents_RequestSyntax) ** ユーザーの訪問に関連付けられたセッション ID。アプリケーションは、ユーザーが最初にウェブサイトにアクセスしたとき、またはアプリケーションを使用したときに、sessionId を生成します。Amazon Personalize は、sessionId を使用して、ユーザーがログインする前にイベントをユーザーに関連付けます。詳細については、「[Recording item interaction events](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** [trackingId](#API_UBS_PutEvents_RequestSyntax) ** イベントの追跡 ID。ID は、[CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) API に対する呼び出しによって生成されます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** [userId](#API_UBS_PutEvents_RequestSyntax) ** イベントに関連付けられているユーザー。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutEvents) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutEvents) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutEvents) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutEvents) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutEvents) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutEvents) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutEvents) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutEvents) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutEvents) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutEvents) # PutItems 1 つ以上のアイテムを Items データセットに追加します。詳細については、「[Importing items individually](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html)」を参照してください。 ## リクエストの構文 ``` POST /items HTTP/1.1 Content-type: application/json { "datasetArn": "string", "items": [ { "itemId": "string", "properties": "string" } ] } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [datasetArn](#API_UBS_PutItems_RequestSyntax) ** 1 つまたは複数のアイテムを追加する Items データセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [items](#API_UBS_PutItems_RequestSyntax) ** アイテムデータのリスト。型: [Item](API_UBS_Item.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。最大数は 10 項目です。必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutItems) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutItems) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutItems) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutItems) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutItems) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutItems) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutItems) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutItems) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutItems) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutItems) # PutUsers 1 名以上のユーザーを Users データセットに追加します。詳細については、「[Importing users individually](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html)」を参照してください。 ## リクエストの構文 ``` POST /users HTTP/1.1 Content-type: application/json { "datasetArn": "string", "users": [ { "properties": "string", "userId": "string" } ] } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [datasetArn](#API_UBS_PutUsers_RequestSyntax) ** 1 名または複数のユーザーを追加する Users データセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [users](#API_UBS_PutUsers_RequestSyntax) ** ユーザーデータのリスト。型: [User](API_UBS_User.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。最大数は 10 項目です。必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceInUseException ** 指定されたリソースは使用中です。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** 指定されたリソースが見つかりませんでした。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutUsers) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutUsers) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutUsers) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutUsers) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutUsers) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutUsers) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutUsers) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutUsers) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutUsers) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutUsers) # Amazon Personalize Runtime 次のアクションは、Amazon Personalize Runtime でサポートされています。 + [GetActionRecommendations](API_RS_GetActionRecommendations.md) + [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) + [GetRecommendations](API_RS_GetRecommendations.md) # GetActionRecommendations 予測スコアで降順にソートされたレコメンデーションアクションのリストを返します。PERSONALIZED\$1ACTIONS レシピでトレーニングされたソリューションバージョンをデプロイするカスタムキャンペーンがある場合は、`GetActionRecommendations` API を使用してください。 PERSONALIZED\$1ACTIONS レシピの詳細については、「[PERSONALIZED\$1ACTIONS recipes](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html)」を参照してください。アクションレコメンデーションの取得については、「[Getting action recommendations](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html)」を参照してください。 ## リクエストの構文 ``` POST /action-recommendations HTTP/1.1 Content-type: application/json { "campaignArn": "string", "filterArn": "string", "filterValues": { "string" : "string" }, "numResults": number, "userId": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) ** アクションレコメンデーションの取得に使用するキャンペーンの Amazon リソースネーム (ARN)。このキャンペーンでは、PERSONALIZED\$1ACTIONS レシピでトレーニングされたソリューションバージョンをデプロイする必要があります。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) ** 返されたレコメンデーションに適用するフィルターの ARN。詳細については、「[レコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。このパラメータを使用するときは、フィルターのリソースが `ACTIVE` であることを確認してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) ** レコメンデーションをフィルタリングするときに使用する値。フィルター式の各プレースホルダーパラメータについて、(大文字と小文字が一致した状態で) パラメータ名をキーとして指定し、フィルター値を対応する値として指定します。1 つのパラメータの複数の値をコンマで区切ります。 `INCLUDE` 要素を使用してアクションを含めるフィルター式について、式で定義されているすべてのパラメータの値を指定する必要があります。`EXCLUDE` 要素を使用してアクションを除外する式を含むフィルターについては、`filter-values` を省略できます。この場合、Amazon Personalize は、式のその部分を使用してレコメンデーションをフィルタリングしません。詳細については、「[レコメンデーションとユーザーセグメントのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。タイプ: 文字列間のマッピングマップエントリ: アイテムの最大数は 25 です。キーの長さの制限: 最大長は 50 です。キーパターン: `[A-Za-z0-9_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) ** 返される結果の数。デフォルトは 5 です。最大は 100 です。タイプ: 整数値の範囲: 最小値は 0 です。必須: いいえ ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) ** アクションレコメンデーションを提供するユーザーのユーザー ID。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "actionList": [ { "actionId": "string", "score": number } ], "recommendationId": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) ** 予測スコアで降順にソートされたアクションレコメンデーションのリスト。リストには最大 100 個のアクションを含めることができます。アクションスコアの詳細については、「[How action recommendation scoring works](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html)」を参照してください。型: [PredictedAction](API_RS_PredictedAction.md) オブジェクトの配列 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) ** レコメンデーションの ID。タイプ: 文字列 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースは存在しません。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations) # GetPersonalizedRanking 特定のユーザーに推奨されるアイテムのリストを再ランク付けします。リストの最初のアイテムは、ユーザーが関心を持つ可能性が最も高いアイテムとみなされます。 **注記** キャンペーンにデプロイするソリューションが PERSONALIZED\$1RANKING タイプのレシピを使用して作成済みであることが必要です。 ## リクエストの構文 ``` POST /personalize-ranking HTTP/1.1 Content-type: application/json { "campaignArn": "string", "context": { "string" : "string" }, "filterArn": "string", "filterValues": { "string" : "string" }, "inputList": [ "string" ], "metadataColumns": { "string" : [ "string" ] }, "userId": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) ** パーソナライズされたランキングの生成に使用するキャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: はい ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) ** レコメンデーションを取得するときに使用するコンテキストメタデータ。コンテキストメタデータには、ユーザーの現在の場所やデバイスタイプなど、ユーザーのレコメンデーションを取得するときに関連する可能性のあるインタラクション情報が含まれます。タイプ: 文字列から文字列へのマップマップエントリ: アイテムの最大数は 150 です。キーの長さの制限: 最大長は 150 です。キーパターン: `[A-Za-z\d_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) ** 特定のユーザーのレコメンデーションからアイテムを含めたり、アイテムを除外したりするために作成したフィルターの Amazon リソースネーム (ARN)。詳細については、「[レコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) ** レコメンデーションをフィルタリングするときに使用する値。フィルター式の各プレースホルダーパラメータについて、(大文字と小文字が一致した状態で) パラメータ名をキーとして指定し、フィルター値を対応する値として指定します。1 つのパラメータの複数の値をコンマで区切ります。 `INCLUDE` 要素を使用してアイテムを含めるフィルター式について、式で定義されているすべてのパラメータの値を指定する必要があります。`EXCLUDE` 要素を使用してアイテムを除外する式を含むフィルターについては、`filter-values` を省略できます。この場合、Amazon Personalize は、レコメンデーションをフィルタリングするために式のその部分を使用しません。詳細については、「[レコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。タイプ: 文字列間のマッピングマップエントリ: アイテムの最大数は 25 です。キーの長さの制限: 最大長は 50 です。キーパターン: `[A-Za-z0-9_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) ** ランク付けするアイテムのリスト (`itemId` による)。アイテムがトレーニングデータセットに含まれていなかった場合、そのアイテムは再ランク付けされたリストの最後に追加されます。レコメンデーションにメタデータを含める場合、最大数は 50 です。それ以外の場合、最大数は 500 です。型: 文字列の配列長さの制約: 最大長は 256 です。必須: はい ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) ** キャンペーンを作成または更新したときにレコメンデーションのメタデータを有効にした場合は、アイテムデータセットのメタデータ列を指定して、パーソナライズしたランキングに含めるようにします。マップキーは `ITEMS` で、値はアイテムデータセットの列名のリストです。指定できる列の最大数は 10 です。キャンペーンのメタデータを有効にする方法については、「[Enabling metadata in recommendations for a campaign](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)」を参照してください。タイプ: 文字列マップの配列への文字列マップエントリ: アイテムの最大数は 1 です。キーの長さの制限: 最大長は 256 です。配列メンバー: 最大数は 99 アイテムです。長さの制限: 最大長は 1,024 です。必須: いいえ ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) ** キャンペーンによるパーソナライズされたランキングの提供先とするユーザー。タイプ: 文字列長さの制約: 最大長は 256 です。必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "personalizedRanking": [ { "itemId": "string", "metadata": { "string" : "string" }, "promotionName": "string", "reason": [ "string" ], "score": number } ], "recommendationId": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) ** アイテムのリスト (ユーザーが関心を持つ可能性が最も高い順)。最大数は 500 です。型: [PredictedItem](API_RS_PredictedItem.md) オブジェクトの配列 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) ** レコメンデーションの ID。タイプ: 文字列 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースは存在しません。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) # GetRecommendations 推奨アイテムのリストを返します。キャンペーンについて、キャンペーンの Amazon リソースネーム (ARN) は必須であり、必要なユーザーとアイテムの入力は、キャンペーンをサポートするソリューションの作成に使用されたレシピタイプによって次のように異なります。 + USER\$1PERSONALIZATION - `userId` 必須、`itemId` 未使用 + RELATED\$1ITEMS - `itemId` 必須、`userId` 未使用 **注記** タイプ PERSONALIZED\$1RANKING のレシピを使用して作成されたソリューションにサポートされたキャンペーンは、[GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) API を使用します。レコメンダーの場合、レコメンダーの ARN が必要であり、必要なアイテムとユーザー入力は、レコメンダーをサポートするユースケース (ドメインベースのレシピ) によって異なります。ユースケースにおける要件の詳細については、「[レコメンダーのユースケースの選択](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html)」を参照してください。 ## リクエストの構文 ``` POST /recommendations HTTP/1.1 Content-type: application/json { "campaignArn": "string", "context": { "string" : "string" }, "filterArn": "string", "filterValues": { "string" : "string" }, "itemId": "string", "metadataColumns": { "string" : [ "string" ] }, "numResults": number, "promotions": [ { "filterArn": "string", "filterValues": { "string" : "string" }, "name": "string", "percentPromotedItems": number } ], "recommenderArn": "string", "userId": "string" } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [campaignArn](#API_RS_GetRecommendations_RequestSyntax) ** レコメンデーションの取得に使用するキャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [context](#API_RS_GetRecommendations_RequestSyntax) ** レコメンデーションを取得するときに使用するコンテキストメタデータ。コンテキストメタデータには、ユーザーの現在の場所やデバイスタイプなど、ユーザーのレコメンデーションを取得するときに関連する可能性のあるインタラクション情報が含まれます。タイプ: 文字列から文字列へのマップマップエントリ: アイテムの最大数は 150 です。キーの長さの制限: 最大長は 150 です。キーパターン: `[A-Za-z\d_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** [filterArn](#API_RS_GetRecommendations_RequestSyntax) ** 返されたレコメンデーションに適用するフィルターの ARN。詳細については、「[レコメンデーションのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。このパラメータを使用するときは、フィルターのリソースが `ACTIVE` であることを確認してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [filterValues](#API_RS_GetRecommendations_RequestSyntax) ** レコメンデーションをフィルタリングするときに使用する値。フィルター式の各プレースホルダーパラメータについて、(大文字と小文字が一致した状態で) パラメータ名をキーとして指定し、フィルター値を対応する値として指定します。1 つのパラメータの複数の値をコンマで区切ります。 `INCLUDE` 要素を使用してアイテムを含めるフィルター式について、式で定義されているすべてのパラメータの値を指定する必要があります。`EXCLUDE` 要素を使用してアイテムを除外する式を含むフィルターについては、`filter-values` を省略できます。この場合、Amazon Personalize は、レコメンデーションをフィルタリングするために式のその部分を使用しません。詳細については、「[レコメンデーションとユーザーセグメントのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。タイプ: 文字列間のマッピングマップエントリ: アイテムの最大数は 25 です。キーの長さの制限: 最大長は 50 です。キーパターン: `[A-Za-z0-9_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** [itemId](#API_RS_GetRecommendations_RequestSyntax) ** レコメンデーションを提供するアイテム ID。 `RELATED_ITEMS` レシピタイプに必要です。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** [metadataColumns](#API_RS_GetRecommendations_RequestSyntax) ** キャンペーンまたはレコメンダーを作成または更新したときにレコメンデーションのメタデータを有効にした場合は、アイテムデータセットのメタデータ列をアイテムレコメンデーションに含めるように指定します。マップキーは `ITEMS` で、値はアイテムデータセットの列名のリストです。指定できる列の最大数は 10 です。キャンペーンのメタデータを有効にする方法については、「[Enabling metadata in recommendations for a campaign](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)」を参照してください。レコメンダーのメタデータを有効にする方法については、「[Enabling metadata in recommendations for a recommender](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata)」を参照してください。タイプ: 文字列マップの配列への文字列マップエントリ: アイテムの最大数は 1 です。キーの長さの制限: 最大長は 256 です。配列メンバー: 最大数は 99 アイテムです。長さの制限: 最大長は 1,024 です。必須: いいえ ** [numResults](#API_RS_GetRecommendations_RequestSyntax) ** 返される結果の数。デフォルトは 25 です。レコメンデーションにメタデータを含める場合、最大数は 50 です。それ以外の場合、最大数は 500 です。タイプ: 整数値の範囲: 最小値は 0 です。必須: いいえ ** [promotions](#API_RS_GetRecommendations_RequestSyntax) ** レコメンデーションリクエストに適用するプロモーション。プロモーションは、設定可能なおすすめアイテムのサブセットに適用される追加のビジネスルールを定義します。型: [Promotion](API_RS_Promotion.md) オブジェクトの配列配列メンバー: 最大数は 1 項目です。必須: いいえ ** [recommenderArn](#API_RS_GetRecommendations_RequestSyntax) ** レコメンデーションを取得するために使用するレコメンダーの Amazon リソースネーム (ARN)。ドメインユースケース向けのレコメンダーを含むドメインデータセットグループを作成した場合は、レコメンダー ARN を提供します。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** [userId](#API_RS_GetRecommendations_RequestSyntax) ** レコメンデーションを提供するユーザー ID。 `USER_PERSONALIZATION` レシピタイプに必要です。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "itemList": [ { "itemId": "string", "metadata": { "string" : "string" }, "promotionName": "string", "reason": [ "string" ], "score": number } ], "recommendationId": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [itemList](#API_RS_GetRecommendations_ResponseSyntax) ** 予測スコアでソートされたレコメンデーションのリスト (降順)。リストには最大 500 個のアイテムを含めることができます。型: [PredictedItem](API_RS_PredictedItem.md) オブジェクトの配列 ** [recommendationId](#API_RS_GetRecommendations_ResponseSyntax) ** レコメンデーションの ID。タイプ: 文字列 ## エラー ** InvalidInputException ** フィールドまたはパラメータに有効な値を指定します。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたリソースは存在しません。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetRecommendations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetRecommendations) # データ型次のデータ型は、Amazon Personalize でサポートされています。 + [Algorithm](API_Algorithm.md) + [AlgorithmImage](API_AlgorithmImage.md) + [AutoMLConfig](API_AutoMLConfig.md) + [AutoMLResult](API_AutoMLResult.md) + [AutoTrainingConfig](API_AutoTrainingConfig.md) + [BatchInferenceJob](API_BatchInferenceJob.md) + [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) + [BatchInferenceJobInput](API_BatchInferenceJobInput.md) + [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) + [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) + [BatchSegmentJob](API_BatchSegmentJob.md) + [BatchSegmentJobInput](API_BatchSegmentJobInput.md) + [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) + [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) + [Campaign](API_Campaign.md) + [CampaignConfig](API_CampaignConfig.md) + [CampaignSummary](API_CampaignSummary.md) + [CampaignUpdateSummary](API_CampaignUpdateSummary.md) + [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) + [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) + [DataDeletionJob](API_DataDeletionJob.md) + [DataDeletionJobSummary](API_DataDeletionJobSummary.md) + [Dataset](API_Dataset.md) + [DatasetExportJob](API_DatasetExportJob.md) + [DatasetExportJobOutput](API_DatasetExportJobOutput.md) + [DatasetExportJobSummary](API_DatasetExportJobSummary.md) + [DatasetGroup](API_DatasetGroup.md) + [DatasetGroupSummary](API_DatasetGroupSummary.md) + [DatasetImportJob](API_DatasetImportJob.md) + [DatasetImportJobSummary](API_DatasetImportJobSummary.md) + [DatasetSchema](API_DatasetSchema.md) + [DatasetSchemaSummary](API_DatasetSchemaSummary.md) + [DatasetSummary](API_DatasetSummary.md) + [DatasetUpdateSummary](API_DatasetUpdateSummary.md) + [DataSource](API_DataSource.md) + [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) + [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) + [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) + [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) + [EventParameters](API_EventParameters.md) + [EventsConfig](API_EventsConfig.md) + [EventTracker](API_EventTracker.md) + [EventTrackerSummary](API_EventTrackerSummary.md) + [FeatureTransformation](API_FeatureTransformation.md) + [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) + [Filter](API_Filter.md) + [FilterSummary](API_FilterSummary.md) + [HPOConfig](API_HPOConfig.md) + [HPOObjective](API_HPOObjective.md) + [HPOResourceConfig](API_HPOResourceConfig.md) + [HyperParameterRanges](API_HyperParameterRanges.md) + [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) + [MetricAttribute](API_MetricAttribute.md) + [MetricAttribution](API_MetricAttribution.md) + [MetricAttributionOutput](API_MetricAttributionOutput.md) + [MetricAttributionSummary](API_MetricAttributionSummary.md) + [OptimizationObjective](API_OptimizationObjective.md) + [Recipe](API_Recipe.md) + [RecipeSummary](API_RecipeSummary.md) + [Recommender](API_Recommender.md) + [RecommenderConfig](API_RecommenderConfig.md) + [RecommenderSummary](API_RecommenderSummary.md) + [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) + [S3DataConfig](API_S3DataConfig.md) + [Solution](API_Solution.md) + [SolutionConfig](API_SolutionConfig.md) + [SolutionSummary](API_SolutionSummary.md) + [SolutionUpdateConfig](API_SolutionUpdateConfig.md) + [SolutionUpdateSummary](API_SolutionUpdateSummary.md) + [SolutionVersion](API_SolutionVersion.md) + [SolutionVersionSummary](API_SolutionVersionSummary.md) + [Tag](API_Tag.md) + [ThemeGenerationConfig](API_ThemeGenerationConfig.md) + [TrainingDataConfig](API_TrainingDataConfig.md) + [TunedHPOParams](API_TunedHPOParams.md) 次のデータ型は、Amazon Personalize Events でサポートされています。 + [Action](API_UBS_Action.md) + [ActionInteraction](API_UBS_ActionInteraction.md) + [Event](API_UBS_Event.md) + [Item](API_UBS_Item.md) + [MetricAttribution](API_UBS_MetricAttribution.md) + [User](API_UBS_User.md) 次のデータ型は、Amazon Personalize Runtime でサポートされています。 + [PredictedAction](API_RS_PredictedAction.md) + [PredictedItem](API_RS_PredictedItem.md) + [Promotion](API_RS_Promotion.md) # Amazon Personalize 次のデータ型は、Amazon Personalize でサポートされています。 + [Algorithm](API_Algorithm.md) + [AlgorithmImage](API_AlgorithmImage.md) + [AutoMLConfig](API_AutoMLConfig.md) + [AutoMLResult](API_AutoMLResult.md) + [AutoTrainingConfig](API_AutoTrainingConfig.md) + [BatchInferenceJob](API_BatchInferenceJob.md) + [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) + [BatchInferenceJobInput](API_BatchInferenceJobInput.md) + [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) + [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) + [BatchSegmentJob](API_BatchSegmentJob.md) + [BatchSegmentJobInput](API_BatchSegmentJobInput.md) + [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) + [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) + [Campaign](API_Campaign.md) + [CampaignConfig](API_CampaignConfig.md) + [CampaignSummary](API_CampaignSummary.md) + [CampaignUpdateSummary](API_CampaignUpdateSummary.md) + [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) + [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) + [DataDeletionJob](API_DataDeletionJob.md) + [DataDeletionJobSummary](API_DataDeletionJobSummary.md) + [Dataset](API_Dataset.md) + [DatasetExportJob](API_DatasetExportJob.md) + [DatasetExportJobOutput](API_DatasetExportJobOutput.md) + [DatasetExportJobSummary](API_DatasetExportJobSummary.md) + [DatasetGroup](API_DatasetGroup.md) + [DatasetGroupSummary](API_DatasetGroupSummary.md) + [DatasetImportJob](API_DatasetImportJob.md) + [DatasetImportJobSummary](API_DatasetImportJobSummary.md) + [DatasetSchema](API_DatasetSchema.md) + [DatasetSchemaSummary](API_DatasetSchemaSummary.md) + [DatasetSummary](API_DatasetSummary.md) + [DatasetUpdateSummary](API_DatasetUpdateSummary.md) + [DataSource](API_DataSource.md) + [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) + [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) + [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) + [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) + [EventParameters](API_EventParameters.md) + [EventsConfig](API_EventsConfig.md) + [EventTracker](API_EventTracker.md) + [EventTrackerSummary](API_EventTrackerSummary.md) + [FeatureTransformation](API_FeatureTransformation.md) + [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) + [Filter](API_Filter.md) + [FilterSummary](API_FilterSummary.md) + [HPOConfig](API_HPOConfig.md) + [HPOObjective](API_HPOObjective.md) + [HPOResourceConfig](API_HPOResourceConfig.md) + [HyperParameterRanges](API_HyperParameterRanges.md) + [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) + [MetricAttribute](API_MetricAttribute.md) + [MetricAttribution](API_MetricAttribution.md) + [MetricAttributionOutput](API_MetricAttributionOutput.md) + [MetricAttributionSummary](API_MetricAttributionSummary.md) + [OptimizationObjective](API_OptimizationObjective.md) + [Recipe](API_Recipe.md) + [RecipeSummary](API_RecipeSummary.md) + [Recommender](API_Recommender.md) + [RecommenderConfig](API_RecommenderConfig.md) + [RecommenderSummary](API_RecommenderSummary.md) + [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) + [S3DataConfig](API_S3DataConfig.md) + [Solution](API_Solution.md) + [SolutionConfig](API_SolutionConfig.md) + [SolutionSummary](API_SolutionSummary.md) + [SolutionUpdateConfig](API_SolutionUpdateConfig.md) + [SolutionUpdateSummary](API_SolutionUpdateSummary.md) + [SolutionVersion](API_SolutionVersion.md) + [SolutionVersionSummary](API_SolutionVersionSummary.md) + [Tag](API_Tag.md) + [ThemeGenerationConfig](API_ThemeGenerationConfig.md) + [TrainingDataConfig](API_TrainingDataConfig.md) + [TunedHPOParams](API_TunedHPOParams.md) # Algorithm カスタムアルゴリズムを記述します。 ## 内容 ** algorithmArn ** アルゴリズムの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** algorithmImage ** アルゴリズムイメージの Docker コンテナの URI。型: [AlgorithmImage](API_AlgorithmImage.md) オブジェクト必須: いいえ ** creationDateTime ** アルゴリズムの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** defaultHyperParameterRanges ** デフォルトのハイパーパラメータ、それらの範囲、およびそれらがチューニング可能かどうかを指定します。チューニング可能なハイパーパラメータは、ハイパーパラメータ最適化 (HPO) 中にその値を決定できます。型: [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) オブジェクト必須: いいえ ** defaultHyperParameters ** デフォルトのハイパーパラメータを指定します。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** defaultResourceConfig ** トレーニングジョブと並列トレーニングジョブのデフォルトの最大数を指定します。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** lastUpdatedDateTime ** アルゴリズムの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** アルゴリズムの名前タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** roleArn ** ロールの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** trainingInputMode ** トレーニング入力モード。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Algorithm) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Algorithm) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Algorithm) # AlgorithmImage アルゴリズムイメージを記述します。 ## 内容 ** dockerURI ** アルゴリズムイメージの Docker コンテナの URI。タイプ: 文字列長さの制約: 最大長は 256 です。必須: はい ** name ** アルゴリズムイメージの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AlgorithmImage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AlgorithmImage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AlgorithmImage) # AutoMLConfig ソリューションが AutoML を実行すると (`performAutoML` が [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) で true)、Amazon Personalize は、指定されたリストから、既定のメトリクスを最適化するレシピを決定します。その後、Amazon Personalize はそのレシピをソリューションに使用します。 ## 内容 ** metricName ** 最適化するメトリクス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** recipeList ** 候補レシピのリスト。型: 文字列の配列配列メンバー: 最大数は 100 項目です。長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLConfig) # AutoMLResult ソリューションが AutoML を実行する場合 ([CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)で `performAutoML` が true)、指定されたメトリクスを最適化するレシピを指定します。 ## 内容 ** bestRecipeArn ** 最適なレシピの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLResult) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLResult) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLResult) # AutoTrainingConfig `performAutoTraining` が true の場合に使用する自動トレーニング設定。 ## 内容 ** schedulingExpression ** 新しいソリューションバージョンを自動的にトレーニングする頻度を指定します。rate(*値* *単位*) 形式で rate 式を指定します。値には、1～30 の数値を指定します。単位には、`day` または `days` を指定します。例えば、5 日ごとに新しいソリューションバージョンを自動的に作成するには、`rate(5 days)` を指定します。デフォルトは 7 日ごとです。自動トレーニングの詳細については、「[ソリューションの作成と構成](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 16 です。パターン: `rate$\d+ days?$` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoTrainingConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoTrainingConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoTrainingConfig) # BatchInferenceJob バッチ推論ジョブに関する情報が含まれます。 ## 内容 ** batchInferenceJobArn ** バッチ推論ジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** batchInferenceJobConfig ** バッチ推論ジョブの設定の詳細の文字列から文字列へのマップ。型: [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) オブジェクト必須: いいえ ** batchInferenceJobMode ** ジョブのモード。型: 文字列有効な値：`BATCH_INFERENCE | THEME_GENERATION` 必須：いいえ ** creationDateTime ** バッチ推論ジョブの作成時刻。型: タイムスタンプ必須: いいえ ** failureReason ** バッチ推論ジョブが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** filterArn ** バッチ推論ジョブで使用されるフィルターの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** jobInput ** バッチ推論ジョブの生成に使用される入力データの格納場所への Amazon S3 パス。型: [BatchInferenceJobInput](API_BatchInferenceJobInput.md) オブジェクト必須: いいえ ** jobName ** バッチ推論ジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** jobOutput ** バッチ推論ジョブによって生成される出力データを含む Amazon S3 バケット。型: [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) オブジェクト必須: いいえ ** lastUpdatedDateTime ** バッチ推論ジョブの最終更新時刻。型: タイムスタンプ必須: いいえ ** numResults ** バッチ推論ジョブによって生成されたレコメンデーションの数。この数には、失敗した入力レコードについて生成されたエラーメッセージが含まれます。タイプ: 整数必須: いいえ ** roleArn ** バッチ推論ジョブをリクエストした Amazon Identity and Access Management (IAM) ロールの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: いいえ ** solutionVersionArn ** バッチ推論ジョブが作成されたソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** バッチ推論ジョブのステータス。ステータスは、次のいずれかの値です。 + 保留中 + IN PROGRESS + ACTIVE + CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** themeGenerationConfig ** ジョブのテーマ生成設定。型: [ThemeGenerationConfig](API_ThemeGenerationConfig.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJob) # BatchInferenceJobConfig バッチ推論ジョブの設定の詳細。 ## 内容 ** itemExplorationConfig ** `explorationWeight` と `explorationItemAgeCutOff` を含む探索設定ハイパーパラメータ (Amazon Personalize がアイテムを推奨するときに使用するアイテム探索の量を設定するために使用するもの) を指定する文字列から文字列へのマップ。[User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) を参照してください。タイプ: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** rankingInfluence ** POPULARITY と FRESHNESS のランキング影響値のマップ。キーごとに、0.0 から 1.0 までの数値を指定し、そのランク付け要素が最終的なレコメンデーションにどの程度影響するかを決定します。1.0 に近い値は係数に重みを付け、0.0 に近い値はその影響を軽減します。指定しない場合、どちらもデフォルトで 0.0 になります。タイプ: ダブルマップへの文字列。有効なキー: `POPULARITY | FRESHNESS` 有効範囲: 最小値は 0 です。最大値は 1 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobConfig) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobConfig) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobConfig) # BatchInferenceJobInput バッチ推論ジョブの入力設定。 ## 内容 ** s3DataSource ** 入力データを含む Amazon S3 のロケーションの URI。Amazon S3 バケットは、呼び出す API エンドポイントと同じリージョンにある必要があります。型: [S3DataConfig](API_S3DataConfig.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobInput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobInput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobInput) # BatchInferenceJobOutput バッチ推論ジョブの出力設定パラメータ。 ## 内容 ** s3DataDestination ** バッチ推論ジョブの出力が保存される Amazon S3 バケットに関する情報。型: [S3DataConfig](API_S3DataConfig.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobOutput) # BatchInferenceJobSummary [BatchInferenceJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchInferenceJob.html) の短縮版です。ListBatchInferenceJobs 操作は、バッチ推論ジョブの概要のリストを返します。 ## 内容 ** batchInferenceJobArn ** バッチ推論ジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** batchInferenceJobMode ** ジョブのモード。型: 文字列有効な値：`BATCH_INFERENCE | THEME_GENERATION` 必須：いいえ ** creationDateTime ** バッチ推論ジョブの作成時刻。型: タイムスタンプ必須: いいえ ** failureReason ** バッチ推論ジョブが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** jobName ** バッチ推論ジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** lastUpdatedDateTime ** バッチ推論ジョブの最終更新時刻。型: タイムスタンプ必須: いいえ ** solutionVersionArn ** バッチ推論ジョブで使用されるソリューションバージョンの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** バッチ推論ジョブのステータス。ステータスは、次のいずれかの値です。 + 保留中 + IN PROGRESS + ACTIVE + CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobSummary) # BatchSegmentJob バッチセグメントジョブに関する情報が含まれます。 ## 内容 ** batchSegmentJobArn ** バッチセグメントジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** creationDateTime ** バッチセグメントジョブの作成時刻。型: タイムスタンプ必須: いいえ ** failureReason ** バッチセグメントジョブが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** filterArn ** バッチセグメントジョブで使用されるフィルターの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** jobInput ** バッチセグメントジョブの生成に使用される入力データの格納場所への Amazon S3 パス。型: [BatchSegmentJobInput](API_BatchSegmentJobInput.md) オブジェクト必須: いいえ ** jobName ** バッチセグメントジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** jobOutput ** バッチセグメントジョブによって生成される出力データを含む Amazon S3 バケット。型: [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) オブジェクト必須: いいえ ** lastUpdatedDateTime ** バッチセグメントジョブの最終更新時刻。型: タイムスタンプ必須: いいえ ** numResults ** 入力データの各行のバッチセグメントジョブによって生成された予測ユーザーの数。セグメントあたりのユーザーの最大数は 500 万人です。タイプ: 整数必須: いいえ ** roleArn ** バッチセグメントジョブをリクエストした Amazon Identity and Access Management (IAM) ロールの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: いいえ ** solutionVersionArn ** バッチセグメントを生成するためにバッチセグメントジョブで使用されるソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** バッチセグメントジョブのステータス。ステータスは、次のいずれかの値です。 + 保留中 + IN PROGRESS + ACTIVE + CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJob) # BatchSegmentJobInput バッチセグメントジョブの入力設定。 ## 内容 ** s3DataSource ** Amazon S3 の入力または出力バケットの設定の詳細。型: [S3DataConfig](API_S3DataConfig.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobInput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobInput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobInput) # BatchSegmentJobOutput バッチセグメントジョブの出力設定パラメータ。 ## 内容 ** s3DataDestination ** Amazon S3 の入力または出力バケットの設定の詳細。型: [S3DataConfig](API_S3DataConfig.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobOutput) # BatchSegmentJobSummary BatchSegmentJob データ型の短縮版。[ListBatchSegmentJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchSegmentJobs.html) 操作は、バッチセグメントジョブの概要のリストを返します。 ## 内容 ** batchSegmentJobArn ** バッチセグメントジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** creationDateTime ** バッチセグメントジョブの作成時刻。型: タイムスタンプ必須: いいえ ** failureReason ** バッチセグメントジョブが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** jobName ** バッチセグメントジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** lastUpdatedDateTime ** バッチセグメントジョブの最終更新時刻。型: タイムスタンプ必須: いいえ ** solutionVersionArn ** バッチセグメントを生成するためにバッチセグメントジョブで使用されるソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** バッチセグメントジョブのステータス。ステータスは、次のいずれかの値です。 + 保留中 + IN PROGRESS + ACTIVE + CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobSummary) # Campaign ソリューションバージョンのデプロイを記述するオブジェクト。キャンペーンの作成の詳細については、「[CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html)」を参照してください。 ## 内容 ** campaignArn ** キャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** campaignConfig ** キャンペーンの設定の詳細。型: [CampaignConfig](API_CampaignConfig.md) オブジェクト必須: いいえ ** creationDateTime ** キャンペーンの作成日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** failureReason ** キャンペーンが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** キャンペーンの最終更新日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** latestCampaignUpdate ** キャンペーンの更新のプロパティの概要を提供します。詳細なリストについては、[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API を呼び出してください。 `latestCampaignUpdate` フィールドは、キャンペーンで少なくとも 1 回の`UpdateCampaign` 呼び出しがあった場合にのみ返されます。型: [CampaignUpdateSummary](API_CampaignUpdateSummary.md) オブジェクト必須: いいえ ** minProvisionedTPS ** 1 秒あたりにリクエストされる最小プロビジョンドトランザクション (レコメンデーション) を指定します。`minProvisionedTPS` を高く設定すると請求額が増加します。最初は `minProvisionedTPS` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。タイプ: 整数有効な範囲: 最小値は 1 です。必須: いいえ ** name ** キャンペーンの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** solutionVersionArn ** キャンペーンで使用するソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** キャンペーンのステータス。キャンペーンは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Campaign) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Campaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Campaign) # CampaignConfig キャンペーンの設定の詳細。 ## 内容 ** enableMetadataWithRecommendations ** レコメンデーションを含むメタデータがキャンペーンで有効になっているかどうか。有効にすると、レコメンデーションのリクエストでアイテムデータセットの列を指定できます。Amazon Personalize は、レコメンデーションレスポンス内の各アイテムについてこのデータを返します。キャンペーンのメタデータを有効にする方法については、「[Enabling metadata in recommendations for a campaign](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)」を参照してください。レコメンデーションのメタデータを有効にすると、追加費用が発生します。詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。タイプ: ブール値必須: いいえ ** itemExplorationConfig ** `explorationWeight` と `explorationItemAgeCutOff` を含む探索設定ハイパーパラメータ (Amazon Personalize がアイテムを推奨するときに使用するアイテム探索の量を設定するために使用するもの) を指定します。ソリューションが [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) レシピを使用している場合にのみ `itemExplorationConfig` データを提供します。タイプ: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** rankingInfluence ** POPULARITY と FRESHNESS のランキング影響値のマップ。キーごとに、0.0 から 1.0 までの数値を指定し、そのランク付け要素が最終的なレコメンデーションにどの程度影響するかを決定します。1.0 に近い値は係数に重みを付け、0.0 に近い値はその影響を軽減します。指定しない場合、どちらもデフォルトで 0.0 になります。タイプ: ダブルマップへの文字列。有効なキー: `POPULARITY | FRESHNESS` 有効範囲: 最小値は 0 です。最大値は 1 です。必須: いいえ ** syncWithLatestSolutionVersion ** キャンペーンが自動的に更新されて、ソリューションの最新バージョン (トレーニング済みモデル) を使用するかどうか。`True` を指定する場合は、`SolutionVersionArn` パラメータの*ソリューション*の ARN を指定する必要があります。`SolutionArn/$LATEST` 形式である必要があります。デフォルトは `False` で、キャンペーンを手動で更新して、最新のソリューションバージョンをデプロイする必要があります。キャンペーンの自動更新の詳細については、「[キャンペーンの自動更新を有効にする](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)」を参照してください。タイプ: ブール値必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignConfig) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignConfig) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignConfig) # CampaignSummary キャンペーンのプロパティの概要を提供します。詳細なリストについては、[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API を呼び出してください。 ## 内容 ** campaignArn ** キャンペーンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** creationDateTime ** キャンペーンの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** failureReason ** キャンペーンが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** キャンペーンの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** キャンペーンの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** キャンペーンのステータス。キャンペーンは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignSummary) # CampaignUpdateSummary キャンペーンの更新のプロパティの概要を提供します。詳細なリストについては、[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API を呼び出してください。 ## 内容 ** campaignConfig ** キャンペーンの設定の詳細。型: [CampaignConfig](API_CampaignConfig.md) オブジェクト必須: いいえ ** creationDateTime ** キャンペーンの更新の作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** failureReason ** キャンペーンの更新が失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** キャンペーンの更新の最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** minProvisionedTPS ** Amazon Personalize がサポートする、リクエストされた 1 秒あたりの最小プロビジョンドトランザクション (推奨) を指定します。タイプ: 整数有効な範囲: 最小値は 1 です。必須: いいえ ** solutionVersionArn ** デプロイされたソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** キャンペーン更新のステータス。キャンペーンの更新は、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignUpdateSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignUpdateSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignUpdateSummary) # CategoricalHyperParameterRange カテゴリカルハイパーパラメータの名前と範囲を指定します。 ## 内容 ** name ** ハイパーパラメータの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** values ** ハイパーパラメータのカテゴリのリスト。型: 文字列の配列配列メンバー: 最大数は 100 項目です。長さの制限: 最大長は 1,000 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CategoricalHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CategoricalHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CategoricalHyperParameterRange) # ContinuousHyperParameterRange 連続ハイパーパラメータの名前と範囲を指定します。 ## 内容 ** maxValue ** ハイパーパラメータの最大許容値。型: 倍精度浮動小数点数値の範囲: 最小値は -1000000 です。必須: いいえ ** minValue ** ハイパーパラメータの最小許容値。型: 倍精度浮動小数点数値の範囲: 最小値は -1000000 です。必須: いいえ ** name ** ハイパーパラメータの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ContinuousHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ContinuousHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ContinuousHyperParameterRange) # DataDeletionJob Amazon Personalize データセットグループから特定のユーザーへのすべての参照をバッチで削除するジョブについて説明します。データ削除ジョブの作成については、「[ユーザーの削除](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)」を参照してください。 ## 内容 ** creationDateTime ** データ削除ジョブの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** dataDeletionJobArn ** データ削除ジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** datasetGroupArn ** ジョブがレコードを削除するデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** dataSource ** データセットにアップロードするデータを含むデータソース、または Amazon Personalize から削除するレコードのリストについて説明します。型: [DataSource](API_DataSource.md) オブジェクト必須: いいえ ** failureReason ** データ削除ジョブが失敗した場合、その理由を提供します。タイプ: 文字列必須: いいえ ** jobName ** データ削除ジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** lastUpdatedDateTime ** データ削除ジョブが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** numDeleted ** 完了済みジョブによって削除されたレコードの数。タイプ: 整数必須: いいえ ** roleArn ** Amazon S3 データソースから読み取るための許可を持つ IAM ロールの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: いいえ ** status ** データ削除ジョブのステータス。データ削除ジョブのステータスは、次のいずれかです。 + PENDING > IN\$1PROGRESS > COMPLETED または FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJob) # DataDeletionJobSummary データ削除ジョブのプロパティの概要を提供します。詳細なリストについては、[DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) API オペレーションを呼び出してください。 ## 内容 ** creationDateTime ** データ削除ジョブの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** dataDeletionJobArn ** データ削除ジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** datasetGroupArn ** ジョブがレコードを削除したデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** データ削除ジョブが失敗した場合、その理由を提供します。タイプ: 文字列必須: いいえ ** jobName ** データ削除ジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** lastUpdatedDateTime ** データ削除ジョブが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** status ** データ削除ジョブのステータス。データ削除ジョブのステータスは、次のいずれかです。 + PENDING > IN\$1PROGRESS > COMPLETED または FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJobSummary) # Dataset データセットのメタデータを提供します。 ## 内容 ** creationDateTime ** データセットの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetArn ** メタデータの取得対象とするデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** datasetGroupArn ** データセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** datasetType ** 次のいずれかの値になります。 + インタラクション + 項目 + [ユーザー] + アクション + Action\$1Interactions タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `^[A-Za-z_]+$` 必須: いいえ ** lastUpdatedDateTime ** データセットがいつ更新されたかを示すタイムスタンプ。型: タイムスタンプ必須: いいえ ** latestDatasetUpdate ** データセットの最新の更新について説明します。型: [DatasetUpdateSummary](API_DatasetUpdateSummary.md) オブジェクト必須: いいえ ** name ** データセットの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** schemaArn ** 関連付けられたスキーマの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** データセットのステータス。データセットは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** trackingId ** アクションインタラクションデータセットのイベントトラッカーの ID。トラッカーの ID は `PutActionInteractions` API オペレーションで指定します。Amazon Personalize は、これを使用して、データセットグループのアクションインタラクションデータセットに新しいデータを送信します。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Dataset) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Dataset) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Dataset) # DatasetExportJob データセットを Amazon S3 バケットにエクスポートするジョブを記述します。詳細については、「[CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html)」を参照してください。データセットのエクスポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED ## 内容 ** creationDateTime ** データセットのエクスポートジョブの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetArn ** エクスポートするデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** datasetExportJobArn ** データセットのエクスポートジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** データセットのエクスポートジョブが失敗した場合、その理由を提供します。タイプ: 文字列必須: いいえ ** ingestionMode ** エクスポートするデータ (データをインポートした方法に基づく)。データセットのインポートジョブを使用してインポートした `BULK` データ、(コンソール、PutEvents、PutUsers、および PutItems 操作を使用して) 増分的にインポートした `PUT` データ、または両方のタイプの `ALL` をエクスポートすることを選択できます。デフォルト値は `PUT` です。型: 文字列有効な値：`BULK | PUT | ALL` 必須：いいえ ** jobName ** エクスポートジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** jobOutput ** ジョブの出力が保存される Amazon S3 バケットへのパス。例: `s3://bucket-name/folder-name/` 型: [DatasetExportJobOutput](API_DatasetExportJobOutput.md) オブジェクト必須: いいえ ** lastUpdatedDateTime ** データセットのエクスポートジョブのステータスの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** roleArn ** 出力 Amazon S3 バケットにデータを追加するための許可を持つ IAM サービスロールの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** データセットのエクスポートジョブのステータス。データセットのエクスポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJob) # DatasetExportJobOutput データセットのエクスポートジョブの出力設定パラメータ。 ## 内容 ** s3DataDestination ** Amazon S3 の入力または出力バケットの設定の詳細。型: [S3DataConfig](API_S3DataConfig.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobOutput) # DatasetExportJobSummary データセットのエクスポートジョブのプロパティの概要を提供します。詳細なリストについては、[DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html) API を呼び出してください。 ## 内容 ** creationDateTime ** データセットのエクスポートジョブの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetExportJobArn ** データセットのエクスポートジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** データセットのエクスポートジョブが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** jobName ** データセットのエクスポートジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** lastUpdatedDateTime ** データセットのエクスポートジョブのステータスの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** status ** データセットのエクスポートジョブのステータス。データセットのエクスポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobSummary) # DatasetGroup データセットグループは、関連するデータセットのコレクションです (アイテムインタラクション、ユーザー、アイテム、アクション、アクションインタラクション)。[CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) を呼び出すことによってデータセットグループを作成します。その後、データセットを作成して、[CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) を呼び出してデータセットグループに追加します。[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) を呼び出すことにより、データセットグループを使用してソリューションに作成とトレーニングをします。データセットグループには、各タイプのデータセットを 1 つのみ含めることができます。 AWS Key Management Service (KMS) キーを指定して、グループ内のデータセットを暗号化できます。 ## 内容 ** creationDateTime ** データセットグループの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** データセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** domain ** ドメインデータセットグループのドメイン。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** failureReason ** データセットグループの作成が失敗した場合、その理由を提供します。タイプ: 文字列必須: いいえ ** kmsKeyArn ** データセットの暗号化に使用される AWS Key Management Service (KMS) キーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 2,048 です。パターン: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 必須: いいえ ** lastUpdatedDateTime ** データセットグループの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** データセットグループの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** roleArn ** AWS Key Management Service (KMS) キーにアクセスするための許可を持つ AWS Identity and Access Management (IAM) ロールの ARN。IAM ロールの指定は、KMS キーも指定する場合にのみ有効です。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: いいえ ** status ** データセットグループの現在のステータス。データセットグループは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroup) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroup) # DatasetGroupSummary データセットグループのプロパティの概要を提供します。詳細なリストについては、[DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) API を呼び出してください。 ## 内容 ** creationDateTime ** データセットグループの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** データセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** domain ** ドメインデータセットグループのドメイン。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** failureReason ** データセットグループの作成が失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** データセットグループが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** データセットグループの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** データセットグループのステータス。データセットグループは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroupSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroupSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroupSummary) # DatasetImportJob トレーニングデータをデータソース (Amazon S3バケット) から Amazon Personalize データセットにインポートするジョブを記述します。詳細については、「[CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)」を参照してください。データセットのインポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED ## 内容 ** creationDateTime ** データセットのインポートジョブの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetArn ** インポートされたデータを受け取るデータセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** datasetImportJobArn ** データセットのインポートジョブの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** dataSource ** インポートするトレーニングデータを含む Amazon S3 バケット。型: [DataSource](API_DataSource.md) オブジェクト必須: いいえ ** failureReason ** データセットのインポートジョブが失敗した場合、その理由を提供します。タイプ: 文字列必須: いいえ ** importMode ** データセットのインポートジョブが新しいレコードをインポートするために使用するインポートモード。型: 文字列有効な値：`FULL | INCREMENTAL` 必須：いいえ ** jobName ** インポートジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** lastUpdatedDateTime ** データセットが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** publishAttributionMetricsToS3 ** ジョブがメトリクス属性のために Amazon S3 にメトリクスを公開するかどうか。型: ブール値必須: いいえ ** roleArn ** Amazon S3 データソースから読み取るための許可を持つ IAM ロールの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** データセットのインポートジョブのステータス。データセットのインポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJob) # DatasetImportJobSummary データセットのインポートジョブのプロパティの概要を提供します。詳細なリストについては、[DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) API を呼び出してください。 ## 内容 ** creationDateTime ** データセットのインポートジョブの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetImportJobArn ** データセットのインポートジョブの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** データセットのインポートジョブが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** importMode ** データセットのインポートジョブがデータセット内のデータを更新するために使用するインポートモード。詳細については、「[既存のバルクデータの更新](https://docs.aws.amazon.com/personalize/latest/dg/updating-existing-bulk-data.html)」を参照してください。型: 文字列有効な値：`FULL | INCREMENTAL` 必須：いいえ ** jobName ** データセットのインポートジョブの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** lastUpdatedDateTime ** データセットのインポートジョブのステータスの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** status ** データセットのインポートジョブのステータス。データセットのインポートジョブは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJobSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJobSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJobSummary) # DatasetSchema データセットのスキーマを記述します。スキーマについての詳細は、「[CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html)」を参照してください。 ## 内容 ** creationDateTime ** スキーマが作成された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** domain ** ドメインデータセットグループ内のデータセット用に作成したスキーマのドメイン。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** lastUpdatedDateTime ** スキーマが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** スキーマの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** schema ** スキーマ。タイプ: 文字列長さの制限: 最大長は 20,000 です。必須: いいえ ** schemaArn ** スキーマの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchema) # DatasetSchemaSummary データセットスキーマのプロパティの概要を提供します。詳細なリストについては、[DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) API を呼び出してください。 ## 内容 ** creationDateTime ** スキーマが作成された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** domain ** ドメインデータセットグループ内のデータセット用に作成したスキーマのドメイン。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** lastUpdatedDateTime ** スキーマが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** スキーマの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** schemaArn ** スキーマの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchemaSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchemaSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchemaSummary) # DatasetSummary データセットのプロパティの概要を提供します。詳細なリストについては、[DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) API を呼び出してください。 ## 内容 ** creationDateTime ** データセットの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetArn ** データセットの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** datasetType ** データセットのタイプ。次のいずれかの値になります。 + インタラクション + 項目 + [ユーザー] + イベントインタラクションタイプ: 文字列長さの制約: 最大長は 256 です。パターン: `^[A-Za-z_]+$` 必須: いいえ ** lastUpdatedDateTime ** データセットが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** データセットの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** データセットのステータス。データセットは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSummary) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSummary) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSummary) # DatasetUpdateSummary データセットの更新について説明します。 ## 内容 ** creationDateTime ** データセット更新の作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** failureReason ** データセットの更新が失敗した場合、その理由を提供します。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** データセットの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** schemaArn ** データセットの以前のスキーマを置き換えたスキーマの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** データセット更新のステータス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetUpdateSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetUpdateSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetUpdateSummary) # DataSource データセットにアップロードするデータを含むデータソース、または Amazon Personalize から削除するレコードのリストについて説明します。 ## 内容 ** dataLocation ** データセットインポートジョブで、データセットにアップロードするデータが保存される Amazon S3 バケットへのパス。データ削除ジョブで、削除するレコードのリストを保存する Amazon S3 バケットへのパス。例: `s3://bucket-name/folder-name/fileName.csv` CSV ファイルが Amazon S3 バケット内のフォルダにあり、インポートジョブまたはデータ削除ジョブで複数のファイルを検討する場合、フォルダへのパスを指定できます。データ削除ジョブでは、Amazon Personalize は、フォルダとサブフォルダ内のすべてのファイルを使用します。フォルダ名の後に `/` を付けて次の構文を使用します。 `s3://bucket-name/folder-name/` タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `(s3|http|https)://.+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataSource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataSource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataSource) # DefaultCategoricalHyperParameterRange カテゴリ別ハイパーパラメータの名前とデフォルトの範囲、およびハイパーパラメータがチューニング可能かどうかを示します。チューニング可能なハイパーパラメータは、ハイパーパラメータ最適化 (HPO) 中にその値を決定できます。 ## 内容 ** isTunable ** ハイパーパラメータがチューニング可能かどうか。型: ブール値必須: いいえ ** name ** ハイパーパラメータの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** values ** ハイパーパラメータのカテゴリのリスト。型: 文字列の配列配列メンバー: 最大数は 100 項目です。長さの制限: 最大長は 1,000 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) # DefaultContinuousHyperParameterRange 連続ハイパーパラメータの名前とデフォルトの範囲、およびハイパーパラメータがチューニング可能かどうかを示します。チューニング可能なハイパーパラメータは、ハイパーパラメータ最適化 (HPO) 中にその値を決定できます。 ## 内容 ** isTunable ** ハイパーパラメータがチューニング可能かどうか。型: ブール値必須: いいえ ** maxValue ** ハイパーパラメータの最大許容値。型: 倍精度浮動小数点数値の範囲: 最小値は -1000000 です。必須: いいえ ** minValue ** ハイパーパラメータの最小許容値。型: 倍精度浮動小数点数値の範囲: 最小値は -1000000 です。必須: いいえ ** name ** ハイパーパラメータの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultContinuousHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultContinuousHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultContinuousHyperParameterRange) # DefaultHyperParameterRanges ハイパーパラメータとそのデフォルトの範囲を指定します。ハイパーパラメータのタイプは、カテゴリ別、継続的、または整数値のいずれかです。 ## 内容 ** categoricalHyperParameterRanges ** カテゴリハイパーパラメータとそのデフォルトの範囲。タイプ: [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。必須: いいえ ** continuousHyperParameterRanges ** 連続ハイパーパラメータとそのデフォルトの範囲。タイプ: [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。必須: いいえ ** integerHyperParameterRanges ** 整数値のハイパーパラメータとそのデフォルトの範囲。タイプ: [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultHyperParameterRanges) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultHyperParameterRanges) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultHyperParameterRanges) # DefaultIntegerHyperParameterRange 整数値のハイパーパラメータの名前とデフォルトの範囲、およびハイパーパラメータがチューニング可能かどうかを示します。チューニング可能なハイパーパラメータは、ハイパーパラメータ最適化 (HPO) 中にその値を決定できます。 ## 内容 ** isTunable ** ハイパーパラメータがチューニング可能かどうかを示します。型: ブール値必須: いいえ ** maxValue ** ハイパーパラメータの最大許容値。タイプ: 整数有効な範囲: 最大値は 1000000 です。必須: いいえ ** minValue ** ハイパーパラメータの最小許容値。タイプ: 整数値の範囲: 最小値は -1000000 です。必須: いいえ ** name ** ハイパーパラメータの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultIntegerHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultIntegerHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultIntegerHyperParameterRange) # EventParameters ソリューションの作成に使用されるイベントのパラメータについて説明します。 ## 内容 ** eventType ** ソリューションの作成で検討対象となるイベントタイプの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** eventValueThreshold ** イベントタイプのしきい値。このしきい値以上の値を持つイベントのみが、ソリューションの作成で検討対象となります。型: 倍精度浮動小数点数必須: いいえ ** weight ** イベントタイプの重み。重みが大きいほど、作成されたソリューションのイベントタイプの重要度が高くなります。型: 倍精度浮動小数点数有効範囲: 最小値は 0 です。最大値は 1 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventParameters) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventParameters) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventParameters) # EventsConfig ソリューションの作成に使用されるイベントの設定について説明します。 ## 内容 ** eventParametersList ** イベントパラメータのリスト。イベントタイプと、そのイベント値のしきい値と重みが含まれます。タイプ: [EventParameters](API_EventParameters.md) オブジェクトの配列配列メンバー: 最大数は 10 項目です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventsConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventsConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventsConfig) # EventTracker イベントトラッカーに関する情報を提供します。 ## 内容 ** accountId ** イベントトラッカーを所有する AWS アカウント。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** creationDateTime ** イベントトラッカーの作成日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** イベントデータを受け取るデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** eventTrackerArn ** イベントトラッカーの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** lastUpdatedDateTime ** イベントトラッカーの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** イベントトラッカーの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** イベントトラッカーのステータス。イベントトラッカーは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** trackingId ** イベントトラッカーの ID。この ID を [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API へのリクエストに含めます。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTracker) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTracker) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTracker) # EventTrackerSummary イベントトラッカーのプロパティの概要を提供します。詳細なリストについては、[DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) API を呼び出してください。 ## 内容 ** creationDateTime ** イベントトラッカーの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** eventTrackerArn ** イベントトラッカーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** lastUpdatedDateTime ** イベントトラッカーの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** イベントトラッカーの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** イベントトラッカーのステータス。イベントトラッカーは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTrackerSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTrackerSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTrackerSummary) # FeatureTransformation 特徴変換に関する情報を提供します。機能変換は、raw 入力データを変更してモデルトレーニングにより適した形式にするプロセスです。 ## 内容 ** creationDateTime ** 特徴変換の作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** defaultParameters ** 特徴変換のデフォルトパラメータを提供します。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** featureTransformationArn ** FeatureTransformation オブジェクトの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** lastUpdatedDateTime ** 特徴変換の最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** 特徴変換の名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** 特徴変換のステータス。特徴変換は、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FeatureTransformation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FeatureTransformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FeatureTransformation) # FieldsForThemeGeneration テーマ生成の設定の詳細の文字列から文字列へのマップ。 ## 内容 ** itemName ** データセット内の各アイテムの名前を保存するアイテムデータセット列の名前。タイプ: 文字列長さの制限: 最大長は 1,024 です。パターン: `[A-Za-z_][A-Za-z\d_]*` 必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FieldsForThemeGeneration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FieldsForThemeGeneration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FieldsForThemeGeneration) # Filter ARN、ステータス、フィルター式など、レコメンデーションフィルターに関する情報が含まれます。 ## 内容 ** creationDateTime ** フィルターが作成された時刻。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** フィルターが属するデータセットグループの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** フィルターが失敗した場合、その失敗の理由。タイプ: 文字列必須: いいえ ** filterArn ** フィルターの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** filterExpression ** レコメンデーションの結果から除外するアイテムのインタラクションのタイプを指定します。フィルター式は、特定のフォーマットルールに従う必要があります。フィルター式の構造と構文については、「[フィルター式](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2500 です。必須: いいえ ** lastUpdatedDateTime ** フィルターが最後に更新された時刻。型: タイムスタンプ必須: いいえ ** name ** フィルターの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** フィルターのステータス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Filter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Filter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Filter) # FilterSummary フィルターの属性の簡単な概要。 ## 内容 ** creationDateTime ** フィルターが作成された時刻。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** フィルターが属するデータセットグループの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** フィルターが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** filterArn ** フィルターの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** lastUpdatedDateTime ** フィルターが最後に更新された時刻。型: タイムスタンプ必須: いいえ ** name ** フィルターの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** フィルターのステータス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FilterSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FilterSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FilterSummary) # HPOConfig ハイパーパラメータ最適化 (HPO) のプロパティを記述します。 ## 内容 ** algorithmHyperParameterRanges ** ハイパーパラメータとその許容範囲。型: [HyperParameterRanges](API_HyperParameterRanges.md) オブジェクト必須: いいえ ** hpoObjective ** HPO 中に最適化するメトリクス。現時点では、Amazon Personalize は `hpoObjective` の設定をサポートしていません。型: [HPOObjective](API_HPOObjective.md) オブジェクト必須: いいえ ** hpoResourceConfig ** HPO のリソース設定を記述します。型: [HPOResourceConfig](API_HPOResourceConfig.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOConfig) # HPOObjective ハイパーパラメータ最適化 (HPO) 中に最適化するメトリクス。 **注記** 現時点では、Amazon Personalize は `hpoObjective` の設定をサポートしていません。 ## 内容 ** metricName ** メトリクスの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** metricRegex ** トレーニングジョブのログでメトリクスを見つけるための正規表現。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** type ** メトリクスのタイプ。有効な値は、`Maximize` および `Minimize` です。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOObjective) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOObjective) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOObjective) # HPOResourceConfig ハイパーパラメータ最適化 (HPO) のリソース設定を記述します。 ## 内容 ** maxNumberOfTrainingJobs ** ソリューションバージョンを作成するときのトレーニングジョブの最大数。`maxNumberOfTrainingJobs` の最大値は `40` です。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** maxParallelTrainingJobs ** ソリューションバージョンを作成するときの並列トレーニングジョブの最大数。`maxParallelTrainingJobs` の最大値は `10` です。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOResourceConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOResourceConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOResourceConfig) # HyperParameterRanges ハイパーパラメータとその範囲を指定します。ハイパーパラメータのタイプは、カテゴリ別、継続的、または整数値のいずれかです。 ## 内容 ** categoricalHyperParameterRanges ** カテゴリハイパーパラメータとその範囲。タイプ: [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。必須: いいえ ** continuousHyperParameterRanges ** 連続ハイパーパラメータとその範囲。タイプ: [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。必須: いいえ ** integerHyperParameterRanges ** 整数値のハイパーパラメータとその範囲。タイプ: [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) オブジェクトの配列配列メンバー: 最大数は 100 項目です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HyperParameterRanges) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HyperParameterRanges) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HyperParameterRanges) # IntegerHyperParameterRange 整数値のハイパーパラメータの名前と範囲を指定します。 ## 内容 ** maxValue ** ハイパーパラメータの最大許容値。タイプ: 整数有効な範囲: 最大値は 1000000 です。必須: いいえ ** minValue ** ハイパーパラメータの最小許容値。タイプ: 整数値の範囲: 最小値は -1000000 です。必須: いいえ ** name ** ハイパーパラメータの名前。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/IntegerHyperParameterRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/IntegerHyperParameterRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/IntegerHyperParameterRange) # MetricAttribute メトリクス属性のレポート対象となるメトリクスに関する情報が含まれます。詳細については、「[レコメンデーションの影響の測定](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)」を参照してください。 ## 内容 ** eventType ** メトリクスのイベントタイプ。タイプ: 文字列長さの制約: 最大長は 256 です。必須: はい ** expression ** 属性の式。使用できるオプションは、`SUM()` または `SAMPLECOUNT()` です。SUM() 関数では、データセットのタイプ (インタラクションまたはアイテム) と合計する列をパラメーターとして指定します。例えば、SUM(Items.PRICE) などです。タイプ: 文字列長さの制約: 最大長は 256 です。必須: はい ** metricName ** メトリクスの名前。この名前は、Amazon CloudWatch または Amazon S3 のメトリクスを特定するのに役立ちます。タイプ: 文字列長さの制約: 最大長は 256 です。必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribute) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribute) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribute) # MetricAttribution メトリクス属性に関する情報が含まれます。メトリクス属性は、Amazon Personalize にインポートしたデータに関するレポートを作成します。データをインポートする方法に応じて Amazon CloudWatch または Amazon S3 でレポートを表示できます。詳細については、「[レコメンデーションの影響の測定](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)」を参照してください。 ## 内容 ** creationDateTime ** メトリクス属性の作成日時。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** メトリクス属性のデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** メトリクス属性の失敗理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** メトリクス属性の最終更新日時。型: タイムスタンプ必須: いいえ ** metricAttributionArn ** メトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** metricsOutputConfig ** メトリクス属性の出力設定。型: [MetricAttributionOutput](API_MetricAttributionOutput.md) オブジェクト必須: いいえ ** name ** メトリクス属性の名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** メトリクス属性のステータス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribution) # MetricAttributionOutput メトリクス属性の出力設定の詳細。 ## 内容 ** roleArn ** 出力 Amazon S3 バケットにデータを追加し、Amazon CloudWatch にメトリクスを追加するためのアクセス許可を持つ IAM サービスロールの Amazon リソースネーム (ARN)。詳細については、「[レコメンデーションの影響の測定](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必須: はい ** s3DataDestination ** Amazon S3 の入力または出力バケットの設定の詳細。型: [S3DataConfig](API_S3DataConfig.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionOutput) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionOutput) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionOutput) # MetricAttributionSummary メトリクス属性のプロパティの概要を提供します。詳細なリストについては、[DescribeMetricAttribution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeMetricAttribution.html) を呼び出してください。 ## 内容 ** creationDateTime ** メトリクス属性の作成日時。型: タイムスタンプ必須: いいえ ** failureReason ** メトリクス属性の失敗理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** メトリクス属性の最終更新日時。型: タイムスタンプ必須: いいえ ** metricAttributionArn ** メトリクス属性の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** name ** メトリクス属性の名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** status ** メトリクス属性のステータス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionSummary) # OptimizationObjective ストリーミング時間 (分) の最大化や収益の増加など、ソリューションの追加の目的を記述します。詳細については、「[ソリューションの最適化](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html)」を参照してください。 ## 内容 ** itemAttribute ** 最適化の目標に関連する Items データセットの数値メタデータ列。例えば、VIDEO\$1LENGTH (ストリーミング (分) を最大化するため) または PRICE (収益を最大化するため) です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 150 です。必須: いいえ ** objectiveSensitivity ** Amazon Personalize が最適化の目的の重要性と関連性のバランスをどのように取るかを指定します。型: 文字列有効な値：`LOW | MEDIUM | HIGH | OFF` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/OptimizationObjective) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/OptimizationObjective) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/OptimizationObjective) # Recipe レシピに関する情報を提供します。各レシピは、[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 操作を使用するときに Amazon Personalize がモデルトレーニングで使用するアルゴリズムを提供します。 ## 内容 ** algorithmArn ** Amazon Personalize がモデルをトレーニングするために使用するアルゴリズムの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** creationDateTime ** レシピの作成日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** description ** recipe の説明。タイプ: 文字列必須: いいえ ** featureTransformationArn ** FeatureTransformation オブジェクトの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** lastUpdatedDateTime ** レシピの最終更新日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** name ** レシピの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** recipeArn ** レシピの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** recipeType ** 次のいずれかの値になります。 + PERSONALIZED\$1RANKING + RELATED\$1ITEMS + USER\$1PERSONALIZATION タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** status ** レシピのステータス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recipe) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recipe) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recipe) # RecipeSummary レシピのプロパティの概要を提供します。詳細なリストについては、[DescribeRecipe](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecipe.html) API を呼び出してください。 ## 内容 ** creationDateTime ** レシピの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** domain ** レシピのドメイン (レシピがドメインデータセットグループのユースケースの場合)。型: 文字列有効な値：`ECOMMERCE | VIDEO_ON_DEMAND` 必須：いいえ ** lastUpdatedDateTime ** レシピが最後に更新された日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** レシピの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** recipeArn ** レシピの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** レシピのステータス。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecipeSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecipeSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecipeSummary) # Recommender ドメインデータセットグループのレコメンデーションジェネレーターを記述します。特定のドメインユースケース (ドメインレシピ) のドメインデータセットグループにレコメンダーを作成し、[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) リクエストでレコメンダーを指定します。 ## 内容 ** creationDateTime ** レコメンダーの作成日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** レコメンダーを含むドメインデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** failureReason ** レコメンダーが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** レコメンダーの最終更新日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** latestRecommenderUpdate ** レコメンダーに対する最新の更新の概要を提供します。型: [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) オブジェクト必須: いいえ ** modelMetrics ** レコメンダーのパフォーマンスを判断するのに役立つ評価メトリクスを提供します。詳細については、「[レコメンダーの評価](https://docs.aws.amazon.com/personalize/latest/dg/evaluating-recommenders.html)」を参照してください。タイプ: ダブルマップへの文字列。マップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。必須: いいえ ** name ** レコメンダーの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** recipeArn ** レコメンダーが作成されたレシピ (ドメインデータセットグループのユースケース) の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** recommenderArn ** レコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** recommenderConfig ** レコメンダーの設定の詳細。型: [RecommenderConfig](API_RecommenderConfig.md) オブジェクト必須: いいえ ** status ** レコメンダーのステータス。レコメンダーは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recommender) # RecommenderConfig レコメンダーの設定の詳細。 ## 内容 ** enableMetadataWithRecommendations ** レコメンデーション付きのメタデータがレコメンダーに対して有効になっているかどうか。有効にすると、レコメンデーションのリクエストでアイテムデータセットの列を指定できます。Amazon Personalize は、レコメンデーションレスポンス内の各アイテムについてこのデータを返します。レコメンダーのメタデータを有効にする方法については、「[Enabling metadata in recommendations for a recommender](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata)」を参照してください。レコメンデーションのメタデータを有効にすると、追加費用が発生します。詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。型: ブール値必須: いいえ ** itemExplorationConfig ** `explorationWeight` と `explorationItemAgeCutOff` を含む探索設定ハイパーパラメータ (Amazon Personalize がアイテムを推奨するときに使用するアイテム探索の量を設定するために使用するもの) を指定します。レコメンダーがユーザー向けにパーソナライズされたレコメンデーションを生成する場合にのみ `itemExplorationConfig` データを提供します (人気のあるアイテムや類似アイテムではありません)。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** minRecommendationRequestsPerSecond ** Amazon Personalize がサポートする、リクエストされた 1 秒あたりの最小プロビジョンドトランザクション (推奨) を指定します。`minRecommendationRequestsPerSecond` の値を高く設定すると請求額が増加します。最初は `minRecommendationRequestsPerSecond` に 1 を使用することをお勧めします (デフォルト)。低い `minRecommendationRequestsPerSecond` から始めて、Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じてを引き上げることをお勧めします。タイプ: 整数有効な範囲: 最小値は 1 です。必須: いいえ ** trainingDataConfig ** ドメインレコメンダーを作成するときに使用するトレーニングデータ設定を指定します。型: [TrainingDataConfig](API_TrainingDataConfig.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderConfig) # RecommenderSummary レコメンダーのプロパティの概要を提供します。 ## 内容 ** creationDateTime ** レコメンダーの作成日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** レコメンダーを含むドメインデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** lastUpdatedDateTime ** レコメンダーの最終更新日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** name ** レコメンダーの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** recipeArn ** レコメンダーが作成されたレシピ (ドメインデータセットグループのユースケース) の Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** recommenderArn ** レコメンダーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** recommenderConfig ** レコメンダーの設定の詳細。型: [RecommenderConfig](API_RecommenderConfig.md) オブジェクト必須: いいえ ** status ** レコメンダーのステータス。レコメンダーは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderSummary) # RecommenderUpdateSummary レコメンダーの更新のプロパティの概要を提供します。詳細なリストについては、[DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) API を呼び出してください。 ## 内容 ** creationDateTime ** レコメンダーの更新の作成日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** failureReason ** レコメンダーの更新が失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** レコメンダーの更新の最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** recommenderConfig ** レコメンダーの更新の設定の詳細。型: [RecommenderConfig](API_RecommenderConfig.md) オブジェクト必須: いいえ ** status ** レコメンダーの更新のステータス。レコメンダーの更新は、次に示す状態のいずれかになります。 CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderUpdateSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderUpdateSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderUpdateSummary) # S3DataConfig Amazon S3 の入力または出力バケットの設定の詳細。 ## 内容 ** path ** Amazon S3 バケットのファイルパス。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `(s3|http|https)://.+` 必須: はい ** kmsKeyArn ** Amazon Personalize が入力ファイルと出力ファイルを暗号化または復号するために使用する AWS Key Management Service (KMS) キーの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 2,048 です。パターン: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/S3DataConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/S3DataConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/S3DataConfig) # Solution **重要** デフォルトでは、すべての新しいソリューションで自動トレーニングが使用されます。自動トレーニングでは、ソリューションがアクティブな間はトレーニングコストが発生します。不要なコストを避けるために、完了したら[ソリューションを更新](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html)して自動トレーニングを無効にすることができます。トレーニングのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。ソリューションに関する情報を提供するオブジェクト。ソリューションには、Amazon Personalize がレコメンデーションを生成するために使用する、カスタムレシピ、カスタマイズされたパラメータ、およびトレーニング済みモデル (ソリューションバージョン) が含まれます。ソリューションを作成した後は、その設定を変更することはできません。変更を加える必要がある場合は、Amazon Personalize コンソールを使用して[ソリューションをクローン](https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html)するか、新しいソリューションを作成できます。 ## 内容 ** autoMLResult ** `performAutoML` が true の場合、見つかった最適なレシピを指定します。型: [AutoMLResult](API_AutoMLResult.md) オブジェクト必須: いいえ ** creationDateTime ** ソリューションの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** トレーニングデータを提供するデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** eventType ** モデルのトレーニングに使用されるイベントタイプ (例えば、「クリック」または「いいね」)。`eventType` が指定されていない場合、Amazon Personalize は、タイプにかかわらず、同じ重みでトレーニングするためにすべてのインタラクションを使用します。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** lastUpdatedDateTime ** ソリューションの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** latestSolutionUpdate ** ソリューションに対する最新の更新の概要を提供します。型: [SolutionUpdateSummary](API_SolutionUpdateSummary.md) オブジェクト必須: いいえ ** latestSolutionVersion ** ステータスと ARN を含む、ソリューションの最新バージョンを記述します。型: [SolutionVersionSummary](API_SolutionVersionSummary.md) オブジェクト必須: いいえ ** name ** ソリューションの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** performAutoML ** 自動機械学習の有効化は推奨されません。代わりに、利用可能な Amazon Personalize のレシピにユースケースをマッチさせます。詳細については、「[ユースケースの特定](https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html)」を参照してください。 true の場合、Amazon Personalize は、ソリューション構成で指定されたリストから最適な USER\$1PERSONALIZATION recipe の検索を実行します (`recipeArn` を指定しないでください)。false (デフォルト) の場合、Amazon Personalize はトレーニングに `recipeArn` を使用します。タイプ: ブール値必須: いいえ ** performAutoTraining ** ソリューションが自動的にソリューションバージョンを作成するかどうかを指定します。デフォルトは `True` で、ソリューションは 7 日ごとに新しいソリューションバージョンを自動的に作成します。自動トレーニングの詳細については、「[ソリューションの作成と構成](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)」を参照してください。タイプ: ブール値必須: いいえ ** performHPO ** 選択したレシピでハイパーパラメータ最適化 (HPO) を実行するかどうか。デフォルトは `false` です。タイプ: ブール値必須: いいえ ** performIncrementalUpdate ** モデルで増分トレーニング更新が実行されるかどうかを示すブール値。これにより、モデルは完全な再トレーニングを必要とせずに新しいデータからより頻繁に学習できるため、ほぼリアルタイムのパーソナライゼーションが可能になります。このパラメータは、セマンティック類似度レシピを使用するソリューションでのみサポートされます。タイプ: ブール値必須: いいえ ** recipeArn ** ソリューションの作成に使用されたレシピの ARN。これは、`performAutoML` が false の場合に必要です。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** solutionArn ** ソリューションの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** solutionConfig ** ソリューションの設定プロパティを記述します。型: [SolutionConfig](API_SolutionConfig.md) オブジェクト必須: いいえ ** status ** ソリューションのステータス。ソリューションは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Solution) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Solution) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Solution) # SolutionConfig ソリューションの構成プロパティを記述します。 ## 内容 ** algorithmHyperParameters ** アルゴリズムのハイパーパラメータとその値を一覧表示します。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** autoMLConfig ** AutoML の実行時に検索する recipe のリストを含む [AutoMLConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_AutoMLConfig.html) オブジェクト。型: [AutoMLConfig](API_AutoMLConfig.md) オブジェクト必須: いいえ ** autoTrainingConfig ** 使用する自動トレーニング設定を指定します。型: [AutoTrainingConfig](API_AutoTrainingConfig.md) オブジェクト必須: いいえ ** eventsConfig ** イベントの設定について説明します。これにはイベントパラメータのリストが含まれます。最大 10 個のイベントパラメータを指定できます。イベントはソリューションの作成に使用されます。型: [EventsConfig](API_EventsConfig.md) オブジェクト必須: いいえ ** eventValueThreshold ** モデルのトレーニングには、このしきい値以上の値を持つイベントのみが使用されます。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** featureTransformationParameters ** 特徴変換パラメータを一覧表示します。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ** hpoConfig ** ハイパーパラメータ最適化 (HPO) のプロパティを記述します。型: [HPOConfig](API_HPOConfig.md) オブジェクト必須: いいえ ** optimizationObjective ** ストリーミング時間 (分) の最大化や収益の増加など、ソリューションの追加の目的を記述します。詳細については、「[ソリューションの最適化](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html)」を参照してください。型: [OptimizationObjective](API_OptimizationObjective.md) オブジェクト必須: いいえ ** trainingDataConfig ** カスタムソリューションバージョン (トレーニング済みモデル) を作成するときに使用するトレーニングデータ構成を指定します。型: [TrainingDataConfig](API_TrainingDataConfig.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionConfig) # SolutionSummary ソリューションのプロパティの概要を提供します。詳細なリストについては、[DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API を呼び出してください。 ## 内容 ** creationDateTime ** ソリューションの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** lastUpdatedDateTime ** ソリューションの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** ソリューションの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** recipeArn ** ソリューションによって使用されるレシピの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** solutionArn ** ソリューションの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** ソリューションのステータス。ソリューションは、次に示す状態のいずれかになります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionSummary) # SolutionUpdateConfig ソリューション更新の設定の詳細。 ## 内容 ** autoTrainingConfig ** `performAutoTraining` が true の場合に使用する自動トレーニング設定。型: [AutoTrainingConfig](API_AutoTrainingConfig.md) オブジェクト必須: いいえ ** eventsConfig ** イベントの設定について説明します。これにはイベントパラメータのリストが含まれます。最大 10 個のイベントパラメータを指定できます。イベントはソリューションの作成に使用されます。型: [EventsConfig](API_EventsConfig.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateConfig) # SolutionUpdateSummary ソリューションの更新のプロパティの概要を提供します。詳細なリストについては、[DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API を呼び出してください。 ## 内容 ** creationDateTime ** ソリューションの更新の作成日時 (Unix 形式)。型: タイムスタンプ必須: いいえ ** failureReason ** ソリューションの更新が失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** ソリューションの更新の最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** performAutoTraining ** ソリューションが自動的にソリューションバージョンを作成するかどうか。タイプ: ブール値必須: いいえ ** performIncrementalUpdate ** モデルで増分トレーニング更新が実行されるかどうかを示すブール値。有効にすると、アクティブなキャンペーンを持つソリューションバージョンに対して増分トレーニングが実行され、モデルは完全な再トレーニングを必要とせずに新しいデータからより頻繁に学習できるため、ほぼリアルタイムのパーソナライゼーションが可能になります。このパラメータは、セマンティック類似度レシピを使用するソリューションでのみサポートされます。デフォルトは `true` です。特定のスコアや属性 (aws-semantic-similarity レシピによるランキングの影響に使用されるアイテムの人気や鮮度の更新など) は、次の完全なトレーニングが行われるまで更新されない場合があることに注意してください。タイプ: ブール値必須: いいえ ** solutionUpdateConfig ** ソリューションの設定の詳細。型: [SolutionUpdateConfig](API_SolutionUpdateConfig.md) オブジェクト必須: いいえ ** status ** ソリューションの更新のステータス。ソリューションの更新は、次に示す状態のいずれかになります。 CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateSummary) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateSummary) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateSummary) # SolutionVersion カスタムデータセットグループ内の[ソリューション](https://docs.aws.amazon.com/personalize/latest/dg/API_Solution.html)の特定のバージョンに関する情報を提供するオブジェクト。 ## 内容 ** creationDateTime ** このバージョンのソリューションの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** datasetGroupArn ** トレーニングデータを提供するデータセットグループの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** eventType ** モデルのトレーニングに使用されるイベントタイプ (例えば、「クリック」または「いいね」)。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** failureReason ** ソリューションバージョンのトレーニングが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** ソリューションの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** name ** ソリューションバージョンの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** performAutoML ** true の場合、Amazon Personalize は、ソリューション設定に従って最適なレシピを検索します。false (デフォルト) の場合、Amazon Personalize は `recipeArn` を使用します。タイプ: ブール値必須: いいえ ** performHPO ** 選択したレシピでハイパーパラメータ最適化 (HPO) を実行するかどうか。デフォルトは `false` です。タイプ: ブール値必須: いいえ ** performIncrementalUpdate ** ソリューションバージョンが増分更新を実行するかどうか。true に設定すると、トレーニングは trainingMode が UPDATE に設定されている場合と同様に、最新のトレーニング以降に変更されたデータのみを処理します。これは、User-Personalization レシピを使用するソリューションバージョンでのみ使用できます。タイプ: ブール値必須: いいえ ** recipeArn ** ソリューションで使用されるレシピの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** solutionArn ** ソリューションの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** solutionConfig ** ソリューションの設定プロパティを記述します。型: [SolutionConfig](API_SolutionConfig.md) オブジェクト必須: いいえ ** solutionVersionArn ** ソリューションバージョンの ARN。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** ソリューションバージョンのステータス。ソリューションバージョンは、次のいずれかの状態になります。 + CREATE PENDING + CREATE IN\$1PROGRESS + アクティブ + CREATE FAILED + CREATE STOPPING + CREATE STOPPED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** trainingHours ** モデルのトレーニングに使用した時間。モデルのトレーニングにかかる時間について請求されます。このフィールドは、Amazon Personalize がモデルのトレーニングに成功した後にのみ表示されます。型: 倍精度有効な範囲: 最小値は 0 です。必須: いいえ ** trainingMode ** ソリューションバージョンを作成するときに実行するトレーニングの範囲。`FULL` トレーニングでは、データセットグループ内のすべてのデータを考慮します。`UPDATE` は、最新のトレーニング以降に変更されたデータのみを処理します。User-Personalization レシピで作成されたソリューションバージョンのみが `UPDATE` を使用できます。型: 文字列有効な値：`FULL | UPDATE | AUTOTRAIN` 必須：いいえ ** trainingType ** ソリューションバージョンが自動または手動で作成されたかどうか。型: 文字列有効な値：`AUTOMATIC | MANUAL` 必須：いいえ ** tunedHPOParams ** ハイパーパラメータ最適化が実行された場合、最もパフォーマンスの高いモデルのハイパーパラメータ値が含まれます。型: [TunedHPOParams](API_TunedHPOParams.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersion) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersion) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersion) # SolutionVersionSummary ソリューションバージョンのプロパティの概要を提供します。詳細なリストについては、[DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) API を呼び出してください。 ## 内容 ** creationDateTime ** このバージョンのソリューションの作成日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** failureReason ** ソリューションバージョンが失敗した場合、失敗の理由。タイプ: 文字列必須: いいえ ** lastUpdatedDateTime ** ソリューションバージョンの最終更新日時 (Unix 時間)。型: タイムスタンプ必須: いいえ ** solutionVersionArn ** ソリューションバージョンの Amazon リソースネーム (ARN)。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** status ** ソリューションバージョンのステータス。ソリューションバージョンは、次のいずれかの状態になります。 + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -または- CREATE FAILED タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** trainingMode ** ソリューションバージョンを作成するときに実行するトレーニングの範囲。`FULL` トレーニングでは、データセットグループ内のすべてのデータを考慮します。`UPDATE` は、最新のトレーニング以降に変更されたデータのみを処理します。User-Personalization レシピで作成されたソリューションバージョンのみが `UPDATE` を使用できます。型: 文字列有効な値：`FULL | UPDATE | AUTOTRAIN` 必須：いいえ ** trainingType ** ソリューションバージョンが自動または手動で作成されたかどうか。型: 文字列有効な値：`AUTOMATIC | MANUAL` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersionSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersionSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersionSummary) # Tag リソースに適用し、リソースの分類と整理に役立つオプションのメタデータ。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。詳細については、「[Amazon Personalize のリソースにタグ付けする](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)」を参照してください。 ## 内容 ** tagKey ** タグを構成するキーと値のペアの一部。キーは、より具体的なタグ値のカテゴリのように動作する、一般的なラベルです。タイプ: 文字列長さの制限: 最小長は 1 です。最大長は 128 です。パターン: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 必須: はい ** tagValue ** タグを構成するキーと値のペアのオプションの一部。値はタグカテゴリ (キー) の記述子として機能します。タイプ: 文字列長さの制約: 最小長は 0 です。最大長は 256 です。パターン: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Tag) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Tag) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Tag) # ThemeGenerationConfig バッチ推論ジョブでテーマを生成するための設定の詳細。 ## 内容 ** fieldsForThemeGeneration ** バッチ推論ジョブの説明テーマを生成するために使用されるフィールド。型: [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ThemeGenerationConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ThemeGenerationConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ThemeGenerationConfig) # TrainingDataConfig ドメインレコメンダーまたはカスタムソリューションバージョン (トレーニング済みモデル) を作成するときに使用するトレーニングデータ構成。 ## 内容 ** excludedDatasetColumns ** トレーニングから除外する列を指定します。各キーはデータセットタイプで、各値は列のリストです。列を除外することで、Amazon Personalize がレコメンデーションの生成に使用するデータを制御できます。例えば、レコメンデーションをフィルタリングするためだけに使用したい列があるとします。この列をトレーニングから除外すると、Amazon Personalize はフィルタリング時にのみこの列を考慮します。タイプ: 文字列マップの配列への文字列マップエントリ: アイテムの最大数は 3 です。キーの長さの制限: 最大長は 256 です。キーパターン: `^[A-Za-z_]+$` 配列メンバー: 最大数は 50 品目です。長さの制限: 最大長は 1,024 です。パターン: `[A-Za-z_][A-Za-z\d_]*` 必須: いいえ ** includedDatasetColumns ** トレーニングから含める列を指定します。各キーはデータセットタイプで、各値は列のリストです。Amazon Personalize がレコメンデーションの生成に使用するデータを制御するための列を含めます。たとえば、項目データセットに複数の列があっても、トレーニングにタイトルと説明のみを使用したいとします。トレーニングにはこれら 2 つの列のみを含めることができ、Amazon Personalize はトレーニングには含まれている列のみを考慮します。タイプ: 文字列マップの配列への文字列マップエントリ: アイテムの最大数は 3 です。キーの長さの制限: 最大長は 256 です。キーパターン: `^[A-Za-z_]+$` 配列メンバー: 最大数は 50 品目です。長さの制限: 最大長は 1,024 です。パターン: `[A-Za-z_][A-Za-z\d_]*` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWSSDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TrainingDataConfig) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TrainingDataConfig) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TrainingDataConfig) # TunedHPOParams ハイパーパラメータ最適化 (HPO) が実行された場合、最もパフォーマンスの高いモデルのハイパーパラメータ値が含まれます。 ## 内容 ** algorithmHyperParameters ** 最高のパフォーマンスを発揮するモデルのハイパーパラメータ値のリスト。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 100 です。キーの長さの制限: 最大長は 256 です。値の長さの制限: 最大長は 1000 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TunedHPOParams) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TunedHPOParams) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TunedHPOParams) # Amazon Personalize Events 次のデータ型は、Amazon Personalize Events でサポートされています。 + [Action](API_UBS_Action.md) + [ActionInteraction](API_UBS_ActionInteraction.md) + [Event](API_UBS_Event.md) + [Item](API_UBS_Item.md) + [MetricAttribution](API_UBS_MetricAttribution.md) + [User](API_UBS_User.md) # Action `PutActions` API を使用してアクションデータセットに追加されたアクションメタデータを表します。詳細については、「[Importing actions individually](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html)」を参照してください。 ## 内容 ** actionId ** アクションに関連付けられた ID。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** properties ** アクション固有のメタデータの文字列マップ。マップの各要素は、キーバリューペアで設定されています。例えば、`{"value": "100"}`。キーは、アクションデータセットのスキーマ内のフィールドと一致するキャメルケース名を使用します。前の例では、`value` はアクションスキーマで定義された「VALUE」フィールドと一致します。カテゴリ文字列データについて、単一のアクションに複数のカテゴリを含めるには、各カテゴリをパイプ区切り文字 (`|`) で区切ります。例えば、`\"Deluxe|Premium\"` です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 32,000 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Action) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Action) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Action) # ActionInteraction `PutActionInteractions` API を使用して送信されるアクションインタラクションイベントを表します。 ## 内容 ** actionId ** ユーザーが操作したアクションの ID。これはアクションインタラクションスキーマの `ACTION_ID` フィールドに対応します。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** eventType ** アクションインタラクションイベントのタイプ。`Viewed`、`Taken`、および `Not Taken` イベントタイプを指定できます。アクションインタラクションのイベントタイプデータについて詳しくは、「[Event type data](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-event-type-data.html)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** sessionId ** ユーザーの訪問に関連付けられたセッション ID。アプリケーションは、ユーザーが最初にウェブサイトにアクセスしたとき、またはアプリケーションを使用したときに、一意の `sessionId` を生成します。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** timestamp ** アクションインタラクションイベントが発生したときのタイムスタンプ。タイムスタンプは Unix エポック時刻形式 (秒単位) である必要があります。タイプ: タイムスタンプ必須: はい ** eventId ** イベントに関連付けられた ID。イベント ID が指定されていない場合、Amazon Personalize はイベントの一意の ID を生成します。イベント ID はモデルへの入力として使用されません。Amazon Personalize は、イベント ID を使用して一意のイベントを区別します。同じイベント ID を持つ最初のイベント以降の後続のイベントは、モデルトレーニングでは使用されません。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** impression ** ユーザーに表示したアクションのシーケンスを表すアクション ID のリスト。例えば、`["actionId1", "actionId2", "actionId3"]`。Amazon Personalize は、アクションインタラクションイベントのインプレッションデータを使用しません。代わりに、アクションごとに複数のイベントを記録し、`Viewed` イベントタイプを使用してください。型: 文字列の配列配列メンバー: 最小数は 1 項目です。最大数は 25 項目です。長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** properties ** 記録することを選択する可能性のあるイベント固有のデータの文字列マップ。例えば、ユーザーがアクションを実行した場合 (アクション ID 以外)、ユーザーが行ったアクションの数を送信することもできます。マップの各アイテムは、キーバリューペアで設定されています。例: `{"numberOfActions": "12"}` キーは、アクションインタラクションスキーマのフィールドと一致するキャメルケース名を使用します。上の例では、`numberOfActions` はアクションインタラクションスキーマで定義された「NUMBER\$1OF\$1ACTIONS」フィールドと一致します。以下はプロパティのキーワードとして含めることはできません (大文字と小文字は区別されません)。 + userId + sessionId + eventType + timestamp + recommendationId + インプレッションタイプ: 文字列長さの制限: 最小長は 1 です。最大長は 1,024 です。必須: いいえ ** recommendationId ** ユーザーが操作したアイテムを含むレコメンデーションのリストの ID。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 40 です。必須: いいえ ** userId ** アクションを操作したユーザーの ID。これはアクションインタラクションスキーマの `USER_ID` フィールドに対応します。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/ActionInteraction) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/ActionInteraction) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/ActionInteraction) # Event `PutEvents` API を使用して送信されるアイテムインタラクションのイベント情報を表します。 ## 内容 ** eventType ** イベントのタイプ (クリックやダウンロードなど)。このプロパティは、アイテムインタラクションデータセットスキーマの `EVENT_TYPE` フィールドに対応し、追跡しているイベントのタイプによって異なります。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** sentAt ** イベントが発生したときのクライアント側のタイムスタンプ (Unix 時間)。タイプ: タイムスタンプ必須: はい ** eventId ** イベントに関連付けられた ID。イベント ID が指定されていない場合、Amazon Personalize はイベントの一意の ID を生成します。イベント ID はモデルへの入力として使用されません。Amazon Personalize は、イベント ID を使用して一意のイベントを区別します。同じイベント ID を持つ最初のイベント以降の後続のイベントは、モデルトレーニングでは使用されません。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** eventValue ** アイテムインタラクションスキーマの `EVENT_VALUE` フィールドに対応するイベント値。タイプ: 浮動小数点必須: いいえ ** impression ** ユーザーに表示したアイテムのシーケンスを表すアイテム ID のリスト。例えば、`["itemId1", "itemId2", "itemId3"]`。イベントのインプレッションデータを手動で記録する項目のリストを提供します。インプレッションデータの記録についての詳細は、「[インプレッションデータの記録](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data)」を参照してください。型: 文字列の配列配列メンバー: 最小数は 1 項目です。最大数は 25 項目です。長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** itemId ** アイテムインタラクションデータセットのスキーマの `ITEM_ID` フィールドに対応するアイテム ID キー。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** metricAttribution ** イベントに関連するメトリクス属性に関する情報が含まれています。メトリクス属性についての詳細は、「[レコメンデーションの影響の測定](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)」を参照してください。型: [MetricAttribution](API_UBS_MetricAttribution.md) オブジェクト必須: いいえ ** properties ** 記録することを選択する可能性のあるイベント固有のデータの文字列マップ。例えば、ユーザーがサイトで映画を評価した場合 (映画 ID (`itemId`) とレーティング (`eventValue`) 以外)、ユーザーが行った映画のレーティングの数を送信することもできます。マップの各アイテムは、キーバリューペアで設定されています。例: `{"numberOfRatings": "12"}` キーは、アイテムインタラクションデータセットのスキーマのフィールドと一致するキャメルケース名を使用します。上の例では、`numberOfRatings` はアイテムインタラクションデータセットのスキーマで定義された「NUMBER\$1OF\$1RATINGS」フィールドと一致します。以下はプロパティのキーワードとして含めることはできません (大文字と小文字は区別されません)。 + userId + sessionId + eventType + timestamp + recommendationId + インプレッションタイプ: 文字列長さの制限: 最小長は 1 です。最大長は 1,024 です。必須: いいえ ** recommendationId ** ユーザーが操作したアイテムを含むレコメンデーションのリストの ID。Amazon Personalize がユーザーに表示したレコメンデーションをインプレッションデータとして暗黙のうちに記録するには、`recommendationId` を指定します。または、メトリクス属性を使用してレコメンデーションの影響を測定する場合は `recommendationId` を指定します。インプレッションデータの記録についての詳細は、「[インプレッションデータの記録](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data)」を参照してください。メトリクス属性の作成について詳しくは、「[レコメンデーションの影響の測定](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 40 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Event) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Event) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Event) # Item `PutItems` API を使用して Items データセットに追加されたアイテムメタデータを表します。詳細については、「[Importing items individually](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html)」を参照してください。 ## 内容 ** itemId ** アイテムに関連付けられた ID。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** properties ** アイテム固有のメタデータの文字列マップ。マップの各要素は、キーバリューペアで設定されています。例えば、`{"numberOfRatings": "12"}`。キーは、Items データセットのスキーマ内のフィールドと一致するキャメルケース名を使用します。前の例では、`numberOfRatings` は Items スキーマで定義された「NUMBER\$1OF\$1RATINGS」フィールドと一致します。カテゴリ文字列データについて、単一のアイテムに複数のカテゴリを含めるには、各カテゴリをパイプ区切り文字 (`|`) で区切ります。例えば、`\"Horror|Action\"` です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 32,000 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Item) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Item) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Item) # MetricAttribution イベントに関連するメトリクス属性に関する情報が含まれます。メトリクス属性についての詳細は、「[レコメンデーションの影響の測定](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)」を参照してください。 ## 内容 ** eventAttributionSource ** サードパーティーなどのイベントのソース。タイプ: 文字列長さの制約: 最大長は 1,024 です。パターン: `^[\x20-\x7E]*[\x21-\x7E]+[\x20-\x7E]*$` 必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/MetricAttribution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/MetricAttribution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/MetricAttribution) # User `PutUsers` API を使用して Users データセットに追加されたユーザーメタデータを表します。詳細については、「[Importing users individually](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html)」を参照してください。 ## 内容 ** userId ** ユーザーに関連付けられた ID。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ** properties ** アイテム固有のメタデータの文字列マップ。マップの各要素は、キーバリューペアで設定されています。例えば、`{"numberOfVideosWatched": "45"}`。キーは、Users データセットのスキーマ内のフィールドと一致するキャメルケース名を使用します。前の例では、`numberOfVideosWatched` は Users スキーマで定義された「NUMBER\$1OF\$1VIDEOS\$1WATCHED」フィールドに一致します。カテゴリ文字列データについて、単一のユーザーに複数のカテゴリを含めるには、各カテゴリをパイプ区切り文字 (`|`) で区切ります。例えば、`\"Member|Frequent shopper\"` です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 24,000 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/User) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/User) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/User) # Amazon Personalize Runtime 次のデータ型は、Amazon Personalize Runtime でサポートされています。 + [PredictedAction](API_RS_PredictedAction.md) + [PredictedItem](API_RS_PredictedItem.md) + [Promotion](API_RS_Promotion.md) # PredictedAction アクションを識別するオブジェクト。 [GetActionRecommendations](API_RS_GetActionRecommendations.md) API は `PredictedAction` のリストを返します。 ## 内容 ** actionId ** レコメンデーションアクションの ID。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** score ** レコメンデーションアクションのスコア。アクションスコアの詳細については、「[How action recommendation scoring works](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html)」を参照してください。型: 倍精度浮動小数点数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedAction) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedAction) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedAction) # PredictedItem アイテムを識別するオブジェクト。 [GetRecommendations](API_RS_GetRecommendations.md) および [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) API は、`PredictedItem` のリストを返します。 ## 内容 ** itemId ** 推奨アイテム ID。タイプ: 文字列長さの制約: 最大長は 256 です。必須: いいえ ** metadata ** アイテムデータセットのアイテムに関するメタデータ。型: 文字列間のマッピングキーの長さの制限: 最大長は 150 です。値の長さの制限: 最大長は 20,000 です。必須: いいえ ** promotionName ** 予測アイテムを含むプロモーションの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** reason ** User-Personalization-v2 を使用する場合、アイテムがレコメンデーションに含まれていた原因のリスト。次のような原因が考えられます。 + プロモーション対象アイテム - レコメンデーションリクエストに適用したプロモーションの一部としてアイテムが含まれていたことを示します。 + 探索 - アイテムが探索に含まれていたことを示します。探索では、レコメンデーションに、インタラクションデータまたはユーザーとの関連性が少ないアイテムが含まれます。探索の詳細については、「[探索](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#about-exploration)」を参照してください。 + 人気のあるアイテム - アイテムがプレースホルダーの人気のあるアイテムとして含まれていたことを示します。フィルターを使用する場合、フィルターが削除するレコメンデーションの数に応じて、Amazon Personalize はレコメンデーションリクエストの `numResults` を満たすプレースホルダーアイテムを追加する場合があります。これらのアイテムは、インタラクションデータに基づいて、フィルター基準を満たす一般的なアイテムです。これらにはユーザーの関連性スコアがありません。型: 文字列の配列長さの制約: 最大長は 256 です。必須: いいえ ** score ** 次にユーザーが該当のアイテムを選択することについての、モデルの確実性の数値表現。スコアリングロジックの詳細については、「[レコメンデーションスコア](getting-recommendations.md#how-scores-work)」を参照してください。型: 倍精度浮動小数点数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedItem) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedItem) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedItem) # Promotion プロモーションに関する情報が含まれています。プロモーションは、設定可能な推奨アイテムのサブセットに適用される追加のビジネスルールを定義します。 ## 内容 ** filterArn ** プロモーションで使用される Amazon リソースネーム (ARN)。このフィルターはプロモーション対象アイテムの条件を定義します。フィルターを使用する方法については、「プロモーションフィルター」を参照してください。タイプ: 文字列長さの制約: 最大長は 256 です。パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+` 必須: いいえ ** filterValues ** アイテムをプロモーションするときに使用する値。フィルター式の各プレースホルダーパラメータについて、(大文字と小文字が一致した状態で) パラメータ名をキーとして指定し、フィルター値を対応する値として指定します。1 つのパラメータの複数の値をコンマで区切ります。 `INCLUDE` 要素を使用してアイテムを含めるフィルター式について、式で定義されているすべてのパラメータの値を指定する必要があります。`EXCLUDE` 要素を使用してアイテムを除外する式を含むフィルターについては、`filter-values` を省略できます。この場合、Amazon Personalize は、式のその部分を使用してレコメンデーションをフィルタリングしません。フィルター作成についての詳細は、「[レコメンデーションとユーザーセグメントのフィルタリング](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)」を参照してください。型: 文字列間のマッピングマップエントリ: アイテムの最大数は 25 です。キーの長さの制限: 最大長は 50 です。キーパターン: `[A-Za-z0-9_]+` 値の長さの制限: 最大長は 1000 です。必須: いいえ ** name ** プロモーションの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 63 です。パターン: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必須: いいえ ** percentPromotedItems ** プロモーションを適用する推奨アイテム品の割合。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion) # 共通エラーこのセクションでは、AWS のすべてのサービスの API アクションに共通のエラーを一覧表示しています。このサービスの API アクションに固有のエラーについては、その API アクションのトピックを参照してください。 **AccessDeniedException** このアクションを実行する十分なアクセス権限がありません。 HTTP ステータスコード: 400 **IncompleteSignature** リクエストの署名が AWS 基準に適合しません。 HTTP ステータスコード: 400 **InternalFailure** リクエストの処理が、不明なエラー、例外、または障害により実行できませんでした。 HTTP ステータスコード: 500 **InvalidAction** リクエストされたアクション、またはオペレーションは無効です。アクションが正しく入力されていることを確認してください。 HTTP ステータスコード: 400 **InvalidClientTokenId** 指定された X.509 証明書または AWS アクセスキー ID がレコード内に見つかりません。 HTTP ステータスコード: 403 **NotAuthorized** このアクションを実行するためのアクセス許可がありません。 HTTP ステータスコード: 400 **OptInRequired** サービスを利用するためには、AWS アクセスキー ID を取得する必要があります。 HTTP ステータスコード: 403 **RequestExpired** リクエストの日付スタンプの 15 分以上後またはリクエストの有効期限 (署名付き URL の場合など) の 15 分以上後に、リクエストが到着しました。または、リクエストの日付スタンプが現在より 15 分以上先です。 HTTP ステータスコード: 400 **ServiceUnavailable** サーバーの一時的な障害により、リクエストは失敗しました。 HTTP ステータスコード: 503 **ThrottlingException** リクエストのスロットリングにより、リクエストが拒否されました。 HTTP ステータスコード: 400 **ValidationError** 入力が、AWS サービスで指定された制約を満たしていません。 HTTP ステータスコード: 400 # 共通パラメータ次のリストには、すべてのアクションが署名バージョン 4 リクエストにクエリ文字列で署名するために使用するパラメータを示します。アクション固有のパラメータは、アクションのトピックに示されています。署名バージョン 4 の詳細については、*IAM ユーザーガイド*[の AWS API リクエストの署名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)を参照してください。 **X-Amz-Algorithm** リクエストの署名を作成するのに使用したハッシュアルゴリズム。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列有効な値：`AWS4-HMAC-SHA256` 必須: 条件による **X-Amz-Credential** 認証情報スコープの値で、アクセスキー、日付、対象とするリージョン、リクエストしているサービス、および終了文字列 ("aws4\$1request") を含む文字列です。値は次の形式で表現されます: [*access\$1key*/*YYYYMMDD*/*リージョン*/*サービス*/aws4\$1request]。詳細については、*IAM* [ユーザーガイドの「署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列必須: 条件による **X-Amz-Date** 署名を作成するときに使用する日付です。形式は ISO 8601 基本形式の YYYYMMDD'T'HHMMSS'Z' でなければなりません。例えば、日付 `20120325T120000Z` は、有効な X-Amz-Date の値です。条件: X-Amz-Date はすべてのリクエストに対してオプションです。署名リクエストで使用する日付よりも優先される日付として使用できます。ISO 8601 ベーシック形式で日付ヘッダーが指定されている場合、X-Amz-Date は必要ありません。X-Amz-Date を使用すると、常に Date ヘッダーの値よりも優先されます。詳細については、*IAM ユーザーガイド*[の AWS API リクエスト署名の要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)を参照してください。タイプ: 文字列必須: 条件による **X-Amz-Security-Token** AWS Security Token Service () の呼び出しによって取得された一時的なセキュリティトークンAWS STS。 AWS STSの一時的なセキュリティ認証情報をサポートするサービスのリストについては、「IAM ユーザーガイド」の「[IAM と連携するAWS のサービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。条件: から一時的なセキュリティ認証情報を使用している場合は AWS STS、セキュリティトークンを含める必要があります。タイプ: 文字列必須: 条件による **X-Amz-Signature** 署名する文字列と派生署名キーから計算された 16 進符号化署名を指定します。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列必須: 条件による **X-Amz-SignedHeaders** 正規リクエストの一部として含まれていたすべての HTTP ヘッダーを指定します。署名付きヘッダーの指定の詳細については、*IAM* [ユーザーガイドの「署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列必須: 条件による