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

# AWS CloudHSM 設定にクラスターを追加する
<a name="cloudhsm_cli-multi-cluster-add-cluster"></a>

複数のクラスターに接続する場合は、`configure-cli add-cluster` コマンドを使用してクラスターを設定に追加します。

## 構文
<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]
```

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

### `cluster-id` パラメータを使用してクラスターを追加する
<a name="w2aac23c15c19b7c13b7b3b1"></a>

**Example**  
 `configure-cli add-cluster` とともに `cluster-id` パラメータを使用して、クラスター (`cluster-1234567` の ID) を設定に追加します。  

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

**ヒント**  
`configure-cli add-cluster` を `cluster-id` パラメータと一緒に使用してもクラスターが追加されない場合は、以下の例を参照して、追加するクラスターを識別するための `--region` と `--endpoint` パラメータも必要な、より長いバージョンのこのコマンドを参照してください。例えば、クラスターのリージョンが AWS CLI のデフォルトとして設定されているものと異なる場合、適切なリージョンを使用するように `--region` パラメータを使用する必要があります。さらに、呼び出しに使用する AWS CloudHSM API エンドポイントを指定することもできます。これは、デフォルトの DNS ホスト名を使用しない VPC インターフェイスエンドポイントを使用するなど、さまざまなネットワーク設定に必要な場合があります AWS CloudHSM。

### `cluster-id`、`endpoint`、および `region` パラメータを使用してクラスターを追加する
<a name="w2aac23c15c19b7c13b7b3b3"></a>

**Example**  
 `configure-cli add-cluster` とともに `cluster-id`、`endpoint`、`region` のパラメータを使用して、クラスター (`cluster-1234567` の ID) を設定に追加します。  

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

`--cluster-id`、`--region`、`--endpoint` パラメータの詳細については、[AWS CloudHSM クライアント SDK 5 設定パラメータ](configure-tool-params5.md)を参照してください。

## パラメータ
<a name="cloudhsm_cli-multi-cluster-add-cluster-parameters"></a>

**--cluster-id {{<Cluster ID>}}**  
 `DescribeClusters` を呼び出して、クラスターIDに関連付けられたクラスターのすべての HSM Elastic Network Interface（ENI）IPアドレスを検索します。システムは ENI IP アドレスを設定 AWS CloudHSM ファイルに追加します。  
パブリックインターネットにアクセスできない VPC 内の EC2 インスタンスから `--cluster-id`パラメータを使用する場合は、接続するインターフェイス VPC エンドポイントを作成する必要があります AWS CloudHSM。VPC エンドポイントの詳細については、「[AWS CloudHSM および VPC エンドポイント](cloudhsm-vpc-endpoint.md)」を参照してください。
必須: はい

**--endpoint {{<Endpoint>}}**  
`DescribeClusters` 呼び出しに使用する AWS CloudHSM API エンドポイントを指定します。このオプションは `--cluster-id` と組み合わせて設定する必要があります。  
必須: いいえ

**--hsm-ca-cert {{<HsmCA Certificate Filepath>}}**  
HSM CA 証明書ファイルへのファイルパスを指定します。  
必須: いいえ

**--region {{<Region>}}**  
クラスターのリージョンを指定します。このオプションは `--cluster-id` と組み合わせて設定する必要があります。  
この `--region` パラメータを指定しない場合、システムは `AWS_DEFAULT_REGION` または `AWS_REGION` の環境変数の読み取りを試みてリージョンを選択します。これらの変数が設定されていない場合、環境変数で別のファイルを指定しない限り、AWS Config (通常は `~/.aws/config`) のプロファイルに関連付けられたリージョンをチェックします`AWS_CONFIG_FILE`。いずれも設定されていない場合は、`us-east-1` デフォルトでリージョンが設定されます。  
必須: いいえ

**--client-cert-hsm-tls-file {{<クライアント証明書の hsm tls パス>}}**  
 TLS クライアントと HSM の相互認証に使用するクライアント証明書へのパス。  
 このオプションは、CloudHSM CLI で HSM に少なくとも 1 つのトラストアンカーを登録している場合にのみ使用します。このオプションは `--client-key-hsm-tls-file` と組み合わせて設定する必要があります。  
必須: いいえ

**--client-key-hsm-tls-file {{<クライアントキー hsm tls のパス＞}}**  
 TLS クライアントと HSM の相互認証に使用されるクライアントキーへのパス。  
 このオプションは、CloudHSM CLI で HSM に少なくとも 1 つのトラストアンカーを登録している場合にのみ使用します。このオプションは `--client-cert-hsm-tls-file` と組み合わせて設定する必要があります。  
必須: いいえ