Exemplos de Resource Groups usando Tools for PowerShell - AWS SDKExemplos de código
Ações

Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos de Resource Groups usando Tools for PowerShell

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Tools for PowerShell with 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 funções de serviço individuais, é possível ver as ações no contexto em seus cenários relacionados.

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

Tópicos

Ações

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

Ferramentas para PowerShell

Exemplo 1: Este exemplo adiciona a chave de tag 'Instances' com o valor 'workboxes' ao determinado grupo de recursos arn

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 API obter detalhes, consulte Tag in AWS Tools for PowerShell Cmdlet Reference.

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

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um tipo de recurso ResourceQuery for Instance 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 API obter detalhes, consulte SearchResourcesem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte GetGroupem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte ListGroupsem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Este exemplo busca a consulta de recursos para o determinado grupo de recursos

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 API obter detalhes, consulte GetGroupQueryem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte ListGroupResourcesem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Este exemplo lista as tags para o determinado grupo de recursos arn

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

Saída:

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

  • Para API obter detalhes, consulte GetTagsem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um novo grupo de AWS recursos de Resource Groups baseado em tags chamado TestPowerShellGroup. O grupo inclui EC2 instâncias da Amazon na região atual que são marcadas com a chave de tag “Nome” 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 API obter detalhes, consulte CreateGroupem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte DeleteGroupem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte Untag in AWS Tools for PowerShell Cmdlet Reference.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte UpdateGroupem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Esse 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 API obter detalhes, consulte UpdateGroupQueryem Referência de AWS Tools for PowerShell cmdlet.