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

# Excluir um AWS CloudHSM usuário com a CLI do CloudHSM
<a name="cloudhsm_cli-user-delete"></a>

O **user delete** comando na CLI do CloudHSM exclui um usuário do seu cluster. AWS CloudHSM Somente contas de usuário com a função de administrador podem executar esse comando. Você não pode excluir um usuário que esteja atualmente conectado a um HSM. 

## Tipo de usuário
<a name="user-delete-userType"></a>

Os seguintes tipos de usuários podem executar este comando.
+ Administrador

## Requisitos
<a name="user-delete-requirements"></a>
+ Você não pode excluir contas de usuários que possuem chaves.
+ Sua conta de usuário deve ter a função de administrador para executar esse comando.

## Sintaxe
<a name="user-delete-syntax"></a>

Como esses comandos não têm parâmetros específicos, insira os argumentos na ordem especificada nos diagramas de sintaxe.

```
aws-cloudhsm > help user delete
Delete a user

Usage: user delete [OPTIONS] --username <USERNAME> --role <ROLE>

Options:
      --cluster-id <CLUSTER_ID>
          Unique Id to choose which of the clusters in the config file to run the operation against. If not provided, will fall back to the value provided when interactive mode was started, or error

      --username <USERNAME>
          Username to access the HSM cluster

      --role <ROLE>
          Role the user has in the cluster

          Possible values:
          - crypto-user: A CryptoUser has the ability to manage and use keys
          - admin:       An Admin has the ability to manage user accounts

      --approval <APPROVAL>
          Filepath of signed quorum token file to approve operation
```

## Exemplo
<a name="user-delete-examples"></a>

```
aws-cloudhsm > user delete --username alice --role crypto-user
{
  "error_code": 0,
  "data": {
    "username": "alice",
    "role": "crypto-user"
  }
}
```

## Argumentos
<a name="user-delete-arguments"></a>

***<CLUSTER\$1ID>***  
O ID do cluster em que essa operação será executada.  
Obrigatório: se vários clusters tiverem sido [configurados.](cloudhsm_cli-configs-multi-cluster.md)

***<USERNAME>***  
Especifica um nome amigável para o usuário. O tamanho máximo é de 31 caracteres. O único caractere especial permitido é um sublinhado ( \$1 ). O nome de usuário não diferencia maiúsculas de minúsculas neste comando. O nome de usuário é sempre exibido em minúsculas.  
Obrigatório: Sim

***<ROLE>***  
Especifica a função atribuída a esse usuário. Esse parâmetro é obrigatório. Os valores válidos são **admin**, **crypto-user**.  
Para obter a função do usuário, use o comando **user list**. Para obter informações detalhadas sobre os tipos de usuários em um HSM, consulte [Noções básicas dos usuários de HSM](manage-hsm-users.md).  
Obrigatório: Sim

***<APPROVAL>***  
Especifica o caminho do arquivo para um arquivo de token de quórum designado para aprovar a operação. Exigido somente se o valor do quórum do serviço de usuário do quórum for maior que 1.  
Obrigatório: Sim

## Tópicos relacionados
<a name="user-delete-seealso"></a>
+ [lista de usuários](cloudhsm_cli-user-list.md)
+ [criar usuário](cloudhsm_cli-user-create.md)
+ [alterar senha de usuário](cloudhsm_cli-user-change-password.md)