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

# Adicione um cluster à sua AWS CloudHSM configuração
<a name="cloudhsm_cli-multi-cluster-add-cluster"></a>

Ao se conectar a vários clusters, use o comando `configure-cli add-cluster` para adicionar um cluster à sua configuração.

## Sintaxe
<a name="cloudhsm_cli-multi-cluster-add-cluster-syntax"></a>

```
configure-cli add-cluster{{ [OPTIONS]}}
        --cluster-id {{<CLUSTER ID>}} 
        [--region {{<REGION>}}]
        [--endpoint {{<ENDPOINT>}}]
        [--hsm-ca-cert {{<HSM CA CERTIFICATE FILE>}}]
        [--client-cert-hsm-tls-file {{<CLIENT CERTIFICATE FILE>}}]
        [--client-key-hsm-tls-file {{<CLIENT KEY FILE>}}]
        [-h, --help]
```

## Exemplos
<a name="cloudhsm_cli-multi-cluster-add-cluster-examples"></a>

### Adicione um cluster usando o parâmetro `cluster-id`
<a name="w2aac23c15c19b7c13b7b3b1"></a>

**Example**  
 Use o parâmetro `configure-cli add-cluster` junto com `cluster-id` para adicionar um cluster (com o ID de`cluster-1234567`) para a sua configuração.   

```
$ sudo /opt/cloudhsm/bin/configure-cli add-cluster --cluster-id {{<cluster-1234567>}}
```

```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\bin\configure-cli.exe" add-cluster --cluster-id {{<cluster-1234567>}}
```

**dica**  
Se o uso de `configure-cli add-cluster` com o parâmetro `cluster-id` não resultar na adição do cluster, consulte o exemplo a seguir para obter uma versão mais longa deste comando que também requer os parâmetros `--region` e `--endpoint` para identificar o cluster que está sendo adicionado. Se, por exemplo, a região do cluster for diferente daquela configurada como padrão da AWS CLI, você deverá usar o parâmetro `--region` para usar a região correta. Além disso, você pode especificar o endpoint da AWS CloudHSM API a ser usado na chamada, o que pode ser necessário para várias configurações de rede, como usar endpoints de interface VPC que não usam o nome de host DNS padrão para. AWS CloudHSM

### Adicione um cluster usando os parâmetros `cluster-id`, `endpoint` e `region`
<a name="w2aac23c15c19b7c13b7b3b3"></a>

**Example**  
 Use `configure-cli add-cluster` junto com os parâmetros `cluster-id`, `endpoint` e `region` para adicionar um cluster (com o ID de `cluster-1234567`) à sua configuração.   

```
$ sudo /opt/cloudhsm/bin/configure-cli add-cluster --cluster-id {{<cluster-1234567>}} --region {{<us-east-1>}} --endpoint {{<https://cloudhsmv2.us-east-1.amazonaws.com>}}
```

```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\bin\configure-cli.exe" add-cluster --cluster-id {{<cluster-1234567>}} --region {{<us-east-1>}} --endpoint {{<https://cloudhsmv2.us-east-1.amazonaws.com>}}
```

Para obter mais informações sobre os parâmetros `--endpoint`, `--cluster-id` e `--region`, consulte [AWS CloudHSM Parâmetros de configuração do SDK do cliente 5](configure-tool-params5.md).

## Parâmetros
<a name="cloudhsm_cli-multi-cluster-add-cluster-parameters"></a>

**--ID do cluster {{<Cluster ID>}}**  
 Faz uma chamada `DescribeClusters` para encontrar todos os endereços IP da interface de rede elástica (ENI) do HSM no cluster associado ao ID do cluster. O sistema adiciona os endereços IP ENI aos arquivos de AWS CloudHSM configuração.  
Se você usar o `--cluster-id` parâmetro de uma EC2 instância dentro de uma VPC que não tem acesso à Internet pública, deverá criar uma interface VPC endpoint à qual se conectar. AWS CloudHSM Para obter mais informações sobre os endpoints da VPC, consulte [AWS CloudHSM e VPC endpoints](cloudhsm-vpc-endpoint.md).
Obrigatório: Sim

**--ponto final {{<Endpoint>}}**  
Especifique o endpoint AWS CloudHSM da API usado para fazer a `DescribeClusters` chamada. Você deve definir essa opção em combinação com `--cluster-id`.   
Obrigatório: não

**--hsm-ca-cert {{<HsmCA Certificate Filepath>}}**  
Especifica o caminho de arquivo do certificado de CA do HSM.  
Obrigatório: não

**--região {{<Region>}}**  
Especifique a região do seu cluster. Você deve definir essa opção em combinação com `--cluster-id`.  
Se você não fornecer o parâmetro `--region`, o sistema escolherá a região tentando ler as variáveis de ambiente `AWS_DEFAULT_REGION` ou `AWS_REGION`. Se essas variáveis não estiverem definidas, o sistema verificará a região associada ao seu perfil no seu arquivo de AWS Config (normalmente `~/.aws/config`), a menos que você tenha especificado um arquivo diferente na variável de ambiente `AWS_CONFIG_FILE`. Se nenhuma das opções acima for definida, o sistema usará a região `us-east-1` como padrão.  
Obrigatório: não

**-- client-cert-hsm-tls -arquivo {{<client certificate hsm tls path>}}**  
 Caminho para o certificado de cliente usado para autenticação mútua entre cliente TLS e HSM.   
 Use essa opção somente se você tiver registrado pelo menos uma âncora de confiança no HSM com a CLI do CloudHSM. Você deve definir essa opção em combinação com `--client-key-hsm-tls-file`.   
Obrigatório: não

**-- client-key-hsm-tls -arquivo {{<client key hsm tls path>}}**  
 Caminho para a chave do cliente usado para autenticação mútua entre cliente TLS e HSM.   
 Use essa opção somente se você tiver registrado pelo menos uma âncora de confiança no HSM com a CLI do CloudHSM. Você deve definir essa opção em combinação com `--client-cert-hsm-tls-file`.   
Obrigatório: não