Uso de tags - Guia do Desenvolvedor de Amazon Kinesis Data Analytics para aplicativos SQL
Adicionar tags quando um aplicativo é criadoAdicionar ou atualizar tags para um aplicativo existenteListar tags para um aplicativoRemover tags de um aplicativo

Para novos projetos, recomendamos que você use o novo Managed Service for Apache Flink Studio em vez do Kinesis Data Analytics para aplicativos SQL. O Managed Service for Apache Flink Studio combina facilidade de uso com recursos analíticos avançados, permitindo que você crie aplicativos sofisticados de processamento de stream em minutos.

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

Uso de tags

Esta seção descreve como adicionar tags de metadados de chave-valor para aplicativos do Kinesis Data Analytics. Essas tags podem ser usadas para as seguintes finalidades:

  • Determinar o faturamento de aplicativos individuais do Kinesis Data Analytics. Para obter mais informações, consulte Como usar tags de alocação de custos no AWSGuia 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 no Guia do usuário.

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

Adicionar tags quando um aplicativo é criado

Você pode adicionar tags ao criar um aplicativo usando o parâmetro tags da ação CreateApplication.

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

Você pode adicionar tags a um aplicativo usando a ação TagResource. Você não pode adicionar tags a um aplicativo usando a ação UpdateApplication.

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

Para listar tags existentes, use a ação ListTagsForResource.

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

{
   "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication"
}

Remover tags de um aplicativo

Para remover tags de um aplicativo, use a ação UntagResource.

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

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