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