API 작업으로 KMS 키 태그 관리

이러한 AWS Key Management Service(AWS KMS) API를 이용해 현재 관리 중인 KMS 키에 대한 태그를 추가, 삭제, 나열할 수 있습니다. 이 예제들은 AWS Command Line Interface(AWS CLI)를 사용하지만, 사용자는 어떤 지원되는 프로그래밍 언어라도 사용할 수 있습니다. AWS 관리형 키 태그를 지정할 수 없습니다.

KMS 키의 태그를 추가, 편집, 보기 및 삭제하려면 필요한 사용 권한이 있어야 합니다. 자세한 내용은 태그에 대한 액세스 제어 섹션을 참조하세요.

CreateKey: 새 KMS 키에 태그 추가

고객 관리 키를 생성할 때 태그를 추가할 수 있습니다. 태그를 지정하려면 CreateKey작업의 Tags 파라미터를 사용하십시오.

KMS 키를 생성할 때 태그를 추가하려면 IAM 정책에서 호출자가 kms:TagResource 권한을 가지고 있어야 합니다. 최소한 권한에 계정 및 리전의 모든 KMS 키가 포함되어야 합니다. 자세한 내용은 태그에 대한 액세스 제어 섹션을 참조하세요.

CreateKey 의 값은Tags 파라미터 값은 대소문자를 구분하는 태그 키 및 태그 값 페어 모음입니다. KMS 키의 각 태그에는 다른 태그 이름이 있어야 합니다. 태그 값은 null이거나 빈 문자열일 수 있습니다.

예를 들어 다음 AWS CLI 명령은 Project:Alpha 태그가 있는 대칭 암호화 KMS 키를 만듭니다. 두 개 이상의 키-값 페어를 지정할 때는 공백을 사용하여 각 페어를 구분합니다.

$ aws kms create-key --tags TagKey=Project,TagValue=Alpha

이 명령이 성공하면 새 KMS 키에 대한 정보가 있는 KeyMetadata 객체를 반환합니다. 그러나 KeyMetadata에는 태그가 포함되지 않습니다. 태그를 가져오려면 ListResourceTags작업을 사용하십시오.

TagResource: KMS 키의 태그 추가 또는 변경

이 TagResource작업은 KMS 키에 하나 이상의 태그를 추가합니다. 이 작업을 사용하여 다른 AWS 계정의 태그를 추가 또는 편집할 수 없습니다.

태그를 추가하려면 새 태그 키와 태그 값을 지정합니다. 태그를 편집하려면 기존 태그 키와 새 태그 값을 지정합니다. KMS 키의 각 태그에는 다른 태그 키가 있어야 합니다. 태그 값은 null이거나 빈 문자열일 수 있습니다.

예를 들어 다음 명령은 예제 KMS 키에 Purpose 및 Department 태그를 추가합니다.

$ aws kms tag-resource \
         --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
         --tags TagKey=Purpose,TagValue=Pretest TagKey=Department,TagValue=Finance

이 명령이 제대로 실행되면 메타데이터를 반환하지 않습니다. KMS 키의 태그를 보려면 작업을 사용하십시오. ListResourceTags

또한 TagResource를 이용해 기존 태그의 태그 값을 변경할 수도 있습니다. 태그 값을 바꾸려면 동일한 태그 키를 다른 값으로 지정하십시오.

예를 들어 이 명령은 Purpose 태그 값을 Pretest에서 Test로 바꿉니다.

$ aws kms tag-resource \
         --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
         --tags TagKey=Purpose,TagValue=Test

ListResourceTags: KMS 키의 태그 가져오기

이 ListResourceTags작업은 KMS 키의 태그를 가져옵니다. KeyId 파라미터가 필요합니다. 이 작업을 사용하여 다른 AWS 계정의 KMS 키에 있는 태그를 볼 수 없습니다.

예를 들어 다음 명령은 예제 KMS 키에 대한 태그를 가져옵니다.

$ aws kms list-resource-tags --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
       
  "Truncated": false,
  "Tags": [
      {
        "TagKey": "Project",
        "TagValue": "Alpha"
     },
     {
       "TagKey": "Purpose",
       "TagValue": "Test"
     },
     {
       "TagKey": "Department",
       "TagValue": "Finance"
     }
  ]
}

UntagResource: KMS 키에서 태그 삭제

이 UntagResource작업은 KMS 키에서 태그를 삭제합니다. 삭제할 태그를 식별하려면 태그 키를 지정합니다. 이 작업을 사용하여 다른 AWS 계정의 KMS 키에서 태그를 삭제할 수 없습니다.

성공하면 UntagResource 작업은 어떠한 출력도 반환하지 않습니다. 또한 지정된 태그 키가 KMS 키에서 발견되지 않으면 예외를 발생시키거나 응답을 반환하지 않습니다. 작업이 제대로 수행되었는지 확인하려면 작업을 사용하십시오. ListResourceTags

예를 들어 이 명령은 KMS 키에서 Purpose 태그와 해당 값을 삭제합니다.

$ aws kms untag-resource --key-id 1234abcd-12ab-34cd-56ef-1234567890ab --tag-keys Purpose