Há mais exemplos de AWS SDK disponíveis no 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á.
Usar GetResources com uma CLI
Os exemplos de código a seguir mostram como usar o GetResources.
- CLI
-
- AWS CLI
-
Obter uma lista de recursos marcados
O exemplo
get-resourcesa seguir exibe uma lista de recursos na conta que estão marcados com o nome e o valor da chave especificados.aws resourcegroupstaggingapi get-resources \ --tag-filtersKey=Environment,Values=Production\ --tags-per-page100Saída:
{ "ResourceTagMappingList": [ { "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", "Tags": [ { "Key": "Environment", "Value": "Production" } ] } ] }Para obter mais informações, consulte a Referência GetResourcesda API Resource Groups Tagging.
-
Para obter detalhes da API, consulte GetResources
em Referência de AWS CLI Comandos.
-
- PowerShell
-
- 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 a partir dos metadados do shell ou da instância. EC2
Get-RGTResourceSaí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 no Amazon Resource Name (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-RGTResourceSaí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).
-
- Ferramentas para PowerShell V5
-
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 a partir dos metadados do shell ou da instância. EC2
Get-RGTResourceSaí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 no Amazon Resource Name (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-RGTResourceSaí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 (V5).
-