View a markdown version of this page

Exemplos da API de marcação de Resource Groups usando o Tools for PowerShell V4 - AWS Exemplos de código do SDK
Ações

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

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 da API de marcação de Resource Groups usando o Tools for PowerShell V4

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

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-RGTResourceTag.

Ferramentas para PowerShell V4

Exemplo 1: esse exemplo adiciona as chaves de tag “stage” e “version” com os valores “beta” e “preprod_test” a um bucket do Amazon S3 e a uma tabela do Amazon DynamoDB. Uma única chamada será feita para o serviço a fim de aplicar as tags.

$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"

Add-RGTResourceTag -ResourceARNList $arn1,$arn2 -Tag @{ "stage"="beta"; "version"="preprod_test" }

Exemplo 2: esse exemplo adiciona as tags e os valores especificados a um bucket do Amazon S3 e a uma tabela do Amazon DynamoDB. Duas chamadas são feitas para o serviço, uma para cada ARN de recurso canalizado para o cmdlet.

$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"

$arn1,$arn2 | Add-RGTResourceTag -Tag @{ "stage"="beta"; "version"="preprod_test" }

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

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

Ferramentas para PowerShell V4

Exemplo 1: retorna todos os recursos marcados em uma região e as chaves de tag associadas ao recurso. Se nenhum parâmetro -Region for fornecido ao cmdlet, ele tentará inferir a região pelo shell ou pelos metadados da instância do EC2.

Get-RGTResource

Saída:

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}   
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

Exemplo 2: retorna todos os recursos marcados do tipo especificado em uma região. A string para cada nome de serviço e tipo de recurso é a mesma incorporada ao nome do recurso da Amazon (ARN) de um recurso.

Get-RGTResource -ResourceType "s3"

Saída:

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

Exemplo 3: retorna todos os recursos marcados do tipo especificado em uma região. Observe que quando os tipos de recursos são canalizados para o cmdlet, uma chamada para o serviço é feita para cada tipo de recurso fornecido.

"dynamodb","s3" | Get-RGTResource

Saída:

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}   
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

Exemplo 4: retorna todos os recursos marcados que correspondem ao filtro especificado.

Get-RGTResource -TagFilter @{ Key="stage" }

Saída:

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

Exemplo 5: retorna todos os recursos marcados que correspondem ao filtro e ao tipo de recurso especificados.

Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb"

Saída:

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}

Exemplo 6: retorna todos os recursos marcados que correspondem ao filtro especificado.

Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") }

Saída:

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}

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

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

Ferramentas para PowerShell V4

Exemplo 1: retorna todas as chaves de tag na região especificada. Se o parâmetro -Region não for especificado, o cmdlet tentará inferir a região por meio da região padrão do shell ou dos metadados da instância do EC2. Observe que as chaves da tag não são retornadas em nenhuma ordem específica.

Get-RGTTagKey -region us-west-2

Saída:

version
stage

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

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

Ferramentas para PowerShell V4

Exemplo 1: retorna o valor da tag especificada em uma região. Se o parâmetro -Region não for especificado, o cmdlet tentará inferir a região por meio da região padrão do shell ou dos metadados da instância do EC2.

Get-RGTTagValue -Key "stage" -Region us-west-2

Saída:

beta

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

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

Ferramentas para PowerShell V4

Exemplo 1: remove as chaves de tag “stage” e “version” e os valores associados de um bucket do Amazon S3 e de uma tabela do Amazon DynamoDB. Uma única chamada será feita para o serviço a fim de remover as tags. Antes que as tags sejam removidas, o cmdlet solicitará a confirmação. Para ignorar a confirmação, adicione o parâmetro -Force.

$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"

Remove-RGTResourceTag -ResourceARNList $arn1,$arn2 -TagKey "stage","version"

Exemplo 2: remove as chaves de tag “stage” e “version” e os valores associados de um bucket do Amazon S3 e de uma tabela do Amazon DynamoDB. Duas chamadas são feitas para o serviço, uma para cada ARN de recurso canalizado para o cmdlet. Antes de cada chamada, o cmdlet solicitará a confirmação. Para ignorar a confirmação, adicione o parâmetro -Force.

$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"

$arn1,$arn2 | Remove-RGTResourceTag -TagKey "stage","version"

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