Exemples d’utilisation de l’AWS CLI avec l’explorateur de ressources

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

L’exemple associate-default-view suivant définit une vue, telle que spécifiée par son ARN, comme vue par défaut pour la région AWS 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 Définition d’une vue par défaut dans une région AWS dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Pour récupérer les détails sur plusieurs vues de l’explorateur de ressources

L’exemple batch-get-view suivant affiche les détails de deux vues spécifiées par leurs ARN. Utilisez des espaces pour séparer plusieurs ARN 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 About Resource Explorer views dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

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

L’exemple create-index suivant crée un index local dans la région AWS dans laquelle l’opération est appelée. L’AWS CLI génère automatiquement une valeur de paramètre client-token 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 la création d’un index local, vous pouvez le convertir en index agrégateur pour le compte en exécutant la commande update-index-type.

Pour plus d’informations, consultez Turning on Resource Explorer in an AWS Region to index your resources dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

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

L’exemple create-view suivant crée une vue dans la région AWS 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

L’exemple create-view suivant crée une vue dans la région AWS us-east-1 qui renvoie uniquement les ressources de la région associées au service Amazon EC2. 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 Creating views for search dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

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

L’exemple delete-index suivant supprime l’index Explorateur de ressources spécifié dans la région AWS 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 Désactivation de l’explorateur de ressources AWS dans une région AWS dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

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 région AWS

L’exemple disassociate-default-view suivant supprime la vue par défaut de l’explorateur de ressources pour la région AWS 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 Définition d’une vue par défaut dans une région AWS dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Pour récupérer la vue de l’explorateur de ressources qui est la vue par défaut pour sa région AWS

L’exemple get-default-view suivant récupère l’ARN de la vue par défaut pour la région AWS 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 Définition d’une vue par défaut dans une région AWS dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

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

L’exemple get-index suivant affiche les détails de l’index Explorateur de ressources dans la région AWS 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’exemple get-index suivant affiche les détails de l’index Explorateur de ressources dans la région AWS 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 Vérification des régions AWS où l’explorateur de ressources est activé dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Pour récupérer les 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 About Resource Explorer views dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Pour créer une liste des régions AWS dans lesquelles l’explorateur de ressources 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 spécifie le type de chaque index, sa région AWS 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 Vérification des régions AWS où l’explorateur de ressources est activé dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Pour créer une liste des régions AWS dans lesquelles l’explorateur de ressources possède des index

L’exemple list-supported-resource-types 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 à récupérer 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 Vérification des régions AWS où l’explorateur de ressources est activé dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

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 région AWS 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 Tagging views for access control dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Pour créer une liste des vues de l’explorateur de ressources disponibles dans une région AWS

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 About Resource Explorer views 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 AWS 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 à récupérer 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’exemple de recherche search suivant affiche toutes les ressources (« * ») de la région AWS spécifiée qui sont visibles dans la vue indiquée. Les résultats incluent uniquement les ressources associées à Amazon EC2 en 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 Using AWS Resource Explorer to search for resources dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

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 Tagging views for access control 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 Tagging views for access control dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Pour modifier le type d’un index Explorateur de ressources

L’exemple update-index-type suivant convertit l’index spécifié de type local en type aggregator pour activer la possibilité de rechercher des ressources dans toutes les régions AWS du compte. Vous devez envoyer la demande à la région AWS qui contient l’index à 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 Turning on cross-Region search by creating an aggregator index dans le Guide de l’utilisateur de l’explorateur de ressources AWS.

Exemple 1 : pour mettre à jour le champ IncludedProperties 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’exemple update-view 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 service 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

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 About Resource Explorer views dans le Guide de l’utilisateur de l’explorateur de ressources AWS.