Amazon AppStream 2.0 리소스 태그 지정 - 아마존 AppStream 2.0
태그 지정 관련 기본 사항태그 제한AppStream 2.0 콘솔에서 리소스 생성 중에 태그 추가AppStream 2.0 콘솔에서 기존 리소스에 대해 태그 추가, 편집 및 삭제AppStream 2.0 API, AWS SDK 또는 AWS CLI를 사용하여 태그 작업

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

Amazon AppStream 2.0 리소스 태그 지정

AWS를 통해 태그의 형태로 AWS 리소스에 메타데이터를 할당할 수 있습니다. 이러한 태그를 사용하여 AppStream 2.0 이미지 빌더, 이미지, 플릿 및 스택을 간편하게 관리할 수 있으며 결제 데이터를 비롯한 데이터를 구성할 수도 있습니다.

다음을 할 수 있습니다.

  • 리소스를 다양한 방식으로 논리적으로 그룹화할 수 있습니다(예: 용도별, 소유자별 또는 환경별).

    이는 동일한 유형의 리소스가 많을 때 유용합니다.

  • 지정한 태그를 기반으로 특정 리소스를 신속하게 식별할 수 있습니다.

  • AWS 비용 식별 및 제어

예를 들어 다른 환경(예: 개발 또는 프로덕션)에 있거나 다른 사업 부문(예: HR 또는 마케팅)에 할당된 AppStream 2.0 플릿을 식별하고 그룹화할 수 있습니다. 그런 다음 이러한 플릿과 관련된 AWS 비용을 더 자세히 추적할 수 있습니다. 이렇게 하려면 가입하여 태그 키 값이 포함된 Amazon Web Services 계정 청구서를 가져옵니다. 태그를 사용한 비용 할당 보고서 설정에 대한 자세한 내용은 AWS Billing 사용 설명서에서 월간 비용 할당 보고서를 참조하세요.

태그 지정 관련 기본 사항

태그란 다른 AWS 서비스 태그처럼 키-값 페어로 구성됩니다. 리소스에 태그를 지정하려면 각 태그에 대한 키 및 값을 지정합니다. 키는 "project", "owner" 또는 "environment" 등의 특정 연결 값을 가진 일반 범주일 수 있으며 동일한 키와 값을 여러 리소스에서 공유할 수 있습니다. AppStream 2.0 리소스를 생성한 후 바로 태그를 지정하거나 나중에 지정할 수 있습니다. 리소스를 삭제하면 삭제한 리소스에서 태그가 함께 삭제됩니다. 그러나 동일한 태그 키를 가지고 있는 다른 AppStream 2.0 및 AWS 리소스는 영향을 받지 않습니다.

태그 키와 값을 편집할 수 있으며 언제든지 리소스에서 태그를 제거할 수 있습니다. 태그의 값을 빈 문자열로 설정할 수 있지만 태그의 이름을 Null로 설정할 수는 없습니다. 해당 리소스에 대해 키가 기존 태그와 동일한 태그를 추가하는 경우 새 값이 이전 값을 덮어씁니다. 리소스를 삭제하면 리소스 태그도 삭제됩니다.

참고

AppStream 2.0 리소스의 AWS 비용을 추적하기 위해 월별 비용 할당 보고서를 설정할 계획인 경우, 기존 AppStream 2.0 리소스에 추가된 태그는 해당 월에 갱신된 리소스에 대해 다음 달의 첫 번째 일에 비용 할당 보고서에 나타납니다.

태그 제한

  • AppStream 2.0 리소스당 최대 태그 수는 50개입니다.

  • 키의 최대 길이는 UTF-8 형식의 유니코드 문자 128자입니다.

  • 값의 최대 길이는 UTF-8 형식의 유니코드 문자 256자입니다.

  • 태그 키와 값은 대/소문자를 구분합니다.

  • 태그 이름이나 값에서 'aws:' 접두사는 사용하지 마세요. 이 단어는 AWS용으로 예약된 시스템 태그입니다. 이 접두사가 지정된 태그 이름이나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.

  • 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 + - = . _ : / @ 등의 특수 문자입니다.

  • 동일한 키와 값을 여러 리소스에서 공유할 수는 있지만 동일한 리소스에 중복 키를 사용할 수는 없습니다.

  • 리소스 생성 중에 리소스에 태그를 추가할 수 있습니다. 이미 생성된 리소스에 대해 태그를 추가, 편집 및 삭제할 수도 있습니다.

AppStream 2.0 콘솔에서 리소스 생성 중에 태그 추가

AppStream 2.0 콘솔에서 리소스를 생성할 때, 태그를 하나 이상 추가하여 리소스를 관리할 수 있습니다. 자세한 정보는 다음 주제를 참조하세요.

AppStream 2.0 콘솔에서 기존 리소스에 대해 태그 추가, 편집 및 삭제

AppStream 2.0 콘솔을 사용하여 기존 리소스에 대한 태그를 추가, 편집 및 삭제할 수 있습니다.

기존 AppStream 2.0 리소스에 대한 태그를 추가, 편집 또는 삭제하는 방법

  1. https://console.aws.amazon.com/appstream2에서 AppStream 2.0 콘솔을 엽니다.

  2. 탐색 모음에서 태그를 추가, 편집 또는 삭제할 리소스가 포함된 리전을 선택합니다.

  3. 탐색 창에서 리소스 유형을 선택합니다. 리소스 유형은 이미지 빌더, 이미지, 플릿 또는 스택일 수 있습니다.

  4. 리소스 목록에서 리소스를 선택합니다.

  5. [Tags], [Add/Edit Tags]를 선택한 후 다음 중 하나 이상의 작업을 수행합니다.

    • 태그를 추가하려면 태그 추가를 선택하고, 각 태그에 대한 키와 값을 입력합니다.

    • 태그를 편집하려면 필요에 따라 태그의 키와 값을 수정합니다.

    • 태그를 삭제하려면 해당 태그에 대한 삭제 아이콘(X)을 선택합니다.

  6. Save를 선택합니다.

AppStream 2.0 API, AWS SDK 또는 AWS CLI를 사용하여 태그 작업

AppStream 2.0 API, AWS SDK 또는 AWS Command Line Interface(AWS CLI)를 사용 중인 경우, tags 파라미터와 함께 다음 AppStream 2.0 작업을 사용하여 새 리소스를 생성할 때 태그를 추가할 수 있습니다.

참고

태그 키와 값에 공백을 사용할 수 있습니다. AWS CLI를 사용할 때 공백을 표시하려면 '\s'(인용 부호 없이)를 사용하세요.

태스크 AWS CLI API 작업
새로운 플릿에 대한 태그를 하나 이상 추가 create-fleet

CreateFleet

새로운 이미지 빌더에 대한 태그를 하나 이상 추가 create-imagebuilder

CreateImageBuilder
새로운 스택에 대한 태그를 하나 이상 추가

create-stack

CreateStack

다음 AppStream 2.0 작업을 사용하여 기존 리소스에 대해 태그를 추가, 편집, 제거 또는 나열할 수 있습니다.

태스크 AWS CLI API 작업
리소스에 대한 태그를 하나 이상 추가 또는 덮어쓰기 tag-resource

TagResource
리소스에 대한 태그를 하나 이상 제거 untag-resource

UntagResource
리소스에 대한 태그를 하나 이상 나열

list-tags-for-resource

ListTagsForResource

AppStream 2.0 API, AWS SDK 또는 AWS CLI 작업을 사용하여 기존 AppStream 2.0 리소스에 대한 태그를 추가, 편집, 제거 또는 나열할 때 해당 Amazon 리소스 이름(ARN)을 사용하여 리소스를 지정하세요. ARN은 AWS 리소스를 고유하게 식별하며 다음과 같은 일반적인 구문을 사용합니다.

arn:aws:appstream:region:account:resourceType/resourceName
region

리소스가 생성된 AWS 리전(예: us-east-1)입니다.

account

AWS 계정 ID이며 하이픈은 제외합니다(예: 123456789012).

resourceType

리소스의 유형입니다. AppStream 2.0 리소스 유형 image-builder, image, fleet, stack에 태그를 지정할 수 있습니다.

resourceName

리소스의 이름입니다.

예를 들어, AWS CLI describe-fleets 명령을 사용하여 AppStream 2.0 플릿에 대한 ARN을 얻을 수 있습니다. 다음 명령을 복사합니다.

aws appstream describe-fleets

TestFleet이라는 단일 플릿이 포함된 환경의 경우 JSON 출력에 다음과 같이 이 리소스의 ARN이 나타납니다.

"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"

이 리소스의 ARN을 얻은 후 tag-resource 명령을 사용하여 두 개의 태그를 추가할 수 있습니다.

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"
    }
}