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

Após uma análise cuidadosa, decidimos descontinuar o Amazon Kinesis Data Analytics SQL para aplicativos em duas etapas:

1. A partir de 15 de outubro de 2025, você não poderá criar um novo Kinesis Data Analytics SQL para aplicativos.

2. Excluiremos as aplicações a partir de 27 de janeiro de 2026. Você não poderá iniciar ou operar seu Amazon Kinesis Data Analytics SQL para aplicativos. O suporte não estará mais disponível para o Amazon Kinesis Data Analytics SQL a partir desse momento. Para obter mais informações, consulte Descontinuação do Amazon Kinesis Data Analytics SQL para aplicativos.

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

  • 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" ]
}