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 de Amazon Personalize, AWS Command Line Interface (AWS CLI) o los SDK de AWS. 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.

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.

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 usar AWS Command Line Interface (AWS CLI) para agregar etiquetas al crear un recurso o agregar etiquetas a un recurso existente.

Adición de etiquetas al crear un recurso

Para crear un nuevo recurso y añadirle una etiqueta mediante AWS CLI, use el comando create adecuado para el recurso e incluya el parámetro tags 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 acerca de los comandos que puede usar para crear un recurso de Amazon Personalize, consulte la Referencia de comandos de AWS CLI de Amazon Personalize.

Adición de etiquetas a un recurso existente

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

Agregado de etiquetas (SDK de AWS)

Puede usar los SDK de AWS para agregar etiquetas al crear un recurso o agregar 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 SDK de AWS, use el método create 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

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