D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples d'utilisation de Resource Explorer AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de l' AWS Command Line Interface explorateur de ressources.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `associate-default-view`
L'exemple de code suivant montre comment utiliser`associate-default-view`.
**AWS CLI**
**Pour définir une vue de l'explorateur de ressources par défaut pour sa AWS région**
L'`associate-default-view`exemple 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) dans le *guide de l'utilisateur de AWS Resource Explorer*.
+ Pour plus de détails sur l'API, reportez-vous [AssociateDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/associate-default-view.html)à la section *Référence des AWS CLI commandes*.
### `batch-get-view`
L'exemple de code suivant montre comment utiliser`batch-get-view`.
**AWS CLI**
**Pour extraire des détails sur plusieurs vues de l’explorateur de ressources**
L'`batch-get-view`exemple 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, reportez-vous [BatchGetView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/batch-get-view.html)à la section *Référence des AWS CLI commandes*.
### `create-index`
L'exemple de code suivant montre comment utiliser`create-index`.
**AWS CLI**
**Pour activer l'explorateur de ressources dans une AWS région en créant un index**
L'`create-index`exemple 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-type](https://docs.aws.amazon.com/cli/latest/reference/resource-explorer-2/update-index-type.html)commande.
Pour plus d'informations, consultez la section [Activation de l'explorateur de ressources dans une AWS région pour indexer vos ressources](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-register.html) dans le *guide de l'utilisateur de l'explorateur de AWS ressources*.
+ Pour plus de détails sur l'API, reportez-vous [CreateIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-index.html)à la section *Référence des AWS CLI commandes*.
### `create-view`
L'exemple de code suivant montre comment utiliser`create-view`.
**AWS CLI**
**Exemple 1 : pour créer une vue non filtrée pour l'index dans une région AWS **
L'`create-view`exemple 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 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 [Création de vues pour une recherche](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-create.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, reportez-vous [CreateView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-view.html)à la section *Référence des AWS CLI commandes*.
### `delete-index`
L'exemple de code suivant montre comment utiliser`delete-index`.
**AWS CLI**
**Pour désactiver l'explorateur de ressources dans une AWS région en supprimant son index**
L'`delete-index`exemple 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-deregister.html) dans le *guide de l'utilisateur de l'explorateur de AWS ressources*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-index.html)à la section *Référence des AWS CLI commandes*.
### `delete-view`
L'exemple de code suivant montre comment utiliser`delete-view`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-delete.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, reportez-vous [DeleteView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-view.html)à la section *Référence des AWS CLI commandes*.
### `disassociate-default-view`
L'exemple de code suivant montre comment utiliser`disassociate-default-view`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) dans le *guide de l'utilisateur de AWS Resource Explorer*.
+ Pour plus de détails sur l'API, reportez-vous [DisassociateDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/disassociate-default-view.html)à la section *Référence des AWS CLI commandes*.
### `get-default-view`
L'exemple de code suivant montre comment utiliser`get-default-view`.
**AWS CLI**
**Pour récupérer la vue Resource Explorer qui est la vue par défaut pour sa AWS région**
L'`get-default-view`exemple 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) dans le *guide de l'utilisateur de AWS Resource Explorer*.
+ Pour plus de détails sur l'API, reportez-vous [GetDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-default-view.html)à la section *Référence des AWS CLI commandes*.
### `get-index`
L'exemple de code suivant montre comment utiliser`get-index`.
**AWS CLI**
**Exemple 1 : pour récupérer les détails d’un index agrégateur Explorateur de ressources**
L'`get-index`exemple 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-index`exemple 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) *guide de l'utilisateur de l'explorateur de AWS ressources*.
+ Pour plus de détails sur l'API, reportez-vous [GetIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-index.html)à la section *Référence des AWS CLI commandes*.
### `get-view`
L'exemple de code suivant montre comment utiliser`get-view`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, reportez-vous [GetView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-view.html)à la section *Référence des AWS CLI commandes*.
### `list-indexes`
L'exemple de code suivant montre comment utiliser`list-indexes`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) *guide de l'utilisateur de l'explorateur de AWS ressources*.
+ Pour plus de détails sur l'API, reportez-vous [ListIndexes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-indexes.html)à la section *Référence des AWS CLI commandes*.
### `list-supported-resource-types`
L'exemple de code suivant montre comment utiliser`list-supported-resource-types`.
**AWS CLI**
**Pour répertorier les AWS régions dans lesquelles Resource Explorer possède des index**
L'`list-supported-resource-types`exemple 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) *guide de l'utilisateur de l'explorateur de AWS ressources*.
+ Pour plus de détails sur l'API, reportez-vous [ListSupportedResourceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-supported-resource-types.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `list-views`
L'exemple de code suivant montre comment utiliser`list-views`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, voir [ListViews](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-views.html)la section *Référence des AWS CLI commandes*.
### `search`
L'exemple de code suivant montre comment utiliser`search`.
**AWS CLI**
**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'`search`exemple de recherche suivant affiche toutes les ressources (« \$1 ») 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 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:
{
"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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/using-search.html) dans le *guide de l'utilisateur de l'explorateur de AWS ressources*.
+ Pour plus de détails sur l’API, consultez [Search](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/search.html) dans la *Référence des commandes de l’AWS CLI *.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, voir [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/tag-resource.html)la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, voir [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/untag-resource.html)la section *Référence des AWS CLI commandes*.
### `update-index-type`
L'exemple de code suivant montre comment utiliser`update-index-type`.
**AWS CLI**
**Pour modifier le type d’un index Explorateur de ressources**
L'`update-index-type`exemple 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-aggregator-region.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS .*
+ Pour plus de détails sur l'API, voir [UpdateIndexType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-index-type.html)la section *Référence des AWS CLI commandes*.
### `update-view`
L'exemple de code suivant montre comment utiliser`update-view`.
**AWS CLI**
**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’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 [À propos des vues de l’explorateur de ressources](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) dans le *Guide de l’utilisateur de l’explorateur de ressources AWS *.
+ Pour plus de détails sur l'API, voir [UpdateView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-view.html)la section *Référence des AWS CLI commandes*.