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á.

# Adicionar tags nos aplicativos do Managed Service for Apache Flink
<a name="how-tagging"></a>



Esta seção descreve como adicionar tags de metadados de valor-chave para aplicativos do Managed Service for Apache Flink. Essas tags podem ser usadas para as seguintes finalidades:
+ Determinar o faturamento para um aplicativo individual do Managed Service for Apache Flink. Para obter mais informações, consulte [Como usar tags de alocação](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia de Gerenciamento de custos e faturamento*.
+ Controlar o acesso a recursos de aplicativos com base em tags. Para obter mais informações, consulte [Controlar o acesso usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *Guia do usuário do AWS Identity and Access Management *.
+ Finalidades definidas pelo usuário. Você pode definir a funcionalidade do aplicativo com base na presença de tags do usuário.

Observe as seguintes informações sobre a marcação:
+ O número máximo de tags do aplicativo inclui tags de sistema. O número máximo de tags do aplicativo definidas pelo usuário é de 50.
+ Se uma ação inclui uma lista de tags que tem valores `Key` duplicados, o serviço lançará um `InvalidArgumentException`.

**Topics**
+ [Adicionar tags quando um aplicativo é criado](how-tagging-create.md)
+ [Adicionar ou atualizar tags para um aplicativo existente](how-tagging-add.md)
+ [Listar tags para um aplicativo](how-tagging-list.md)
+ [Remover tags de um aplicativo](how-tagging-remove.md)

# Adicionar tags quando um aplicativo é criado
<a name="how-tagging-create"></a>

Você adiciona tags ao criar um aplicativo usando o `tags` parâmetro da [CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html)ação.

O exemplo de solicitação a seguir mostra o nó `Tags` para uma solicitação `CreateApplication`:

```
"Tags": [ 
    { 
        "Key": "Key1",
        "Value": "Value1"
    },
    { 
        "Key": "Key2",
        "Value": "Value2"
    }
]
```

# Adicionar ou atualizar tags para um aplicativo existente
<a name="how-tagging-add"></a>

Você adiciona tags a um aplicativo usando a [TagResource](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_TagResource.html)ação. Você não pode adicionar tags a um aplicativo usando a [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html)ação.

Para atualizar uma tag existente, adicione uma tag com a mesma chave da tag existente.

O exemplo de solicitação a seguir para a ação `TagResource` adiciona novas tags ou atualiza tags existentes:

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "NewTagKey",
         "Value": "NewTagValue"
      },
      { 
         "Key": "ExistingKeyOfTagToUpdate",
         "Value": "NewValueForExistingTag"
      }
   ]
}
```

# Listar tags para um aplicativo
<a name="how-tagging-list"></a>

Para listar as tags existentes, você usa a [ListTagsForResource](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_ListTagsForResource.html)ação.

O exemplo de solicitação a seguir para a ação `ListTagsForResource` lista as tags de um aplicativo:

```
{
   "ResourceARN": "arn:aws:kinesisanalyticsus-west-2:012345678901:application/MyApplication"
}
```

# Remover tags de um aplicativo
<a name="how-tagging-remove"></a>

Para remover tags de um aplicativo, você usa a [UntagResource](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UntagResource.html)ação.

O exemplo de solicitação a seguir para a ação `UntagResource` remove tags de um aplicativo:

```
{
   "ResourceARN": "arn:aws:kinesisanalyticsus-west-2:012345678901:application/MyApplication",
   "TagKeys": [ "KeyOfFirstTagToRemove", "KeyOfSecondTagToRemove" ]
}
```