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

# 리소스에 사용자 지정 태그 추가
<a name="custom-tags-add"></a>

 다음 페이지에서는 사용자 지정 태그 전파를 사용하는 데 필요한 단계를 보여줍니다. 사용자 지정 태그 전파에는 다음 단계가 필요합니다.
+  사용자 지정 태그 전파에 옵트인 
+  리소스에 사용자 지정 태그 추가 

 기존 도메인에서 사용자 지정 태그 전파를 활성화하면 애플리케이션이 다시 시작될 때까지 기존 애플리케이션에서 태그 전파가 작동하지 않습니다. 마찬가지로 새 사용자 지정 태그가 추가되면 기존 리소스에서 태그가 업데이트되지 않습니다. 예를 들어 도메인에 두 개의 태그가 있고 사용자가 해당 도메인에 리소스를 만든다고 가정합니다. 그러면 리소스에 태그가 두 개입니다. 도메인에 새 태그가 추가되면 그 새 태그는 기존 리소스에 추가되지 않습니다. 하지만 만든 새 리소스에는 새 태그가 연결됩니다.

## 사전 조건
<a name="custom-tags-add-prereq"></a>
+  사용자는 리소스를 만들기 위해 `sagemaker:AddTags` 권한이 있어야 합니다.
  +  `SageMakerFullAccess` 관리형 정책을 사용하거나 SageMaker Role Manager를 사용하여 만든 새 도메인의 경우 `sagemaker:AddTags` 권한이 미리 채워집니다.
  +  사용자 지정 AWS Identity and Access Management 정책을 사용하는 기존 도메인의 경우 사용자가 리소스를 생성할 수 있는 권한을 포함하도록 `sagemaker:AddTags` 정책을 업데이트해야 합니다.

## 사용자 지정 태그 전파에 옵트인
<a name="custom-tags-add-opt-in"></a>

사용자 지정 태그 전파에 옵트인하는 프로세스는 콘솔에서 옵트인하는지, AWS CLI에서 옵트인하는지에 따라 다릅니다. 콘솔에서는 기존 도메인을 업데이트하는 방법으로만 사용자 지정 태그 전파에 옵트인할 수 있습니다. 에서 도메인을 생성하거나 기존 도메인을 업데이트할 때 사용자 지정 태그 전파를 AWS CLI옵트인할 수 있습니다.



### 콘솔에서 옵트인
<a name="custom-tags-add-opt-in-console"></a>

다음 단계에서는 콘솔에서 사용자 지정 태그 전파에 옵트인하는 방법을 간략하게 설명합니다. 콘솔에서는 기존 도메인을 업데이트하는 방법으로만 사용자 지정 태그 전파에 옵트인할 수 있습니다.

1. [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)에서 Amazon SageMaker AI 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **관리자 구성**을 선택합니다. **관리자 구성**에서 **도메인**을 선택합니다.

1. **도메인** 페이지에서 사용자 지정 태그 전파를 활성화할 도메인을 선택합니다.

1. **도메인 세부정보** 페이지에서 **도메인 설정** 탭을 선택합니다.

1. **도메인 설정** 탭에서 **사용자 지정 태그 전파**로 이동합니다.

1. **편집**을 선택합니다.

1. **사용자 지정 태그 전파 편집** 페이지에서 **사용자 지정 태그 자동 전파**를 선택합니다.

1. **제출**을 선택합니다.

### 를 사용하여 옵트인 AWS CLI
<a name="custom-tags-add-opt-in-cli"></a>

 를 사용하여 사용자 지정 태그 전파를 옵트인하려면 [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) 및 [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) APIs의 `TagPropagation` 속성을 AWS CLI사용합니다. 이 필드의 값은 기본적으로 `DISABLED`입니다. 비어 있는 값도 기본적으로 `DISABLED`로 설정됩니다. 다음 예에서는 사용자 지정 태그 전파를 활성화하는 방법을 보여줍니다.

```
aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED
```

## 사용자 지정 태그 추가
<a name="custom-tags-add-tags"></a>

사용자 지정 태그 전파를 추가하는 프로세스는 콘솔에서 추가하는지, AWS CLI에서 추가하는지에 따라 다릅니다.

### 콘솔에서 추가
<a name="custom-tags-add-tags-console"></a>

다음 단계에서는 콘솔에서 도메인에 사용자 지정 태그를 추가하는 방법을 간략하게 설명합니다.

1. [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)에서 Amazon SageMaker AI 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **관리자 구성**을 선택합니다. **관리자 구성**에서 **도메인**을 선택합니다.

1. **도메인** 페이지에서 사용자 지정 태그를 추가할 도메인을 선택합니다.

1. **도메인 세부정보** 페이지에서 **도메인 설정** 탭을 선택합니다.

1. **도메인 설정** 탭에서 **태그**로 이동합니다.

1. **편집**을 선택합니다.

1. **태그** 페이지에서 **태그 추가**를 선택합니다. 사용자 지정 태그의 키 및 값 페어를 추가합니다.

1. **저장**을 선택합니다. 이제 이 사용자 지정 태그가 도메인에서 만든 SageMaker AI 리소스로 전파됩니다.

다음 단계에서는 콘솔에서 사용자 프로필에 사용자 지정 태그를 추가하는 방법을 간략하게 설명합니다.

1. [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)에서 Amazon SageMaker AI 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **관리자 구성**을 선택합니다. **관리자 구성**에서 **도메인**을 선택합니다.

1. **도메인** 페이지에서 사용자 지정 태그를 추가할 사용자 프로필이 포함된 도메인을 선택합니다.

1. **도메인 세부 정보** 페이지에서 **사용자 프로필** 탭을 선택합니다.

1. **사용자 프로필** 탭에서 사용자 지정 태그를 추가할 사용자 프로필을 선택합니다.

1. **사용자 세부 정보** 탭에서 **세부 정보** 섹션으로 이동합니다.

1. **편집**을 선택합니다.

1. **태그** 섹션에서 **태그 추가**를 선택합니다. 사용자 지정 태그의 키 및 값 페어를 추가합니다.

1. **제출**을 선택합니다. 이제 이 사용자 지정 태그가 도메인에서 만든 SageMaker AI 리소스로 전파됩니다.

### 를 사용하여 추가 AWS CLI
<a name="custom-tags-add-tags-cli"></a>

 사용자 지정 태그 전파를 활성화한 후 생성 또는 업데이트 중에 도메인, 사용자 프로필 또는 AWS CLI 스페이스 수준에서를 사용하여 사용자 지정 태그를 추가할 수 있습니다. 사용자 지정 태그를 추가하는 방법은 새 리소스를 만드는지, 기존 리소스에 태그를 추가하는지에 따라 다릅니다.

 다음 예에서는 만드는 중에 도메인 수준에서 사용자 지정 태그를 추가하는 방법을 보여줍니다.

```
aws sagemaker create-domain \
    --domain-name domain-id \
    --auth-mode IAM \
    --default-user-settings '{"ExecutionRole": "execution-role"}' \
    --subnet-ids subnet-id \
    --vpc-id vpc-id \
    --tags Key=key,Value=value \
    --tag-propagation ENABLED
```

 다음과 같이 [AddTags](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html) API를 사용하여 기존 도메인, 사용자 프로필 및 공간에 대한 사용자 지정 태그를 추가해야 합니다.

```
aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value
```