Utilizar DescribeTags con una CLI

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

CLI

AWS CLI

Descripción de todas las etiquetas

En este ejemplo, se describen todas las etiquetas.

aws autoscaling describe-tags

Salida:

{
    "Tags": [
        {
            "ResourceType": "auto-scaling-group",
            "ResourceId": "my-asg",
            "PropagateAtLaunch": true,
            "Value": "Research",
            "Key": "Dept"
        },
        {
            "ResourceType": "auto-scaling-group",
            "ResourceId": "my-asg",
            "PropagateAtLaunch": true,
            "Value": "WebServer",
            "Key": "Role"
        }
    ]
}

Para obtener más información, consulte Etiquetado de grupos e instancias de Auto Scaling en la Guía del usuario de Amazon EC2 Auto Scaling.

Ejemplo 2: describir las etiquetas de un grupo específico

Para describir etiquetas de un grupo de escalado automático específico, utilice la opción --filters.

aws autoscaling describe-tags --filters Name=auto-scaling-group,Values=my-asg

Para obtener más información, consulte Etiquetado de grupos e instancias de Auto Scaling en la Guía del usuario de Amazon EC2 Auto Scaling.

Ejemplo 3: cómo describir el número especificado de etiquetas

Para devolver un número específico de etiquetas, utilice la opción --max-items.

aws autoscaling describe-tags \
    --max-items 1

Si la salida incluye un campo de NextToken, hay más etiquetas. Para obtener las etiquetas adicionales, utilice el valor de este campo con la opción --starting-token en una llamada posterior de la siguiente manera.

aws autoscaling describe-tags \
    --filters Name=auto-scaling-group,Values=my-asg \
    --starting-token Z3M3LMPEXAMPLE

Para obtener más información, consulte Etiquetado de grupos e instancias de Auto Scaling en la Guía del usuario de Amazon EC2 Auto Scaling.

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

PowerShell

Herramientas para la PowerShell versión 4

Ejemplo 1: En este ejemplo se describen las etiquetas con un valor clave de «myTag» o «myTag2». Los valores posibles para el nombre del filtro son «autoscaling-group», «key», «value» y «propagate-at-launch». La sintaxis utilizada en este ejemplo requiere PowerShell la versión 3 o posterior.

Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )

Salida:

Key               : myTag2
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue2

Key               : myTag
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue

Ejemplo 2: Con PowerShell la versión 2, debe utilizarse New-Object para crear el filtro para el parámetro Filter.

$keys = New-Object string[] 2
$keys[0] = "myTag"
$keys[1] = "myTag2"
$filter = New-Object Amazon.AutoScaling.Model.Filter
$filter.Name = "key"
$filter.Values = $keys
Get-ASTag -Filter @( $filter )

Ejemplo 3: En este ejemplo se describen todas las etiquetas para todos los grupos de escalado automático.

Get-ASTag

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se describen las etiquetas con un valor clave de «myTag» o «myTag2». Los valores posibles para el nombre del filtro son «autoscaling-group», «key», «value» y «propagate-at-launch». La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o posterior.

Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )

Salida:

Key               : myTag2
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue2

Key               : myTag
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue

Ejemplo 2: Con PowerShell la versión 2, debe utilizarse New-Object para crear el filtro para el parámetro Filter.

$keys = New-Object string[] 2
$keys[0] = "myTag"
$keys[1] = "myTag2"
$filter = New-Object Amazon.AutoScaling.Model.Filter
$filter.Name = "key"
$filter.Values = $keys
Get-ASTag -Filter @( $filter )

Ejemplo 3: En este ejemplo se describen todas las etiquetas para todos los grupos de escalado automático.

Get-ASTag

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