Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
您可以使用 Amazon Personalize 控制台、Amazon Command Line Interface (Amazon CLI) 或 Amazon SDK 在 Amazon Personalize 资源中添加、显示、更新和删除标签键与值。以下示例演示如何向 Amazon Personalize 数据集组添加标签。您可以用同样的方式向其他 Amazon Personalize 资源添加标签。
添加标签（控制台）
在 Amazon Personalize 中创建资源时，您可以使用 Amazon Personalize 控制台添加可选标签。以下示例向数据集组添加标签。
向新数据集组添加标签
-
打开 Amazon Personalize 控制台（网址为 https://console.aws.amazon.com/personalize/home），并登录您的账户。
-
选择创建数据集组。
-
对于名称，输入名称。
-
对于域，选择一个域。
-
展开标签部分，选择添加新标签。
-
对于键和值，输入对应的值。
例如，分别为 Environment 和 Test。
-
要添加更多标签，请选择添加新标签。
您最多可以为每个资源添加 50 个标签。
-
选择下一步来继续创建您的资源。
向现有资源添加标签的方法类似：选择您的资源并使用标签字段添加标签。
添加标签 (Amazon CLI)
在创建资源或向现有资源添加标签时，可以使用 Amazon Command Line Interface (Amazon CLI) 来添加标签。
要通过 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 Personalize Amazon CLI 命令参考。
向现有资源添加标签
要向现有资源添加标签，请使用 tag-resource 命令。指定资源的 ARN，并在 tags 参数中提供标签键和值。
aws personalize tag-resource \
--resource-arn resource ARN \
--tags tagKey=key,tagValue=value
添加标签 (Amazon SDK)
在创建资源或向现有资源添加标签时，可以使用 Amazon SDK 来添加标签。
要使用 Amazon SDK 创建新资源并为其添加标签，请使用相应的 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 "";
}
向现有资源添加标签
以下代码展示了如何向现有 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 "";
}