# AWS WA Tool 리소스에 태그 지정
<a name="tagging"></a>

AWS WA Tool 리소스 관리를 돕기 위해 *태그* 형식으로 각 리소스에 고유한 메타데이터를 할당할 수 있습니다. 이 주제에서는 태그를 설명하고 태그를 생성하는 방법을 보여줍니다.

**Topics**
+ [태그 기본 사항](#tag-basics)
+ [리소스에 태깅](#tag-resources)
+ [태그 제한](#tag-restrictions)
+ [콘솔을 사용한 태그 작업](#tag-resources-console)
+ [API를 사용한 태그 작업](#tag-resources-api-sdk)

## 태그 기본 사항
<a name="tag-basics"></a>

태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 *키*와 선택적 *값*으로 구성됩니다.

태그를 사용하면 AWS 리소스를 용도, 소유자, 환경과 같은 다양한 기준으로 분류할 수 있습니다. 동일한 유형의 리소스가 많은 경우 할당한 태그에 따라 특정 리소스를 빠르게 식별할 수 있습니다. 예를 들어 AWS WA Tool 서비스에 태그 집합을 정의하면 각 서비스의 소유자 및 스택 수준을 추적하는 데 도움이 됩니다. 각 리소스 유형에 대해 일관된 태그 키 집합을 고안하는 것이 좋습니다.

태그가 리소스에 자동으로 할당되는 것은 아닙니다. 태그를 추가한 후에는 언제든지 태그 키와 값을 편집하거나 리소스에서 태그를 제거할 수 있습니다. 리소스를 삭제하면 리소스 태그도 삭제됩니다.

태그는 AWS WA Tool에는 의미가 없으며 엄격하게 문자열로 해석됩니다. 태그의 값을 빈 문자열로 설정할 수 있지만 태그의 값을 Null로 설정할 수는 없습니다. 해당 리소스에 대해 키가 기존 태그와 동일한 태그를 추가하는 경우 새 값이 이전 값을 덮어씁니다.

AWS Management Console, AWS CLI, AWS WA Tool API를 사용하여 태그 관련 작업을 수행할 수 있습니다.

AWS Identity and Access Management(IAM)를 사용하는 경우 AWS 계정에서 태그를 생성, 편집 또는 삭제할 수 있는 권한이 있는 사용자를 제어할 수 있습니다.

## 리소스에 태깅
<a name="tag-resources"></a>

새로운 또는 기존 AWS WA Tool 리소스에 태그를 지정할 수 있습니다.

AWS WA Tool 콘솔을 사용 중인 경우 새로 생성된 리소스 또는 기존 리소스에 태그를 언제든지 적용할 수 있습니다. 기존 워크로드의 경우 **속성** 탭을 통해 태그를 적용할 수 있습니다. 기존 사용자 지정 렌즈, 프로필 및 검토 템플릿의 경우 **개요** 탭을 통해 태그를 적용할 수 있습니다.

AWS WA Tool API, AWS CLI 또는 AWS SDK를 사용 중인 경우 관련 API 작업의 `tags` 파라미터를 사용하여 새 리소스에 태그를 적용하거나 `TagResource` API 작업을 사용하여 기존 리소스에 태그를 적용할 수 있습니다. 자세한 내용은 [TagResource](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html)를 참조하세요.

일부 리소스 생성 작업에서는 리소스 생성 시 리소스에 태그를 지정할 수 있습니다. 리소스 생성 중에 태그를 적용할 수 없는 경우 리소스 생성 프로세스는 실패합니다. 이로써 생성 중에 태그를 지정하려는 리소스는 지정된 태그와 함께 생성되거나 전혀 생성되지 않습니다. 생성 시 리소스에 태그를 지정하면 리소스 생성 후 사용자 지정 태그 지정 스크립트를 실행할 필요가 없습니다.

다음 표는 태그를 지정할 수 있는 AWS WA Tool 리소스와 생성 시 태그를 지정할 수 있는 리소스를 설명합니다.


**AWS WA Tool 리소스 태그 지정 지원**  

| 리소스 | 태그 지원 | 태그 전달 지원 | 생성 시 태그 지정 지원(AWS WA Tool API, AWS CLI, AWS SDK) | 
| --- | --- | --- | --- | 
|  AWS WA Tool 워크로드  |  예  | 아니요 |  예  | 
| AWS WA Tool 사용자 지정 렌즈 | 예 | 아니요 | 예 | 
| AWS WA Tool 프로필 | 예 | 아니요 | 예 | 
| AWS WA Tool 검토 템플릿 | 예 | 아니요 | 예 | 

## 태그 제한
<a name="tag-restrictions"></a>

태그에 적용되는 기본 제한은 다음과 같습니다.
+ 리소스당 최대 태그 수 – 50개
+ 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - UTF-8 형식의 유니코드 문자 128자
+ 최대 값 길이 - UTF-8 형식의 유니코드 문자 256자
+ 태그 지정 스키마를 여러 AWS 서비스와 리소스에서 사용하는 경우 다른 서비스에서 허용되는 문자에 제한이 있을 수 있음에 유의하세요. 일반적으로 허용되는 문자는 UTF-8로 표시할 수 있는 문자, 숫자 및 공백과 특수 문자 \+ - = . \_ : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ AWS 용도로 예약된 키 또는 값에는 `aws:`, `AWS:` 또는 이러한 접두사의 대문자 또는 소문자 조합을 사용하지 않습니다. 이 접두사가 지정된 태그 키나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 포함된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.

## 콘솔을 사용한 태그 작업
<a name="tag-resources-console"></a>

AWS WA Tool 콘솔을 사용하면 새 리소스 또는 기존 리소스에 연결된 태그를 관리할 수 있습니다.

### 생성 중 개별 리소스에서 태그 추가
<a name="adding-tags-creation"></a>

AWS WA Tool 리소스를 생성할 때 태그를 해당 리소스에 추가할 수 있습니다.

### 개별 리소스에 대한 태그 추가 및 삭제
<a name="adding-or-deleting-tags"></a>

AWS WA Tool을 사용하면 워크로드의 경우 **속성** 탭에서, 그리고 사용자 지정 렌즈, 프로필 및 검토 템플릿의 경우 **개요** 탭에서 리소스와 관련된 태그를 직접 추가하거나 삭제할 수 있습니다.

**워크로드에 태그를 추가하거나 삭제하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.

1. 탐색 모음에서 사용할 리전을 선택합니다.

1. 탐색 창에서 **워크로드**를 선택합니다.

1. 수정할 워크로드를 선택하고 **속성**을 선택합니다.

1. **태그** 섹션에서 **태그 관리**를 선택합니다.

1. 필요에 따라 태그를 추가하거나 삭제합니다.
   + 태그를 추가하려면 **새 태그 추가**를 선택한 다음 **키**와 **값** 필드를 입력합니다.
   + 태그를 삭제하려면 **제거**를 선택합니다.

1. 추가, 수정 또는 삭제하려는 각 태그에 대해 이 과정을 반복합니다. **저장**을 선택하여 변경 사항을 저장합니다.

**사용자 지정 렌즈에 태그를 추가하거나 삭제하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.

1. 탐색 모음에서 사용할 리전을 선택합니다.

1. 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.

1. 수정할 사용자 지정 렌즈 이름을 선택합니다.

1. **개요** 탭의 **태그** 섹션에서 **태그 관리**를 선택합니다.

1. 필요에 따라 태그를 추가하거나 삭제합니다.
   + 태그를 추가하려면 **새 태그 추가**를 선택한 다음 **키**와 **값** 필드를 입력합니다.
   + 태그를 삭제하려면 **제거**를 선택합니다.

1. 추가, 수정 또는 삭제하려는 각 태그에 대해 이 과정을 반복합니다. **저장**을 선택하여 변경 사항을 저장합니다.

**프로필에서 태그를 추가하거나 삭제하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.

1. 탐색 모음에서 사용할 리전을 선택합니다.

1. 탐색 창에서 **프로필**을 선택합니다.

1. 수정할 프로필의 이름을 선택합니다.

1. **개요** 탭의 **태그** 섹션에서 **태그 관리**를 선택합니다.

1. 필요에 따라 태그를 추가하거나 삭제합니다.
   + 태그를 추가하려면 **새 태그 추가**를 선택한 다음 **키**와 **값** 필드를 입력합니다.
   + 태그를 삭제하려면 **제거**를 선택합니다.

1. 추가, 수정 또는 삭제하려는 각 태그에 대해 이 과정을 반복합니다. **저장**을 선택하여 변경 사항을 저장합니다.

**검토 템플릿에 태그를 추가하거나 삭제하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.

1. 탐색 모음에서 사용할 리전을 선택합니다.

1. 탐색 창에서 **검토 템플릿**을 선택합니다.

1. 수정할 검토 템플릿의 이름을 선택합니다.

1. **개요** 탭의 **태그** 섹션에서 **태그 관리**를 선택합니다.

1. 필요에 따라 태그를 추가하거나 삭제합니다.
   + 태그를 추가하려면 **새 태그 추가**를 선택한 다음 **키**와 **값** 필드를 입력합니다.
   + 태그를 삭제하려면 **제거**를 선택합니다.

1. 추가, 수정 또는 삭제하려는 각 태그에 대해 이 과정을 반복합니다. **저장**을 선택하여 변경 사항을 저장합니다.

## API를 사용한 태그 작업
<a name="tag-resources-api-sdk"></a>

다음 AWS WA Tool API 작업을 사용하여 리소스에 대한 태그를 추가, 업데이트, 나열 및 삭제합니다.


**AWS WA Tool 리소스 태그 지정 지원**  

| 작업 | API 작업 | 
| --- | --- | 
|  하나 이상의 태그를 추가하거나 덮어씁니다.  |  [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html)  | 
|  하나 이상의 태그를 삭제합니다.  |  [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html)  | 
| 리소스에 대한 태그를 나열합니다. |  [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html)  | 

일부 리소스 생성 작업에서는 리소스를 생성할 때 태그를 지정할 수 있습니다. 다음 태스크는 생성 시 태그 지정을 지원합니다.


| 작업 | API 작업 | 
| --- | --- | 
| 워크로드 생성 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html) | 
| 새 렌즈 가져오기 | [ImportLens](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ImportLens.html) | 
| 프로필 생성 | [CreateProfile](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateProfile.html) | 
| 검토 템플릿 생성 | [CreateReviewTemplate](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateReviewTemplate.html) |