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
<a name="tags-add"></a>

Você pode adicionar, exibir, atualizar e remover chaves e valores de tag dos recursos do Amazon Personalize com o console Amazon Personalize AWS Command Line Interface ,AWS CLI() ou. 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. 

**Topics**
+ [

## Como adicionar tags (console)
](#add-tag-console)
+ [

## Adicionar tags (AWS CLI)
](#add-tag-cli)
+ [

## Adicionar tags (AWS SDKs)
](#add-tag-sdk)

## Como adicionar tags (console)
<a name="add-tag-console"></a>



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. Abra o console Amazon Personalize em [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e faça login na sua conta.

1. Escolha **Criar grupo de conjuntos de dados**.

1. **Nome**, insira um nome.

1. Em **Domínio**, escolha um domínio.

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

1. Digite um valor para **Chave ** e **Valor**.

   Por exemplo, **Environment** e **Test**, respectivamente.

1. Para adicionar mais tags, escolha **Adicionar nova tag**.

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

1. 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)
<a name="add-tag-cli"></a>

Você pode usar o AWS Command Line Interface (AWS CLI) para adicionar tags ao criar um recurso ou adicionar tags a um recurso existente.

**Topics**
+ [

### Como adicionar tags na hora de criar um recurso
](#create-resource-with-tags-cli)
+ [

### Adicionar tags a um recurso existente
](#add-tag-existing-resource-cli)

### Como adicionar tags na hora de criar um recurso
<a name="create-resource-with-tags-cli"></a>

Para criar um novo recurso e adicionar uma tag a ele com o AWS CLI, use o `create` comando apropriado para o recurso e inclua o `tags` parâmetro e os valores. 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 obter informações sobre os comandos que você pode usar para criar um recurso do Amazon Personalize, consulte a Referência de comandos do [Amazon AWS CLI Personalize](https://docs.aws.amazon.com/cli/latest/reference/personalize/).

### Adicionar tags a um recurso existente
<a name="add-tag-existing-resource-cli"></a>

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
```

## Adicionar tags (AWS SDKs)
<a name="add-tag-sdk"></a>

Você pode usar o AWS SDKs para adicionar tags ao criar um recurso ou adicionar tags a um recurso existente.

**Topics**
+ [

### Como adicionar tags na hora de criar um recurso
](#create-resource-with-tags-sdk)
+ [

### Adicionar tags a um recurso existente
](#add-tag-existing-resource-sdk)

### Como adicionar tags na hora de criar um recurso
<a name="create-resource-with-tags-sdk"></a>

Para criar um novo recurso e adicionar uma tag a ele com o AWS SDKs, use o `create` método apropriado. 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
<a name="add-tag-existing-resource-sdk"></a>

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 "";
}
```

------