レコメンダーの停止と開始

レコメンダーがアクティブになったら、レコメンダーを停止して後で開始できます。こうすることで、レコメンダーへの請求を一時停止して、使用したときだけ料金を支払うことができます。例えば、特定の曜日にのみレコメンデーションを取得する必要がある場合があります。必要のない日にレコメンダーを停止し、必要な日にレコメンダーを開始できます。

レコメンダーを停止すると、レコメンダーを使用してレコメンデーションを取得することはできません。レコメンダーを停止すると、レコメンダーへの請求と再トレーニングは停止されます。ただし、レコメンダーを停止してもレコメンダーは削除されません。いつでも再起動して、レコメンデーションの取得を再開できます。レコメンダーを開始しても、データを使用して新しいレコメンダーは作成されません。そうではなく、レコメンダーへの請求と再トレーニングが 7 日ごとに再開されます。

Amazon Personalize コンソール、 AWS Command Line Interface （AWS CLI）、 AWS SDKsオペレーションを使用して、レコメンダーを停止StartRecommenderおよび開始できます。 StopRecommender

レコメンダーの状態

レコメンダーを停止すると、レコメンダーの状態は次の順序でアクティブから非アクティブに変わります。

アクティブ > 保留中止 > 進行中停止 > 非アクティブ

レコメンダーを起動すると、レコメンダーの状態は次の順序でインアクティブからアクティブに変わります。

非アクティブ > 保留中開始 > 進行中 > アクティブ

レコメンダーの停止および開始 (コンソール)

Amazon Personalize を使用して、レコメンダーの停止および再開ができます。

トピック

• レコメンダーの停止 (コンソール)
• レコメンダーを起動する (コンソール)

レコメンダーの停止 (コンソール)

Amazon Personalize コンソールを使用してアクティブなレコメンダーを停止するには、次のようにします。

レコメンダーを停止するには

1. https://console.aws.amazon.com/personalize/home で Amazon Personalize コンソールを開き、アカウントにサインインします。

2. [データセットグループ] のページで、ドメインデータセットグループを選択します。

3. ナビゲーションペインから、[レコメンダー] を選択します。

4. [レコメンダー] のページで、更新するレコメンダーを選択します。

5. 右上の [レコメンダーを停止] を選択し、表示されるウィンドウで確認します。

   レコメンダーのステータスが非アクティブになると、レコメンダーは停止しています。これにより、レコメンダーへの請求と再トレーニングは停止されます。レコメンダーは起動するまで使用できません。

レコメンダーを起動する (コンソール)

Amazon Personalize コンソールを使用して、次のように非アクティブなレコメンダーを開始できます。

レコメンダーを開始するには

1. https://console.aws.amazon.com/personalize/home で Amazon Personalize コンソールを開き、アカウントにサインインします。

2. [データセットグループ] のページで、ドメインデータセットグループを選択します。

3. ナビゲーションペインから、[レコメンダー] を選択します。

4. [レコメンダー] のページで、更新するレコメンダーを選択します。

5. 右上の [レコメンダーを開始] を選択し、表示されるウィンドウでレコメンダーを開始することを確認します。

   レコメンダーの状態がアクティブになったら、レコメンダーからのレコメンデーションの取得を再開できます。レコメンダーへの請求と自動再トレーニングも再開されます。

レコメンダーの停止と再開 (AWS CLI)

でアクティブなレコメンダーを停止するには AWS CLI、 stop-recommender コマンドを使用して、次のようにレコメンダーの Amazon リソースネーム (ARN) を指定します。

aws personalize stop-recommender --recommender-arn "recommender arn"

で非アクティブなレコメンダーを開始するには AWS CLI、 start-recommender コマンドを使用して、停止したレコメンダーの ARN を次のように指定します。

aws personalize start-recommender --recommender-arn "recommender arn"

StartRecommender API オペレーションの詳細については、「」および「StopRecommender」を参照してください。

レコメンダーの停止と再起動 (AWS SDKs)

AWS SDKs を使用して、アクティブなレコメンダーを開始したり、非アクティブなレコメンダーを停止したりできます。StartRecommender API オペレーションの詳細については、「」および「StopRecommender」を参照してください。

トピック

• レコメンダーの停止 (AWS SDKs)
• レコメンダーの開始 (AWS SDKs)

レコメンダーの停止 (AWS SDKs)

次のコードは、 AWS SDKs を使用してアクティブなレコメンダーを停止する方法を示しています。停止すると、レコメンダーへの請求と自動再トレーニングがすべて停止します。レコメンダーは再起動するまで使用できません。

SDK for Python (Boto3)

SDK for Python (Boto3) でアクティブなレコメンダーを停止するには、stop_recommender メソッドを使用し、レコメンダーの Amazon リソースネーム (ARN) を次のように指定します。

import boto3
personalize = boto3.client('personalize')

stop_recommender_response = personalize.stop_recommender(
    recommenderArn = "recommenderARN"
)
print(stop_recommender_response)

SDK for Java 2.x

SDK for Java 2.x でアクティブなレコメンダーを停止するには、stopRecommender メソッドを使用して、次のようにレコメンダーの ARN を指定します。

public static void stopRecommender(PersonalizeClient personalizeClient, 
                                              String datasetGroupArn) {
    
    try {
    
        StopRecommenderRequest stopRecommenderRequest = StopRecommenderRequest.builder()
                .recommenderArn(recommenderArn)
                .build();
        personalizeClient.stopRecommender(stopRecommenderRequest);
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}

SDK for JavaScript v3

// Get service clients and commands using ES6 syntax.
import { StopRecommenderCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";
  
// create personalizeClient
const personalizeClient = new PersonalizeClient({
  region: "REGION"
});

// set the request params
export const stopRecommenderParam = {
  recommenderArn: "RECOMMENDER_ARN" /* required */
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new StopRecommenderCommand(stopRecommenderParam)
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

レコメンダーの開始 (AWS SDKs)

次のコードは、 AWS SDKs を使用して非アクティブなレコメンダーを開始する方法を示しています。レコメンダーの状態がアクティブになると、レコメンダーのステータスからのレコメンデーションの取得を再開できます。同時に、レコメンダー請求と自動再トレーニングも再開されます。

SDK for Python (Boto3)

SDK for Python (Boto3) を使用して非アクティブなレコメンダーを開始するには、start_recommender メソッドを使用し、次のようにレコメンダーの Amazon リソースネーム (ARN) を指定します。

import boto3
personalize = boto3.client('personalize')

start_recommender_response = personalize.start_recommender(
    recommenderArn = "recommenderARN"
)
print(start_recommender_response)

SDK for Java 2.x

SDK for Java 2.x で非アクティブなレコメンダーを起動するには、startRecommender メソッドを使用してレコメンダーの ARN を次のように指定します。

public static void startRecommender(PersonalizeClient personalizeClient, 
                                              String datasetGroupArn) {
    
    try {
    
        StartRecommenderRequest startRecommenderRequest = StartRecommenderRequest.builder()
                .recommenderArn(recommenderArn)
                .build();
        personalizeClient.startRecommender(startRecommenderRequest);
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}

SDK for JavaScript v3

// Get service clients and commands using ES6 syntax.
import { StartRecommenderCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";
  
// create personalizeClient
const personalizeClient = new PersonalizeClient({
  region: "REGION"
});

// set the request params
export const startRecommenderParam = {
  recommenderArn: "RECOMMENDER_ARN" /* required */
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new StartRecommenderCommand(startRecommenderParam)
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();