Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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 `DescribeTags` com uma CLI
<a name="auto-scaling_example_auto-scaling_DescribeTags_section"></a>

Os exemplos de código a seguir mostram como usar o `DescribeTags`.

------
#### [ CLI ]

**AWS CLI**  
**Como descrever todas as tags**  
Este exemplo descreve todas as tags.  

```
aws autoscaling describe-tags
```
Saída:  

```
{
    "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 obter mais informações, consulte [Marcar instâncias e grupos de Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 2: Como descrever tags para um grupo especificado.**  
Use a opção para descrever as tags de um grupo do Auto Scaling específico use a opção `--filters`.  

```
aws autoscaling describe-tags --filters {{Name=auto-scaling-group,Values=my-asg}}
```
Para obter mais informações, consulte [Marcar instâncias e grupos de Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 3: Para descrever o número específico de tags**  
Use a opção `--max-items` para retornar um número específico de tags.  

```
aws autoscaling describe-tags \
    --max-items {{1}}
```
Se a saída incluir um campo `NextToken`, há mais tags. Para obter os tags adicionais, use o valor desse campo com a opção `--starting-token` em uma chamada subsequente da seguinte maneira.  

```
aws autoscaling describe-tags \
    --filters {{Name=auto-scaling-group,Values=my-asg}} \
    --starting-token {{Z3M3LMPEXAMPLE}}
```
Para obter mais informações, consulte [Marcar instâncias e grupos de Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
+  Para obter detalhes da API, consulte [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-tags.html)em *Referência de AWS CLI Comandos*. 

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: Este exemplo descreve as tags com um valor-chave de “myTag” ou “myTag2”. Os valores possíveis para o nome do filtro são “grupo do auto scaling”, “chave”, “valor” e “propagar na execução”. A sintaxe usada neste exemplo requer a PowerShell versão 3 ou posterior.**  

```
Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )
```
**Saída**:  

```
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
```
**Exemplo 2: Com a PowerShell versão 2, você deve usar New-Object para criar o filtro para o 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 )
```
**Exemplo 3: Este exemplo descreve todas as tags para tudos seus grupos do Auto Scaling.**  

```
Get-ASTag
```
+  Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: Este exemplo descreve as tags com um valor-chave de “myTag” ou “myTag2”. Os valores possíveis para o nome do filtro são “grupo do auto scaling”, “chave”, “valor” e “propagar na execução”. A sintaxe usada neste exemplo requer a PowerShell versão 3 ou posterior.**  

```
Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )
```
**Saída**:  

```
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
```
**Exemplo 2: Com a PowerShell versão 2, você deve usar New-Object para criar o filtro para o 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 )
```
**Exemplo 3: Este exemplo descreve todas as tags para tudos seus grupos do Auto Scaling.**  

```
Get-ASTag
```
+  Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------