Exemples d'utilisation de Resource Explorer AWS CLI

Pour définir une vue de l'explorateur de ressources par défaut pour sa AWS région

L'associate-default-viewexemple suivant définit une vue, telle que spécifiée par son ARN, comme vue par défaut pour la AWS région dans laquelle vous appelez l'opération.

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

Sortie :

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

Pour plus d'informations, consultez la section Définition d'un affichage par défaut dans une AWS région dans le guide de l'utilisateur de AWS Resource Explorer.

Pour extraire des détails sur plusieurs vues de l’explorateur de ressources

L'batch-get-viewexemple suivant affiche les détails de deux vues spécifiées par leur ARNs. Utilisez des espaces pour séparer les multiples ARNs dans le paramètre --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

Sortie :

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

Pour plus d’informations sur les vues, consultez À propos des vues de l’explorateur de ressources dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Pour activer l'explorateur de ressources dans une AWS région en créant un index

L'create-indexexemple suivant crée un index local dans la AWS région dans laquelle l'opération est appelée. La AWS CLI génère automatiquement une valeur de client-token paramètre aléatoire et l'inclut dans l'appel à AWS si vous ne spécifiez aucune valeur.

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

Sortie :

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

Après avoir créé un index local, vous pouvez le convertir en index agrégateur pour le compte en exécutant la update-index-typecommande.

Pour plus d'informations, consultez la section Activation de l'explorateur de ressources dans une AWS région pour indexer vos ressources dans le guide de l'utilisateur de l'explorateur de AWS ressources.

Exemple 1 : pour créer une vue non filtrée pour l'index dans une région AWS

L'create-viewexemple suivant crée une vue dans la AWS région spécifiée qui renvoie tous les résultats de la région sans aucun filtrage. La vue inclut le champ facultatif Tags sur les résultats renvoyés. Étant donné que cette vue est créée dans la région qui contient l’index agrégateur, elle peut inclure les résultats de toutes les régions du compte contenant un index Explorateur de ressources.

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

Sortie :

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

Exemple 2 : pour créer une vue qui renvoie uniquement les ressources associées à Amazon EC2

Ce qui suit create-view crée une vue dans AWS Region us-east-1 qui renvoie uniquement les ressources de la Region associées au EC2 service Amazon. La vue inclut le champ facultatif Tags sur les résultats renvoyés. Étant donné que cette vue est créée dans la région qui contient l’index agrégateur, elle peut inclure les résultats de toutes les régions du compte contenant un index Explorateur de ressources.

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

Sortie :

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

Pour plus d’informations, consultez Création de vues pour une recherche dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Pour désactiver l'explorateur de ressources dans une AWS région en supprimant son index

L'delete-indexexemple suivant supprime l'index Resource Explorer spécifié dans la AWS région dans laquelle vous faites la demande.

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

Sortie :

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

Pour plus d'informations sur la suppression d'un index, consultez la section Désactivation de l'explorateur de AWS ressources dans une AWS région dans le guide de l'utilisateur de l'explorateur de AWS ressources.

Pour supprimer une vue de l’explorateur de ressources

L’exemple delete-view suivant supprime une vue spécifiée par son 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

Sortie :

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

Pour plus d’informations, consultez Suppression de vues dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Pour supprimer la vue de l'explorateur de ressources par défaut pour une AWS région

Ce qui suit disassociate-default-view supprime la vue par défaut de l'explorateur de ressources pour la AWS région dans laquelle vous appelez l'opération. Après l’exécution de cette opération, toutes les opérations de recherche dans la région doivent spécifier explicitement une vue, sinon l’opération échoue.

aws resource-explorer-2 disassociate-default-view

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Définition d'un affichage par défaut dans une AWS région dans le guide de l'utilisateur de AWS Resource Explorer.

Pour récupérer la vue Resource Explorer, qui est la vue par défaut pour sa AWS région

L'get-default-viewexemple suivant récupère l'ARN de la vue par défaut pour la AWS région dans laquelle vous appelez l'opération.

aws resource-explorer-2 get-default-view

Sortie :

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

Pour plus d'informations, consultez la section Définition d'un affichage par défaut dans une AWS région dans le guide de l'utilisateur de AWS Resource Explorer.

Exemple 1 : pour récupérer les détails d’un index agrégateur Explorateur de ressources

L'get-indexexemple suivant affiche les détails de l'index Resource Explorer dans la AWS région spécifiée. Étant donné que la région spécifiée contient l’index agrégateur du compte, la sortie crée une liste des régions qui répliquent les données dans l’index de cette région.

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

Sortie :

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

Exemple 2 : pour récupérer les détails d’un index Explorateur de ressources local

L'get-indexexemple suivant affiche les détails de l'index Resource Explorer dans la AWS région spécifiée. Étant donné que la région spécifiée contient un index local, la sortie répertorie la région vers laquelle elle réplique les données de l’index de cette région.

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

Sortie :

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

Pour plus d'informations sur les index, consultez la section Vérification des AWS régions dans lesquelles l'explorateur de ressources est activé dans le guide de l'utilisateur de l'explorateur de AWS ressources.

Pour extraire des détails sur une vue de l’explorateur de ressources

L’exemple get-view suivant affiche les détails d’une vue spécifiée par son 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

Sortie :

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

Pour plus d’informations sur les vues, consultez À propos des vues de l’explorateur de ressources dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Pour répertorier les AWS régions dans lesquelles Resource Explorer possède des index

L’exemple list-indexes suivant crée une liste des index de toutes les régions dans lesquelles l’explorateur de ressources possède un index. La réponse indique le type de chaque index, sa AWS région et son ARN.

aws resource-explorer-2 list-indexes

Sortie :

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

Pour plus d'informations sur les index, consultez la section Vérification des AWS régions dans lesquelles l'explorateur de ressources est activé dans le guide de l'utilisateur de l'explorateur de AWS ressources.

Pour répertorier les AWS régions dans lesquelles Resource Explorer possède des index

L'list-supported-resource-typesexemple suivant répertorie tous les types de ressources actuellement pris en charge par & AREXlong ;. L’exemple de réponse inclut une valeur NextToken qui indique qu’il y a davantage de sorties disponibles à extraire avec des appels supplémentaires.

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

Sortie :

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

Pour obtenir la partie suivante de la sortie, appelez à nouveau l’opération et transmettez la valeur de réponse NextToken de l’appel précédent comme valeur de --starting-token. Répétez cette action jusqu’à ce que NextToken soit absent de la réponse.

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

Sortie :

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

Pour plus d'informations sur les index, consultez la section Vérification des AWS régions dans lesquelles l'explorateur de ressources est activé dans le guide de l'utilisateur de l'explorateur de AWS ressources.

Pour créer une liste des balises attachées à une vue ou à un index de l’explorateur de ressources

L’exemple list-tags-for-resource suivant crée une liste des paires clé/valeur de balise attachées à la vue avec l’ARN spécifié. Vous devez appeler l'opération depuis la AWS région qui contient la ressource.

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

Sortie :

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

Pour plus d’informations sur le balisage des vues, consultez Balisage des vues pour le contrôle d’accès dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Pour répertorier les vues de l'explorateur de ressources disponibles dans une AWS région

L’exemple list-views suivant répertorie toutes les vues disponibles dans la région dans laquelle vous invoquez l’opération.

aws resource-explorer-2 list-views

Sortie :

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

Pour plus d’informations sur les vues, consultez À propos des vues de l’explorateur de ressources dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Exemple 1 : pour effectuer une recherche à l’aide de la vue par défaut

L’exemple search suivant affiche toutes les ressources de la région spécifiée qui sont associées au service. La recherche utilise la vue par défaut pour la région. L’exemple de réponse inclut une valeur NextToken qui indique qu’il y a davantage de sorties disponibles à extraire avec des appels supplémentaires.

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

Sortie :

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

Exemple 2 : pour effectuer une recherche à l’aide d’une vue spécifiée

L'searchexemple de recherche suivant affiche toutes les ressources (« * ») de la AWS région spécifiée qui sont visibles dans la vue spécifiée. Les résultats incluent uniquement les ressources associées à Amazon en EC2 raison des filtres attachés à la vue.

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

Sortie :

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

Pour plus d'informations, consultez la section Utilisation de l'explorateur de AWS ressources pour rechercher des ressources dans le guide de l'utilisateur de l'explorateur de AWS ressources.

Pour baliser une vue de l’explorateur de ressources

L’exemple tag-resource suivant ajoute la clé de balise « environment » avec la valeur « production » à la vue avec l’ARN spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage des vues pour le contrôle d’accès dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Pour supprimer une balise d’une vue de l’explorateur de ressources

L’exemple untag-resource suivant supprime les balises avec le nom de clé « environment » de la vue avec l’ARN spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage des vues pour le contrôle d’accès dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Pour modifier le type d’un index Explorateur de ressources

L'update-index-typeexemple suivant convertit l'index spécifié de type local en type aggregator pour activer la possibilité de rechercher des ressources dans toutes les AWS régions du compte. Vous devez envoyer la demande à la AWS région qui contient l'index que vous souhaitez mettre à jour.

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

Sortie :

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

Pour plus d’informations sur la modification du type d’un index, consultez Activation de la recherche entre régions en créant un index agrégateur dans le Guide de l’utilisateur de l’explorateur de ressources AWS .

Exemple 1 : pour mettre à jour le IncludedProperties champ d'une vue de l'explorateur de ressources

L’exemple update-view suivant met à jour la vue spécifiée en ajoutant `tags` au paramètre `IncludedProperties` facultatif. Après l’exécution de cette opération, les opérations de recherche qui utilisent cette vue incluent des informations sur les balises attachées aux ressources qui apparaissent dans les résultats.

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

Sortie :

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

Exemple 2 : pour mettre à jour les filtres attachés à une vue

L'update-viewexemple suivant met à jour la vue spécifiée pour utiliser un filtre qui limite les résultats aux seuls types de ressources associés au EC2 service 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

Sortie :

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

Pour plus d’informations sur les vues, consultez À propos des vues de l’explorateur de ressources dans le Guide de l’utilisateur de l’explorateur de ressources AWS .