As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Sobre aliases
<a name="alias-about"></a>

Saiba como os aliases funcionam na criptografia AWS de pagamento.

**Um alias é um recurso independente AWS **  
Um alias não é propriedade de uma chave de criptografia AWS de pagamento. As ações executadas no alias não afetam a chave associada. Você pode criar um alias para uma chave de criptografia AWS de pagamento e, em seguida, atualizar o alias para que seja associado a uma chave de criptografia de AWS pagamento diferente. Você pode até mesmo excluir o alias sem qualquer efeito na chave de criptografia AWS de pagamento associada. Se você excluir uma chave do AWS Payment Cryptography, todos os aliases associados a essa chave deixarão de ser atribuídos.  
Se você especificar um alias como recurso em uma política do IAM, a política se referirá ao alias, não à chave de criptografia de AWS pagamento associada.

**Cada alias tem um nome fácil de usar**  
Ao criar um alias, você especifica o nome do alias prefixado por `alias/`. Por exemplo, `alias/test_1234`

**Cada alias é associado a uma chave AWS de criptografia de pagamento por vez**  
O alias e sua chave AWS de criptografia de pagamento devem estar na mesma conta e região.   
Uma chave AWS de criptografia de pagamento pode ser associada a mais de um alias simultaneamente, mas cada alias só pode ser mapeado para uma única chave   
Por exemplo, esta saída de `list-aliases` mostra que o alias `alias/sampleAlias1` está associado exatamente a uma chave de AWS Payment Cryptography de destino, que é representada pela propriedade `KeyArn`.  

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

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

**Vários aliases podem ser associados à mesma chave de criptografia AWS de pagamento**  
Por exemplo, você pode associar os aliases `alias/sampleAlias1;` e `alias/sampleAlias2` à mesma chave.  

```
$ 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"
            }
        ]
    }
```

**Um alias deve ser exclusivo para uma determinada conta e região**  
Por exemplo, é possível ter apenas um alias `alias/sampleAlias1` em cada conta e região. Os aliases diferenciam maiúsculas de minúsculas, mas não recomendamos usar aliases que diferem apenas no tamanho das letras, pois podem estar propensos a erros. Não é possível alterar um nome de alias. No entanto, você pode excluir o alias e criar um novo com o nome desejado.

**É possível criar um alias com o mesmo nome em regiões diferentes**  
Por exemplo, você pode ter um alias `alias/sampleAlias2` no Leste dos EUA (Norte da Virgínia) e um alias `alias/sampleAlias2` no Oeste dos EUA (Oregon). Cada alias seria associado a uma chave de criptografia AWS de pagamento em sua região. Se o seu código se referir a um nome de alias como `alias/finance-key`, você poderá executá-lo em várias regiões. Em cada região, ele usa um alias/sampleAlias2 diferente. Para obter detalhes, consulte [Usar aliases em suas aplicações](alias-using.md).

**Você pode alterar a chave AWS de criptografia de pagamento associada a um alias**  
Você pode usar a `UpdateAlias` operação para associar um alias a uma chave de criptografia AWS de pagamento diferente. Por exemplo, se o `alias/sampleAlias2` alias estiver associado à chave de criptografia de `arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h ` AWS pagamento, você poderá atualizá-lo para que fique associado à `arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi` chave.  
AWS A criptografia de pagamento não valida que as chaves antigas e novas tenham todos os mesmos atributos, como o uso da chave. A atualização com um tipo de chave diferente pode resultar em problemas em seu aplicativo.

**Algumas chaves não têm aliases**  
Um alias é um atributo opcional e nem todas as chaves terão aliases, a menos que você opte por operar seu ambiente dessa maneira. As chaves podem ser associadas a aliases usando o comando `create-alias`. Além disso, você pode usar a operação update-alias para alterar a chave de AWS Payment Cryptography associada a um alias e a operação delete-alias para excluir um alias. Como resultado, algumas chaves AWS de criptografia de pagamento podem ter vários aliases e outras podem não ter nenhum.

**Mapear uma chave para um alias**  
É possível mapear uma chave (representada por um ARN) para um ou mais aliases usando o comando `create-alias`. Esse comando não é idempotente. Para atualizar um alias, use o comando 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"
    }
}
```