本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 向 Amazon Personalize 资源添加标签
<a name="tags-add"></a>

您可以使用 Amazon Personalize 控制台 Amazon Command Line Interface （Amazon CLI）或，在 Amazon Personalize 资源中添加、显示、更新和删除标签密钥和值 Amazon SDKs。以下示例演示如何向 Amazon Personalize 数据集组添加标签。您可以用同样的方式向其他 Amazon Personalize 资源添加标签。

**Topics**
+ [添加标签（控制台）](#add-tag-console)
+ [添加标签 (Amazon CLI)](#add-tag-cli)
+ [添加标签 (Amazon SDKs)](#add-tag-sdk)

## 添加标签（控制台）
<a name="add-tag-console"></a>



在 Amazon Personalize 中创建资源时，您可以使用 Amazon Personalize 控制台添加可选标签。以下示例向数据集组添加标签。

**向新数据集组添加标签**

1. 在[https://console.aws.amazon.com/personalize/家](https://console.amazonaws.cn/personalize/home)中打开 Amazon Personalize 控制台并登录您的账户。

1. 选择**创建数据集组**。

1. 对于**名称**，输入名称。

1. 对于**域**，选择一个域。

1. 展开**标签**部分，选择**添加新标签**。

1. 对于**键**和**值**，输入对应的值。

   例如，分别为 **Environment** 和 **Test**。

1. 要添加更多标签，请选择**添加新标签**。

   您最多可以为每个资源添加 50 个标签。

1. 选择**下一步**来继续创建您的资源。

向现有资源添加标签的方法类似：选择您的资源并使用**标签**字段添加标签。

## 添加标签 (Amazon CLI)
<a name="add-tag-cli"></a>

在创建资源或向现有资源添加标签时，可以使用 Amazon Command Line Interface (Amazon CLI) 来添加标签。

**Topics**
+ [在创建资源时添加标签](#create-resource-with-tags-cli)
+ [向现有资源添加标签](#add-tag-existing-resource-cli)

### 在创建资源时添加标签
<a name="create-resource-with-tags-cli"></a>

要创建新资源并使用为其添加标签 Amazon CLI，请对该资源使用相应的`create`命令并包括`tags`参数和值。例如，以下命令针对 ECOMMERCE 域创建一个名为 `myDatasetGroup` 的新域数据集组，并添加以下标签：带有 `Test` 标签值的 `Environment` 标签键以及 `Owner` 标签键和 `xyzCorp` 值。

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

有关可用于创建 Amazon Personalize 资源的命令的信息，请参阅《[亚马逊个性化 Amazon CLI 命令参考](https://docs.amazonaws.cn/cli/latest/reference/personalize/)》。

### 向现有资源添加标签
<a name="add-tag-existing-resource-cli"></a>

要向现有资源添加标签，请使用 `tag-resource` 命令。指定资源的 ARN，并在 `tags` 参数中提供标签键和值。

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

## 添加标签 (Amazon SDKs)
<a name="add-tag-sdk"></a>

您可以在创建资源时使用添加标签，或者为现有资源添加标签。 Amazon SDKs 

**Topics**
+ [在创建资源时添加标签](#create-resource-with-tags-sdk)
+ [向现有资源添加标签](#add-tag-existing-resource-sdk)

### 在创建资源时添加标签
<a name="create-resource-with-tags-sdk"></a>

要创建新资源并使用为其添加标签 Amazon SDKs，请使用适当的`create`方法。使用 `tags` 参数为每个标签指定键值对。例如，以下代码针对 ECOMMERCE 域创建一个名为 `myDatasetGroup` 的新域数据集组，并添加以下标签：带有 `Test` 标签值的 `Environment` 标签键以及 `Owner` 标签键和 `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 "";
}
```

------

### 向现有资源添加标签
<a name="add-tag-existing-resource-sdk"></a>

以下代码展示了如何向现有 Amazon Personalize 资源添加标签。指定要为其添加标签的资源的 Amazon 资源名称 (ARN)，并为每个标签指定键值对。

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

------