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

# 範例資源總管搜尋查詢
<a name="using-search-query-examples"></a>

下列範例顯示您可以在中使用的常見查詢類型的語法AWS 資源總管。

**重要**  
如果您使用AWS CLI`search`指令，且`--query-string`參數值以`-`運算子做為第一個字元，則必須使用等號字元 (`=`) 來分隔參數名稱與其值，而不是一般的空格字元。如果您使用空格字元，CLI 會誤解字串。例如，下列查詢會失敗。  

```
aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"
```
下列已修正的查詢會取`=`代空間，如預期般運作。  

```
aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"
```
如果您變更查詢字串中篩選器的順序，使得`-`不是參數值中的第一個字元，您可以使用標準空格字元。下面的查詢工作。  

```
aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
```

## 搜尋未標記的資源
<a name="example-1"></a>

如果您想要在帳戶中使用以[屬性為基礎的存取控制 (ABAC)](https://aws.amazon.com/identity/attribute-based-access-control/)、使用以[成本為基礎的配置](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)，或針對資源執行以標籤為基礎的自動化，您必須知道帳戶中哪些資源可能遺失標籤。下列範例查詢使用特殊大小寫篩選[標籤：none](using-search-query-syntax.md#query-syntax-filters) 可傳回缺少使用者產生標籤的所有資源。

`tag:none`篩選條件僅適用於*使用者建立的*標籤。由產生和維護的標籤AWS會從此篩選器中排除，且仍會顯示在結果中。

```
tag:none
```

()。AWS查詢字串中的第一個元素會篩選掉所有使用者建立的標籤，複製前一個範例。 AWS創建的系統標籤始*終*以字母開頭`aws`。因此，您可以使用[邏輯 NOT 運算子 (-)](using-search-query-syntax.md#query-syntax-operators) 搭配 [tag.key 篩選器](using-search-query-syntax.md#query-syntax-filters)，也可以排除任何具有以索引鍵名稱開頭之標籤的資源`aws`。

```
tag:none -tag.key:aws*
```

## 搜尋已標記的資源
<a name="example-2"></a>

若要尋找具有任何類型標籤的所有資源，您可以使用[邏輯 NOT 運算子 (-)](using-search-query-syntax.md#query-syntax-operators) 搭配特殊大小寫[標籤：none](using-search-query-syntax.md#query-syntax-filters) 篩選，如下所示。

```
-tag:none
```

## 搜尋缺少特定標籤的資源
<a name="example-3"></a>

同樣與 ABAC 相關，您可能想要搜索所有沒有具有指定密鑰的標籤的資源。下列範例會使用[邏輯 NOT 運算](using-search-query-syntax.md#query-syntax-operators)子，傳`-`回缺少具有索引鍵名稱之標籤的所有資源`Department`。

```
-tag.key:Department
```

## 搜尋具有無效標籤值的資源
<a name="example-4"></a>

基於符合性原因，您可能想要搜尋重要標籤上標籤值遺漏或拼錯的所有資源。下列範例會傳回含有索引鍵名稱之標籤的所有資源`environment`。不過，查詢會篩選出任何具有有效值`prod``integ`、或的資源`dev`。此查詢中出現的任何結果都有其他值，您應該調查並更正。

**重要**  
資源瀏覽器搜索***不***區分大小寫，無法區分僅與其大寫方式不同的鍵名稱和值。例如，下列範例中的值符合`PROD`、`prod``PrOd`、或任何變化。不過，有些應用程式會以區分大小寫的方式使用標籤。建議您標準化組織的大小寫策略，例如僅使用小寫的標籤關鍵字名稱和值。一致的方法可以幫助避免由於標籤的大寫不同而可能導致的混淆。

```
tag.key:environment -tag:environment=prod -tag:environment=integ -tag:environment=dev
```

## 搜尋下列子集中的資源AWS 區域
<a name="example-5"></a>

使用[`'*'`萬用字元運算子](using-search-query-syntax.md#query-syntax-operators)來比對世界特定區域中的所有區域。下列範例會傳回位於歐洲 (EU) 區域的所有資源。

```
region:eu-*
```

## 全球
<a name="example-6"></a>

使用`region:`篩選條件的特殊大小寫`global`值來尋找被視為全域且與個別區域無關聯的資源。

```
region:global
```

## 搜索位於特定地區的特定類型的資源
<a name="example-7"></a>

當您使用多個篩選器時，Resource Explorer 會結合前置詞與隱含邏輯`AND`運算子來評估運算式。Amazon EC2 ()`AND`。

```
region:ap-east-1 resourcetype:ec2:instance
```

**注意**  
由於隱含的原因`AND`，您只能針對只能有一個與資源相關聯的值的屬性成功使用一個篩選器。例如，資源只能是一個資源的一部分AWS 區域。因此，下列查詢不會傳回任何結果。  

```
region:us-east-1 region:us-west-1
```
此限制***不***適用於可同時具有多個值之屬性的篩選器，例如`tag:``tag.key:`、和`tag.value:`。

## 搜尋具有多字詞彙的資源
<a name="example-8"></a>

以[雙引號 (`"`)](using-search-query-syntax.md#query-syntax-operators) 括住多字詞詞彙，只會傳回以指定順序排列整個字詞的結果。如果沒有雙引號，資源總管會傳回符合任何組成字詞的個別字詞的資源。例如，下列查詢會使用雙引號，只傳回符合該字詞的資源`"west wing"`。查詢***不***符合`us-west-2`AWS 區域 (或其程式碼中包含的任何其他區域)`west` 中的資源，或符合「wing」一詞而不含「west」一詞的資源。

```
"west wing"
```

## 搜尋屬於指定 CloudFormation堆疊一部分的資源
<a name="example-9"></a>

當您將資源創建為CloudFormation堆棧的一部分時，它們都*會自動*標記為堆棧的名稱。下列範例會傳回建立為指定堆疊一部分的所有資源。

```
tag:aws:cloudformation:stack-name=my-stack-name
```