기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Personalize 리소스에 태그 추가
<a name="tags-add"></a>

Personalize 콘솔, AWS Command Line Interface (AWS CLI) 또는 AWS SDKs. 다음 예제는 Personalize 데이터세트 그룹에 태그를 추가하는 방법을 보여줍니다. 동일한 방식으로 다른 Amazon Personalize 리소스에 태그를 추가할 수 있습니다.

**Topics**
+ [태그 추가(콘솔)](#add-tag-console)
+ [태그 추가(AWS CLI)](#add-tag-cli)
+ [태그(AWS SDKs) 추가](#add-tag-sdk)

## 태그 추가(콘솔)
<a name="add-tag-console"></a>



Personalize에서 리소스를 생성할 때 Personalize 콘솔을 사용하여 선택적 태그를 추가할 수 있습니다. 다음 예제에서는 데이터세트 그룹에 태그를 추가합니다.

**새 데이터세트 그룹에 태그를 추가하려면**

1. [https://console.aws.amazon.com/acm-pca/home](https://console.aws.amazon.com/personalize/home)에서 Personalize 콘솔을 열고 계정에 로그인합니다.

1. **데이터세트 그룹 생성**을 선택합니다.

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>

새 리소스를 생성하고를 사용하여 태그를 추가하려면 리소스에 적절한 `create` 명령을 AWS CLI사용하고 `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
```

Personalize 리소스를 생성하는 데 사용할 수 있는 명령에 대한 자세한 내용은 [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`이라는 이름이 지정된 새 도메인 데이터세트 그룹을 생성하고 다음 태그(`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 "";
}
```

------