本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 停止建議者
<a name="stopping-starting-recommender"></a>

建議程式處於作用中狀態後，您可以停止建議程式，稍後再啟動。如此一來，您可以暫停推薦者計費，並只在使用時付費。例如，您可能只需要在一週的某些日子取得建議。您可以在不需要的那幾天停止推薦者，然後在那天啟動推薦者。

停止推薦者之後，您就無法使用它來取得建議。停止建議者會停止建議者計費和重新訓練。不過，停止推薦者並不會刪除推薦者。您可以隨時重新啟動它，並繼續取得建議。啟動推薦者不會使用您的資料建立新的推薦者。相反地，它會繼續建議者計費，每 7 天重新訓練一次。

您可以使用 Amazon Personalize 主控台 AWS Command Line Interface (AWS CLI)， AWS SDKs來停止和啟動建議程式。

**建議程式狀態**

當您停止建議程式時，建議程式狀態會依下列順序從 ACTIVE 變更為 INACTIVE：

作用中 > 停止待定 > 停止進行中 > 非作用中

當您啟動建議程式時，建議程式狀態會從 INACTIVE 變更為 ACTIVE，順序如下：

非作用中 > 開始擱置 > 開始進行中 > 作用中

**Topics**
+ [停止建議程式 （主控台）](#stop-start-recommender-console)
+ [停止建議程式 (AWS CLI)](#stop-start-recommender-cli)
+ [停止建議程式 (AWS SDKs)](#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，請使用 命令，該`stop-recommender`命令使用 [StopRecommender](API_StopRecommender.md) API 操作，並為推薦者提供 Amazon Resource Name (ARN)。若要重新啟動它，您可以使用使用 的 `start-recommender`命令[StartRecommender](API_StartRecommender.md)。下列程式碼示範如何停止推薦者：

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

## 停止建議程式 (AWS SDKs)
<a name="stop-start-recommender-sdks"></a>

若要使用 AWS SDKs 停止作用中的推薦者，請使用 [StopRecommender](API_StopRecommender.md) API 操作，並為推薦者提供 Amazon Resource Name (ARN)。若要重新啟動它，請使用 [StartRecommender](API_StartRecommender.md)。下列程式碼示範如何停止推薦者：

------
#### [ SDK for Python (Boto3) ]

若要使用適用於 Python 的 SDK (Boto3) 停止作用中的推薦者，請使用 `stop_recommender`方法並為推薦者提供 Amazon Resource Name (ARN)，如下所示。

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

stop_recommender_response = personalize.stop_recommender(
    recommenderArn = "{{recommenderARN}}"
)
print(stop_recommender_response)
```

------
#### [ SDK for Java 2.x ]

若要使用適用於 Java 的 SDK 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();
```

------