# Marcação de APIs no AWS Glue
<a name="aws-glue-api-tags"></a>

## Tipos de dados
<a name="aws-glue-api-tags-objects"></a>
+ [Estrutura Tag](#aws-glue-api-tags-Tag)

## Estrutura Tag
<a name="aws-glue-api-tags-Tag"></a>

O objeto `Tag` representa um rótulo que pode ser atribuído a um recurso da AWS. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos.

Para obter mais informações sobre tags e como controlar o acesso aos recursos no AWS Glue, consulte [Marcações AWS no AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) e [Especificação de ARNs de recurso AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html) no guia do desenvolvedor.

**Campos**
+ `key` – String UTF-8, superior a 1 e inferior a 128 bytes de comprimento.

  A chave de tags. A chave é necessária ao criar uma tag em um objeto. A chave diferencia maiúsculas de minúsculas e não deve conter o prefixo aws.
+ `value` – String UTF-8 com comprimento não superior a 256 bytes.

  O valor da tag. O valor é opcional ao criar uma tag em um objeto. O valor diferencia maiúsculas de minúsculas e não deve conter o prefixo aws.

## Operações
<a name="aws-glue-api-tags-actions"></a>
+ [Ação TagResource (Python: tag\$1resource)](#aws-glue-api-tags-TagResource)
+ [Ação UntagResource (Python: untag\$1resource)](#aws-glue-api-tags-UntagResource)
+ [Ação GetTags (Python: get\$1tags)](#aws-glue-api-tags-GetTags)

## Ação TagResource (Python: tag\$1resource)
<a name="aws-glue-api-tags-TagResource"></a>

Adiciona etiquetas a um recurso. Uma tag é um rótulo que pode ser atribuído a um recurso da AWS. No AWS Glue, apenas determinados recursos podem ser marcados. Para obter informações sobre quais recursos podem ser marcados, consulte [Tags da AWS no AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html).

Além das permissões de marcação para chamar APIs relacionadas a tags, você também precisa da permissão `glue:GetConnection` para chamar APIs de marcação em conexões e da permissão `glue:GetDatabase` para chamar APIs de marcação em bancos de dados.

**Solicitação**
+ `ResourceArn`: *obrigatório:* string UTF-8, não menos do que 1 ou superior a 10.240 bytes de comprimento, correspondente a [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  O ARN do recurso do AWS Glue ao qual se deseja adicionar as tags. Para obter mais informações sobre ARNs de recurso do AWS Glue, consulte o [padrão de string de ARN do AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-common.html#aws-glue-api-regex-aws-glue-arn-id).
+ `TagsToAdd`: *obrigatório:* uma matriz de mapa dos pares de chave-valor, no máximo 50 pares.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.

  Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.

  As tags a serem adicionadas a esse recurso.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `ResourceNotFoundException`

## Ação UntagResource (Python: untag\$1resource)
<a name="aws-glue-api-tags-UntagResource"></a>

Remove as tags especificadas de um recurso de integração.

**Solicitação**
+ `ResourceArn`: *obrigatório:* string UTF-8, não menos do que 1 ou superior a 10.240 bytes de comprimento, correspondente a [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  O nome do recurso da Amazon (ARN) do recurso de integração.
+ `TagsToRemove`: *obrigatório:* uma matriz de strings UTF-8, no máximo 50 strings.

  Uma lista das tags de metadados a serem removidas do recurso.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `ResourceNotFoundException`

## Ação GetTags (Python: get\$1tags)
<a name="aws-glue-api-tags-GetTags"></a>

Recupera uma lista de tags associadas a um recurso.

**Solicitação**
+ `ResourceArn`: *obrigatório:* string UTF-8, não menos do que 1 ou superior a 10.240 bytes de comprimento, correspondente a [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  O nome do recurso da Amazon (ARN) do recurso para o qual deseja recuperar as tags.

**Resposta**
+ `Tags`: uma matriz de mapa dos pares de chave-valor, não mais que 50 pares.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.

  Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.

  As tags solicitadas.

**Erros**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `EntityNotFoundException`