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 AWS 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 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ê adiciona tags ao criar um aplicativo usando o tags parâmetro da CreateApplicationaçã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

Você adiciona tags a um aplicativo usando a TagResourceação. Você não pode adicionar tags a um aplicativo usando a UpdateApplicationaçã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

Para listar as tags existentes, você usa a ListTagsForResourceação.

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, você usa a UntagResourceação.

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