在 Amazon 中提交組態請求 CloudSearch - Amazon CloudSearch
組態請求的結構請求身分驗證

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

在 Amazon 中提交組態請求 CloudSearch

重要

提交組態請求的最簡單方法是使用 Amazon CloudSearch 主控台、Amazon CloudSearch 命令列工具或 Java、、 JavaScript、。AWS SDK NET,PHP, 紅寶石, 或 Python (博托). 命令列工具並為您SDKs處理簽署程序，並確保 Amazon CloudSearch 組態請求已正確形成。如需有關的詳細資訊 AWSSDKs，請參閱AWS軟體開發套件。

您可以使用AWS查詢通訊協定將 Amazon CloudSearch 組態請求提交至您區域的 Amazon CloudSearch 端點。如需支援的區域和端點的最新清單，請參閱區域與端點。

AWS查詢請求是透過HTTPHTTPGET或POST使用名為 Action 的查詢參數來提交或HTTPS請求。您必須在所有組態要求中指定API版本，且該版本必須符合建立網域時指定的API版本。

您必須在每個請求中包含授權參數和數字簽名。Amazon CloudSearch 支持AWS簽名版本 4。如需詳細的簽署指示，請參閱AWS一般參考中的簽章 V4 簽署程序。

注意

Amazon 會 CloudSearch 限制對組態服務的過多請求。節流是由動作發生的，因此過多的DescribeDomains請求不會導致 Amazon 限制 CloudSearch DescribeIndexFields請求。請求上限會根據服務的需求而變動，但允許每小時多次呼叫各項動作。

組態請求的結構

此參考資料將 Amazon CloudSearch 組態請求顯示為URLs，可直接在瀏覽器中使用。(雖然GET請求顯示為URLs，但參數值會以未編碼的方式顯示，以便於閱讀。 請記住，您必須在提交請求時URL對參數值進行編碼。） 包URL含三個部分：

  • 端點 - 要對其執行動作的 Web 服務進入點，即 cloudsearch.us-east-1.amazonaws.com。

  • 動作 — 您要執行的 Amazon CloudSearch 組態動作。如需完整的動作清單，請參閱動作。

  • 參數-指定動作所需的任何請求參數。每一次查詢請求還必須附上若干一般參數以供處理身分驗證。如需詳細資訊，請參閱請求身分驗證。

您必須在每個 Amazon CloudSearch 組態請求中指定Version參數。目前的 Amazon CloudSearch API 版本是 2013 年 1 月 1 日。

例如，下列GET要求會建立名為電影的新搜尋網域：

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簽名版本 4。如需詳細的簽署指示，請參閱AWS一般參考中的簽章 V4 簽署程序。

注意

如果您剛開始簽署自己的AWS請求，請查看SDKs實施簽名的方式。大部分的來源可AWSSDKs在 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