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

# エイリアスについて
<a name="alias-about"></a>

 AWS Payment Cryptography でのエイリアスの動作について説明します。

**エイリアスは独立した AWS リソースです**  
エイリアスは AWS Payment Cryptography キーのプロパティではありません。エイリアスに対して実行するアクションは、エイリアスに関連付けられた キーには影響しません。 AWS Payment Cryptography キーのエイリアスを作成し、エイリアスを更新して別の AWS Payment Cryptography キーに関連付けることができます。関連付けられた AWS Payment Cryptography キーに影響を与えずにエイリアスを削除することもできます。 AWS Payment Cryptography キーを削除すると、そのキーに関連付けられているすべてのエイリアスが割り当てられなくなります。  
IAM ポリシーでリソースとしてエイリアスを指定すると、ポリシーは関連する AWS Payment Cryptography キーではなくエイリアスを参照します。

**各エイリアスにはわかりやすい名前が付いています**  
エイリアスを作成するときは、`alias/` によりプレフィックスが付いたエイリアス名を指定します。`alias/test_1234` の例

**各エイリアスは、一度に 1 つの AWS Payment Cryptography キーに関連付けられます。**  
エイリアスとその AWS Payment Cryptography キーは、同じアカウントとリージョンに存在する必要があります。  
 AWS Payment Cryptography キーは複数のエイリアスに同時に関連付けることができますが、各エイリアスは 1 つのキーにのみマッピングできます。  
例えば、この `list-aliases` 出力では、`alias/sampleAlias1` エイリアスが正確に 1 つのターゲット AWS Payment Cryptography キーに関連付けられていることが示されています。これは、`KeyArn` プロパティによって表されます。  

```
$ aws payment-cryptography list-aliases
```

```
  {
    "Aliases": [
        {
            "AliasName": "alias/sampleAlias1",
            "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
        }
    ]
}
```

**複数のエイリアスを同じ AWS Payment Cryptography キーに関連付けることができます**  
例えば、`alias/sampleAlias1;` と `alias/sampleAlias2` のエイリアスを同じキーに関連付けることができます。  

```
$ aws payment-cryptography list-aliases
```

```
{
        "Aliases": [
            {
                "AliasName": "alias/sampleAlias1",
                "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
            },
            {
                "AliasName": "alias/sampleAlias2",
                "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
            }
        ]
    }
```

**エイリアスは、アカウントとリージョン内で一意である必要があります**  
例えば、各アカウントとリージョンに `alias/sampleAlias1` エイリアスを 1 つだけ持つことができます。エイリアスでは大文字と小文字が区別されますが、大文字と小文字だけが異なるエイリアスは使用しないことをお勧めします。エイリアス名は変更できません。ただし、エイリアスを削除して、目的の名前で新しいエイリアスを作成することはできます。

**異なるリージョンに同じ名前のエイリアスを作成することができます**  
例えば、米国東部 (バージニア北部) に `alias/sampleAlias2` エイリアスを持つことができ、米国西部 (オレゴン) に `alias/sampleAlias2` エイリアスを持つことができます。各エイリアスは、そのリージョンの AWS Payment Cryptography キーに関連付けられます。コードが `alias/finance-key` のようなエイリアス名を参照している場合は、複数のリージョンで実行できます。各リージョンでは、異なるエイリアス/サンプルエイリアス2 が使用されます。詳細については、「[アプリケーションでのエイリアスの使用](alias-using.md)」を参照してください。

**エイリアスに関連付けられた AWS Payment Cryptography キーを変更できます。**  
`UpdateAlias` オペレーションを使用して、エイリアスを別の AWS Payment Cryptography キーに関連付けることができます。たとえば、`alias/sampleAlias2`エイリアスが `arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h ` AWS Payment Cryptography キーに関連付けられている場合は、`arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi`キーに関連付けられているように更新できます。  
AWS Payment Cryptography は、古いキーと新しいキーに、キーの使用など同じ属性がすべて含まれていることを検証しません。別のキータイプで更新すると、アプリケーションで問題が発生する可能性があります。

**一部のキーにはエイリアスがない**  
エイリアスはオプション機能であり、このような方法で環境を運用しない限り、すべてのキーにエイリアスがあるわけではありません。キーは `create-alias` コマンドを使用してエイリアスに関連付けることができます。また、update-alias オペレーションを使用してエイリアスに関連付けられている AWS Payment Cryptography キーを変更することや、delete-alias オペレーションを使用してエイリアスを削除することもできます。その結果、一部の AWS Payment Cryptography キーには複数のエイリアスがあり、一部のキーにはエイリアスがない場合があります。

**キーをエイリアスにマッピングする**  
`create-alias` コマンドを使用して、キー (ARN で表される) を 1 つ以上のエイリアスにマップできます。このコマンドは同一ではありません。エイリアスを更新するには、update-alias コマンドを使用してください。  

```
$ aws payment-cryptography create-alias --alias-name alias/sampleAlias1 \
             --key-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h
```

```
{
    "Alias": {
        "AliasName": "alias/alias/sampleAlias1",
        "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
    }
}
```