Syntaxreferenz für Suchabfragen für Resource Explorer

AWS Ressourcen Explorer hilft Ihnen dabei, einzelne AWS Ressourcen in Ihrem zu finden AWS-Konten. Damit Sie genau die Ressourcen finden können, nach denen Sie suchen, akzeptiert Resource Explorer Suchabfragezeichenfolgen, die die in diesem Thema beschriebene Syntax unterstützen. Beispielabfragen, die demonstrieren, wie die hier beschriebenen Funktionen verwendet werden, finden Sie unterBeispiel für Resource Explorer-Suchanfragen.

Anmerkung

Derzeit werden Tags, die an AWS Identity and Access Management (IAM) -Ressourcen wie Rollen oder Benutzer angehängt sind, nicht indexiert.

So funktionieren Abfragen im Resource Explorer

Suchanfragen verwenden immer eine Ansicht. Wenn Sie keine explizit angeben, verwendet Resource Explorer die Ansicht, die als Standardansicht für die Ansicht vorgesehen ist AWS-Region , in der Sie gerade arbeiten.

Ansichten bestimmen, welche Ressourcen für Sie zum Abfragen verfügbar sind. Sie können verschiedene Ansichten erstellen, die jeweils einen anderen Satz von Ressourcen zurückgeben.

Sie könnten beispielsweise eine Ansicht erstellen, die nur die Ressourcen enthält, die mit dem Schlüssel Environment und dem Wert gekennzeichnet sindProduction. Dann könnten Sie festlegen, dass nur Benutzern Zugriff auf diese Ansicht gewährt wird, die diese Ressourcen aus geschäftlichen Gründen aufrufen möchten. Verschiedene Benutzer, die diese Ressourcen einsehen müssen, könnten auf eine separate Ansicht zugreifen, die die Ressourcen Alpha oder die Beta Umgebung enthält. Informationen darüber, wie Sie steuern können, wer Zugriff auf welche Ansichten erhält, finden Sie unterZugriff auf Resource Explorer-Ansichten für die Suche gewähren.

Syntax der Abfragezeichenfolge

Dieser Abschnitt enthält Informationen zu grundlegenden Aspekten der Abfragesyntax, zu Filtern und Filteroperatoren.

Grundlagen

Im Grunde genommen QueryString handelt es sich bei a um eine Reihe von frei formulierten Textschlüsselwörtern, die implizit durch einen logischen OR Operator verknüpft werden. Trennen Sie jedes Schlüsselwort von den anderen, indem Sie ein Leerzeichen verwenden, wie im folgenden Beispiel gezeigt:

ec2 billing test gamma

Resource Explorer bewertet diese Liste von Schlüsselwörtern dahingehend, dass sie Folgendes bedeuten:

ec2 OR billing OR test OR gamma

Resource Explorer sortiert die Ergebnisse nach Relevanz und gibt Ressourcen, die einer größeren Anzahl von Suchbegriffen entsprechen, eine höhere Priorität. Ressourcen, die einem oder mehreren der Begriffe nicht entsprechen, werden nicht von den Ergebnissen ausgeschlossen. Resource Explorer betrachtet sie jedoch als weniger relevant und verschiebt sie in den Suchergebnissen weiter nach unten.

Wenn Sie eine leere Zeichenfolge für den QueryString Parameter angeben, gibt Ihre Abfrage die ersten 1.000 Ressourcen zurück, die in der für den Vorgang verwendeten Ansicht verfügbar sind. Die maximale Anzahl von Ressourcen, die von einer Abfrage zurückgegeben werden können, ist 1.000.

Anmerkung

AWS behält sich das Recht vor, die Abgleichslogik und die Relevanzalgorithmen für die Bewertung von frei formulierten Textschlüsselwörtern zu aktualisieren, damit wir unseren Kunden die relevantesten Ergebnisse liefern können. Daher können sich die Ergebnisse, die für dieselben Abfragen mit frei formulierten Textschlüsselwörtern zurückgegeben werden, im Laufe der Zeit ändern. Wenn Sie deterministischere Ergebnisse benötigen, empfehlen wir die Verwendung von Filtern. Die Logik des Filterabgleichs ändert sich im Laufe der Zeit nicht.

Filter

Sie können die Ergebnisse Ihrer Abfrage strenger einschränken, indem Sie Filter einbeziehen. Im Gegensatz zu Textschlüsselwörtern werden Filter in der Abfrage mit dem ANDOperator ausgewertet. Stellen Sie sich beispielsweise die folgende Abfrage vor, die aus zwei frei formbaren Schlüsselwörtern und zwei Filtern besteht:

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

Diese Abfrage wird wie folgt ausgewertet:

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

Filter werden immer mit ANDlogischen Operatoren ausgewertet. Wenn eine Ressource nicht mit dem Filter übereinstimmt, ist diese Ressource nicht in den Ergebnissen enthalten. Die Ergebnisse der Beispielabfrage beinhalten alle Ressourcen, die mit Amazon verknüpft sind EC2 und sich im Westen der USA (Oregon) befinden AWS-Region und denen mindestens eines der Schlüsselwörter in irgendeiner Weise zugeordnet ist.

Anmerkung

Aufgrund der impliziten Angabe AND können Sie erfolgreich nur einen Filter für ein Attribut verwenden, für das nur ein Wert mit der Ressource verknüpft werden kann. Eine Ressource kann beispielsweise nur Teil einer AWS-Region Ressource sein. Daher gibt die folgende Abfrage keine Ergebnisse zurück.

region:us-east-1 region:us-west-1

Diese Einschränkung gilt nicht für Filter für Attribute, die mehrere Werte gleichzeitig haben können, wie tag:tag.key:, undtag.value:.

In der folgenden Tabelle sind die verfügbaren Filternamen aufgeführt, die Sie in einer Resource Explorer-Suchabfrage verwenden können.

Name des Filters	Beschreibung und Beispiel
accountid:	AWS-Konto Derjenige, dem die Ressource gehört. Resource Explorer bezieht in die Ergebnisse nur die Ressourcen ein, die dem angegebenen Konto gehören. accountid:123456789012
application:	Mit diesem Filter können Sie nach Ressourcen mit einem awsApplication Tagschlüssel und einem Ressourcengruppenwert suchen. Sie können nach dem Namen der Anwendung oder der Ressourcengruppe der Anwendung suchenARN. application:MyApplicationName application:arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced Anmerkung Um diesen Filter verwenden zu können, muss Ihre Ansicht Zugriff auf Tagging-Daten haben.
id:	Die Kennung einer einzelnen Ressource, ausgedrückt als Amazon-Ressourcenname (ARN). id:arn:aws:license-manager:us-east-1:123456789012:license-configuration:lic-ecbd5574fd92cb0d312baea26EXAMPLE
region:	Der AWS-Region Ort, an dem sich die Ressource befindet. Resource Explorer bezieht in die Ergebnisse nur die Ressourcen ein, die sich in der angegebenen AWS-Region Datenbank befinden. region:us-east-1 Anmerkung Wenn Sie nur den Regionalcode eingeben (ohne Filter, z. B.us-east-1), werden nicht dieselben Ergebnisse zurückgegeben wieregion:us-east-1. Dieses Ergebnis ist darauf zurückzuführen, dass der Regionalcode als Freitextschlüsselwort, bei dem es sich nicht um einen Filter handelt, in seine einzelnen Teile zerlegt wird. us-east-1Wird beispielsweise als useast, und 1 gesucht. Diese Aufschlüsselung in Komponenten erfolgt nicht, wenn Sie das region: Präfix verwenden.
region:global	Ein Sonderfall für den region: Filter, mit dem Sie nach Ressourcen suchen können, die keiner Einzelperson zugeordnet sind, AWS-Region sondern als global gelten. region:global Anmerkung Wenn Sie nur das Schlüsselwort eingeben, werden global nicht dieselben Ergebnisse zurückgegebenregion:global, da das wörtliche Wort „global“ nicht mit globalen Ressourcen verknüpft ist. Wenn Sie global als Schlüsselwort eingeben, werden nur die Ressourcen zurückgegeben, denen diese Literalzeichenfolge der Ressource zugeordnet ist.
resourcetype:	Der Ressourcentyp in service:type Notation. Resource Explorer bezieht nur die Ressourcen des angegebenen Typs in die Ergebnisse ein. resourcetype:ec2:instance
resourcetype.supports:	Mit diesem Filter können Sie nach Ressourcen suchen, die Tags unterstützen. tagsist der einzige unterstützte Wert. Resource Explorer bezieht in die Ergebnisse nur die Ressourcen ein, die mit Tags versehen werden können. resourcetype.supports:tags
service:	Die AWS-Service , die dem Typ der Ressource zugeordnet ist. Resource Explorer berücksichtigt in den Ergebnissen nur die Ressourcen, die vom angegebenen Dienst erstellt und verwaltet werden. service:ec2
tag:	Ein Tag-Schlüssel/Wert-Paar, ausgedrückt als. <key>=<value> Resource Explorer bezieht in die Ergebnisse nur die Ressourcen ein, die über ein Tag verfügen, das sowohl einen passenden Schlüssel als auch den angegebenen Wert enthält. tag:environment=production
tag:all	Ein Sonderfall des tag: Filters, mit dem Sie nach Ressourcen suchen können, denen ein oder mehrere benutzerdefinierte Tags zugeordnet sind, auch wenn der Ressourcentyp im Resource Explorer nicht unterstützt wird. Anmerkung Ressourcen mit vom AWS Dienst erstellten Tags werden weiterhin in den Ergebnissen für diesen Filter angezeigt.
tag:none	Ein Sonderfall des tag: Filters, mit dem Sie nach Ressourcen suchen können, denen keine vom Benutzer erstellten Tags zugeordnet sind. Anmerkung Ressourcen mit vom AWS Dienst erstellten Tags werden weiterhin in den Ergebnissen für diesen Filter angezeigt.
tag.key:	Ein Tag-Schlüssel. Resource Explorer bezieht in die Ergebnisse nur die Ressourcen ein, die über ein Tag mit einem passenden Schlüssel verfügen, unabhängig vom Wert. tag.key:environment
tag.value:	Ein Tag-Wert. Resource Explorer bezieht unabhängig vom Schlüsselnamen nur die Ressourcen in die Ergebnisse ein, die über ein Tag mit einem passenden Wert verfügen. tag.value:production

Operatoren filtern

Sie können Ihre Schlüsselwörter und Filter ändern, indem Sie einen der in der folgenden Tabelle aufgeführten Operatoren als Teil der Zeichenfolge hinzufügen.

Operator	Beschreibung und Beispiel
"multiple word phrase" or "hyphenated-phrase"	Setzen Sie einen aus mehreren Wörtern bestehenden Satz, der als einzelnes Schlüsselwort behandelt werden soll, in doppelte Anführungszeichen (" "). Der Ressourcen-Explorer enthält nur die Ressourcen, die dem gesamten Ausdruck entsprechen, also alle Wörter zusammen und in der angegebenen Reihenfolge. Wenn Sie die doppelten Anführungszeichen nicht verwenden, teilt Resource Explorer den Ausdruck durch Leerzeichen oder Bindestriche in seine Bestandteile auf und schließt Ressourcen ein, die den einzelnen Komponenten entsprechen, auch wenn sie nicht zusammen oder in einer anderen Reihenfolge vorkommen. Alles hinter dem Operator sollte in Anführungszeichen stehen. "This matches only resources with the whole sentence." This matches resources with any of the words. "us-east-1"— entspricht nur Ressourcen, die genau dieser Region zugeordnet sind. us-east-1— entspricht allen Ressourcen, die „uns“, „Ost“ oder „1“ enthalten. -tag:"environment=production"
keyword*	Platzhalterübereinstimmung mit Präfixen. Sie können ein Platzhalterzeichen (ein Sternchen*) nur am Ende der Zeichenfolge platzieren. Resource Explorer bezieht in die Ergebnisse nur die Ressourcen ein, deren Werte mit dem Präfixtext vor dem beginnen. * Das folgende Beispiel entspricht allen AWS-Regionen , die mit beginnenus-east. region:us-east* Wichtig Bei der einheitlichen Suche wird am Ende des ersten Schlüsselworts in der Zeichenfolge automatisch ein Platzhalterzeichen (*) eingefügt. Das bedeutet, dass vereinheitlichte Suchergebnisse Ressourcen enthalten, die mit einer beliebigen Zeichenfolge übereinstimmen, die mit dem angegebenen Schlüsselwort beginnt. Bei der Suche, die im Textfeld Abfrage auf der Seite Ressourcensuche in der Resource Explorer-Konsole ausgeführt wird, wird nicht automatisch ein Platzhalterzeichen angehängt. Sie können nach einem beliebigen Begriff * manuell ein Wort in die Suchzeichenfolge einfügen.
-keyword	NotBetreiber. Sie können einen Bindestrich (-) an den Anfang des Schlüsselworts setzen oder einen Filter verwenden, um die Suchergebnisse umzukehren. Resource Explorer schließt alle Ressourcen aus den Ergebnissen aus, die dem Schlüsselwort oder Filter entsprechen, der diesem Operator folgt. Das folgende Beispiel führt dazu, dass alle Ressourcen, die mit dem EC2 Amazon-Service verknüpft sind, von den Ergebnissen ausgeschlossen werden. -service:ec2 Wichtig Wenn Sie den AWS CLI search Befehl verwenden und Ihr --query-string Parameterwert den - Operator als erstes Zeichen hat, müssen Sie den Parameternamen durch ein Gleichheitszeichen (=) anstelle des üblichen Leerzeichens von seinem Wert trennen. Wenn Sie das Leerzeichen verwenden, CLI interpretiert das die Zeichenfolge falsch. Die folgende Abfrage schlägt beispielsweise fehl. aws resource-explorer-2 search --query-string "-tag:none region:us-east-1" Die folgende korrigierte Abfragezeichenfolge, bei der ein Leerzeichen = ersetzt wird, funktioniert erwartungsgemäß. 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 Abfragezeichenfolge funktioniert. aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
\<special character>	Sie können Sonderzeichen maskieren, die exakt wie abgebildet enthalten und nicht interpretiert werden müssen. Wenn Ihr Text eines der Sonderzeichen ( * " - : = \) enthält, müssen Sie diesem Zeichen einen umgekehrten Schrägstrich (\) voranstellen, um sicherzustellen, dass das Zeichen wörtlich genommen wird. Das folgende Beispiel zeigt, wie Sie ein Freitextschlüsselwort verwenden, das den Bindestrich () - enthält. "my-key-word" Um zu verhindern, dass Resource Explorer den Ausdruck an den Bindestrichen in drei separate Schlüsselwörter aufteilt, können Sie außerdem den gesamten Ausdruck in doppelte Anführungszeichen setzen. "my\-key\-word" Um einen buchstäblichen umgekehrten Schrägstrich einzufügen, fügen Sie zwei umgekehrte Schrägstriche hintereinander ein. Der erste umgekehrte Schrägstrich wird als Escape interpretiert und der zweite umgekehrte Schrägstrich ist das einzufügende Literalzeichen. "some_text\\some_more_text"

Anmerkung

Wenn die Ansicht die mit den Ressourcen verknüpften Tags enthält, löst der Search Vorgang keine Validierungsfehler für Suchzeichenfolgen aus, da ein ungültiger Filter auch als Freitextsuche interpretiert werden könnte. Obwohl er wie ein Filter cat:blue aussieht, kann Resource Explorer ihn beispielsweise nicht als einen Filter analysieren, da er cat: keiner der gültigen, definierten Filter ist. Stattdessen interpretiert Resource Explorer die gesamte Zeichenfolge als formlose Suchzeichenfolge, sodass sie mit Dingen wie einem Tag-Schlüsselnamen oder einem Teil eines Suchbegriffs übereinstimmt. ARN

Der Vorgang löst einen Validierungsfehler aus, wenn eine der folgenden Bedingungen zutrifft:

• Die Ansicht enthält keine Informationen zu Tags

• Die Suchabfrage verwendet explizit einen Tagfilter (tag.key:,tag.value:, odertag:)