CloudFormation 리소스 태그 지정

CloudFormation 템플릿에서 Tags 속성을 사용하여 리소스에 태그를 적용할 수 있습니다. 그러면 해당 리소스를 식별하고 분류하는 데 도움이 될 수 있습니다.

Tags 속성을 지원하는 리소스에 대한 자세한 내용은 AWS 리소스 및 속성 유형 참조에서 개별 리소스를 참조하세요. 리소스가 아직 Tags 속성을 지원하지 않는 경우 리소스의 서비스는 자체 API 작업을 사용하여 태그 지정을 지원할 수 있습니다. 자세한 내용은 해당 서비스에 대한 설명서를 참조하세요.

사용자가 정의하는 태그 외에도 CloudFormation에서는 aws: 접두사가 있는 다음과 같은 스택 레벨 태그를 자동으로 생성합니다.

• aws:cloudformation:logical-id

• aws:cloudformation:stack-id

• aws:cloudformation:stack-name

aws: 접두사는 AWS용으로 예약되어 있습니다. 이 접두사는 대소문자를 구분하지 않습니다. Key 또는 Value 속성에 이 접두사를 사용하면 태그를 업데이트하거나 삭제할 수 없습니다. 이 접두사가 포함된 태그는 리소스당 태그 수에 산입되지 않습니다.

aws: 접두사가 있는 태그를 포함하여 리소스에 대한 스택 수준 태그 전파는 리소스 유형에 따라 다릅니다. 예를 들어, 블록 디바이스 매핑에서 생성된 Amazon EBS 볼륨에는 태그가 전파되지 않습니다.

참고

일부 리소스에는 명시적 태그 전파 설정이 필요합니다. 예를 들어 EC2 인스턴스에 태그를 전파하려면 AWS::AutoScaling::AutoScalingGroup 리소스의 PropagateAtLaunch 속성이 true로 설정되어 있어야 합니다. 그러나 스택 레벨 태그는 PropagateAtLaunch 설정에 관계없이 EC2 인스턴스에 자동으로 적용됩니다.

구문

JSON

{
  "Key" : String,
  "Value" : String
}

YAML

Key: String
Value: String

속성

Key

태그의 키 이름입니다. 1 ~ 128자의 유니코드 문자로 이루어진 값을 지정할 수 있으며 aws:로 시작할 수 없습니다. 유니코드 문자 세트, 숫자, 공백, _, ., :, /, =, +, @, -, " 등의 문자를 무엇이든 사용할 수 있습니다.

필수 항목 여부: 예

유형: 문자열

Value

태그의 값입니다. 1~256자 길이의 값을 지정할 수 있습니다. 유니코드 문자 세트, 숫자, 공백, _, ., /, =, +, - 등의 문자를 무엇이든 사용할 수 있습니다.

필수 항목 여부: 예

유형: 문자열

예제

이 예제에서는 Tags 속성을 보여줍니다. 지원 리소스의 Properties 단원에서 이 속성을 지정합니다. 리소스가 생성되면 파라미터를 사용해 Environment 태그가 동적으로 설정되고 Owner 태그는 정적으로 MyName으로 설정됩니다.

JSON

"Tags" : [
   {
      "Key" : "Environment",
      "Value" : { "Ref": "Environment" }
   },
   {
      "Key" : "Owner",
      "Value" : "MyName"
   }
]

YAML

Tags: 
  - Key: Environment
    Value: !Ref Environment
  - Key: Owner
    Value: MyName

다음 사항도 참조하세요.

• AWS CloudFormation 사용 설명서의 스택 옵션 구성

• AWS CloudFormation 사용 설명서의 AWS Management Console에서 CloudFormation 스택 데이터 및 리소스 보기