Esempi di Esploratore di risorse che utilizzano la AWS CLI - AWS Command Line Interface
Operazioni

Esempi di Esploratore di risorse che utilizzano la AWS CLI

Negli esempi di codice seguenti viene mostrato come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con Esploratore di risorse.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare associate-default-view.

AWS CLI

Come impostare come predefinita una visualizzazione di Esploratore di risorse per la relativa Regione AWS

L’esempio associate-default-view seguente imposta una visualizzazione, come specificato dal relativo ARN, come visualizzazione predefinita per la Regione AWS 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, consulta Setting a default view in an AWS Region in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta AssociateDefaultView in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare batch-get-view.

AWS CLI

Come recuperare i dettagli su una visualizzazione dell’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 About Resource Explorer views in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta BatchGetView in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-index.

AWS CLI

Come attivare Esploratore di risorse in una Regione AWS creando un indice

L’esempio create-index seguente crea un indice locale nella Regione AWS in cui viene chiamata l’operazione. AWS CLI genera automaticamente un valore di parametro client-token casuale e, se non si specifica un valore, lo include nella chiamata a AWS.

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 Turning on Resource Explorer in an AWS Region to index your resources in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta CreateIndex in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-view.

AWS CLI

Esempio 1: come creare una visualizzazione non filtrata per l’indice in una Regione AWS

L’esempio create-view seguente crea una visualizzazione nella Regione AWS 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

Il comando create-view seguente crea una visualizzazione nella Regione AWS 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 Creating views for search in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta CreateView in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-index.

AWS CLI

Come disattivare Esploratore di risorse in una Regione AWS eliminando il relativo indice

L’esempio delete-index seguente elimina l’indice dell’Esploratore di risorse specificato nella Regione AWS 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, consulta Turning off AWS Resource Explorer in an AWS Region in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta DeleteIndex in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-view.

AWS CLI

Come eliminare una visualizzazione dell’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 Deleting views in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta DeleteView in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare disassociate-default-view.

AWS CLI

Come rimuovere la visualizzazione predefinita dell’Esploratore di risorse per una Regione AWS

Il comando disassociate-default-view seguente rimuove la visualizzazione predefinita dell’Esploratore di risorse per la Regione AWS in cui viene chiamata 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, consulta Setting a default view in an AWS Region in AWS Resource Explorer Users Guide.

L’esempio di codice seguente mostra come utilizzare get-default-view.

AWS CLI

Come recuperare la visualizzazione dell’Esploratore di risorse, ovvero la visualizzazione predefinita per la relativa Regione AWS

L’esempio get-default-view seguente mostra l’ARN della visualizzazione predefinita per la Regione AWS 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, consulta Setting a default view in an AWS Region in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta GetDefaultView in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-index.

AWS CLI

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

L’esempio get-index seguente mostra i dettagli dell’indice dell’Esploratore di risorse nella Regione AWS 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 dell’Esploratore di risorse

L’esempio get-index seguente mostra i dettagli dell’indice dell’Esploratore di risorse nella Regione AWS 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 Checking which AWS Regions have Resource Explorer turned on in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta GetIndex in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-view.

AWS CLI

Come recuperare i dettagli su una visualizzazione dell’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 About Resource Explorer views in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta GetView in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-indexes.

AWS CLI

Come elencare le Regioni AWS in cui l’Esploratore di risorse 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 Regione AWS e l’ARN corrispondente.

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 Checking which AWS Regions have Resource Explorer turned on in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta ListIndexes in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-supported-resource-types.

AWS CLI

Come elencare le Regioni AWS in cui l’Esploratore di risorse dispone di indici

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, consulta Checking which AWS Regions have Resource Explorer turned on in AWS Resource Explorer Users Guide.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come elencare i tag collegati a una visualizzazione o a un indice dell’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 Regione AWS 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 in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta ListTagsForResource in Riferimento ai comandi AWS CLI.

L’esempio di codice seguente mostra come utilizzare list-views.

AWS CLI

Come elencare le visualizzazioni dell’Esploratore di risorse 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 About Resource Explorer views in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta ListViews in AWS CLI Command Reference.

L’esempio di codice seguente 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

Nella seguente ricerca di esempio search vengono mostrate tutte le risorse (“*”) presenti nella Regione AWS specificata che sono visibili attraverso la visualizzazione 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, consulta Using AWS Resource Explorer to search for resources in AWSResource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta Search in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come assegnare tag a una visualizzazione dell’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 views for access control in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta TagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere un tag da una visualizzazione dell’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 views for access control in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta UntagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-index-type.

AWS CLI

Come modificare il tipo di un indice dell’Esploratore di risorse

L’esempio update-index-type seguente converte l’indice dal tipo local al tipo aggregator specificato per attivare la possibilità di cercare risorse in tutte le Regioni AWS dell’account. È necessario inviare la richiesta alla Regione AWS 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 Turning on cross-Region search by creating an aggregator index in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta UpdateIndexType in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-view.

AWS CLI

Esempio 1: come aggiornare il campo IncludedProperties per una visualizzazione dell’Esploratore di risorse

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 collegati 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 About Resource Explorer views in AWS Resource Explorer Users Guide.

  • Per informazioni dettagliate sull’API, consulta UpdateView in AWS CLI Command Reference.