Esempi di Resource Explorer utilizzando AWS CLI - AWS Command Line Interface

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di Resource Explorer utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Resource Explorer.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni illustrino come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel contesto degli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareassociate-default-view.

AWS CLI

Per impostare una visualizzazione di Resource Explorer come predefinita per la relativa AWS regione

L'associate-default-viewesempio seguente imposta una vista, come specificato da itsARN, come visualizzazione predefinita per la AWS regione in cui viene chiamata l'operazione.

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

Output:

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

Per ulteriori informazioni, vedere Impostazione di una visualizzazione predefinita in una AWS regione nella Guida per l'utente di AWS Resource Explorer.

Il seguente esempio di codice mostra come utilizzarebatch-get-view.

AWS CLI

Per recuperare dettagli su più visualizzazioni di Resource Explorer

L'batch-get-viewesempio seguente mostra i dettagli relativi a due viste specificate da loroARNs. Utilizzate gli spazi per separare i multipli ARNs nel parametro --view-arn.

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

Output:

{ "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": [] }

Per ulteriori informazioni sulle visualizzazioni, vedere Informazioni sulle visualizzazioni di Resource Explorer nella Guida per gli utenti di AWS Resource Explorer.

  • Per API i dettagli, vedere BatchGetViewin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-index.

AWS CLI

Per attivare Resource Explorer in una AWS regione creando un indice

L'create-indexesempio seguente crea un indice locale nella AWS regione in cui viene chiamata l'operazione. Genera AWS CLI automaticamente un valore di client-token parametro casuale e lo include nella chiamata a AWS se non si specifica un valore.

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

Output:

{ "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" }

Dopo aver creato un indice locale, puoi convertirlo nell'indice di aggregazione per l'account eseguendo il update-index-typecomando.

Per ulteriori informazioni, consulta Attivazione di Resource Explorer in una AWS regione per indicizzare le risorse nella Guida per l'utente di AWS Resource Explorer.

Il seguente esempio di codice mostra come utilizzarecreate-view.

AWS CLI

Esempio 1: creare una vista non filtrata per l'indice in una regione AWS

L'create-viewesempio seguente crea una vista nella AWS regione specificata che restituisce tutti i risultati nella regione senza alcun filtro. La visualizzazione include il campo opzionale Tag sui risultati restituiti. Poiché questa vista viene creata nella regione che contiene l'indice di aggregazione, può includere i risultati di tutte le regioni dell'account che contengono un indice Resource Explorer.

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

Output:

{ "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" } }

Esempio 2: creare una visualizzazione che restituisca solo le risorse associate ad Amazon EC2

Quanto segue create-view crea una visualizzazione nella AWS regione us-east-1 che restituisce solo le risorse della regione associate al EC2 servizio Amazon. La visualizzazione include il Tags campo opzionale sui risultati restituiti. Poiché questa vista viene creata nella regione che contiene l'indice dell'aggregatore, può includere i risultati di tutte le regioni dell'account che contengono un indice Resource Explorer.

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

Output:

{ "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" } }

Per ulteriori informazioni, consulta Creazione di viste per la ricerca nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere CreateViewin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-index.

AWS CLI

Per disattivare Resource Explorer in una AWS regione eliminandone l'indice

L'delete-indexesempio seguente elimina l'indice Resource Explorer specificato nella AWS regione in cui viene effettuata la richiesta.

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

Output:

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

Per ulteriori informazioni sull'eliminazione di un indice, vedere Disattivazione di AWS Resource Explorer in una AWS regione nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere DeleteIndexin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-view.

AWS CLI

Per eliminare una visualizzazione di Resource Explorer

L'delete-viewesempio seguente elimina una visualizzazione specificata da itsARN.

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

Output:

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

Per ulteriori informazioni, vedere Eliminazione delle viste nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere DeleteViewin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredisassociate-default-view.

AWS CLI

Per rimuovere la visualizzazione predefinita di Resource Explorer per una AWS regione

Di seguito viene disassociate-default-view rimossa la visualizzazione predefinita di Resource Explorer per la AWS regione in cui viene richiamata l'operazione. Dopo aver eseguito questa operazione, tutte le operazioni di ricerca nella regione devono specificare in modo esplicito una vista o l'operazione ha esito negativo.

aws resource-explorer-2 disassociate-default-view

Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Impostazione di una visualizzazione predefinita in una AWS regione nella Guida per l'utente di AWS Resource Explorer.

Il seguente esempio di codice mostra come utilizzareget-default-view.

AWS CLI

Per recuperare la vista Resource Explorer, che è la vista predefinita per la relativa regione AWS

L'get-default-viewesempio seguente recupera ARN la visualizzazione predefinita per la AWS regione in cui viene chiamata l'operazione.

aws resource-explorer-2 get-default-view

Output:

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

Per ulteriori informazioni, vedere Impostazione di una visualizzazione predefinita in una AWS regione nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere GetDefaultViewin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-index.

AWS CLI

Esempio 1: per recuperare i dettagli per un indice di aggregazione di Resource Explorer

L'get-indexesempio seguente visualizza i dettagli dell'indice Resource Explorer nella regione specificata AWS . Poiché la regione specificata contiene l'indice di aggregazione per l'account, l'output elenca le regioni che replicano i dati nell'indice di questa regione.

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

Output:

{ "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" }

Esempio 2: per recuperare i dettagli per un indice locale di Resource Explorer

L'get-indexesempio seguente visualizza i dettagli dell'indice Resource Explorer nella AWS regione specificata. Poiché la regione specificata contiene un indice locale, l'output elenca la regione in cui replica i dati dall'indice di questa regione.

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

Output:

{ "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" }

Per ulteriori informazioni sugli indici, consulta Verifica delle AWS regioni in cui è attivo Resource Explorer nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere GetIndexin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-view.

AWS CLI

Per recuperare i dettagli su una visualizzazione di Resource Explorer

L'get-viewesempio seguente mostra i dettagli su una vista specificata da itsARN.

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

Output:

{ "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" } }

Per ulteriori informazioni sulle visualizzazioni, vedere Informazioni sulle visualizzazioni di Resource Explorer nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere GetViewin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-indexes.

AWS CLI

Per elencare le AWS regioni in cui Resource Explorer ha indici

L'list-indexesesempio seguente elenca gli indici di tutte le regioni in cui Resource Explorer ha un indice. La risposta specifica il tipo di ciascun indice, la relativa AWS regione e la relativa. ARN

aws resource-explorer-2 list-indexes

Output:

{ "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" } ] }

Per ulteriori informazioni sugli indici, consulta Verifica delle AWS aree in cui è attivo Resource Explorer nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere ListIndexesin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-supported-resource-types.

AWS CLI

Per elencare le AWS regioni in cui Resource Explorer ha indici

L'list-supported-resource-typesesempio seguente elenca tutti i tipi di risorse attualmente supportati da &AREXlong;. La risposta di esempio include un NextToken valore che indica che c'è più output disponibile da recuperare con chiamate aggiuntive.

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

Output:

{ "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=" }

Per ottenere la parte successiva dell'output, richiamate nuovamente l'operazione e passate il valore di NextToken risposta della chiamata precedente come valore per--starting-token. Ripetere l'operazione finché non NextToken è assente dalla risposta.

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

Output:

{ "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=" }

Per ulteriori informazioni sugli indici, consulta Verifica delle AWS aree in cui è attivo Resource Explorer nella Guida per l'utente di AWS Resource Explorer.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare i tag associati a una visualizzazione o a un indice di Resource Explorer

L'list-tags-for-resourceesempio seguente elenca le coppie di tag chiave e valore allegate alla visualizzazione con il valore specificatoARN. È necessario chiamare l'operazione dalla AWS regione che contiene la risorsa.

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

Output:

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

Per ulteriori informazioni sull'assegnazione di tag alle viste, consulta Tagging views for access control nella AWS Resource Explorer Users Guide.

Il seguente esempio di codice mostra come utilizzarelist-views.

AWS CLI

Per elencare le viste di Resource Explorer disponibili in una AWS regione

L'list-viewsesempio seguente elenca tutte le viste disponibili nella regione in cui si richiama l'operazione.

aws resource-explorer-2 list-views

Output:

{ "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" ] }

Per ulteriori informazioni sulle visualizzazioni, vedere Informazioni sulle visualizzazioni di Resource Explorer nella Guida per l'utente di AWS Resource Explorer.

  • Per API i dettagli, vedere ListViewsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaresearch.

AWS CLI

Esempio 1: Per effettuare una ricerca utilizzando la visualizzazione predefinita

L'searchesempio seguente visualizza tutte le risorse dell'area specificata associate al servizio. La ricerca utilizza la visualizzazione predefinita per la regione. La risposta di esempio include un NextToken valore che indica che è disponibile più output da recuperare con chiamate aggiuntive.

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

Output:

{ "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" }

Esempio 2: Effettuare una ricerca utilizzando una visualizzazione specificata

La ricerca di search esempio seguente mostra tutte le risorse («*») nella AWS regione specificata che sono visibili attraverso la vista specificata. I risultati includono solo le risorse associate ad Amazon a EC2 causa dei filtri allegati alla vista.

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

Output:

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" }

Per ulteriori informazioni, consulta Using AWS Resource Explorer per la ricerca di AWS risorse nella Resource Explorer Users Guide.

  • Per API i dettagli, consulta Search in AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per etichettare una vista di Resource Explorer

L'tag-resourceesempio seguente aggiunge la chiave di tag «environment» con il valore «production» alla vista con il valore specificatoARN.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le viste per il controllo degli accessi nella Guida per l'utente di AWS Resource Explorer.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere un tag da una visualizzazione di Resource Explorer

L'untag-resourceesempio seguente rimuove qualsiasi tag con il nome chiave «environment» dalla vista con il nome specificatoARN.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le viste per il controllo degli accessi nella Guida per l'utente di AWS Resource Explorer.

Il seguente esempio di codice mostra come utilizzareupdate-index-type.

AWS CLI

Per modificare il tipo di un indice di Resource Explorer

L'update-index-typeesempio seguente converte l'indice specificato da tipo local aggregator a tipo per attivare la possibilità di cercare risorse in tutte le AWS regioni dell'account. È necessario inviare la richiesta alla AWS regione che contiene l'indice che si desidera aggiornare.

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

Output:

{ "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" }

Per ulteriori informazioni sulla modifica del tipo di indice, consulta Attivazione della ricerca tra aree geografiche creando un indice di aggregazione nella Guida per gli utenti di AWS Resource Explorer.

Il seguente esempio di codice mostra come utilizzareupdate-view.

AWS CLI

Esempio 1: per aggiornare il IncludedProperties campo per una visualizzazione di Resource Explorer

L'update-viewesempio seguente aggiorna la vista specificata `tags` aggiungendola a quella opzionale`IncludedProperties`. Dopo aver eseguito questa operazione, le operazioni di ricerca che utilizzano questa visualizzazione includono informazioni sui tag associati alle risorse che appaiono nei risultati.

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

Output:

{ "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" } }

Esempio 2: per aggiornare i filtri allegati a una vista

L'update-viewesempio seguente aggiorna la vista specificata per utilizzare un filtro che limita i risultati solo ai tipi di risorse associati al EC2 servizio Amazon.

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

Output:

{ "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" } }

Per ulteriori informazioni sulle visualizzazioni, consulta Informazioni sulle visualizzazioni di Resource Explorer nella Guida per gli utenti di AWS Resource Explorer.

  • Per API i dettagli, vedere UpdateViewin AWS CLI Command Reference.