Marcação de APIs no AWS Glue - AWS Glue
 —  tipos de dados  —Tag — operações —TagResource (tag_resource)UntagResource (untag_resource)GetTags (get_tags)

Marcação de APIs no AWS Glue

Tipos de dados

Estrutura Tag

O objeto Tag representa um rótulo que pode ser atribuído a um recurso da AWS. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você.

Para obter mais informações sobre tags e como controlar o acesso aos recursos no AWS Glue, consulte Marcações da AWS no AWS Glue) e Especificação de ARNs de recurso no AWS Glue 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ção TagResource (Python: tag_resource)

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.

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 #22.

    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.

  • 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

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

Ação UntagResource (Python: untag_resource)

Remove etiquetas de 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 #22.

    O nome de recurso da Amazon (ARN) do recurso do qual remover as tags.

  • TagsToRemove: obrigatório: uma matriz de strings UTF-8, no máximo 50 strings.

    As tags a serem removidas desse recurso.

Resposta

  • Nenhum parâmetro de resposta.

Erros

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

Ação GetTags (Python: get_tags)

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 #22.

    O nome de 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