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

# API 작업으로 키 태그 관리
<a name="manage-tags-api"></a>

[AWS Payment Cryptography API](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/Welcome.html)를 이용해 현재 관리 중인 키에 대한 태그를 추가, 삭제, 나열할 수 있습니다. 이 예제들은 [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/)를 사용하지만, 사용자는 어떤 지원되는 프로그래밍 언어라도 사용할 수 있습니다. 태그를 지정할 수 없습니다 AWS 관리형 키.

키의 태그를 추가, 편집, 보기 및 삭제하려면 필요한 사용 권한이 있어야 합니다. 자세한 내용은 [태그에 대한 액세스 제어](tag-permissions.md)을 참조하세요.

**Topics**
+ [CreateKey: 새 키에 태그 추가](#tagging-keys-create-key)
+ [TagResource: 키에 태그 추가 또는 변경](#tagging-keys-tag-resource)
+ [ListResourceTags: 키에 지정된 태그 가져오기](#tagging-keys-list-resource-tags)
+ [UntagResource: 키에서 태그 삭제](#tagging-keys-untag-resource)

## CreateKey: 새 키에 태그 추가
<a name="tagging-keys-create-key"></a>

키를 생성할 때 태그를 추가할 수 있습니다. 태그를 지정하려면 [CreateKey](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html) 작업의 `Tags` 파라미터를 사용합니다.

키를 생성할 때 태그를 추가하려면 IAM 정책에서 호출자가 `payment-cryptography:TagResource` 권한을 가지고 있어야 합니다. 최소한 권한에 계정 및 리전의 모든 키가 포함되어야 합니다. 자세한 내용은 [태그에 대한 액세스 제어](tag-permissions.md)을 참조하세요.

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

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

```
$ aws payment-cryptography create-key --exportable --key-attributes KeyAlgorithm=TDES_2KEY, \
        KeyUsage=TR31_C0_CARD_VERIFICATION_KEY,KeyClass=SYMMETRIC_KEY, \
        KeyModesOfUse='{Generate=true,Verify=true}' \
        --tags '[{"Key":"Project","Value":"Alpha"},{"Key":"BIN","Value":"123456"}]'
```

이 명령이 성공하면 새 키에 대한 정보가 있는 `Key` 객체를 반환합니다. 그러나 `Key`에는 태그가 포함되지 않습니다. 태그를 가져오려면 [ListResourceTags](#tagging-keys-list-resource-tags) 작업을 사용합니다.

## TagResource: 키에 태그 추가 또는 변경
<a name="tagging-keys-tag-resource"></a>

[TagResource](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_TagResource.html) 작업은 키에 하나 이상의 태그를 추가합니다. 이 작업을 사용하여 다른 AWS 계정의 태그를 추가 또는 편집할 수 없습니다.

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

예를 들어 다음 명령은 예제 키에 **UseCase** 및 **BIN** 태그를 추가합니다.

```
$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tags '[{"Key":"UseCase","Value":"Acquiring"},{"Key":"BIN","Value":"123456"}]' 
```

이 명령이 제대로 실행되면 메타데이터를 반환하지 않습니다. 키에 지정된 태그를 보려면 [ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html) 작업을 사용합니다.

또한 **TagResource**를 이용해 기존 태그의 태그 값을 변경할 수도 있습니다. 태그 값을 바꾸려면 동일한 태그 키를 다른 값으로 지정하세요. 수정 명령에 나열되지 않은 태그는 변경되거나 제거되지 않습니다.

예를 들어 이 명령은 `Project` 태그 값을 `Alpha`에서 `Noe`로 바꿉니다.

이 명령은 내용 없이 http/200을 반환합니다. 변경 내용을 보려면 `ListTagsForResource`을 사용하세요.

```
$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h \ 
        --tags '[{"Key":"Project","Value":"Noe"}]'
```

## ListResourceTags: 키에 지정된 태그 가져오기
<a name="tagging-keys-list-resource-tags"></a>

[ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html) 작업은 키에 지정된 태그를 가져옵니다. `ResourceArn`(keyArn 또는 keyAlias) 파라미터가 필요합니다. 이 작업을 사용하여 다른 AWS 계정의 키에 있는 태그를 볼 수 없습니다.

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

```
$ aws payment-cryptography list-tags-for-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h
       
  {
    "Tags": [
        {
            "Key": "BIN",
            "Value": "20151120"
        },
        {
            "Key": "Project",
            "Value": "Production"
        }
    ]
}
```

## UntagResource: 키에서 태그 삭제
<a name="tagging-keys-untag-resource"></a>

[UntagResource](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_UntagResource.html) 작업은 키에서 태그를 삭제합니다. 삭제할 태그를 식별하려면 태그 키를 지정합니다. 이 작업을 사용하여 다른 AWS 계정의 키에서 태그를 삭제할 수 없습니다.

성공하면 `UntagResource` 작업은 어떠한 출력도 반환하지 않습니다. 또한 지정된 태그 키가 키에서 발견되지 않으면 예외를 발생시키거나 응답을 반환하지 않습니다. 작업이 작동했는지 확인하려면 [ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html) 작업을 수행합니다.

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

```
$ aws payment-cryptography untag-resource \ 
        --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tag-keys Project
```