Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # 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 [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)de la API de etiquetado de Resource Groups*. + Para obtener más información sobre la API, consulte [GetResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html)la *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 PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet 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 [GetResources](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ------