

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Beispiel für Resource Explorer-Suchanfragen
<a name="using-search-query-examples"></a>

Die folgenden Beispiele zeigen die Syntax für gängige Abfragetypen, die Sie in verwenden könnenAWS Resource Explorer.

**Wichtig**  
Wenn Sie denAWS CLI`search` Befehl verwenden und Ihr`--query-string` Parameterwert den`-` Operator als erstes Zeichen enthält, müssen Sie den Parameternamen von seinem Wert durch ein Gleichheitszeichen (`=`) anstelle des üblichen Leerzeichens trennen. Wenn Sie das Leerzeichen verwenden, interpretiert die CLI die Zeichenfolge falsch. Beispielsweise schlägt die folgende Abfrage fehl.  

```
aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"
```
Die folgende korrigierte Abfrage, bei der das Leerzeichen`=` ersetzt wurde, funktioniert wie erwartet.  

```
aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"
```
Wenn Sie die Reihenfolge der Filter in der Abfragezeichenfolge ändern, sodass das`-` nicht das erste Zeichen im Parameterwert ist, können Sie das Standard-Leerzeichen verwenden. Die folgende Abfrage funktioniert.  

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

## Suche nach Ressourcen ohne Tags
<a name="example-1"></a>

Wenn Sie die [attributbasierte Zugriffskontrolle (ABAC)](https://aws.amazon.com/identity/attribute-based-access-control/) in Ihrem Konto verwenden, eine [kostenbasierte Zuweisung](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) verwenden oder eine tagbasierte Automatisierung für Ihre Ressourcen durchführen möchten, müssen Sie wissen, bei welchen Ressourcen in Ihrem Konto möglicherweise Tags fehlen. Die folgende Beispielabfrage verwendet das [Filter-Tag für Sonderfälle: none](using-search-query-syntax.md#query-syntax-filters), um alle Ressourcen zurückzugeben, denen benutzergenerierte Tags fehlen.

Der`tag:none` Filter gilt nur für Tags, *die vom Benutzer erstellt wurden*. Tags, die von generiert und verwaltetAWS werden, sind von diesem Filter ausgenommen und erscheinen weiterhin in den Ergebnissen.

```
tag:none
```

Um auch alleAWS erstellten System-Tags auszuschließen, fügen Sie einen zweiten Filter hinzu, wie im folgenden Beispiel gezeigt. Das erste Element in der Abfragezeichenfolge dupliziert das vorherige Beispiel, indem es alle vom Benutzer erstellten Tags herausfiltert. AWSerstellte System-Tags beginnen *immer* mit den Buchstaben`aws`. Daher können Sie den [logischen NOT-Operator (-)](using-search-query-syntax.md#query-syntax-operators) mit dem [Filter tag.key](using-search-query-syntax.md#query-syntax-filters) verwenden, um auch alle Ressourcen auszuschließen, die ein Tag mit einem Schlüsselnamen haben, der mit beginnt`aws`.

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

## Suche nach markierten Ressourcen
<a name="example-2"></a>

Um alle Ressourcen zu finden, die ein beliebiges Tag haben, können Sie den [logischen NOT-Operator (-)](using-search-query-syntax.md#query-syntax-operators) mit dem [Sonderfall-Tag: none](using-search-query-syntax.md#query-syntax-filters) wie folgt filtern.

```
-tag:none
```

## Suchen Sie nach Ressourcen, denen ein bestimmtes Tag fehlt
<a name="example-3"></a>

Auch im Zusammenhang mit ABAC möchten Sie vielleicht nach allen Ressourcen suchen, die kein Tag mit einem bestimmten Schlüssel haben. Im folgenden Beispiel wird der [logische NOT-Operator](using-search-query-syntax.md#query-syntax-operators) verwendet,`-` um alle Ressourcen zurückzugeben, denen ein Tag mit dem Schlüsselnamen fehlt`Department`.

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

## Suchen Sie nach Ressourcen mit ungültigen Tag-Werten
<a name="example-4"></a>

Aus Compliance-Gründen sollten Sie möglicherweise nach allen Ressourcen suchen, bei denen Tag-Werte für wichtige Tags fehlen oder falsch geschrieben wurden. Das folgende Beispiel gibt alle Ressourcen zurück, die ein Tag mit dem Schlüsselnamen haben`environment`. Die Abfrage filtert jedoch jede Ressource heraus, die einen der gültigen Werte hat`prod``integ`, oder`dev`. Alle Ergebnisse dieser Abfrage haben einen anderen Wert, den Sie untersuchen und korrigieren sollten.

**Wichtig**  
Bei der Suche im Resource Explorer wird ***nicht*** zwischen Groß- und Kleinschreibung unterschieden und es kann nicht zwischen Schlüsselnamen und Werten unterschieden werden, die sich nur dadurch unterscheiden, wie sie groß geschrieben werden. Die Werte im folgenden Beispiel stimmen beispielsweise mit`PROD`,`prod``PrOd`, oder einer beliebigen Variante überein. In einigen Anwendungen wird bei der Verwendung von Tags jedoch zwischen Groß- und Kleinschreibung unterschieden. Wir empfehlen, dass Sie für Ihr Unternehmen eine Standardstrategie zur Großschreibung festlegen, z. B. nur Namen und Werte für Tag-Schlüsselnamen und -werte in Kleinbuchstaben zu verwenden. Ein konsistenter Ansatz kann dazu beitragen, Verwirrung zu vermeiden, die entstehen kann, wenn Tags verwendet werden, die sich nur dadurch unterscheiden, wie sie groß geschrieben werden.

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

## Suchen Sie nach Ressourcen in einer Teilmenge vonAWS-Regionen
<a name="example-5"></a>

Verwenden Sie den [`'*'`Platzhalteroperator](using-search-query-syntax.md#query-syntax-operators), um alle Regionen in einem bestimmten Gebiet der Welt abzugleichen. Das folgende Beispiel gibt alle Ressourcen zurück, die sich in Regionen in Europa (EU) befinden.

```
region:eu-*
```

## Suchen Sie nach globalen Ressourcen
<a name="example-6"></a>

Verwenden Sie den`global` Sonderfallwert für den`region:` Filter, um Ihre Ressourcen zu finden, die als global betrachtet werden und keiner einzelnen Region zugeordnet sind.

```
region:global
```

## Suchen Sie nach Ressourcen eines bestimmten Typs, die sich in einer bestimmten Region befinden
<a name="example-7"></a>

Wenn Sie mehrere Filter verwenden, wertet Resource Explorer den Ausdruck aus, indem er die Präfixe mit impliziten logischen`AND` Operatoren kombiniert. Im folgenden Beispiel werden alle Ressourcen in der Region`AND` Asien-Pazifik (Hongkong) Amazon EC2 EC2-Instances zurückgegeben.

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

**Anmerkung**  
Aufgrund des Impliziten`AND` können Sie erfolgreich nur einen Filter für ein Attribut verwenden, dem nur ein Wert zugeordnet sein kann. Beispielsweise kann eine Ressource nur Teil einer Ressource seinAWS-Region. Daher gibt die folgende Abfrage keine Ergebnisse zurück.  

```
region:us-east-1 region:us-west-1
```
Diese Einschränkung gilt ***nicht*** für die Filter für Attribute, die mehrere Werte gleichzeitig haben können, z. B.`tag:``tag.key:`, und`tag.value:`.

## Suchen Sie nach Ressourcen, die einen Begriff mit mehreren Wörtern enthalten
<a name="example-8"></a>

Umgeben Sie einen Begriff mit mehreren Wörtern in [doppelte Anführungszeichen (`"`)](using-search-query-syntax.md#query-syntax-operators), um nur Ergebnisse zurückzugeben, die den gesamten Begriff in der angegebenen Reihenfolge enthalten. Ohne doppelte Anführungszeichen gibt Resource Explorer Ressourcen zurück, die mit den einzelnen Wörtern übereinstimmen, aus denen der Begriff besteht. Die folgende Abfrage verwendet beispielsweise die doppelten Anführungszeichen, um nur Ressourcen zurückzugeben, die dem Begriff entsprechen`"west wing"`. Die Abfrage stimmt ***nicht*** mit Ressourcen in der Region`us-west-2`AWS-Region (oder einer anderen Region, die`west` in ihrem Code enthalten ist) oder mit Ressourcen, die dem Wort „Flügel“ ohne das Wort „West“ entsprechen, überein.

```
"west wing"
```

## Sucht nach Ressourcen, die Teil eines bestimmten CloudFormation Stacks sind
<a name="example-9"></a>

Wenn Sie eine Ressource als Teil einesCloudFormation Stacks erstellen, werden sie alle *automatisch* mit dem Namen des Stacks gekennzeichnet. Das folgende Beispiel gibt alle Ressourcen zurück, die als Teil des angegebenen Stacks erstellt wurden.

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