Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub
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 *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `associate-default-view`
Il seguente esempio di codice mostra come utilizzare`associate-default-view`.
**AWS CLI**
**Per impostare una visualizzazione di Resource Explorer come predefinita per la relativa AWS regione**
L'`associate-default-view`esempio seguente imposta una vista, come specificato dal relativo ARN, come vista predefinita per la AWS regione in cui si chiama 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) *Guida per l'utente di AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [AssociateDefaultView AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/associate-default-view.html)*Command Reference*.
### `batch-get-view`
Il seguente esempio di codice mostra come utilizzare`batch-get-view`.
**AWS CLI**
**Come recuperare i dettagli su più viste di Esploratore di risorse**
L'`batch-get-view`esempio seguente mostra i dettagli relativi a due viste specificate da loro ARNs. 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, consulta [Informazioni sulle viste di Esploratore di risorse](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) nella *Guida per l’utente di Esploratore di risorse AWS Resource Explorer*.
+ *Per i dettagli sull'API, consulta [BatchGetView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/batch-get-view.html)Command Reference.AWS CLI *
### `create-index`
Il seguente esempio di codice mostra come utilizzare`create-index`.
**AWS CLI**
**Per attivare Resource Explorer in una AWS regione creando un indice**
L'`create-index`esempio seguente crea un indice locale nella AWS regione in cui viene chiamata l'operazione. La AWS CLI genera 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-type](https://docs.aws.amazon.com/cli/latest/reference/resource-explorer-2/update-index-type.html)comando.
Per ulteriori informazioni, consulta [Attivazione di Resource Explorer in una AWS regione per indicizzare le risorse](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-register.html) nella *Guida per l'utente di AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [CreateIndex AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-index.html)*Command Reference*.
### `create-view`
Il seguente esempio di codice mostra come utilizzare`create-view`.
**AWS CLI**
**Esempio 1: creare una vista non filtrata per l'indice in una regione AWS **
L'`create-view`esempio seguente crea una vista nella AWS regione specificata che restituisce tutti i risultati nella regione senza alcun filtro. La visualizzazione include il campo opzionale Tags sui risultati restituiti. Poiché questa visualizzazione viene creata nella Regione che contiene l’indice aggregatore, può includere i risultati di tutte le Regioni dell’account che contengono un indice dell’Esploratore di risorse.
```
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: come creare una visualizzazione che restituisca solo le risorse associate ad Amazon EC2**
Quanto segue `create-view` crea una visualizzazione in AWS Region `us-east-1` che restituisce solo le risorse della regione associate al servizio Amazon EC2. La visualizzazione include il campo opzionale `Tags` sui risultati restituiti. Poiché questa visualizzazione viene creata nella Regione che contiene l’indice aggregatore, può includere i risultati di tutte le Regioni dell’account che contengono un indice dell’Esploratore di risorse.
```
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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-create.html) nella *Guida per l’utente di Esploratore di risorse AWS *.
+ Per i dettagli sull'API, consulta [CreateView AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-view.html)*Command Reference.*
### `delete-index`
Il seguente esempio di codice mostra come utilizzare`delete-index`.
**AWS CLI**
**Per disattivare Resource Explorer in una AWS regione eliminandone l'indice**
L'`delete-index`esempio 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-deregister.html) per l'*utente di AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [DeleteIndex AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-index.html)*Command Reference.*
### `delete-view`
Il seguente esempio di codice mostra come utilizzare`delete-view`.
**AWS CLI**
**Come eliminare una visualizzazione di Esploratore di risorse**
L’esempio `delete-view` seguente elimina una visualizzazione specificata dal relativo ARN.
```
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, consulta [Eliminazione delle viste](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-delete.html) nella *Guida per l’utente di Esploratore di risorse AWS *.
+ Per i dettagli sull'API, consulta [DeleteView AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-view.html)*Command Reference*.
### `disassociate-default-view`
Il seguente esempio di codice mostra come utilizzare`disassociate-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 visualizzazione o l’operazione avrà 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) *Guida per l'utente di AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [DisassociateDefaultView AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/disassociate-default-view.html)*Command Reference*.
### `get-default-view`
Il seguente esempio di codice mostra come utilizzare`get-default-view`.
**AWS CLI**
**Per recuperare la vista Resource Explorer, che è la vista predefinita per la relativa regione AWS **
L'`get-default-view`esempio seguente recupera l'ARN della vista che è l'impostazione predefinita per AWS la regione in cui si chiama 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) per l'*utente di AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [GetDefaultView AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-default-view.html)*Command Reference*.
### `get-index`
Il seguente esempio di codice mostra come utilizzare`get-index`.
**AWS CLI**
**Esempio 1: come recuperare i dettagli per un indice aggregatore di Esploratore di risorse**
L'`get-index`esempio seguente visualizza i dettagli dell'indice Resource Explorer AWS nella regione specificata. Poiché la Regione specificata contiene l’indice aggregatore 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: come recuperare i dettagli per un indice locale di Esploratore di risorse**
L'`get-index`esempio seguente visualizza i dettagli dell'indice Resource Explorer AWS nella 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, vedere [Verifica delle AWS aree in cui è attivo Resource Explorer](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) nella Guida per l'*utente di AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [GetIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-index.html)Reference*.
### `get-view`
Il seguente esempio di codice mostra come utilizzare`get-view`.
**AWS CLI**
**Come recuperare i dettagli su una visualizzazione di Esploratore di risorse**
L’esempio `get-view` seguente mostra i dettagli di una visualizzazione specificata dal relativo ARN.
```
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, consulta [Informazioni sulle viste di Esploratore di risorse](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) nella *Guida per l’utente di Esploratore di risorse AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [GetView AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-view.html)*Command Reference*.
### `list-indexes`
Il seguente esempio di codice mostra come utilizzare`list-indexes`.
**AWS CLI**
**Per elencare le AWS regioni in cui Resource Explorer ha indici**
L’esempio `list-indexes` seguente elenca gli indici di tutte le Regioni in cui Esploratore di risorse dispone di un indice. La risposta specifica il tipo di ciascun indice, la relativa AWS regione e il relativo 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*](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) Explorer.
+ Per i dettagli sull'API, consulta *AWS CLI Command [ListIndexes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-indexes.html)Reference*.
### `list-supported-resource-types`
Il seguente esempio di codice mostra come utilizzare`list-supported-resource-types`.
**AWS CLI**
**Per elencare le AWS regioni in cui Resource Explorer ha indici**
L'`list-supported-resource-types`esempio seguente elenca tutti i tipi di risorse attualmente supportati da &AREXlong;. Nella risposta di esempio è incluso un valore `NextToken` che indica la presenza di ulteriore 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, chiama nuovamente l’operazione e passa il valore della risposta `NextToken` della chiamata precedente come valore per `--starting-token`. Ripeti l’operazione finché `NextToken` risulta 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 regioni in cui è attivo Resource Explorer](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) nella Guida per *gli utenti di AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [ListSupportedResourceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-supported-resource-types.html)Reference*.
### `list-tags-for-resource`
Il seguente esempio di codice mostra come utilizzare`list-tags-for-resource`.
**AWS CLI**
**Come elencare i tag allegati a una visualizzazione o a un indice di Esploratore di risorse**
L’esempio `list-tags-for-resource` seguente elenca le coppie di chiave di tag e valore collegate alla visualizzazione con l’ARN specificato. È 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 delle viste per il controllo dell’accesso](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) nella *Guida per l’utente di Esploratore di risorse AWS *.
+ Per i dettagli sull'API, vedere [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-tags-for-resource.html)in *AWS CLI Command Reference*.
### `list-views`
Il seguente esempio di codice mostra come utilizzare`list-views`.
**AWS CLI**
**Per elencare le viste di Resource Explorer disponibili in una AWS regione**
L’esempio `list-views` seguente elenca tutte le visualizzazioni disponibili nella Regione in cui viene invocata 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, consulta [Informazioni sulle viste di Esploratore di risorse](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) nella *Guida per l’utente di Esploratore di risorse AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [ListViews AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-views.html)*Command Reference*.
### `search`
Il seguente esempio di codice mostra come utilizzare`search`.
**AWS CLI**
**Esempio 1: come effettuare una ricerca utilizzando la visualizzazione predefinita**
L’esempio `search` seguente visualizza tutte le risorse dell’area specificata associate al servizio. La ricerca utilizza la visualizzazione predefinita per la Regione. Nella risposta di esempio è incluso un valore `NextToken` che indica la presenza di ulteriore output disponibile 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: come effettuare una ricerca utilizzando una visualizzazione specificata**
La ricerca di `search` esempio seguente mostra tutte le risorse («\$1») nella AWS regione specificata che sono visibili attraverso la vista specificata. I risultati includono solo le risorse associate ad Amazon EC2 a causa dei filtri collegati alla visualizzazione.
```
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:
{
"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, vedere [Utilizzo di AWS Resource Explorer per la ricerca di risorse nella Guida per](https://docs.aws.amazon.com/resource-explorer/latest/userguide/using-search.html) *l'utente di AWS Resource Explorer*.
+ Per informazioni dettagliate sull’API, consulta [Search](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/search.html) in *AWS CLI Command Reference*.
### `tag-resource`
Il seguente esempio di codice mostra come utilizzare`tag-resource`.
**AWS CLI**
**Come taggare una visualizzazione di Esploratore di risorse**
L’esempio `tag-resource` seguente aggiunge la chiave di tag “environment” con il valore “production” alla visualizzazione con l’ARN specificato.
```
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 [Tagging delle viste per il controllo dell’accesso](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) nella *Guida per l’utente di Esploratore di risorse AWS *.
+ Per i dettagli sull'API, consulta [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/tag-resource.html)*Command Reference*.
### `untag-resource`
Il seguente esempio di codice mostra come utilizzare`untag-resource`.
**AWS CLI**
**Come rimuovere un tag da una visualizzazione di Esploratore di risorse**
L’esempio `untag-resource` seguente rimuove i tag con il nome di chiave “environment” dalla visualizzazione con l’ARN specificato.
```
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 [Tagging delle viste per il controllo dell’accesso](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) nella *Guida per l’utente di Esploratore di risorse AWS *.
+ Per i dettagli sull'API, consulta [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/untag-resource.html)*Command Reference*.
### `update-index-type`
Il seguente esempio di codice mostra come utilizzare`update-index-type`.
**AWS CLI**
**Come modificare il tipo di un indice di Esploratore di risorse**
L'`update-index-type`esempio 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 di un tipo di indice, consulta [Attivazione della ricerca tra Regioni mediante la creazione di un indice di aggregazione](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-aggregator-region.html) nella *Guida per l’utente di Esploratore di risorse AWS *.
+ Per i dettagli sull'API, consulta [UpdateIndexType AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-index-type.html)*Command Reference*.
### `update-view`
Il seguente esempio di codice mostra come utilizzare`update-view`.
**AWS CLI**
**Esempio 1: per aggiornare il IncludedProperties campo per una visualizzazione di Resource Explorer**
L’esempio `update-view` seguente aggiorna la visualizzazione specificata aggiungendo i ``tags`` alle ``IncludedProperties`` opzionali. Dopo aver eseguito questa operazione, le operazioni di ricerca che utilizzano questa visualizzazione includono informazioni sui tag collegati 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: come aggiornare i filtri associati a una visualizzazione**
L’esempio `update-view` seguente aggiorna la visualizzazione specificata per utilizzare un filtro che limita i risultati ai soli tipi di risorse associati al servizio Amazon EC2.
```
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 viste di Esploratore di risorse](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) nella *Guida per l’utente di Esploratore di risorse AWS Resource Explorer*.
+ Per i dettagli sull'API, consulta [UpdateView AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-view.html)*Command Reference*.