翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # アクション 次のアクションは、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)