Resource Explorer-Beispiele mit AWS CLI - AWS Command Line Interface

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

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.

Resource Explorer-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Resource Explorer Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie Sieassociate-default-view.

AWS CLI

So legen Sie eine Resource Explorer-Ansicht als Standard für die zugehörige AWS Region fest

Im folgenden associate-default-view Beispiel wird eine Ansicht, wie in ihrem ARN angegeben, als Standardansicht für die AWS Region festgelegt, in der Sie den Vorgang aufrufen.

aws resource-explorer-2 associate-default-view \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

Ausgabe:

{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

Weitere Informationen finden Sie unter Einrichten einer Standardansicht in einer AWS Region im AWS Resource Explorer-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungbatch-get-view.

AWS CLI

So rufen Sie Details zu mehreren Resource-Explorer-Ansichten ab

Im folgenden batch-get-view Beispiel werden die Details zu zwei Ansichten angezeigt, die durch ihre angegeben sind ARNs. Verwenden Sie Leerzeichen, um das Vielfache ARNs im Parameter --view-arn zu trennen.

aws resource-explorer-2 batch-get-view \ --view-arns arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222, \ arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

Ausgabe:

{ "Views": [ { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T21:33:45.249000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" }, { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } ] "Errors": [] }

Weitere Informationen zu Ansichten finden Sie unter Über Resource-Explorer-Ansichten im AWS -Resource-Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie BatchGetViewin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-index.

AWS CLI

So aktivieren Sie den Resource Explorer in einer AWS Region, indem Sie einen Index erstellen

Im folgenden create-index Beispiel wird ein lokaler Index in der AWS Region erstellt, in der die Operation aufgerufen wird. Die AWS CLI generiert automatisch einen zufälligen client-token Parameterwert und schließt ihn in den Aufruf von ein, AWS wenn Sie keinen Wert angeben.

aws resource-explorer-2 create-index \ --region us-east-1

Ausgabe:

{ "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222c", "CreatedAt": "2022-11-01T20:00:59.149Z", "State": "CREATING" }

Nachdem Sie einen lokalen Index erstellt haben, können Sie ihn in den Aggregatorindex für das Konto konvertieren, indem Sie den update-index-typeBefehl ausführen.

Weitere Informationen finden Sie im Resource Explorer-Benutzerhandbuch unter Resource Explorer in einer AWS Region aktivieren, um Ihre Ressourcen zu indizieren.AWS

  • Einzelheiten zur API finden Sie CreateIndexin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-view.

AWS CLI

Beispiel 1: Um eine ungefilterte Ansicht für den Index in einer AWS Region zu erstellen

Im folgenden create-view Beispiel wird eine Ansicht in der angegebenen AWS Region erstellt, die alle Ergebnisse in der Region ohne jegliche Filterung zurückgibt. Die Ansicht enthält das optionale Feld Tags für die zurückgegebenen Ergebnisse. Da diese Ansicht in der Region erstellt wird, die den Aggregatorindex enthält, kann sie Ergebnisse aus allen Regionen des Kontos enthalten, die einen Resource-Explorer-Index enthalten.

aws resource-explorer-2 create-view \ --view-name My-Main-View \ --included-properties Name=tags \ --region us-east-1

Ausgabe:

{ "View": { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }

Beispiel 2: So erstellen Sie eine Ansicht, die nur Ressourcen zurückgibt, die mit Amazon verknüpft sind EC2

Im Folgenden create-view wird eine Ansicht in AWS Region erstelltus-east-1, die nur die Ressourcen in der Region zurückgibt, die mit dem EC2 Amazon-Service verknüpft sind. Die Ansicht enthält das optionale Feld Tags für die zurückgegebenen Ergebnisse. Da diese Ansicht in der Region erstellt wird, die den Aggregatorindex enthält, kann sie Ergebnisse aus allen Regionen des Kontos enthalten, die einen Resource-Explorer-Index enthalten.

aws resource-explorer-2 create-view \ --view-name My-EC2-Only-View \ --included-properties Name=tags \ --filters FilterString="service:ec2" \ --region us-east-1

Ausgabe:

{ "View": { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [ { "Name":"tags" } ], "LastUpdatedAt": "2022-07-13T21:35:09.059Z", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" } }

Weitere Informationen finden Sie unter Erstellen von Ansichten für die Suche im Benutzerhandbuch zu AWS Resource Explorer.

  • Einzelheiten zur API finden Sie CreateViewin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-index.

AWS CLI

Um den Resource Explorer in einer AWS Region durch Löschen des zugehörigen Indexes auszuschalten

Im folgenden delete-index Beispiel wird der angegebene Resource Explorer-Index in der AWS Region gelöscht, in der Sie die Anforderung stellen.

aws resource-explorer-2 delete-index \ --arn arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222 \ --region us-west-2

Ausgabe:

{ "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "State": "DELETING" }

Weitere Informationen zum Löschen eines Indexes finden Sie unter Ausschalten des AWS Resource Explorer-Explorers in einer AWS Region im AWS Resource Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteIndexin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-view.

AWS CLI

So löschen Sie eine Resource-Explorer-Ansicht

Im folgenden Beispiel für delete-view wird eine angegebene Ansicht anhand ihres ARN gelöscht.

aws resource-explorer-2 delete-view \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

Ausgabe:

{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

Weitere Informationen finden Sie unter Löschen von Ansichten im Benutzerhandbuch zu AWS Resource Explorer.

  • Einzelheiten zur API finden Sie DeleteViewin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdisassociate-default-view.

AWS CLI

Um die Resource Explorer-Standardansicht für eine AWS Region zu entfernen

Im Folgenden disassociate-default-view wird die Resource Explorer-Standardansicht für die AWS Region entfernt, in der Sie den Vorgang aufrufen. Nach der Ausführung dieser Operation müssen alle Suchvorgänge in der Region explizit eine Ansicht angeben. Andernfalls schlägt der Vorgang fehl.

aws resource-explorer-2 disassociate-default-view

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Einrichten einer Standardansicht in einer AWS Region im AWS Resource Explorer-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungget-default-view.

AWS CLI

Um die Resource Explorer-Ansicht abzurufen, die die Standardansicht für die entsprechende AWS Region ist

Im folgenden get-default-view Beispiel wird der ARN der Ansicht abgerufen, die der Standard für die AWS Region ist, in der Sie den Vorgang aufrufen.

aws resource-explorer-2 get-default-view

Ausgabe:

{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

Weitere Informationen finden Sie unter Einrichten einer Standardansicht in einer AWS Region im AWS Resource Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetDefaultViewunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-index.

AWS CLI

Beispiel 1: So rufen Sie die Details für einen Resource-Explorer-Aggregatorindex ab

Im folgenden get-index Beispiel werden die Details für den Resource Explorer-Index in der angegebenen AWS Region angezeigt. Da die angegebene Region den Aggregatorindex für das Konto enthält, werden in der Ausgabe die Regionen aufgeführt, die Daten in den Index dieser Region replizieren.

aws resource-explorer-2 get-index \ --region us-east-1

Ausgabe:

{ "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "CreatedAt": "2022-07-12T18:59:10.503000+00:00", "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00", "ReplicatingFrom": [ "ap-south-1", "us-west-2" ], "State": "ACTIVE", "Tags": {}, "Type": "AGGREGATOR" }

Beispiel 2: So rufen Sie die Details für einen lokalen Resource-Explorer-Index ab

Im folgenden get-index Beispiel werden die Details für den Resource Explorer-Index in der angegebenen AWS Region angezeigt. Da die angegebene Region einen lokalen Index enthält, wird in der Ausgabe die Region aufgeführt, in die Daten aus dem Index dieser Region repliziert werden.

aws resource-explorer-2 get-index \ --region us-west-2

Ausgabe:

{ "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "CreatedAt": "2022-07-12T18:59:10.503000+00:00", "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00", "ReplicatingTo": [ "us-west-2" ], "State": "ACTIVE", "Tags": {}, "Type": "LOCAL" }

Weitere Informationen zu Indizes finden Sie im Resource Explorer-Benutzerhandbuch unter Überprüfen, in welchen AWS Regionen der AWS Resource Explorer aktiviert ist.

  • Einzelheiten zur API finden Sie GetIndexin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-view.

AWS CLI

So rufen Sie Details zu einer Resource-Explorer-Ansicht ab

Im folgenden Beispiel für get-view werden die Details zu einer Ansicht angezeigt, die durch ihren ARN angegeben ist.

aws resource-explorer-2 get-view \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

Ausgabe:

{ "Tags" : {}, "View" : { "Filters" : { "FilterString" : "service:ec2" }, "IncludedProperties" : [ { "Name" : "tags" } ], "LastUpdatedAt" : "2022-07-13T21:33:45.249Z", "Owner" : "123456789012", "Scope" : "arn:aws:iam::123456789012:root", "ViewArn" : "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }

Weitere Informationen zu Ansichten finden Sie unter Über Resource-Explorer-Ansichten im AWS -Resource-Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetViewin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-indexes.

AWS CLI

Um die AWS Regionen aufzulisten, in denen Resource Explorer Indizes hat

Das folgende Beispiel für list-indexes listet die Indizes für alle Regionen auf, in denen Resource Explorer über einen Index verfügt. Die Antwort gibt den Typ jedes Indexes, seine AWS Region und seinen ARN an.

aws resource-explorer-2 list-indexes

Ausgabe:

{ "Indexes": [ { "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "Region": "us-west-2", "Type": "AGGREGATOR" }, { "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "Region": "us-east-1", "Type": "LOCAL" }, { "Arn": "arn:aws:resource-explorer-2:us-east-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333", "Region": "us-east-2", "Type": "LOCAL" }, { "Arn": "arn:aws:resource-explorer-2:us-west-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE44444", "Region": "us-west-1", "Type": "LOCAL" } ] }

Weitere Informationen zu Indizes finden Sie im Resource Explorer-Benutzerhandbuch unter Überprüfen, in welchen AWS Regionen der AWS Resource Explorer aktiviert ist.

  • Einzelheiten zur API finden Sie ListIndexesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-supported-resource-types.

AWS CLI

Um die AWS Regionen aufzulisten, in denen Resource Explorer Indizes hat

Das folgende list-supported-resource-types Beispiel listet alle Ressourcentypen auf, die derzeit von &AREXlong; unterstützt werden. Die Beispielantwort enthält einen NextToken-Wert, der angibt, dass mehr Ausgabe verfügbar ist, die mit zusätzlichen Aufrufen abgerufen werden kann.

aws resource-explorer-2 list-supported-resource-types \ --max-items 10

Ausgabe:

{ "ResourceTypes": [ { "ResourceType": "cloudfront:cache-policy", "Service": "cloudfront" }, { "ResourceType": "cloudfront:distribution", "Service": "cloudfront" }, { "ResourceType": "cloudfront:function", "Service": "cloudfront" }, { "ResourceType": "cloudfront:origin-access-identity", "Service": "cloudfront" }, { "ResourceType": "cloudfront:origin-request-policy", "Service": "cloudfront" }, { "ResourceType": "cloudfront:realtime-log-config", "Service": "cloudfront" }, { "ResourceType": "cloudfront:response-headers-policy", "Service": "cloudfront" }, { "ResourceType": "cloudwatch:alarm", "Service": "cloudwatch" }, { "ResourceType": "cloudwatch:dashboard", "Service": "cloudwatch" }, { "ResourceType": "cloudwatch:insight-rule", "Service": "cloudwatch" } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=" }

Rufen Sie den Vorgang erneut auf, um den nächsten Teil der Ausgabe abzurufen, und übergeben Sie den NextToken-Antwortwert des vorherigen Aufrufs als Wert für --starting-token an. Wiederholen Sie den Vorgang, bis NextToken nicht mehr in der Antwort auftritt.

aws resource-explorer-2 list-supported-resource-types \ --max-items 10 \ --starting-token eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=

Ausgabe:

{ "ResourceTypes": [ { "ResourceType": "cloudwatch:metric-stream", "Service": "cloudwatch" }, { "ResourceType": "dynamodb:table", "Service": "dynamodb" }, { "ResourceType": "ec2:capacity-reservation", "Service": "ec2" }, { "ResourceType": "ec2:capacity-reservation-fleet", "Service": "ec2" }, { "ResourceType": "ec2:client-vpn-endpoint", "Service": "ec2" }, { "ResourceType": "ec2:customer-gateway", "Service": "ec2" }, { "ResourceType": "ec2:dedicated-host", "Service": "ec2" }, { "ResourceType": "ec2:dhcp-options", "Service": "ec2" }, { "ResourceType": "ec2:egress-only-internet-gateway", "Service": "ec2" }, { "ResourceType": "ec2:elastic-gpu", "Service": "ec2" } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyMH0=" }

Weitere Informationen zu Indizes finden Sie im Resource Explorer-Benutzerhandbuch unter Überprüfen, in welchen AWS Regionen der AWS Resource Explorer aktiviert ist.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

So listen Sie die Tags auf, die einer Resource-Explorer-Ansicht oder einem Index zugeordnet sind

Das folgende Beispiel für list-tags-for-resource listet den Tag-Schlüssel und Wertepaare auf, die mit dem angegebenen ARN an die Ansicht angehängt sind. Sie müssen den Vorgang von der AWS Region aus aufrufen, die die Ressource enthält.

aws resource-explorer-2 list-tags-for-resource \ --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

Ausgabe:

{ "Tags": { "application": "MainCorpApp", "department": "1234" } }

Weitere Informationen zum Markieren von Ansichten finden Sie unter Markierungen für die Zugriffssteuerung im Benutzerhandbuch zu AWS Resource Explorer.

Das folgende Codebeispiel zeigt die Verwendunglist-views.

AWS CLI

Um die in einer AWS Region verfügbaren Resource Explorer-Ansichten aufzulisten

Im folgenden Beispiel für list-views werden alle Ansichten aufgelistet, die in der Region verfügbar sind, in der Sie den Vorgang aufrufen.

aws resource-explorer-2 list-views

Ausgabe:

{ "Views": [ "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Default-All-Resources-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Production-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333" ] }

Weitere Informationen zu Ansichten finden Sie unter Über Resource-Explorer-Ansichten im AWS -Resource-Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ListViewsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungsearch.

AWS CLI

Beispiel 1: So suchen Sie mit der Standardansicht

Im folgenden Beispiel für search werden alle Ressourcen in der angegebenen Ansicht angezeigt, die dem Service zugeordnet sind. Bei der Suche wird die Standardansicht für die Region verwendet. Die Beispielantwort enthält einen NextToken-Wert, der angibt, dass mehr Ausgabe verfügbar ist, die mit zusätzlichen Aufrufen abgerufen werden kann.

aws resource-explorer-2 search \ --query-string "service:iam"

Ausgabe:

{ "Count": { "Complete": true, "TotalResources": 55 }, "NextToken": "AG9VOEF1KLEXAMPLEOhJHVwo5chEXAMPLER5XiEpNrgsEXAMPLE...b0CmOFOryHEXAMPLE", "Resources": [{ "Arn": "arn:aws:iam::123456789012:policy/service-role/Some-Policy-For-A-Service-Role", "LastReportedAt": "2022-07-21T12:34:42Z", "OwningAccountId": "123456789012", "Properties": [], "Region": "global", "ResourceType": "iam:policy", "Service": "iam" }, { "Arn": "arn:aws:iam::123456789012:policy/service-role/Another-Policy-For-A-Service-Role", "LastReportedAt": "2022-07-21T12:34:42Z", "OwningAccountId": "123456789012", "Properties": [], "Region": "global", "ResourceType": "iam:policy", "Service": "iam" }, { ... TRUNCATED FOR BREVITY ... }], "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/my-default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

Beispiel 2: So suchen Sie mit einer bestimmten Ansicht

In der folgenden search Beispielsuche werden alle Ressourcen („*“) in der angegebenen AWS Region angezeigt, die in der angegebenen Ansicht sichtbar sind. Die Ergebnisse enthalten EC2 aufgrund der Filter, die der Ansicht zugewiesen sind, nur Ressourcen, die mit Amazon verknüpft sind.

aws resource-explorer-2 search \ -- query-string "*" \ -- view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

Ausgabe:

HTTP/1.1 200 OK Date: Tue, 01 Nov 2022 20:00:59 GMT Content-Type: application/json Content-Length: <PayloadSizeBytes> { "Count": { "Complete": true, "TotalResources": 67 }, "Resources": [{ "Arn": "arn:aws:ec2:us-east-1:123456789012:network-acl/acl-1a2b3c4d", "LastReportedAt": "2022-07-21T18:52:02Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-11-15T14:48:29Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:network-acl", "Service": "ec2" }, { "Arn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-1a2b3c4d", "LastReportedAt": "2022-07-21T21:22:23Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-07-29T19:02:39Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:subnet", "Service": "ec2" }, { "Arn": "arn:aws:ec2:us-east-1:123456789012:dhcp-options/dopt-1a2b3c4d", "LastReportedAt": "2022-07-21T06:08:53Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-11-15T15:11:05Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:dhcpoptions", "Service": "ec2" }, { ... TRUNCATED FOR BREVITY ... }], "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" }

Weitere Informationen finden Sie unter Verwenden von AWS Resource Explorer zur Suche nach Ressourcen im AWS Resource Explorer-Benutzerhandbuch.

  • API-Details finden Sie unter Search in der AWS CLI -Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendung vontag-resource.

AWS CLI

So markieren Sie eine Resource-Explorer-Ansicht

Das folgende Beispiel für tag-resource fügt der Ansicht mit dem angegebenen ARN den Tag-Schlüssel „environment“ mit dem Wert „production“ hinzu.

aws resource-explorer-2 tag-resource \ --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \ --tags environment=production

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Markierungen für die Zugriffssteuerung im AWS -Resource-Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

So entfernen Sie ein Tag aus einer Resource-Explorer-Ansicht

Im folgenden Beispiel für untag-resource werden alle Tags mit dem Schlüssel „environment“ aus der Ansicht mit dem angegebenen ARN entfernt.

aws resource-explorer-2 untag-resource \ --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \ --tag-keys environment

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Markierungen für die Zugriffssteuerung im AWS -Resource-Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-index-type.

AWS CLI

So ändern Sie den Typ eines Resource-Explorer-Indexes

Im folgenden update-index-type Beispiel wird der angegebene Index von Typ local zu Typ konvertiertaggregator, um die Möglichkeit zu aktivieren, in allen AWS Regionen des Kontos nach Ressourcen zu suchen. Sie müssen die Anforderung an die AWS Region senden, die den Index enthält, den Sie aktualisieren möchten.

aws resource-explorer-2 update-index-type \ --arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \ --type aggregator \ --region us-east-1

Ausgabe:

{ "Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "LastUpdatedAt":"2022-07-13T18:41:58.799Z", "State":"updating", "Type":"aggregator" }

Informationen zum Verändern des Indextyps finden Sie unter Aktivieren der multiregionalen Suche durch Erstellen eines Aggregatorindexes im Benutzerhandbuch zu AWS Resource Explorer.

  • Einzelheiten zur API finden Sie UpdateIndexTypein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-view.

AWS CLI

Beispiel 1: Um das IncludedProperties Feld für eine Resource Explorer-Ansicht zu aktualisieren

Im folgenden Beispiel für update-view wird die angegebene Ansicht aktualisiert, indem `tags` zur optionalen `IncludedProperties` hinzugefügt wird. Nach dem Ausführen dieses Vorgangs enthalten Suchvorgänge, die diese Ansicht verwenden, Informationen zu den Tags, die den Ressourcen zugeordnet sind und in den Ergebnissen erscheinen.

aws resource-explorer-2 update-view \ --included-properties Name=tags \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

Ausgabe:

{ "View": { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }

Beispiel 2: So aktualisieren Sie die einer Ansicht zugeordneten Filter

Im folgenden update-view Beispiel wird die angegebene Ansicht aktualisiert, sodass sie einen Filter verwendet, der die Ergebnisse nur auf Ressourcentypen beschränkt, die mit dem EC2 Amazon-Service verknüpft sind.

aws resource-explorer-2 update-view \ --filters FilterString="service:ec2" \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

Ausgabe:

{ "View": { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [], "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" } }

Weitere Informationen zu Ansichten finden Sie unter Über Resource-Explorer-Ansichten im AWS -Resource-Explorer-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UpdateViewin der AWS CLI Befehlsreferenz.