本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Amazon CloudSearch 中提交組態請求
**重要**
提交組態請求最簡單的方法是使用 Amazon CloudSearch 主控台、Amazon CloudSearch 命令列工具或適用於 Java、JavaScript、.NET、PHP、Ruby 或 Python (Boto) 的 AWS 開發套件。命令列工具和 SDKs 會為您處理簽署程序，並確保 Amazon CloudSearch 組態請求格式正確。如需 AWS 軟體開發套件的詳細資訊，請參閱 [AWS 軟體開發套件](https://aws.amazon.com/code)。
您可以使用 AWS 查詢通訊協定，將 Amazon CloudSearch 組態請求提交至您區域的 Amazon CloudSearch 端點。如需支援的區域和端點的最新清單，請參閱[區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloudsearch_region)。
AWS 查詢請求是使用名為 Action 的查詢參數透過 HTTP GET 或 POST 所提交的 HTTP 或 HTTPS 請求。所有組態請求皆必須指定 API 版本，且該版本必須與網域建立時所指定的 API 版本相符。
您必須在每個請求中包含授權參數和數位簽章。Amazon CloudSearch 支援 AWS Signature 第 4 版。如需詳細的簽署說明，請參閱 AWS 一般參考中的 [Signature 第 4 版簽署程序](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)。
**注意**
Amazon CloudSearch 會調節對組態服務的過度請求。調節*會透過動作*發生，因此過多的`DescribeDomains`請求不會導致 Amazon CloudSearch 調節`DescribeIndexFields`請求。請求上限會根據服務的需求而變動，但允許每小時多次呼叫各項動作。
## 組態請求的結構
此參考以 URLs顯示 Amazon CloudSearch 組態請求，可直接在瀏覽器中使用。（雖然 GET 請求顯示為 URLs，但參數值會顯示為未編碼，以便於讀取。 請注意，提交請求時，您必須使用 URL 編碼參數值。) URL 包含三個部分：
+ 端點 - 要對其執行動作的 Web 服務進入點，即 `cloudsearch.us-east-1.amazonaws.com`。
+ 動作：您要執行的 Amazon CloudSearch 組態動作。如需完整的動作清單，請參閱[動作](API_Operations.md)。
+ 參數 - 指定動作所需的任何請求參數。每一次查詢請求還必須附上若干一般參數以供處理身分驗證。如需詳細資訊，請參閱[請求身分驗證](#configuration-request-authentication)。
您必須在每個 Amazon CloudSearch 組態請求中指定 `Version` 參數。目前的 Amazon CloudSearch API 版本為 2013-01-01。
例如，以下 GET 請求會建立一個新的搜尋網域，名為 *movies*：
```
https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
3c8dcb
```
## 請求身分驗證
提交至組態 API 的請求將使用您的 AWS 存取金鑰進行身分驗證。您必須在每個請求中包含授權參數和數位簽章。Amazon CloudSearch 支援 AWS Signature 第 4 版。如需詳細的簽署說明，請參閱 AWS 一般參考中的 [Signature 第 4 版簽署程序](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)。
**注意**
如果您才剛入門親自簽署 AWS 請求，不妨先了解一下開發套件實作簽署的方式。大多數 AWS 開發套件的原始碼均可從 [https://github.com/aws](https://github.com/aws) 取得。
例如，建構 `CreateDomain` 請求時需要以下資訊：
```
Region name: us-east-1
Service name: cloudsearch
API version: 2013-01-01
Date: 2014-03-12T21:41:29.094Z
Access key: AKIAIOSFODNN7EXAMPLE
Secret key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Action: CreateDomain
Action Parameters: DomainName=movies
```
`CreateDomain` 請求的正式查詢字串大致如下：
```
Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
```
最終已簽署的請求大致如下：
```
https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2014-03-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
```