Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Adición de etiquetas a recursos de Amazon Personalize
<a name="tags-add"></a>

Puede añadir, mostrar, actualizar y eliminar claves y valores de etiquetas de los recursos de Amazon Personalize con la consola Amazon Personalize, AWS Command Line Interface (AWS CLI) o AWS SDKs. Los siguientes ejemplos muestran cómo agregar una etiqueta al grupo de conjuntos de datos de Amazon Personalize. Puede agregar etiquetas a otros recursos de Amazon Personalize del mismo modo. 

**Topics**
+ [

## Adición de etiquetas (consola)
](#add-tag-console)
+ [

## Adición de etiquetas (AWS CLI)
](#add-tag-cli)
+ [

## Adición de etiquetas (AWS SDKs)
](#add-tag-sdk)

## Adición de etiquetas (consola)
<a name="add-tag-console"></a>



Al crear un recurso en Amazon Personalize, puede añadir etiquetas opcionales con la consola de Amazon Personalize. El siguiente ejemplo añade una etiqueta a un grupo de conjuntos de datos. 

**Para agregar etiquetas a un grupo de conjunto de datos nuevo**

1. Abre la consola Amazon Personalize en [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e inicia sesión en tu cuenta.

1. Elija **Crear grupo de conjuntos de datos**.

1. En **Nombre**, ingrese un nombre.

1. En **Dominio**, elija un dominio.

1. Amplíe la sección **Etiquetas**, elija **Añadir nueva etiqueta**.

1. Escriba un valor adecuado para **Clave** y **Valor**.

   Por ejemplo, **Environment** y **Test**, respectivamente.

1. Para añadir más etiquetas, elija **Añadir nueva etiqueta**.

   Puede agregar hasta 50 etiquetas a un recurso.

1. Seleccione **Siguiente** para seguir creando el recurso.

Añadir etiquetas a un recurso existente es similar: elija su recurso y utilice los campos **Etiquetas** para añadir las etiquetas. 

## Adición de etiquetas (AWS CLI)
<a name="add-tag-cli"></a>

Puede usar AWS Command Line Interface (AWS CLI) para agregar etiquetas al crear un recurso o agregar etiquetas a un recurso existente.

**Topics**
+ [

### Adición de etiquetas al crear un recurso
](#create-resource-with-tags-cli)
+ [

### Adición de etiquetas a un recurso existente
](#add-tag-existing-resource-cli)

### Adición de etiquetas al crear un recurso
<a name="create-resource-with-tags-cli"></a>

Para crear un nuevo recurso y añadirle una etiqueta con el AWS CLI, utilice el `create` comando correspondiente al recurso e incluya el `tags` parámetro y los valores. Por ejemplo, el siguiente comando crea un nuevo grupo de conjuntos de datos de dominio con el nombre `myDatasetGroup` del dominio ECOMMERCE y agrega las siguientes etiquetas: una clave de etiqueta `Environment` con un valor de etiqueta `Test` y una clave de etiqueta `Owner` y un valor `xyzCorp`. 

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

Para obtener información sobre los comandos que puede utilizar para crear un recurso de Amazon Personalize, consulte la [referencia de AWS CLI comandos de Amazon Personalize](https://docs.aws.amazon.com/cli/latest/reference/personalize/).

### Adición de etiquetas a un recurso existente
<a name="add-tag-existing-resource-cli"></a>

Para agregar una etiqueta a un recurso existente, utilice el comando `tag-resource`. Especifique el ARN del recurso y proporcione la clave y el valor de la etiqueta en el parámetro `tags`.

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

## Adición de etiquetas (AWS SDKs)
<a name="add-tag-sdk"></a>

Puede utilizarla AWS SDKs para añadir etiquetas al crear un recurso o para añadir etiquetas a un recurso existente.

**Topics**
+ [

### Adición de etiquetas al crear un recurso
](#create-resource-with-tags-sdk)
+ [

### Adición de etiquetas a un recurso existente
](#add-tag-existing-resource-sdk)

### Adición de etiquetas al crear un recurso
<a name="create-resource-with-tags-sdk"></a>

Para crear un recurso nuevo y añadirle una etiqueta con el AWS SDKs, utilice el `create` método adecuado. Use el parámetro `tags` para especificar los pares clave-valor para cada una de sus etiquetas. Por ejemplo, el siguiente código crea un nuevo grupo de conjuntos de datos de dominio con el nombre `myDatasetGroup` del dominio ECOMMERCE y agrega las siguientes etiquetas: una clave de etiqueta `Environment` con un valor de etiqueta `Test` y una clave de etiqueta `Owner` y un valor `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 "";
}
```

------

### Adición de etiquetas a un recurso existente
<a name="add-tag-existing-resource-sdk"></a>

El siguiente código muestra cómo agregar una etiqueta a un recurso de Amazon Personalize existente. Especifique el nombre de recurso de Amazon (ARN) del recurso al que desea agregar etiquetas y especifique pares de clave-valor para cada una de sus etiquetas.

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

------