Ejemplos de Resource Groups con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)
Acciones

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Ejemplos de Resource Groups con las Herramientas para PowerShell V4

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante Herramientas de AWS para PowerShell V4 con Resource Groups.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Add-RGResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se añade la clave de etiqueta “Instances” con el valor “workboxes” al ARN del grupo de recursos especificado.

Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes

Salida:

Arn                                                            Tags
---                                                            ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}

  • Para obtener información sobre la API, consulte Tag en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Find-RGResource.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una ResourceQuery para los tipos de recursos de instancia con filtros de etiquetas y se buscan los recursos.

$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

Salida:

ResourceArn                                                     ResourceType
-----------                                                     ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance

  • Para obtener información sobre la API, consulte SearchResources en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-RGGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se recupera el grupo de recursos según el nombre del grupo.

Get-RGGroup -GroupName auto-no

Salida:

Description GroupArn                                                     Name
----------- --------                                                     ----
            arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no

  • Para obtener información sobre la API, consulte GetGroup en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-RGGroupList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se enumeran los grupos de recursos ya creados.

Get-RGGroupList

Salida:

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

  • Para obtener información sobre la API, consulte ListGroups en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-RGGroupQuery.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se recupera la consulta de recursos del grupo de recursos especificado.

Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery

Salida:

Query                                                                                        Type
-----                                                                                        ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0

  • Para obtener información sobre la API, consulte GetGroupQuery en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-RGGroupResourceList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se enumeran los recursos del grupo en función de los filtros aplicados por tipo de recurso.

Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers

Salida:

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

  • Para obtener información sobre la API, consulte ListGroupResources en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-RGResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se enumeran las etiquetas del ARN del grupo de recursos especificado.

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

Salida:

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

  • Para obtener información sobre la API, consulte GetTags en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-RGGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un nuevo grupo de recursos de AWS Resource Groups basado en etiquetas llamado TestPowerShellGroup. El grupo incluye instancias de Amazon EC2 de la región actual etiquetadas con la clave de etiqueta “Name” y el valor de etiqueta “test2”. El comando devuelve la consulta y el tipo de grupo, así como los resultados de la operación.

$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."

Salida:

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

  • Para obtener información sobre la API, consulte CreateGroup en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-RGGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el grupo de recursos designado.

Remove-RGGroup -GroupName non-tag-cfn-elbv2

Salida:

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

  • Para obtener información sobre la API, consulte DeleteGroup en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-RGResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la etiqueta mencionada del grupo de recursos.

Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances

Salida:

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}

  • Para obtener información sobre la API, consulte Untag en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-RGGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se actualiza la descripción del grupo.

Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"

Salida:

Description             GroupArn                                                      Name
-----------             --------                                                      ----
Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes

  • Para obtener información sobre la API, consulte UpdateGroup en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-RGGroupQuery.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un objeto de consulta y se actualiza la consulta del grupo.

$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

Salida:

GroupName ResourceQuery
--------- -------------
build600  Amazon.ResourceGroups.Model.ResourceQuery

  • Para obtener información sobre la API, consulte UpdateGroupQuery en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).