翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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) オペレーションはキーに 1 つ以上のタグを追加します。このオペレーションを使用して、別の 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
```