

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

# 使用AWS 資源總管搜尋資源
<a name="using-search"></a>

啟用的主要目的AWS 資源總管在您的AWS 帳戶是允許您的使用者搜尋帳戶中的資源。使用AWS 管理主控台或AWS Command Line Interface(AWS CLI) 以使用資源總管搜尋資源。

以下是資源總管搜尋的一些主要特性。
+ **每次搜尋都必須使用檢視。**

  檢視是資源總管用來判斷誰有權查看哪些資源的權限。若要在資源總管搜尋作業中使用檢視，使用者必須具有`Allow`上的`resource-explorer-2:Search`指定視圖的操作。此權限來自[以身分為基礎的權限原則](manage-views-grant-access.md)附於提出請求的主體。

  檢視可以包含篩選條件，以限制哪些資源可以包含在結果中。透過建立使用篩選器的不同檢視，並授與不同主參與者對不同檢視的存取權，您可以配置每個使用者群組只能檢視與其相關資源的環境。

  如需檢視的詳細資訊，請參閱〈[管理資源總管檢視以提供搜尋存取權](manage-views.md)。
+ **資源瀏覽器使用異步後台進程來維護其索引。**

  Resource Explorer 可能需要一些時間，以便其索引程序探索新建立或修改的資源，並將其新增至本機索引。資源總管將本機索引中的變更複寫到彙總器索引可能需要額外的時間。

  這同樣適用於您刪除的資源。刪除索引程序會探索該刪除的資源，以及要從本機索引中移除該資源的資訊之後，可能需要一些時間。資源總管需要額外的時間，才能將該刪除從本機索引複製到帳戶的彙總索引。

  新增、修改和刪除資源最多可能需要 36 小時的時間，資源總管才能在您啟動資源總管的所有區域中顯示搜尋結果中的變更。
+ **資源總管中的搜索發生在AWS 區域。**

  您開啟資源總管的每個區域都只包含儲存在該區域中的資源的索引。視圖也與區域相關聯，並且只能返回該地區索引中找到的資源。其中一個例外是彙總器索引，它會接收所有本機索引的複寫副本，以支援在帳戶中的所有區域中進行搜尋。
+ **跨區域搜尋需要帳戶的彙總索引。**

  讓使用者搜尋所有資源的步驟AWS 區域，管理員必須指定一個 [區域]，以包含帳戶的彙總器索引。每個本機索引的副本會自動複寫到彙總索引。

  因此，只有彙總索引 Region 中的檢視才能傳回包含所有資源的結果AWS 區域在帳戶中。
+ **查詢包含任意數量的自由格式文字關鍵字和篩選器。**

  自由格式關鍵字會使用邏輯合併在查詢中**`OR`**運營商。[使用資源總管定義篩選器名稱的篩選器](using-search-query-syntax.md#query-syntax-filters)使用邏輯組合在查詢中**`AND`**運營商。請看下面的例子查詢。

  ```
  test instance service:EC2 region:us-west-2
  ```

  這是由資源總管評估如下。

  ```
  test OR instance AND service:EC2 AND region:us-west-2
  ```

  此查詢要求相符資源必須是美國西部 (奧勒岡) 區域的 Amazon EC2 資源，且至少要有一個關鍵字 (*測試*,*實例*) 以某種方式附加，例如在名稱、描述或標籤中。
**注意**  
因為隱含的`AND`，對於只能有一個與資源關聯的值的屬性，您只能成功使用一個篩選器。例如，資源只能是一個資源的一部分AWS 區域。因此，下列查詢不會傳回任何結果。  

  ```
  region:us-east-1 region:us-west-1
  ```
這個限制***不***套用至可同時具有多個值之屬性的篩選條件，例如`tag:`,`tag.key:`，以及`tag.value:`。
+ **搜尋只能傳回前 1,000 個結果。**

  此需求包括含有符合所有資源的空白查詢字串的搜尋。若要查看空白查詢字串傳回超過 1,000 的資源，您必須使用查詢將相符結果限制為您要查看的結果，並將相符項目數限制在 1,000 以下。
+ **您可以執行的搜尋作業數量有每個帳戶的配額。**

  配額限制您每秒可進行的查詢次數，以及每個月可以進行的查詢次數。如需特定配額數量，請參閱[資源總管的配額](quotas.md)。

------
#### [ AWS 管理主控台 ]

**使用資源總管搜尋資源的步驟**

1. 在「」**[資源搜尋](https://console.aws.amazon.com/resource-explorer/home#/search)**頁面上，首先選擇您要使用的檢視表。您可以從您有權存取的檢視中進行選擇。

1. 對於**查詢**，輸入搜尋字詞，然後[過濾器](using-search-query-syntax.md#query-syntax-filters)識別您想要查看的資源。如需有關所有可用語法選項的資訊，請參閱〈[Resource Explorer 的搜尋查詢語法參考](using-search-query-syntax.md)。

1. 新闻**輸入**提交您的查詢。

   資源總管顯示符合兩者的所有結果`Filter`在視圖中定義，**查詢**您提供的。結果會依相關性排序，符合較多查詢字詞的資源會在清單中顯示較高，而符合較少字詞的資源則會顯示在清單下方。

1. 選擇資源的標識符以導航到該資源類型的本機控制台，您可以在其中以該服務支持的所有方式與資源進行交互。

------
#### [ AWS CLI ]

**使用資源總管搜尋資源的步驟**  
執行下列命令，以使用指定的檢視來搜尋資源。該檢視表必須存在於您執行作業的「區域」中。下列範例會搜尋已標記的 Amazon EC2 執行個體`env=production`在美國東部 (俄亥俄州) (美國東部 -2)。如需有關所有可用語法選項的資訊`query-string`參數，請參閱[Resource Explorer 的搜尋查詢語法參考](using-search-query-syntax.md)。

```
$ aws resource-explorer-2 search \
    --region us-east-1 \
    --query-string "resourcetype:AWS::EC2::Instance tag:env=production"
    --view-arn arn:aws:resource-explorer-2:us-east-2:123456789012:view/My-Resources-View/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111
```

------

## 將搜尋結果匯出至 .csv 檔案
<a name="export-search-results-csv"></a>

您可以匯出的結果**資源搜尋**查詢至逗號分隔值 (.csv) 檔案。.csv 檔案包含識別碼、資源類型、區域、AWS 帳戶、標籤的總數，以及集合中每個唯一標籤鍵的欄。.csv 檔案可協助您設定您的AWS組織中的資源，或判斷跨資源標記時，哪些地方有重疊或不一致。

1. 在您的結果中**資源搜尋**查詢，選擇**將資源匯出為 CSV**。

   您可以選擇只匯出目前可以看到的資料欄的結果，或匯出所有可用欄。  
![\[資源搜尋查詢結果將 1000 種資源匯出為 CSV 檔案帶有用於導出可見列或導出顯示在右上角的所有列的選項的命令按鈕资源表。\]](http://docs.aws.amazon.com/zh_tw/resource-explorer/latest/userguide/images/Export-search-results.png)

1. 當瀏覽器出現提示時，請選擇開啟 .csv 檔案，或將檔案儲存到方便的位置。