Utilizar GetResources con una CLI

Los siguientes ejemplos de código muestran cómo utilizar GetResources.

CLI

AWS CLI

Para obtener una lista de recursos etiquetados

En el siguiente ejemplo de get-resources, se muestra una lista de los recursos de la cuenta que están etiquetados con el nombre y el valor clave especificados.

aws resourcegroupstaggingapi get-resources \
    --tag-filters Key=Environment,Values=Production \
    --tags-per-page 100

Salida:

{
    "ResourceTagMappingList": [
        {
            "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}

Para obtener más información, consulte la referencia GetResourcesde la API de etiquetado de Resource Groups.

• Para obtener más información sobre la API, consulte GetResourcesla Referencia de AWS CLI comandos.

PowerShell

Herramientas para la PowerShell versión 4

Ejemplo 1: Devuelve todos los recursos etiquetados de una región y las claves de etiqueta asociadas al recurso. Si no se proporciona ningún parámetro -Region al cmdlet, se intentará deducir la región del intérprete de comandos de los metadatos de la instancia de EC2.

Get-RGTResource

Salida:

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

Ejemplo 2: Devuelve todos los recursos etiquetados del tipo especificado en una región. La cadena de cada nombre de servicio y tipo de recurso es la misma que la incluida en el Nombre de recurso de Amazon (ARN) de un recurso.

Get-RGTResource -ResourceType "s3"

Salida:

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

Ejemplo 3: Devuelve todos los recursos etiquetados del tipo especificado en una región. Tenga en cuenta que cuando los tipos de recursos se envían al cmdlet, se realiza una llamada al servicio por cada tipo de recurso especificado.

"dynamodb","s3" | Get-RGTResource

Salida:

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

Ejemplo 4: Devuelve todos los recursos etiquetados que coinciden con el filtro especificado.

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

Salida:

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

Ejemplo 5: Devuelve todos los recursos etiquetados que coinciden con el filtro especificado.

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

Salida:

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

Ejemplo 6: Devuelve todos los recursos etiquetados que coinciden con el filtro especificado.

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

Salida:

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

• Para obtener más información sobre la API, consulte GetResources Herramientas de AWS para PowerShellCmdlet Reference (V4).

Herramientas para la versión 5 PowerShell

Ejemplo 1: Devuelve todos los recursos etiquetados de una región y las claves de etiqueta asociadas al recurso. Si no se proporciona ningún parámetro -Region al cmdlet, se intentará deducir la región del intérprete de comandos de los metadatos de la instancia de EC2.

Get-RGTResource

Salida:

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

Ejemplo 2: Devuelve todos los recursos etiquetados del tipo especificado en una región. La cadena de cada nombre de servicio y tipo de recurso es la misma que la incluida en el Nombre de recurso de Amazon (ARN) de un recurso.

Get-RGTResource -ResourceType "s3"

Salida:

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

Ejemplo 3: Devuelve todos los recursos etiquetados del tipo especificado en una región. Tenga en cuenta que cuando los tipos de recursos se envían al cmdlet, se realiza una llamada al servicio por cada tipo de recurso especificado.

"dynamodb","s3" | Get-RGTResource

Salida:

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

Ejemplo 4: Devuelve todos los recursos etiquetados que coinciden con el filtro especificado.

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

Salida:

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

Ejemplo 5: Devuelve todos los recursos etiquetados que coinciden con el filtro especificado.

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

Salida:

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

Ejemplo 6: Devuelve todos los recursos etiquetados que coinciden con el filtro especificado.

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

Salida:

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

• Para obtener más información sobre la API, consulte GetResourcesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).