기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon WorkSpaces 애플리케이션 리소스에 태그 지정
AWS 를 사용하면 AWS 리소스에 태그 형태로 메타데이터를 할당할 수 있습니다. 이러한 태그를 사용하여 WorkSpaces 애플리케이션 이미지 빌더, 이미지, 플릿 및 스택을 관리하고 결제 데이터를 포함한 데이터를 구성할 수 있습니다.
다음을 수행할 수 있습니다.
+ 리소스를 다양한 방식으로 논리적으로 그룹화할 수 있습니다(예: 용도별, 소유자별 또는 환경별).
이는 동일한 유형의 리소스가 많을 때 유용합니다.
+ 지정한 태그를 기반으로 특정 리소스를 신속하게 식별할 수 있습니다.
+ AWS 비용 식별 및 제어
예를 들어 다른 환경(예: 개발 또는 프로덕션)에 있거나 다른 사업부(예: HR 또는 마케팅)에 할당된 WorkSpaces 애플리케이션 플릿을 식별하고 그룹화할 수 있습니다. 그런 다음 이러한 플릿에 대한 관련 AWS 비용을 세부 수준에서 추적할 수 있습니다. 이렇게 하려면 가입하여 태그 키 값이 포함된 Amazon Web Services 계정 청구서를 가져옵니다. 태그를 사용한 비용 할당 보고서 설정에 대한 자세한 내용은 **AWS Billing 사용 설명서에서 [월간 비용 할당 보고서](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)를 참조하세요.
**Topics**
+ [태그 지정 관련 기본 사항](tagging-introduction.md)
+ [태그 제한](tag-restrictions.md)
+ [리소스 생성 중 태그 추가](basic-tagging-resource-creation-console.md)
+ [태그 추가, 편집 및 삭제](basic-tagging-console.md)
+ [API, SDK 또는 CLI 사용](basic-tagging-API-SDK-CLI.md)
# Amazon WorkSpaces 애플리케이션의 태그 지정 기본 사항
태그는 다른 AWS 서비스 태그와 유사한 키-값 페어로 구성됩니다. 리소스에 태그를 지정하려면 각 태그에 대한 *키* 및 *값*을 지정합니다. 키는 "project", "owner" 또는 "environment" 등의 특정 연결 값을 가진 일반 범주일 수 있으며 동일한 키와 값을 여러 리소스에서 공유할 수 있습니다. WorkSpaces 애플리케이션 리소스를 생성한 직후 또는 나중에 태그를 지정할 수 있습니다. 리소스를 삭제하면 삭제한 리소스에서 태그가 함께 삭제됩니다. 그러나 태그 키가 동일한 다른 WorkSpaces 애플리케이션 및 AWS 리소스는 영향을 받지 않습니다.
태그 키와 값을 편집할 수 있으며 언제든지 리소스에서 태그를 제거할 수 있습니다. 태그의 값을 빈 문자열로 설정할 수 있지만 태그의 이름을 Null로 설정할 수는 없습니다. 해당 리소스의 기존 태그와 동일한 키를 가진 태그를 추가하면 새 값이 이전 값을 덮어씁니다. 리소스를 삭제하면 리소스에 대한 모든 태그도 삭제됩니다.
**참고**
WorkSpaces 애플리케이션 리소스에 대한 AWS 비용을 추적하기 위해 월별 비용 할당 보고서를 설정하려는 경우 기존 WorkSpaces 애플리케이션 리소스에 추가된 태그는 해당 월에 갱신된 리소스에 대해 다음 달 1일에 비용 할당 보고서에 표시됩니다.
# Amazon WorkSpaces 애플리케이션에 대한 태그 제한
+ WorkSpaces 애플리케이션 리소스당 최대 태그 수는 50개입니다.
+ 키의 최대 길이는 UTF-8 형식의 유니코드 문자 128자입니다.
+ 값의 최대 길이는 UTF-8 형식의 유니코드 문자 256자입니다.
+ 태그 키와 값은 대/소문자를 구분합니다.
+ 태그 이름 또는 값에 "aws:" 접두사는 AWS 사용하도록 예약된 시스템 태그이므로 사용하지 마십시오. 이 접두사가 지정된 태그 이름이나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.
+ 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @ 등의 특수 문자입니다.
+ 동일한 키와 값을 여러 리소스에서 공유할 수는 있지만 동일한 리소스에 중복 키를 사용할 수는 없습니다.
+ 리소스 생성 중에 리소스에 태그를 추가할 수 있습니다. 이미 생성된 리소스에 대해 태그를 추가, 편집 및 삭제할 수도 있습니다.
# Amazon WorkSpaces 애플리케이션 콘솔에서 리소스 생성 중 태그 추가
WorkSpaces 애플리케이션 콘솔에서 리소스를 생성할 때 하나 이상의 태그를 추가하여 리소스를 관리할 수 있습니다. 자세한 내용은 다음 항목을 참조하세요.
+ 이미지 빌더 - [이미지 빌더를 시작하여 스트리밍 애플리케이션 설치 및 구성](tutorial-image-builder-create.md), 4단계
+ 이미지 - [6단계: 이미지 생성 완료](tutorial-image-builder.md#tutorial-image-builder-finish-create-image), 1단계
+ 플릿 - [Amazon WorkSpaces 애플리케이션에서 플릿 생성](set-up-stacks-fleets-create.md), 3단계
+ 스택 - [Amazon WorkSpaces 애플리케이션에서 스택 생성](set-up-stacks-fleets-install.md), 2단계
# Amazon WorkSpaces 애플리케이션 콘솔에서 기존 리소스에 대한 태그 추가, 편집 및 삭제
WorkSpaces 애플리케이션 콘솔을 사용하여 기존 리소스에 대한 태그를 추가, 편집 및 삭제할 수 있습니다.
**기존 WorkSpaces 애플리케이션 리소스에 대한 태그를 추가, 편집 또는 삭제하려면**
1. [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home) WorkSpaces 애플리케이션 콘솔을 엽니다.
1. 탐색 모음에서 태그를 추가, 편집 또는 삭제할 리소스가 포함된 리전을 선택합니다.
1. 탐색 창에서 리소스 유형을 선택합니다. 리소스 유형은 이미지 빌더, 이미지, 플릿 또는 스택일 수 있습니다.
1. 리소스 목록에서 리소스를 선택합니다.
1. **태그**, **태그 추가/편집**을 선택한 후 다음 중 하나 이상의 작업을 수행합니다.
+ 태그를 추가하려면 **태그 추가**를 선택하고, 각 태그에 대한 키와 값을 입력합니다.
+ 태그를 편집하려면 필요에 따라 태그의 키와 값을 수정합니다.
+ 태그를 삭제하려면 해당 태그에 대한 **삭제** 아이콘(X)을 선택합니다.
1. **저장**을 선택합니다.
# Amazon WorkSpaces 애플리케이션 API, AWS SDK 또는 AWS CLI를 사용하여 태그 작업
WorkSpaces 애플리케이션 API, AWS SDK 또는 AWS 명령줄 인터페이스(AWS CLI)를 사용하는 경우 파라미터와 함께 다음 WorkSpaces 애플리케이션 작업을 사용하여 새 리소스를 생성할 때 태그를 `tags` 추가할 수 있습니다.
**참고**
태그 키와 값에 공백을 사용할 수 있습니다. AWS CLI를 사용할 때 공백을 표시하려면 "\$1s"(따옴표 제외)를 사용합니다.
| Task | AWS CLI | API 작업 |
| --- | --- | --- |
| 새로운 플릿에 대한 태그를 하나 이상 추가 | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html) | [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags) |
| 새로운 이미지 빌더에 대한 태그를 하나 이상 추가 | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) | [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags) |
| 새로운 스택에 대한 태그를 하나 이상 추가 | [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html) | [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags) |
다음 WorkSpaces 애플리케이션 작업을 사용하여 기존 리소스에 대한 태그를 추가, 편집, 제거 또는 나열할 수 있습니다.
| Task | AWS CLI | API 작업 |
| --- | --- | --- |
| 리소스에 대한 태그를 하나 이상 추가 또는 덮어쓰기 | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) | [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html) |
| 리소스에 대한 태그를 하나 이상 제거 | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html) | [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html) |
| 리소스에 대한 태그를 하나 이상 나열 | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html) | [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html) |
WorkSpaces 애플리케이션 API, AWS SDK 또는 AWS CLI 작업을 사용하여 기존 WorkSpaces 애플리케이션 리소스에 대한 태그를 추가, 편집, 제거 또는 나열하는 경우 Amazon 리소스 이름(ARN)을 사용하여 리소스를 지정합니다. ARN은 AWS 리소스를 고유하게 식별하고 다음과 같은 일반 구문을 사용합니다.
```
arn:aws:appstream:region:account:resourceType/resourceName
```
***리전***
리소스가 생성된 AWS 리전(예: `us-east-1`).
***account***
하이픈이 없는 AWS 계정 ID입니다(예: `123456789012`).
***resourceType***
리소스의 유형입니다. `image-builder`, , `image` `fleet`및 WorkSpaces 애플리케이션 리소스 유형에 태그를 지정할 수 있습니다`stack`.
***resourceName***
리소스의 이름입니다.
예를 들어 AWS CLI [describe-fleets ](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html)명령을 사용하여 WorkSpaces 애플리케이션 플릿의 ARN을 얻을 수 있습니다. 다음 명령을 복사합니다.
```
aws appstream describe-fleets
```
`TestFleet`이라는 단일 플릿이 포함된 환경의 경우 JSON 출력에 다음과 같이 이 리소스의 ARN이 나타납니다.
```
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"
```
이 리소스의 ARN을 얻은 후 [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) 명령을 사용하여 두 개의 태그를 추가할 수 있습니다.
```
aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT
```
첫 번째 태그인 `Environment=Test`는 플릿이 테스트 환경에 있음을 나타냅니다. 두 번째 태그인 `Department=IT`는 플릿이 IT 부서에 있음을 나타냅니다.
다음 명령을 사용하여 플릿에 추가한 두 개의 태그를 나열할 수 있습니다.
```
aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet
```
이 예제에서 JSON 출력은 다음과 같습니다.
```
{
"Tags": {
"Environment" : "Test",
"Department" : "IT"
}
}
```