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

CreateRecommender

指定したレシピ (ドメインデータセットグループのユースケース) を使用してレコメンダーを作成します。ドメインデータセットグループのレコメンダーを作成し、リクエストを行うときにレコメンダーの Amazon リソースネーム (ARN) を指定します。GetRecommendations

1 秒あたりの最小レコメンデーションリクエスト数

レコメンダーを作成する際、レコメンダーの 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必要に応じて値を増やすことをお勧めします。

[ステータス]

レコメンダーは、次に示す状態のいずれかになります。

レコメンダーステータスを取得するには、お電話くださいDescribeRecommender。

リクエストの構文

{
   "datasetGroupArn": "string",
   "name": "string",
   "recipeArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

リクエストパラメータ

リクエストは以下の JSON 形式のデータを受け入れます。

レスポンスの構文

{
   "recommenderArn": "string"
}

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

エラー

その他の参照資料

言語固有の AWS SDK の 1 つでこの API を使用する方法の詳細については、以下を参照してください。