本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將標籤新增至 Amazon Personalize 資源
<a name="tags-add"></a>

您可以使用 Amazon Personalize 主控台 AWS Command Line Interface (AWS CLI) 或 AWS SDKs，從 Amazon Personalize 資源新增、顯示、更新和移除標籤金鑰和值。下列範例示範如何將標籤新增至 Amazon Personalize 資料集群組。您可以透過相同方式將標籤新增至其他 Amazon Personalize 資源。

**Topics**
+ [新增標籤 （主控台）](#add-tag-console)
+ [新增標籤 (AWS CLI)](#add-tag-cli)
+ [新增標籤AWS SDKs)](#add-tag-sdk)

## 新增標籤 （主控台）
<a name="add-tag-console"></a>



當您在 Amazon Personalize 中建立資源時，您可以使用 Amazon Personalize 主控台新增選用標籤。下列範例會將標籤新增至資料集群組。

**將標籤新增至新的資料集群組**

1. 在 [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home)：// 開啟 Amazon Personalize 主控台並登入您的帳戶。

1. 選擇 **Create dataset group (建立資料集群組)**。

1. 針對**名稱**，輸入名稱。

1. 針對**網域**，選擇網域。

1. 展開**標籤**區段，然後選擇**新增標籤**。

1. 針對**索引鍵**和**值**，輸入適當的值。

   例如，分別為 **Environment**和 **Test**。

1. 若要新增更多標籤，請選擇**新增標籤**。

   您最多可以將 50 個標籤新增至資源。

1. 選擇**下一步**以繼續建立您的資源。

將標籤新增至現有資源類似：選擇您的資源，並使用**標籤**欄位來新增標籤。

## 新增標籤 (AWS CLI)
<a name="add-tag-cli"></a>

您可以在建立資源或將標籤新增至現有資源時，使用 AWS Command Line Interface (AWS CLI) 來新增標籤。

**Topics**
+ [建立資源時新增標籤](#create-resource-with-tags-cli)
+ [將標籤新增到現有資源](#add-tag-existing-resource-cli)

### 建立資源時新增標籤
<a name="create-resource-with-tags-cli"></a>

若要建立新的資源，並使用 將標籤新增至其中 AWS CLI，請使用適當的資源`create`命令，並包含 `tags` 參數和值。例如，下列命令會為 ECOMMERCE 網域建立名為 `myDatasetGroup` 的新網域資料集群組，並新增下列標籤：具有`Environment`標籤值的`Test`標籤索引鍵，以及`Owner`標籤索引鍵和`xyzCorp`值。

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

如需可用來建立 Amazon Personalize 資源之命令的相關資訊，請參閱 [Amazon Personalize AWS CLI 命令參考](https://docs.aws.amazon.com/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}}
```

## 新增標籤AWS SDKs)
<a name="add-tag-sdk"></a>

您可以使用 AWS SDKs 在建立資源時新增標籤，或將標籤新增至現有資源。

**Topics**
+ [建立資源時新增標籤](#create-resource-with-tags-sdk)
+ [將標籤新增到現有資源](#add-tag-existing-resource-sdk)

### 建立資源時新增標籤
<a name="create-resource-with-tags-sdk"></a>

若要建立新的資源，並使用 AWS SDKs 將標籤新增至其中，請使用適當的`create`方法。使用 `tags` 參數來指定每個標籤的鍵/值對。例如，下列程式碼會為 ECOMMERCE 網域建立名為 的新網域資料集群組`myDatasetGroup`，並新增下列標籤：具有`Environment`標籤值的`Test`標籤索引鍵，以及`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 Resource Name (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 "";
}
```

------