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

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