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

# レコメンダーを停止する
<a name="stopping-starting-recommender"></a>

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

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

Amazon Personalize コンソール、AWS Command Line Interface (AWS CLI)、AWS SDK を使用してレコメンダーを停止および開始できます。

**レコメンダーの状態**

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

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

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

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

**Topics**
+ [レコメンダーの停止 (コンソール)](#stop-start-recommender-console)
+ [レコメンダーを停止する (AWS CLI)](#stop-start-recommender-cli)
+ [レコメンダーを停止する (AWS SDK)](#stop-start-recommender-sdks)

## レコメンダーの停止 (コンソール)
<a name="stop-start-recommender-console"></a>

Amazon Personalize コンソールのレコメンダーの詳細ページからレコメンダーを停止できます。

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

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

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

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

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

1. レコメンダーの詳細ページで、右上の **[レコメンダーを停止]** を選択し、表示されるウィンドウで確認します。レコメンダーのステータスが非アクティブになると、レコメンダーは停止しています。同じページから再開できます。

## レコメンダーを停止する (AWS CLI)
<a name="stop-start-recommender-cli"></a>

アクティブなレコメンダーを AWS CLI で停止するには、[StopRecommender](API_StopRecommender.md) API オペレーションを使用する `stop-recommender` コマンドを使用して、レコメンダーの Amazon リソースネーム (ARN) を指定します。再起動するには、[StartRecommender](API_StartRecommender.md) を使用する `start-recommender` コマンドを使用します。次のコードは、レコメンダーを停止する方法を示しています。

```
aws personalize stop-recommender --recommender-arn "{{recommender arn}}"
```

## レコメンダーを停止する (AWS SDK)
<a name="stop-start-recommender-sdks"></a>

アクティブなレコメンダーを AWS SDK で停止するには、[StopRecommender](API_StopRecommender.md) API オペレーションを使用して、レコメンダーの Amazon リソースネーム (ARN) を指定します。再起動するには、[StartRecommender](API_StartRecommender.md) を使用します。次のコードは、レコメンダーを停止する方法を示しています。

------
#### [ 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();
```

------