Esempi di Resource Explorer utilizzando AWS CLI

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

L'associate-default-viewesempio seguente imposta una vista, come specificata dal relativo ARN, come visualizzazione 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 Guida per l'utente di AWS Resource Explorer.

Come recuperare i dettagli su più viste di Esploratore di risorse

L’esempio batch-get-view seguente mostra i dettagli su due visualizzazioni specificate dai rispettivi ARN. Utilizza gli spazi per separare i diversi ARN 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 nella Guida per l’utente di Esploratore di risorse AWS Resource Explorer.

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. 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 comando update-index-type.

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

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 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 vista nella AWS regione us-east-1 che restituisce solo le risorse nella 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 nella Guida per l’utente di Esploratore di risorse AWS .

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 si effettua 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 an AWS Region nella Guida per l'utente di AWS Resource Explorer.

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 nella Guida per l’utente di Esploratore di risorse AWS .

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

Quanto segue disassociate-default-view rimuove la visualizzazione Resource Explorer predefinita per la AWS regione in cui si chiama 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 Guida per l'utente di AWS Resource Explorer.

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

L'get-default-viewesempio seguente recupera l'ARN della vista predefinita per la AWS 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 per l'utente di AWS Resource Explorer.

Esempio 1: come recuperare i dettagli per un indice aggregatore di Esploratore di risorse

L'get-indexesempio seguente visualizza i dettagli dell'indice Resource Explorer nella regione specificata AWS . 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-indexesempio seguente visualizza i dettagli per l'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 regioni in cui Resource Explorer è attivato nella Guida per l'utente di AWS Resource Explorer.

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 nella Guida per l’utente di Esploratore di risorse AWS Resource Explorer.

Per elencare le AWS regioni in cui Resource Explorer dispone di 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, vedere Verifica in quali AWS regioni è attivo Resource Explorer nella Guida per l'utente di AWS Resource Explorer.

Per elencare le regioni in cui Resource Explorer dispone di indici AWS

L’esempio list-supported-resource-types 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, vedi Verifica delle AWS regioni in cui Resource Explorer è attivato nella Guida per l'utente di AWS Resource Explorer.

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 nella Guida per l’utente di Esploratore di risorse AWS .

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

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 nella Guida per l’utente di Esploratore di risorse AWS Resource Explorer.

Esempio 1: come effettuare una ricerca utilizzando la visualizzazione predefinita

L'searchesempio seguente mostra tutte le risorse nella regione specificata associate al servizio IAM. 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

Il seguente search esempio di ricerca mostra tutte le risorse («*») 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: <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, vedere Utilizzo di AWS Resource Explorer per la ricerca di risorse nella Guida per l'utente di AWS Resource Explorer.

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 nella Guida per l’utente di Esploratore di risorse AWS .

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 nella Guida per l’utente di Esploratore di risorse AWS .

Come modificare il tipo di un indice di Esploratore di risorse

L'update-index-typeesempio seguente converte l'indice specificato da tipo local a tipo aggregator per attivare la possibilità di cercare risorse in tutte le regioni dell'account. AWS È necessario inviare la richiesta alla AWS regione che contiene l'indice da 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 nella Guida per l’utente di Esploratore di risorse AWS .

Esempio 1: per aggiornare il IncludedProperties campo per una visualizzazione 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 nella Guida per l’utente di Esploratore di risorse AWS Resource Explorer.