Utilisation de DescribeTags avec une CLI

Les exemples de code suivants illustrent comment utiliser DescribeTags.

CLI

AWS CLI

Pour décrire toutes les balises

Cet exemple décrit toutes vos balises.

aws autoscaling describe-tags

Sortie :

{
    "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"
        }
    ]
}

Pour de plus amples informations, veuillez consulter Balisage des groupes Auto Scaling et des instances dans le Guide de l’utilisateur Amazon EC2 Auto Scaling.

Exemple 2 : pour décrire les balises d’un groupe spécifique

Pour décrire les balises pour un groupe Auto Scaling spécifique, utilisez l’option --filters.

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

Pour de plus amples informations, veuillez consulter Balisage des groupes Auto Scaling et des instances dans le Guide de l’utilisateur Amazon EC2 Auto Scaling.

Exemple 3 : pour décrire le nombre de balises spécifié

Pour renvoyer un nombre spécifique de balises, utilisez l’option --max-items.

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

Si la sortie inclut un champ NextToken, il existe d’autres balises. Pour obtenir les balises supplémentaires, utilisez la valeur de ce champ avec l’option --starting-token lors d’un appel ultérieur, comme suit.

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

Pour de plus amples informations, veuillez consulter Balisage des groupes Auto Scaling et des instances dans le Guide de l’utilisateur Amazon EC2 Auto Scaling.

• Pour plus de détails sur l'API, reportez-vous DescribeTagsà la section Référence des AWS CLI commandes.

PowerShell

Outils pour PowerShell V4

Exemple 1 : cet exemple décrit les balises dont la valeur clé est « myTag » ou « myTag2 ». Les valeurs possibles pour le nom du filtre sont « auto-scaling-group », « key », « value » et « propagate-at-launch ». La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.

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

Sortie :

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

Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer le filtre pour le paramètre 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 )

Exemple 3 : cet exemple décrit toutes les balises pour tous vos groupes Auto Scaling.

Get-ASTag

• Pour plus de détails sur l'API, reportez-vous DescribeTagsà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple décrit les balises dont la valeur clé est « myTag » ou « myTag2 ». Les valeurs possibles pour le nom du filtre sont « auto-scaling-group », « key », « value » et « propagate-at-launch ». La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.

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

Sortie :

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

Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer le filtre pour le paramètre 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 )

Exemple 3 : cet exemple décrit toutes les balises pour tous vos groupes Auto Scaling.

Get-ASTag

• Pour plus de détails sur l'API, reportez-vous DescribeTagsà la section Référence des Outils AWS pour PowerShell applets de commande (V5).