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

# 取得 Amazon CloudSearch 網域的相關資訊
<a name="getting-domain-info"></a>

您可以擷取您的各個搜尋網域的下列資訊：
+ **網域名稱** — 網域名稱。
+ **ARN** - 網域的 Amazon Resource Name (ARN)。
+ **文件端點** - 您可以透過其提交文件更新的端點。
+ **搜尋端點** - 您可以透過其提交搜尋請求的端點。
+ **可搜尋的文件** — 已編製索引的文件數量。
+ **存取政策** - 針對網域的文件和搜尋端點設定的存取政策。
+ **分析方案** - 可套用至網域索引欄位的文字分析方案。
+ **索引欄位** - 每個已設定索引欄位的名稱和類型。
+ **運算式** - 可用於對搜尋結果進行排序的運算式。
+ **建議者** - 可用於就不完整的查詢擷取建議的建議者。

網域初次建立時，其網域狀態將指出該網域目前正在啟用，而未另提供任何其他資訊。網域的文件端點和搜尋端點如已可用，網域狀態即會顯示可供您用於新增資料和提交搜尋請求的端點位址。若您尚未提交任何資料以供編製索引，可搜尋的文件份數便會是零。

您可以透過 [Amazon CloudSearch console](#getting-domain-info-console)檢視您的網域所有上述相關資訊。如果您是使用 `aws cloudsearch describe-domains` 命令或 AWS 開發套件，網域的 ARN 則會顯示在網域的存取政策中。

若要取得可搜尋的文件份數，請使用主控台或向您的網域搜尋端點提交 `matchall` 請求。

```
q=matchall&q.parser=structured&size=0
```

**Topics**
+ [Amazon CloudSearch console](#getting-domain-info-console)
+ [使用 取得 Amazon CloudSearch 網域資訊 AWS CLI](#getting-domain-info-clt)
+ [DescribeDomains](#getting-domain-info-sdk)

## 使用 Amazon CloudSearch 主控台取得網域資訊
<a name="getting-domain-info-console"></a>

您可以使用 Amazon CloudSearch 主控台來檢視所有網域的相關資訊。主控台的儀表板會顯示您已建立的各個網域的摘要，包括網域名稱、狀態以及可搜尋的文件份數。若要將表格更新為最新資訊，請按一下頁面頂端的 **Refresh (重新整理)** 按鈕。

網域可能處於以下五種狀態的其中一種：
+ **載入**中 - 網域剛建立且仍在初始化中。您必須等到網域的狀態變成 PROCESSING、NEEDS INDEXING 或 ACTIVE 才能開始上傳文件。
+ **作用中** - 網域正在執行，且所有設定的欄位都已編製索引。
+ **需要索引 **- 您已對需要重建索引的網域組態進行變更。若您此時搜尋該網域，結果將不會反映各項變更。完成變更後，請選擇**動作**、**執行索引**以重建索引。
+ **處理**中 - 正在將組態變更套用至您的網域。若您此時搜尋該網域，結果可能不會反映最近的組態變更。
+ **正在刪除** - 您選擇刪除網域及其內容，而網域及其所有資源正在被移除。刪除完成後，該網域就會從網域清單中移除。

 從 Amazon CloudSearch 儀表板，您可以執行下列動作：
+ 檢視您的搜尋網域的狀態
+ 存取特定網域的儀表板
+ 存取 Amazon CloudSearch 文件和其他資源

**檢視特定網域的詳細資訊**

1. 開啟位於 https：//[https://console.aws.amazon.com/cloudsearch/home](https://console.aws.amazon.com/cloudsearch/home) 的 Amazon CloudSearch 主控台。

1. 從左側導覽窗格中選擇**網域**。

<a name="domain-dashboard"></a>網域儀表板會顯示所選網域的狀態摘要。您可以從網域儀表板執行下列事項：
+ 檢視網域的狀態
+ 上傳文件至網域
+ 搜尋所選網域
+ 存取網域組態頁面
+ 刪除網域

## 使用 取得 Amazon CloudSearch 網域資訊 AWS CLI
<a name="getting-domain-info-clt"></a>

使用 `aws cloudsearch describe-domains` 命令即可取得您的搜尋網域的狀態。若要取得特定資訊，例如為網域設定的存取政策、可用性選項和擴展選項，請針對每個選項使用個別的`describe`命令。如需安裝和設定 的詳細資訊 AWS CLI，請參閱[AWS Command Line Interface 《 使用者指南》](https://docs.aws.amazon.com/cli/latest/userguide/)。

**取得網域狀態資訊**
+ 執行 `aws cloudsearch describe-domains` 命令，取得您的所有網域的相關資訊。若要取得特定網域的資訊，請使用 `--domain-names` 選項指定您想查看的網域。例如，以下請求將取得 `movies` 網域的狀態：

  ```
  aws cloudsearch describe-domains --domain-names movies
                          
  {
      "DomainStatusList": [
          {
              "SearchInstanceType": "search.small", 
              "DomainId": "965407640801/movies", 
              "Created": true, 
              "Deleted": false, 
              "SearchInstanceCount": 1, 
              "DomainName": "movies", 
              "SearchService": {
                  "Endpoint": "search-movies-m4fcjhuxgj6i76smhyiz7pfxsu.us-east-1.cloudsearch.amazonaws.com"
              }, 
              "RequiresIndexDocuments": false, 
              "Processing": true, 
              "DocService": {
                  "Endpoint": "doc-movies-m4fcjhuxgj6i76smhyiz7pfxsu.us-east-1.cloudsearch.amazonaws.com"
              }, 
              "ARN": "arn:aws:cloudsearch:us-east-1:965407640801:domain/movies", 
              "SearchPartitionCount": 1
          }
      ]
  }
  ```

`describe-domains` 命令不會傳回網域內可搜尋的文件份數。若要取得可搜尋的文件份數，請使用主控台或向您的網域搜尋端點提交 `matchall` 請求：

```
q=matchall&q.parser=structured&size=0
```

**取得針對網域所設定的分析方案**
+ 執行 `aws cloudsearch describe-analysis-schemes` 命令。例如，以下請求將取得針對 `movies` 網域所設定的分析方案：

  ```
  aws cloudsearch describe-analysis-schemes --domain-name movies
                  
  {
      "AnalysisSchemes": [
          {
              "Status": {
                  "PendingDeletion": false, 
                  "State": "Active", 
                  "CreationDate": "2014-03-28T19:27:30Z", 
                  "UpdateVersion": 31, 
                  "UpdateDate": "2014-03-28T19:27:30Z"
              }, 
              "Options": {
                  "AnalysisSchemeLanguage": "en", 
                  "AnalysisSchemeName": "samplescheme", 
                  "AnalysisOptions": {
                      "AlgorithmicStemming": "none", 
                      "Synonyms": "{\"aliases\":{\"youth\":[\"young adult\"]},\"groups\":[[\"tool box\",\"toolbox\"],[\"band saw\",\"bandsaw\"],[\"drill press\",\"drillpress\"]]}", 
                      "StemmingDictionary": "{}", 
                      "Stopwords": "[]"
                  }
              }
          }
      ]
  }
  ```

**取得針對網域所設定的可用性選項**
+ 執行 `aws cloudsearch describe-availability-options` 命令。例如，以下請求將取得針對 `movies` 網域所設定的可用性選項。如果網域已啟用異地同步備份，`Options` 值會設為 `true`：

  ```
  aws cloudsearch describe-availability-options --domain-name movies
  
  {
      "AvailabilityOptions": {
          "Status": {
              "PendingDeletion": false, 
              "State": "Processing", 
              "CreationDate": "2014-04-30T20:42:57Z", 
              "UpdateVersion": 13, 
              "UpdateDate": "2014-05-01T00:17:45Z"
          }, 
          "Options": true
      }
  }
  ```

**取得針對網域所設定的運算式**
+ 執行 `aws cloudsearch describe-expressions` 命令。例如，以下請求將取得針對 `movies` 網域所設定的運算式：

  ```
  aws cloudsearch describe-expressions --domain-name movies
  
  {
      "Expression": {
          "Status": {
              "PendingDeletion": false, 
              "State": "Processing", 
              "CreationDate": "2014-05-01T01:15:18Z", 
              "UpdateVersion": 52, 
              "UpdateDate": "2014-05-01T01:15:18Z"
          }, 
          "Options": {
              "ExpressionName": "popularhits", 
              "ExpressionValue": "((0.3*popularity)/10.0)+(0.7* _score)"
          }
      }
  }
  ```

## 使用 AWS 開發套件取得網域資訊
<a name="getting-domain-info-sdk"></a>

AWS SDKs (Android 和 iOS SDKs除外） 支援 Amazon CloudSearch 組態 API 中定義的所有 Amazon CloudSearch 動作，包括 `DescribeDomains`。如需安裝與使用 AWS 開發套件的詳細資訊，請參閱 [AWS 軟體開發套件](https://aws.amazon.com/code)。

`DescribeDomains` 動作不會傳回網域內可搜尋的文件份數。若要取得可搜尋的文件份數，請使用主控台或向您的網域搜尋端點提交 `matchall` 請求：

```
q=matchall&q.parser=structured&size=0
```