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 de base pour Resource Groups utilisant AWS SDKs
Les exemples de code suivants montrent comment utiliser les principes de base de Groupes de ressources AWS with AWS SDKs.
**Contents**
+ [Actions](resource-groups_code_examples_actions.md)
+ [`CreateGroup`](resource-groups_example_resource-groups_CreateGroup_section.md)
+ [`DeleteGroup`](resource-groups_example_resource-groups_DeleteGroup_section.md)
+ [`GetGroup`](resource-groups_example_resource-groups_GetGroup_section.md)
+ [`GetGroupQuery`](resource-groups_example_resource-groups_GetGroupQuery_section.md)
+ [`GetTags`](resource-groups_example_resource-groups_GetTags_section.md)
+ [`ListGroupResources`](resource-groups_example_resource-groups_ListGroupResources_section.md)
+ [`ListGroups`](resource-groups_example_resource-groups_ListGroups_section.md)
+ [`SearchResources`](resource-groups_example_resource-groups_SearchResources_section.md)
+ [`Tag`](resource-groups_example_resource-groups_Tag_section.md)
+ [`Untag`](resource-groups_example_resource-groups_Untag_section.md)
+ [`UpdateGroup`](resource-groups_example_resource-groups_UpdateGroup_section.md)
+ [`UpdateGroupQuery`](resource-groups_example_resource-groups_UpdateGroupQuery_section.md)
# Actions pour Resource Groups utilisant AWS SDKs
Les exemples de code suivants montrent comment effectuer des actions Resource Groups individuelles avec AWS SDKs. Chaque exemple inclut un lien vers GitHub, où vous pouvez trouver des instructions pour configurer et exécuter le code.
Les exemples suivants incluent uniquement les actions les plus couramment utilisées. Pour obtenir la liste complète, consultez la [Référence des API Groupes de ressources AWS](https://docs.aws.amazon.com/ARG/latest/APIReference/Welcome.html).
**Topics**
+ [`CreateGroup`](resource-groups_example_resource-groups_CreateGroup_section.md)
+ [`DeleteGroup`](resource-groups_example_resource-groups_DeleteGroup_section.md)
+ [`GetGroup`](resource-groups_example_resource-groups_GetGroup_section.md)
+ [`GetGroupQuery`](resource-groups_example_resource-groups_GetGroupQuery_section.md)
+ [`GetTags`](resource-groups_example_resource-groups_GetTags_section.md)
+ [`ListGroupResources`](resource-groups_example_resource-groups_ListGroupResources_section.md)
+ [`ListGroups`](resource-groups_example_resource-groups_ListGroups_section.md)
+ [`SearchResources`](resource-groups_example_resource-groups_SearchResources_section.md)
+ [`Tag`](resource-groups_example_resource-groups_Tag_section.md)
+ [`Untag`](resource-groups_example_resource-groups_Untag_section.md)
+ [`UpdateGroup`](resource-groups_example_resource-groups_UpdateGroup_section.md)
+ [`UpdateGroupQuery`](resource-groups_example_resource-groups_UpdateGroupQuery_section.md)
# Utilisation de `CreateGroup` avec une CLI
Les exemples de code suivants illustrent comment utiliser `CreateGroup`.
------
#### [ CLI ]
**AWS CLI**
**Exemple 1 : pour créer un groupe de ressources basé sur des balises**
L’exemple `create-group` suivant montre comment créer un groupe de ressources basé sur des balises d’instances Amazon EC2 dans la région actuelle. Il est basé sur une requête pour les ressources balisées avec la clé `Name` et la valeur `WebServers`. Le nom du groupe est `tbq-WebServer`. La requête se trouve dans un fichier JSON distinct qui est transmis à la commande.
```
aws resource-groups create-group \
--name tbq-WebServer \
--resource-query file://query.json
```
Contenu de `query.json` :
```
{
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
```
Sortie :
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
},
"ResourceQuery": {
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
}
```
**Exemple 2 : pour créer un groupe de ressources CloudFormation basé sur une pile**
L'`create-group`exemple suivant crée un groupe de ressources AWS CloudFormation basé sur une pile nommé. `sampleCFNstackgroup` La requête inclut toutes les ressources de la CloudFormation pile spécifiée qui sont prises en charge par AWS Resource Groups.
```
aws resource-groups create-group \
--name cbq-CFNstackgroup \
--resource-query file://query.json
```
Contenu de `query.json` :
```
{
"Type": "CLOUDFORMATION_STACK_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"
}
```
Sortie :
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup",
"Name": "cbq-CFNstackgroup"
},
"ResourceQuery": {
"Type": "CLOUDFORMATION_STACK_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}'
}
}
```
Pour plus d’informations, consultez [Create Groups](https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html) dans le *Guide de l’utilisateur AWS Resource Groups*.
+ Pour plus de détails sur l'API, voir [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/create-group.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un nouveau groupe de AWS ressources Resource Groups basé sur des balises nommé TestPowerShellGroup. Le groupe inclut les instances Amazon EC2 de la région actuelle qui sont balisées avec la clé de balise « Name » et la valeur de balise « test2 ». La commande renvoie la requête et le type de groupe, ainsi que les résultats de l’opération.**
```
$ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery
$ResourceQuery.Type = "TAG_FILTERS_1_0"
$ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}'
$ResourceQuery
New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group."
```
**Sortie** :
```
Query Type
----- ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0
LoggedAt : 11/20/2018 2:40:59 PM
Group : Amazon.ResourceGroups.Model.Group
ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery
Tags : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 338
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [CreateGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple crée un nouveau groupe de AWS ressources Resource Groups basé sur des balises nommé TestPowerShellGroup. Le groupe inclut les instances Amazon EC2 de la région actuelle qui sont balisées avec la clé de balise « Name » et la valeur de balise « test2 ». La commande renvoie la requête et le type de groupe, ainsi que les résultats de l’opération.**
```
$ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery
$ResourceQuery.Type = "TAG_FILTERS_1_0"
$ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}'
$ResourceQuery
New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group."
```
**Sortie** :
```
Query Type
----- ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0
LoggedAt : 11/20/2018 2:40:59 PM
Group : Amazon.ResourceGroups.Model.Group
ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery
Tags : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 338
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [CreateGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `DeleteGroup` avec une CLI
Les exemples de code suivants illustrent comment utiliser `DeleteGroup`.
------
#### [ CLI ]
**AWS CLI**
**Pour mettre à jour la description d’un groupe de ressources**
L’exemple `delete-group` suivant met à jour le groupe de ressources spécifié.
```
aws resource-groups delete-group \
--group-name tbq-WebServer
```
Sortie :
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:1234567890:group/tbq-WebServer",
"Name": "tbq-WebServer"
}
}
```
Pour plus d’informations, consultez [Suppression des groupes](https://docs.aws.amazon.com/ARG/latest/userguide/deleting-resource-groups.html) dans le *Guide de l’utilisateur AWS Resource Groups*.
+ Pour plus de détails sur l'API, voir [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/delete-group.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe de ressources nommé**
```
Remove-RGGroup -GroupName non-tag-cfn-elbv2
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGGroup (DeleteGroup)" on target "non-tag-cfn-elbv2".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Description GroupArn Name
----------- -------- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/non-tag-cfn-elbv2 non-tag-cfn-elbv2
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime le groupe de ressources nommé**
```
Remove-RGGroup -GroupName non-tag-cfn-elbv2
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGGroup (DeleteGroup)" on target "non-tag-cfn-elbv2".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Description GroupArn Name
----------- -------- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/non-tag-cfn-elbv2 non-tag-cfn-elbv2
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `GetGroup` avec une CLI
Les exemples de code suivants illustrent comment utiliser `GetGroup`.
------
#### [ CLI ]
**AWS CLI**
**Pour obtenir les informations sur un groupe de ressources**
L’exemple `get-group` suivant affiche les détails sur le groupe de ressources spécifié. Pour attacher la requête au groupe, utilisez `get-group-query`.
```
aws resource-groups get-group \
--group-name tbq-WebServer
```
Sortie :
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer",
"Description": "A tag-based query resource group of WebServers."
}
}
```
+ Pour plus de détails sur l'API, voir [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-group.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait le groupe de ressources selon le nom du groupe**
```
Get-RGGroup -GroupName auto-no
```
**Sortie** :
```
Description GroupArn Name
----------- -------- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple extrait le groupe de ressources selon le nom du groupe**
```
Get-RGGroup -GroupName auto-no
```
**Sortie** :
```
Description GroupArn Name
----------- -------- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `GetGroupQuery` avec une CLI
Les exemples de code suivants illustrent comment utiliser `GetGroupQuery`.
------
#### [ CLI ]
**AWS CLI**
**Pour attacher la requête à un groupe de ressources**
L’exemple `get-group-query` suivant montre une requête attachée au groupe de ressources spécifié.
```
aws resource-groups get-group-query \
--group-name tbq-WebServer
```
Sortie :
```
{
"GroupQuery": {
"GroupName": "tbq-WebServer",
"ResourceQuery": {
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
}
}
```
+ Pour plus de détails sur l'API, voir [GetGroupQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-group-query.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la requête de ressources pour le groupe de ressources donné**
```
Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery
```
**Sortie** :
```
Query Type
----- ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroupQuery](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple extrait la requête de ressources pour le groupe de ressources donné**
```
Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery
```
**Sortie** :
```
Query Type
----- ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `GetTags` avec une CLI
Les exemples de code suivants illustrent comment utiliser `GetTags`.
------
#### [ CLI ]
**AWS CLI**
**Pour récupérer les balises attachées à un groupe de ressources**
L’exemple `get-tags` suivant affiche les paires clé/valeur de balise attachées au groupe de ressources spécifié (le groupe lui-même, pas ses membres).
```
aws resource-groups get-tags \
--arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer
```
Sortie :
```
{
"Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Tags": {
"QueryType": "tags",
"QueryResources": "ec2-instances"
}
}
```
+ Pour plus de détails sur l'API, voir [GetTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-tags.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les balises pour l’ARN du groupe de ressources donné**
```
Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Sortie** :
```
Key Value
--- -----
Instances workboxes
```
+ Pour plus de détails sur l'API, reportez-vous [GetTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les balises pour l’ARN du groupe de ressources donné**
```
Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Sortie** :
```
Key Value
--- -----
Instances workboxes
```
+ Pour plus de détails sur l'API, reportez-vous [GetTags](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `ListGroupResources` avec une CLI
Les exemples de code suivants illustrent comment utiliser `ListGroupResources`.
------
#### [ CLI ]
**AWS CLI**
**Pour créer une liste de toutes les ressources d’un groupe de ressources**
Exemple 1 : l’exemple `list-resource-groups` suivant répertorie toutes les ressources qui font partie du groupe de ressources spécifié.
```
aws resource-groups list-group-resources \
--group-name tbq-WebServer
```
Sortie :
```
{
"ResourceIdentifiers": [
{
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-09f77fa38c12345ab",
"ResourceType": "AWS::EC2::Instance"
}
]
}
```
Exemple 2 : l’exemple suivant répertorie toutes les ressources du groupe qui ont également « AWS::EC2::Instance » comme « resource-type » :
aws resource-groups list-group-resources --group-name tbq- WebServer --filters Name=Type de ressource, Values= : :EC2 : :Instance AWS
+ Pour plus de détails sur l'API, voir [ListGroupResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-group-resources.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les ressources du groupe sur la base du filtrage par type de ressource**
```
Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers
```
**Sortie** :
```
ResourceArn ResourceType
----------- ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123bc45b567890e1 AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0a1caf2345f67d8dc AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0fd12dd3456789012 AWS::EC2::Instance
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroupResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les ressources du groupe sur la base du filtrage par type de ressource**
```
Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers
```
**Sortie** :
```
ResourceArn ResourceType
----------- ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123bc45b567890e1 AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0a1caf2345f67d8dc AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0fd12dd3456789012 AWS::EC2::Instance
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroupResources](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `ListGroups` avec une CLI
Les exemples de code suivants illustrent comment utiliser `ListGroups`.
------
#### [ CLI ]
**AWS CLI**
**Pour créer une liste des groupes de ressources disponibles**
L’exemple `list-groups` suivant affiche une liste de tous les groupes de ressources.
```
aws resource-groups list-groups
```
Sortie :
```
{
"GroupIdentifiers": [
{
"GroupName": "tbq-WebServer",
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer3"
},
{
"GroupName": "cbq-CFNStackQuery",
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery"
}
],
"Groups": [
{
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
},
{
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery",
"Name": "cbq-CFNStackQuery"
}
]
}
```
+ Pour plus de détails sur l'API, voir [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-groups.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les groupes de ressources déjà créés.**
```
Get-RGGroupList
```
**Sortie** :
```
GroupArn GroupName
-------- ---------
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes
arn:aws:resource-groups:eu-west-1:123456789012:group/build600 build600
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les groupes de ressources déjà créés.**
```
Get-RGGroupList
```
**Sortie** :
```
GroupArn GroupName
-------- ---------
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes
arn:aws:resource-groups:eu-west-1:123456789012:group/build600 build600
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroups](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `SearchResources` avec une CLI
Les exemples de code suivants illustrent comment utiliser `SearchResources`.
------
#### [ CLI ]
**AWS CLI**
**Pour rechercher des ressources correspondant à une requête**
L'`search-resources`exemple suivant extrait une liste de toutes les AWS ressources qui correspondent à la requête spécifiée.
```
aws resource-groups search-resources \
--resource-query file://query.json
```
Contenu de `query.json` :
```
{
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Patch Group\", \"Values\":[\"Dev\"]}]}"
}
```
Sortie :
```
{
"ResourceIdentifiers": [
{
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a23bc45d67890ef",
"ResourceType": "AWS::EC2::Instance"
}
]
}
```
+ Pour plus de détails sur l'API, voir [SearchResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/search-resources.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un type de ressource ResourceQuery for Instance avec des filtres de balises et trouve des ressources.**
```
$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = ConvertTo-Json -Compress -Depth 4 -InputObject @{
ResourceTypeFilters = @('AWS::EC2::Instance')
TagFilters = @(@{
Key = 'auto'
Values = @('no')
})
}
Find-RGResource -ResourceQuery $query | Select-Object -ExpandProperty ResourceIdentifiers
```
**Sortie** :
```
ResourceArn ResourceType
----------- ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance
```
+ Pour plus de détails sur l'API, reportez-vous [SearchResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple crée un type de ressource ResourceQuery for Instance avec des filtres de balises et trouve des ressources.**
```
$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = ConvertTo-Json -Compress -Depth 4 -InputObject @{
ResourceTypeFilters = @('AWS::EC2::Instance')
TagFilters = @(@{
Key = 'auto'
Values = @('no')
})
}
Find-RGResource -ResourceQuery $query | Select-Object -ExpandProperty ResourceIdentifiers
```
**Sortie** :
```
ResourceArn ResourceType
----------- ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance
```
+ Pour plus de détails sur l'API, reportez-vous [SearchResources](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `Tag` avec une CLI
Les exemples de code suivants illustrent comment utiliser `Tag`.
------
#### [ CLI ]
**AWS CLI**
**Pour attacher une balise à un groupe de ressources**
L’exemple `tag` suivant attache les paires clé/valeur de balise spécifiées au groupe de ressources spécifié (le groupe lui-même, pas ses membres).
```
aws resource-groups tag \
--tags QueryType=tags,QueryResources=ec2-instances \
--arn arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer
```
Sortie :
```
{
"Arn": "arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer",
"Tags": {
"QueryType": "tags",
"QueryResources": "ec2-instances"
}
}
```
Pour plus d’informations, consultez [Gestion des balises](https://docs.aws.amazon.com/ARG/latest/userguide/tagging-resources.html) dans le *Guide de l’utilisateur AWS Resource Groups*.
+ Pour plus de détails sur l’API, consultez [Tag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/tag.html) dans la *Référence des commandes de l’AWS CLI *.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute la clé de balise « Instances » avec la valeur « workboxes » à l’ARN du groupe de ressources donné**
```
Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Sortie** :
```
Arn Tags
--- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}
```
+ Pour plus de détails sur l’API, consultez [Tag](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple ajoute la clé de balise « Instances » avec la valeur « workboxes » à l’ARN du groupe de ressources donné**
```
Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Sortie** :
```
Arn Tags
--- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}
```
+ Pour plus de détails sur l’API, consultez [Tag](https://docs.aws.amazon.com/powershell/v5/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V5)*.
------
# Utilisation de `Untag` avec une CLI
Les exemples de code suivants illustrent comment utiliser `Untag`.
------
#### [ CLI ]
**AWS CLI**
**Pour supprimer des balises d’un groupe de ressources**
L’exemple `untags` suivant supprime toute balise avec la clé spécifiée du groupe de ressources lui-même et non de ses membres.
```
aws resource-groups untag \
--arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer \
--keys QueryType
```
Sortie :
```
{
"Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Keys": [
"QueryType"
]
}
```
Pour plus d’informations, consultez [Gestion des balises](https://docs.aws.amazon.com/ARG/latest/userguide/tagging-resources.html) dans le *Guide de l’utilisateur AWS Resource Groups*.
+ Pour plus de détails sur l’API, consultez [Untag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/untag.html) dans la *Référence des commandes de l’AWS CLI *.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise mentionnée du groupe de ressources**
```
Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGResourceTag (Untag)" on target "arn:aws:resource-groups:eu-west-1:933303704102:group/workboxes".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Arn Keys
--- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {Instances}
```
+ Pour plus de détails sur l’API, consultez [Untag](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime la balise mentionnée du groupe de ressources**
```
Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGResourceTag (Untag)" on target "arn:aws:resource-groups:eu-west-1:933303704102:group/workboxes".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Arn Keys
--- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {Instances}
```
+ Pour plus de détails sur l’API, consultez [Untag](https://docs.aws.amazon.com/powershell/v5/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V5)*.
------
# Utilisation de `UpdateGroup` avec une CLI
Les exemples de code suivants illustrent comment utiliser `UpdateGroup`.
------
#### [ CLI ]
**AWS CLI**
**Pour mettre à jour la description d’un groupe de ressources**
L’exemple `update-group` suivant met à jour la description du groupe de ressources spécifié.
```
aws resource-groups update-group \
--group-name tbq-WebServer \
--description "Resource group for all web server resources."
```
Sortie :
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
"Description": "Resource group for all web server resources."
}
}
```
Pour plus d’informations, consultez [Mettre à jour les groupes](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) dans le *Guide de l’utilisateur AWS Resource Groups*.
+ Pour plus de détails sur l'API, voir [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/update-group.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la description du groupe**
```
Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"
```
**Sortie** :
```
Description GroupArn Name
----------- -------- ----
Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour la description du groupe**
```
Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"
```
**Sortie** :
```
Description GroupArn Name
----------- -------- ----
Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
# Utilisation de `UpdateGroupQuery` avec une CLI
Les exemples de code suivants illustrent comment utiliser `UpdateGroupQuery`.
------
#### [ CLI ]
**AWS CLI**
**Exemple 1 : pour mettre à jour la requête pour un groupe de ressources basé sur des balises**
L’exemple `update-group-query` suivant met à jour la requête attachée au groupe de ressources basé sur des balises spécifié.
```
aws resource-groups update-group-query \
--group-name tbq-WebServer \
--resource-query '{"Type":"TAG_FILTERS_1_0", "Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"}'
```
Sortie :
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
},
"ResourceQuery": {
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
}
```
Pour plus d’informations, consultez [Mettre à jour les groupes](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) dans le *Guide de l’utilisateur AWS Resource Groups*.
**Exemple 2 : pour mettre à jour la requête pour un groupe de ressources CloudFormation basé sur une pile**
L'`update-group-query`exemple suivant met à jour la requête attachée au groupe de ressources AWS CloudFormation basé sur une pile spécifié.
```
aws resource-groups update-group-query \
--group-name cbq-CFNstackgroup \
--resource-query '{"Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}'
```
Sortie :
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup",
"Name": "cbq-CFNstackgroup"
},
"ResourceQuery": {
"Type": "CLOUDFORMATION_STACK_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"
}
}
```
Pour plus d’informations, consultez [Mettre à jour les groupes](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) dans le *Guide de l’utilisateur AWS Resource Groups*.
+ Pour plus de détails sur l'API, voir [UpdateGroupQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/update-group-query.html)la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un objet de requête et met à jour la requête pour le groupe.**
```
$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = @{
ResourceTypeFilters = @('AWS::EC2::Instance')
TagFilters = @(@{
Key='Environment'
Values='Build600.11'
})
} | ConvertTo-Json -Compress -Depth 4
Update-RGGroupQuery -GroupName build600 -ResourceQuery $query
```
**Sortie** :
```
GroupName ResourceQuery
--------- -------------
build600 Amazon.ResourceGroups.Model.ResourceQuery
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroupQuery](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un objet de requête et met à jour la requête pour le groupe.**
```
$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = @{
ResourceTypeFilters = @('AWS::EC2::Instance')
TagFilters = @(@{
Key='Environment'
Values='Build600.11'
})
} | ConvertTo-Json -Compress -Depth 4
Update-RGGroupQuery -GroupName build600 -ResourceQuery $query
```
**Sortie** :
```
GroupName ResourceQuery
--------- -------------
build600 Amazon.ResourceGroups.Model.ResourceQuery
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------