Exemples de groupes de ressources utilisant des outils pour PowerShell - Exemples de code de l'AWS SDK
Actions

D'autres AWS SDK exemples sont disponibles dans le GitHub dépôt AWS Doc SDK Examples.

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 groupes de ressources utilisant des outils pour PowerShell

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Tools for PowerShell with Resource Groups.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserAdd-RGResourceTag.

Outils pour PowerShell

Exemple 1 : Cet exemple ajoute la clé de balise « Instances » avec la valeur « workboxes » au groupe de ressources donné arn

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 API plus de détails, consultez la section Référence des balises dans les AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserFind-RGResource.

Outils pour PowerShell

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 API plus de détails, consultez la section SearchResourcesRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserGet-RGGroup.

Outils pour PowerShell

Exemple 1 : Cet exemple récupère 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 API plus de détails, consultez la section GetGroupRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserGet-RGGroupList.

Outils pour PowerShell

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 API plus de détails, consultez la section ListGroupsRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserGet-RGGroupQuery.

Outils pour PowerShell

Exemple 1 : Cet exemple extrait la requête de ressource 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 API plus de détails, consultez la section GetGroupQueryRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserGet-RGGroupResourceList.

Outils pour PowerShell

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 API plus de détails, consultez la section ListGroupResourcesRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserGet-RGResourceTag.

Outils pour PowerShell

Exemple 1 : Cet exemple répertorie les balises pour le groupe de ressources arn donné

Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes

Sortie :

Key       Value
---       -----
Instances workboxes

  • Pour API plus de détails, consultez la section GetTagsRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserNew-RGGroup.

Outils pour PowerShell

Exemple 1 : Cet exemple crée un nouveau groupe de AWS ressources Resource Groups basé sur des balises nommé TestPowerShellGroup. Le groupe inclut les EC2 instances Amazon de la région actuelle qui sont étiqueté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 API plus de détails, consultez la section CreateGroupRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserRemove-RGGroup.

Outils pour PowerShell

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 API plus de détails, consultez la section DeleteGroupRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserRemove-RGResourceTag.

Outils pour PowerShell

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 API plus de détails, voir Untag in AWS Tools for PowerShell Cmdlet Reference.

L'exemple de code suivant montre comment utiliserUpdate-RGGroup.

Outils pour PowerShell

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 API plus de détails, consultez la section UpdateGroupRéférence des AWS Tools for PowerShell applets de commande.

L'exemple de code suivant montre comment utiliserUpdate-RGGroupQuery.

Outils pour PowerShell

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 API plus de détails, consultez la section UpdateGroupQueryRéférence des AWS Tools for PowerShell applets de commande.