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

# DefineSuggester
<a name="API_DefineSuggester"></a>

## 描述
<a name="API_DefineSuggester_Description"></a>

設定網域的建議者。建議者讓您能在使用者完成其查詢輸入之前顯示可能的相符項目。設定建議者時，您必須為可能相符項目指定您要搜尋的文字欄位名稱，以及建議者的唯一名稱。如需詳細資訊，請參閱《[Amazon CloudSearch 開發人員指南](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-suggestions.html)》中的*取得搜尋建議*。

## 請求參數
<a name="API_DefineSuggester_RequestParameters"></a>

 如需所有動作所使用的一般參數相關資訊，請參閱[常見參數](CommonParameters.md)。

 **DomainName**   
代表網域名稱的字串。AWS 區域內任一帳戶所擁有的各網域，其網域名稱皆為獨一無二。網域名稱以字母或數字開頭，並可包含以下字元：a-z (小寫)、0-9 和 - (連字號)。  
類型：字串  
 長度限制：長度下限為 3。長度上限為 28。  
 必要：是 

 **Suggester**   
搜尋建議者的組態資訊。每個建議者都具有獨一無二的名稱，並指定您要用於建議的文字欄位。針對建議者可設定以下選項：`FuzzyMatching`、`SortExpression`。  
類型：[Suggester](API_Suggester.md)  
 必要：是 

## 回應元素
<a name="API_DefineSuggester_ResponseElements"></a>

 名為 `DefineSuggesterResult` 的結構中會傳回以下元素。

 **Suggester**   
`Suggester` 的值及其目前狀態。  
類型：[SuggesterStatus](API_SuggesterStatus.md)

## 錯誤
<a name="API_DefineSuggester_Errors"></a>

 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 **Base**   
處理請求時發生錯誤。  
 HTTP 狀態碼：400

 **內部 (Internal)**   
處理請求時發生內部錯誤。如果此問題持續存在，請從[服務運作狀態儀表板](https://status.aws.amazon.com/)提報問題。  
 HTTP 狀態碼：500

 **InvalidType**   
請求所指定的類型定義無效，因而遭到拒絕。  
 HTTP 狀態碼：409

 **LimitExceeded**   
請求已達到資源限制，因而遭到拒絕。  
 HTTP 狀態碼：409

 **ResourceNotFound**   
請求嘗試參考不存在的資源，因而遭到拒絕。  
 HTTP 狀態碼：409