Como adicionar tags a recursos do Amazon Personalize - Amazon Personalize
Como adicionar tags (console)Adicionar tags (AWS CLI)Como adicionar tags (AWS SDKs)

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

Como adicionar tags a recursos do Amazon Personalize

Você pode adicionar, exibir, atualizar e remover chaves e valores de tags dos recursos do Amazon Personalize com o console Amazon Personalize, a AWS Command Line Interface (AWS CLI) ou os AWS SDKs. Os exemplos a seguir mostram como adicionar uma tag ao grupo de conjuntos de dados do Amazon Personalize. Você pode adicionar tags a outros recursos do Amazon Personalize da mesma forma.

Como adicionar tags (console)

Quando cria um recurso no Amazon Personalize, você pode adicionar tags opcionais com o console do Amazon Personalize. O exemplo a seguir adiciona uma tag a um grupo de conjuntos de dados.

Adicionar tags a um novo grupo de conjuntos de dados

  1. Acesse https://console.aws.amazon.com/personalize/home, abra o console do Amazon Personalize e faça login na sua conta.

  2. Escolha Criar grupo de conjuntos de dados.

  3. Nome, insira um nome.

  4. Em Domínio, escolha um domínio.

  5. Expanda a seção Tags e escolha Adicionar nova tag.

  6. Digite um valor para Chave e Valor.

    Por exemplo, Environment e Test, respectivamente.

  7. Para adicionar mais tags, escolha Adicionar nova tag.

    É possível adicionar até 50 tags a um recurso.

  8. Selecione Próximo para continuar criando o recurso.

Para adicionar tags a um recurso existente, o procedimento é semelhante: escolha o recurso e use os campos Tags para incluir as tags.

Adicionar tags (AWS CLI)

Na AWS Command Line Interface (AWS CLI) é possível adicionar tags na hora de criar um recurso ou adicionar tags a um recurso existente.

Como adicionar tags na hora de criar um recurso

Para criar um novo recurso e adicionar uma tag a ele empregando a AWS CLI, use o comando create para o recurso e inclua os valores e o parâmetro tags. Por exemplo, o comando a seguir cria um novo grupo de conjuntos de dados de domínio com o nome myDatasetGroup para o domínio ECOMMERCE e adiciona as seguintes tags: uma chave de tag de Environment com um valor de tag de Test e uma chave de tag de Owner e um valor de xyzCorp. 

aws personalize create-dataset-group \
--name myDatasetGroup \
--domain ECOMMERCE \
--tags tagKey=Environment,tagValue=Test tagKey=Owner,tagValue=xyzCorp

Para informações sobre os comandos que podem ser usados para criar um recurso do Amazon Personalize, consulte a Referência de comandos na AWS CLI do Amazon personalize.

Adicionar tags a um recurso existente

Para adicionar uma tag a um recurso existente, use o comando tag-resource. Especifique o ARN do recurso e forneça a chave e o valor da tag no parâmetro tags.

aws personalize tag-resource \
--resource-arn resource ARN \
--tags tagKey=key,tagValue=value

Como adicionar tags (AWS SDKs)

Nos SDKs da AWS é possível adicionar tags na hora de criar um recurso ou adicionar tags a um recurso existente.

Como adicionar tags na hora de criar um recurso

Para criar um recurso e adicionar uma tag a ele com os SDKs da AWS, use o método create. Use o parâmetro tags para especificar os pares de valores e chaves para cada uma das suas tags. Por exemplo, o código a seguir cria um novo grupo de conjuntos de dados de domínio com o nome myDatasetGroup para o domínio ECOMMERCE e adiciona as seguintes tags: uma chave de tag de Environment com um valor de tag de Test e uma chave de tag de Owner e um valor de xyzCorp.

SDK for Python (Boto3)
import boto3

personalize = boto3.client('personalize')

response = personalize.create_dataset_group(
  name = 'myDatasetGroup',
  domain = 'ECOMMERCE',
  tags = [
    {
      'tagKey': 'Environment',
      'tagValue': 'Test'
    },
    {
      'tagKey': 'Owner',
      'tagValue': 'xyzCorp'    
    }
  ]    
)
dsg_arn = response['datasetGroupArn']

description = personalize.describe_dataset_group(datasetGroupArn = dsg_arn)['datasetGroup']

print('Name: ' + description['name'])
print('ARN: ' + description['datasetGroupArn'])
print('Status: ' + description['status'])
SDK for Java 2.x
public static String createDomainDatasetGroup(PersonalizeClient personalizeClient, 
                                              String datasetGroupName,
                                              String domain) {
    
    try {
         
        ArrayList <Tag> tags = new ArrayList<>();

        Tag tag1 = Tag.builder()
                .tagKey("Environment")
                .tagValue("Test")
                .build();
        tags.add(tag1);
        Tag tag2 = Tag.builder()
                .tagKey("Owner")
                .tagValue("xyzCorp")
                .build();
        tags.add(tag2);
    
        CreateDatasetGroupRequest createDatasetGroupRequest = CreateDatasetGroupRequest.builder()
                .name(datasetGroupName)
                .domain(domain)
                .tags(tags)
                .build();
        return personalizeClient.createDatasetGroup(createDatasetGroupRequest).datasetGroupArn();
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}

Adicionar tags a um recurso existente

O código a seguir mostra como adicionar uma tag a um recurso existente do Amazon Personalize. Especifique o nome do recurso da Amazon (ARN) do recurso ao qual deseja adicionar tags e especifique os pares de valores e chaves para cada uma de suas tags.

SDK for Python (Boto3)
import boto3
personalize = boto3.client('personalize')

add_tags_response = personalize.tag_resource(
  resourceArn = "resourceArn",
  tags = [
    {
      'tagKey': 'Environment',
      'tagValue': 'Test'
    },
    {
      'tagKey': 'Owner',
      'tagValue': 'xyzCorp'    
    }
  ]    
)
SDK for Java 2.x
public static void tagResource(PersonalizeClient personalizeClient, 
                                              String resourceArn,
                                              String domain) {
    
    try {
         
         ArrayList <Tag> tagList = new ArrayList<>();

          Tag tag1 = Tag.builder()
                  .tagKey("Environment")
                  .tagValue("Test")
                  .build();
          tags.add(tag1);
          Tag tag2 = Tag.builder()
                  .tagKey("Owner")
                  .tagValue("xyzCorp")
                  .build();
          tags.add(tag2);
    
        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn(resourceArn)
                .tags(tagList)
                .build();
                
        personalizeClient.tagResource(tagResourceRequest);
        System.out.println("Tags have been added to "+ resourceArn);
        
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}