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

# DefineExpression
<a name="API_DefineExpression"></a>

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

為搜尋網域設定 ` Expression `。用於建立新的運算式和修改現有的運算式。若有運算式存在，新組態將取代舊組態。如需詳細資訊，請參閱《[Amazon CloudSearch 開發人員指南](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-expressions.html)》中的*設定運算式*。

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

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

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

 **運算式**   
搜尋期間可供評估的具名運算式。可用於對搜尋結果進行排序、定義其他運算式，或由搜尋結果傳回經過計算的資訊。  
類型：[表達式](API_Expression.md)  
 必要：是 

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

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

 **運算式**   
`Expression` 的值及其目前狀態。  
類型：[ExpressionStatus](API_ExpressionStatus.md)

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

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

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

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

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

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

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