Adición de etiquetas a recursos de Amazon Personalize

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

Adición de etiquetas (consola)

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. Abra la consola de Amazon Personalize en https://console.aws.amazon.com/personalize/home e inicie sesión en su cuenta.

2. Elija Crear grupo de conjuntos de datos.

3. En Nombre, ingrese un nombre.

4. En Dominio, elija un dominio.

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

6. Escriba un valor adecuado para Clave y Valor.

   Por ejemplo, Environment y Test, respectivamente.

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

   Puede agregar hasta 50 etiquetas a un recurso.

8. 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)

Puede utilizar AWS Command Line Interface (AWS CLI) para añadir etiquetas al crear un recurso o añadir etiquetas a un recurso existente.

Temas

• Adición de etiquetas al crear un recurso
• Adición de etiquetas a un recurso existente

Adición de etiquetas al crear un recurso

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.

Adición de etiquetas a un recurso existente

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

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

Añadir etiquetas (AWS SDK)

Puedes usar los AWS SDK para añadir etiquetas al crear un recurso o para añadir etiquetas a un recurso existente.

Temas

• Adición de etiquetas al crear un recurso
• Adición de etiquetas a un recurso existente

Adición de etiquetas al crear un recurso

Para crear un recurso nuevo y añadirle una etiqueta con los AWS SDK, usa el método adecuadocreate. 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

El código siguiente muestra cómo añadir 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 "";
}