키 태그 지정 - AWS Key Management Service

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

키 태그 지정

태그는 AWS 리소스에 할당할 수 있는(또는 AWS가 할당할 수 있는) 메타데이터 레이블입니다. 각 태그는 대/소문자를 구분하는 문자열인 태그 키태그 값으로 구성됩니다. 태그 값은 빈(null) 문자열일 수 있습니다. 한 리소스의 각 태그에는 서로 다른 태그 키가 있어야 하지만, 여러 AWS 리소스에 동일한 태그를 추가할 수 있습니다. 각 리소스에는 최대 50개 사용자 생성 태그가 포함될 수 있습니다.

에서 AWS KMS를 생성할 때 CMK고객 관리형 에 태그를 추가할 수 있습니다.CMK 삭제 보류 중CMKs이 아닌 경우 기존 에서 태그를 추가하거나 편집할 수 있습니다. 별칭, AWS 관리형 CMKs 또는 AWS 소유 CMKs에는 태그를 지정할 수 없습니다.

예를 들어, Alpha 프로젝트에 사용하는 모든 "Project"="Alpha" 및 CMKs 버킷에 Amazon S3 태그를 추가할 수 있습니다.

TagKey = "Project" TagValue = "Alpha"

자세한 내용은 키 생성키 편집 단원을 참조하십시오. 형식 및 구문을 포함하여 태그에 대한 일반적인 정보는 https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html의 Amazon Web Services 일반 참조AWS 리소스 태그 지정을 참조하십시오.

태그는 다음을 지원합니다.

  • AWS 리소스를 식별하고 정리합니다. 많은 AWS 서비스가 태그 지정을 지원합니다. 따라서 서로 다른 서비스의 리소스에 동일한 태그를 할당하여 리소스가 서로 관련이 있음을 나타낼 수 있습니다. 예를 들어 동일한 태그를 AWS KMS 고객 마스터 키() 및 CMK(Amazon Elastic Block Store) 볼륨이나 Amazon EBS 보안 암호에 할당할 수 있습니다.AWS Secrets Manager 태그를 사용하여 자동화를 위한 CMK를 식별할 수도 있습니다.

  • AWS 비용을 추적합니다. AWS 리소스에 태그를 추가하면 AWS에서 사용 내역 및 비용을 태그별로 집계한 비용 할당 보고서를 생성합니다. 이 기능을 사용하여 프로젝트, 애플리케이션 또는 비용 센터의 AWS KMS 비용을 추적할 수 있습니다.

    비용 할당 태그 사용에 대한 자세한 내용은 AWS Billing and Cost Management 사용 설명서비용 할당 태그 사용을 참조하십시오. 태그 키 및 태그 값 규칙에 대한 자세한 내용은 https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html사용자 정의 태그 제한AWS Billing and Cost Management 사용 설명서을 참조하십시오.

AWS KMS는 AWS CloudTrail, TagResource 또는 UntagResource 작업을 사용할 때 로그에 항목을 기록합니다.ListResourceTags

태그 관리(CMK)console

콘솔에서 CMK를 생성할 때 CMK에 태그를 추가할 수 있습니다.AWS KMS 콘솔을 사용하여 고객 관리형 CMKs에 태그를 추가, 편집 및 삭제할 수도 있습니다.

기존 CMK에 대한 태그를 추가, 편집 또는 삭제하려면

  1. AWS Management 콘솔에 로그인한 후 https://console.aws.amazon.com/kms에서 AWS Key Management Service(AWS KMS) 콘솔을 엽니다.

  2. AWS 리전을 변경하려면 페이지의 오른쪽 위 모서리에 있는 리전 선택기를 사용합니다.

  3. 탐색 창에서 고객 관리형 키를 선택합니다.(AWS 관리형 CMK의 태그는 관리할 수 없습니다.)

  4. 의 별칭 옆에 있는 확인란을 선택합니다.CMK

  5. [Key actions], [Add or edit tags]를 선택합니다.

  6. 의 세부 정보 페이지에서 CMK태그 탭을 선택합니다.

    • 첫 번째 태그를 생성하려면 태그 생성을 선택하고 태그 이름(필수)과 태그 값(선택 사항)을 입력한 다음 저장을 선택합니다.

      태그 값을 비워 두면 실제 태그 값은 null 또는 빈 문자열이 됩니다.

    • 태그를 추가하려면 편집을 선택하고 태그 추가를 선택하고 태그 이름과 태그 값을 입력한 다음, 저장을 선택합니다.

    • 태그의 이름이나 값을 변경하려면 편집을 선택하여 변경을 한 다음, 저장을 선택합니다.

    • 태그를 삭제하려면 편집을 선택합니다. 태그 행에서 제거를 선택한 다음 저장을 선택합니다.

  7. 변경 사항을 저장하려면 변경 사항 저장을 선택합니다.

태그 관리(CMK)AWS KMS API

() APIAWS Key Management Service를 사용하여 관리하는 AWS KMS에 대한 태그를 추가, 삭제 및 나열할 수 있습니다.CMKs 이 예제들은 AWS Command Line Interface(AWS CLI)를 사용하지만, 사용자는 어떤 지원되는 프로그래밍 언어라도 사용할 수 있습니다.

관리형 AWS에는 태그를 지정할 수 없습니다.CMKs

CreateKey: 새 CMK에 태그 추가

고객 관리형 CMK를 생성할 때 태그를 추가할 수 있습니다. 태그를 지정하려면 TagsCreateKey 작업의 파라미터를 사용합니다. 파라미터의 값은 대/소문자를 구분하는 태그 키 및 태그 값 페어의 모음입니다.Tags

의 각 태그는 다른 태그 이름을 가져야 합니다.CMK 태그 값은 null이거나 빈 문자열일 수 있습니다.

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

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

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

TagResource: 에 대한 태그 추가 또는 변경CMK

TagResource 작업은 에 하나 이상의 태그를 추가합니다.CMK

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

예를 들어, 다음 명령은 예제 PurposeDepartment 및 CMK 태그를 추가합니다.

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

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

을 사용할 수도 있습니다.TagResource - 기존 태그의 태그 값을 변경합니다. 태그 값을 바꾸려면 동일한 태그 키를 다른 값으로 지정합니다.

예를 들어 이 명령은 Purpose 태그의 값을 Pretest에서 Test로 변경합니다.

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

ListResourceTags: 에 대한 태그 가져오기CMK

ListResourceTags 작업은 에 대한 태그를 가져옵니다.CMK key-id 파라미터가 필요합니다.

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

$ 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: 에서 태그 삭제CMK

UntagResource 작업은 에서 태그를 삭제합니다.CMK key-idtag-keys 파라미터가 필요합니다.

성공하면 UntagResource 작업은 출력을 반환하지 않습니다. 또한 지정된 태그 키를 CMK에서 찾을 수 없는 경우 예외가 발생하거나 응답을 반환하지 않습니다. 작업이 작동했는지 확인하려면 ListResourceTags 작업을 사용합니다.

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

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

이 명령이 제대로 실행되면 메타데이터를 반환하지 않습니다.