Exemplos de Resource Groups que usam o Tools for PowerShell V4 - Ferramentas da AWS para PowerShell (versão 4)
Ações

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Exemplos de Resource Groups que usam o Tools for PowerShell V4

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 com Resource Groups.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Add-RGResourceTag.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo adiciona a chave de tag “Instances” com o valor “workboxes” ao ARN do grupo de recursos fornecido

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

Saída:

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

  • Para obter detalhes da API, consulte Tag em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Find-RGResource.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo cria um ResourceQuery para tipos de recursos de instância com filtros de tag e encontra 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

Saída:

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

  • Para obter detalhes da API, consulte SearchResources em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-RGGroup.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo recupera o grupo de recursos de acordo com o nome do grupo

Get-RGGroup -GroupName auto-no

Saída:

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

  • Para obter detalhes da API, consulte GetGroup na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-RGGroupList.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo lista o grupo de recursos já criado.

Get-RGGroupList

Saída:

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 obter detalhes da API, consulte ListGroups na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-RGGroupQuery.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo busca a consulta de recursos para o grupo de recursos indicado

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

Saída:

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

  • Para obter detalhes da API, consulte GetGroupQuery em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-RGGroupResourceList.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo lista os recursos do grupo com base no filtro por tipo de recurso

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

Saída:

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 obter detalhes da API, consulte ListGroupResources em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-RGResourceTag.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo lista tags para o ARN do grupo de recursos indicado

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

Saída:

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

  • Para obter detalhes da API, consulte GetTags em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar New-RGGroup.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo cria um novo grupo de recursos do AWS Resource Groups baseado em tags chamado TestPowerShellGroup. O grupo inclui instâncias do Amazon EC2 na região atual que são marcadas com a chave de tag “Name” e o valor da tag “test2". O comando retorna a consulta, o tipo de grupo e os resultados da operação.

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

Saída:

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 ver detalhes da API, consulte CreateGroup na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Remove-RGGroup.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo remove o grupo de recursos nomeado

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

Saída:

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 obter detalhes da API, consulte DeleteGroup na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Remove-RGResourceTag.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo remove a tag mencionada do grupo de recursos

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

Saída:

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 obter detalhes da API, consulte Untag em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Update-RGGroup.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo atualiza a descrição do grupo

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

Saída:

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

  • Para obter detalhes da API, consulte UpdateGroup na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Update-RGGroupQuery.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo cria um objeto de consulta e atualiza a consulta para o 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

Saída:

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

  • Para obter detalhes da API, consulte UpdateGroupQuery em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).