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á.

# Descreva um AWS CloudHSM erro ao usar o KMU
<a name="key_mgmt_util-Error2String"></a>

Use o comando **Error2String** auxiliar no AWS CloudHSM key\$1mgmt\$1util para retornar o erro que corresponde a um código de erro hexadecimal key\$1mgmt\$1util. Você pode usar esse comando ao solucionar problemas com comandos e scripts.

Antes de executar um comando key\$1mgmt\$1util, você deve [iniciar key\$1mgmt\$1util](key_mgmt_util-setup.md#key_mgmt_util-start) e [fazer login](key_mgmt_util-log-in.md) no HSM como um usuário de criptografia (CU). 

## Sintaxe
<a name="Error2String-syntax"></a>

```
Error2String -h

Error2String -r <response-code>
```

## Exemplos
<a name="Error2String-examples"></a>

Estes exemplos mostram como usar **Error2String** para obter a string de erro para um código de erro da key\$1mgmt\$1util. 

**Example : Obter uma descrição do erro**  
Esse comando obtém a descrição do erro para o código de erro `0xdb`. A descrição explica que uma tentativa de fazer login na key\$1mgmt\$1util falhou porque o usuário possui o tipo de usuário errado. Somente usuários de criptografia (CU) podem fazer login na key\$1mgmt\$1util.  

```
        Command:  Error2String -r 0xdb
        
        Error Code db maps to HSM Error: Invalid User Type.
```

**Example : Encontrar o código de erro**  
Este exemplo mostra onde encontrar o código de erro em um erro da key\$1mgmt\$1util. O código de erro, `0xc6`, aparece após a string: `Cfm3<command-name> returned: `.  
Neste exemplo, [getKeyInfo](key_mgmt_util-getKeyInfo.md)indica que o usuário atual (usuário 4) pode usar a chave em operações criptográficas. No entanto, quando o usuário tenta usar [deleteKey](key_mgmt_util-deleteKey.md) para excluir a chave, o comando retorna o código de erro `0xc6`.   

```
        Command:  deleteKey -k 262162

        Cfm3DeleteKey returned: <0xc6> : HSM Error: Key Access is denied

        Cluster Error Status

        Command:  getKeyInfo -k 262162
        
        Cfm3GetKey returned: 0x00 : HSM Return: SUCCESS

       Owned by user 3

       also, shared to following 1 user(s):

                4
```
Se o erro `0xc6` for reportado, você poderá usar um comando **Error2String** como esse para procurar o erro. Nesse caso, o comando `deleteKey` falhou com um erro de acesso negado porque a chave é compartilhada com o usuário atual, mas possuída por um usuário diferente. Somente os proprietários de chaves têm permissão para excluir uma chave.  

```
        Command:  Error2String -r 0xa8
        
        Error Code c6 maps to HSM Error: Key Access is denied
```

## Parâmetros
<a name="Error2String-parameters"></a>

**-h**  
Exibe a ajuda referente ao comando.   
Obrigatório: Sim

**-r**  
Especifica um código de erro hexadecimal. É necessário o indicador de hexadecimal `0x`.  
Obrigatório: Sim