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

# シャードのレプリカの数を増やす
<a name="increase-replica-count"></a>

Valkey または Redis OSS (クラスターモードが有効) シャード、または Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループのレプリカ数を最大 5 個まで増やすことができます。これを行うには AWS マネジメントコンソール、 AWS CLI、、または ElastiCache API を使用します。

**Topics**
+ [の使用 AWS マネジメントコンソール](#increase-replica-count-con)
+ [の使用 AWS CLI](#increase-replica-count-cli)
+ [ElastiCache API の使用](#increase-replica-count-api)

## の使用 AWS マネジメントコンソール
<a name="increase-replica-count-con"></a>

次の手順では、コンソールを使用して、Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループのレプリカの数を増やします。

**シャードのレプリカの数を増やすには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) で ElastiCache コンソールを開きます。

1. ナビゲーションペインで、**[Valkey]** または **[Redis OSS]** を選択し、レプリカを追加するレプリケーショングループの名前を選択します。

1. レプリカを追加する各シャードのチェックボックスをオンにします

1. [**Add replicas (レプリカの追加)**] を選択します。

1. [**Add Replicas to Shards (シャードにレプリカを追加)**] ページを完了します。
   + [**New number of replicas/shard (シャード当たりの新しいレプリカ数)**] に、選択したすべてのシャードが持つようになるレプリカの数を入力します。この値は、[**Current Number of Replicas per shard (現在のシャード当たりのレプリカ数)**] 以上で、5 以下である必要があります。最小の実行として、レプリカを少なくとも 2 つにすることをお勧めします。
   + [**アベイラビリティーゾーン**] では、[**指定なし**] を選択して新しいレプリカごとにアベイラビリティーゾーンを ElastiCache が選択するようにするか、**アベイラビリティーゾーンの指定**] を選択して、新しいレプリカごとにアベイラビリティーゾーンを選択します。

     [**Specify Availability Zones (アベイラビリティーゾーンを指定する)**] を選択した場合、リストを使用して新しい各レプリカのアベイラビリティーゾーンを指定します。

1. [**Add (追加)**] を選択してレプリカを追加するか、[**Cancel (キャンセル)**] を選択してオペレーションをキャンセルします。

## の使用 AWS CLI
<a name="increase-replica-count-cli"></a>

Valkey または Redis OSS シャードでレプリカの数を増やすには、以下のパラメータを設定して `increase-replica-count` コマンドを使用します。
+ `--replication-group-id` – 必須。レプリカの数を増やすレプリケーショングループを指定します。
+ `--apply-immediately` または `--no-apply-immediately` – 必須。レプリカの数をすぐに増やすか (`--apply-immediately`)、次のメンテナンスウィンドウで増やすか (`--no-apply-immediately`) を指定します。現在、`--no-apply-immediately` はサポートされていません。
+ `--new-replica-count` - オプション。完了時のレプリカノードの数を、最大 5 個で指定します。1 つだけのノードグループまたは Valkey または Redis OSS (クラスターモードが有効) グループを持つ Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループの場合、またはすべてのノードグループでレプリカの数を同じにしたい場合、このパラメータを使用します。この値がノードグループの現在のレプリカの数より大きくない場合、呼び出しは失敗し、例外が発生します。
+ `--replica-configuration` - オプション。各ノードグループのレプリカの数およびアベイラビリティーゾーンを個別に設定できます。各ノードグループを個別に設定する Valkey または Redis OSS (クラスターモードが有効) グループで、このパラメータを使用します。

  `--replica-configuration` には 3 つのオプションのメンバーがあります。
  + `NodeGroupId` – 設定するノードグループの 4 桁の ID。Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループでは、シャード ID は常に `0001` です。Valkey または Redis OSS (クラスターモードが有効) ノードグループの (シャードの) ID を見つけるには、「[シャードの ID を見つける](Shards.md#shard-find-id)」を参照してください。
  + `NewReplicaCount` – このノードグループの、このオペレーションの最後のレプリカの数。この値は、最大 5 で、現在のレプリカの数より大きくなければなりません。この値がノードグループの現在のレプリカの数より大きくない場合、呼び出しは失敗し、例外が発生します。
  + `PreferredAvailabilityZones` – レプリケーショングループのノードが存在するアベイラビリティーゾーンを指定する `PreferredAvailabilityZone` 文字列のリスト。`PreferredAvailabilityZone` 値の数は、プライマリノードに対応する `NewReplicaCount` に 1 を足した数と等しい必要があります。`--replica-configuration` のこのメンバーを省略すると、ElastiCache for Redis OSS は新しいレプリカごとにアベイラビリティーゾーンを選択します。

**重要**  
呼び出しに、`--new-replica-count` または `--replica-configuration` パラメータのいずれかを含める必要がありますが、両方を含めることはできません。

**Example**  
次の例では、`sample-repl-group` レプリケーショングループでレプリカの数を 3 個に増やします。この例が終了すると、各ノードグループのレプリカは 3 個になります。この数は、単一のノードグループがある Valkey または Redis OSS (クラスターモードが無効) グループ、または、複数のノードグループがある Valkey または Redis OSS (クラスターモードが有効) グループのどちらにも適用されます。  
Linux、macOS、Unix の場合:  

```
aws elasticache increase-replica-count \
    --replication-group-id {{sample-repl-group}} \
    --new-replica-count {{3}} \
    --apply-immediately
```
Windows の場合:  

```
aws elasticache increase-replica-count ^
    --replication-group-id {{sample-repl-group}} ^
    --new-replica-count {{3}} ^
    --apply-immediately
```
次の例では、`sample-repl-group` レプリケーショングループで、レプリカの数を、2 つの指定されたノードグループの指定値に増やします。複数のノードグループがある場合、これは Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループです。オプションの `PreferredAvailabilityZones` を指定する場合、リストされているアベイラビリティーゾーンの数は、`NewReplicaCount` に 1 以上を足した値と等しい必要があります。このアプローチは、`NodeGroupId` で指定されるグループのプライマリノードに対応します。  
Linux、macOS、Unix の場合:  

```
aws elasticache increase-replica-count \
    --replication-group-id {{sample-repl-group}} \
    --replica-configuration \
        NodeGroupId={{0001}},NewReplicaCount={{2}},PreferredAvailabilityZones={{us-east-1a}},{{us-east-1c}},{{us-east-1b}} \
        NodeGroupId={{0003}},NewReplicaCount={{3}},PreferredAvailabilityZones={{us-east-1a}},{{us-east-1b}},{{us-east-1c}},{{us-east-1c}} \
    --apply-immediately
```
Windows の場合:  

```
aws elasticache increase-replica-count ^
    --replication-group-id {{sample-repl-group}} ^
    --replica-configuration ^
        NodeGroupId={{0001}},NewReplicaCount={{2}},PreferredAvailabilityZones={{us-east-1a}},{{us-east-1c}},{{us-east-1b}} ^
        NodeGroupId={{0003}},NewReplicaCount={{3}},PreferredAvailabilityZones={{us-east-1a}},{{us-east-1b}},{{us-east-1c}},{{us-east-1c}} \
    --apply-immediately
```

CLI を使用したレプリカの数を増やす詳細については、*Amazon ElastiCache コマンドラインリファレンス*の「[increase-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html)」を参照してください。

## ElastiCache API の使用
<a name="increase-replica-count-api"></a>

Valkey または Redis OSS シャードでレプリカの数を増やすには、以下のパラメータを設定して `IncreaseReplicaCount` アクションを使用します。
+ `ReplicationGroupId` – 必須。レプリカの数を増やすレプリケーショングループを指定します。
+ `ApplyImmediately` – 必須。レプリカの数をすぐに増やすか (`ApplyImmediately=True`)、次のメンテナンスウィンドウで増やすか (`ApplyImmediately=False`) を指定します。現在、`ApplyImmediately=False` はサポートされていません。
+ `NewReplicaCount` - オプション。完了時のレプリカノードの数を、最大 5 個で指定します。ノードグループが 1 つだけある Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループの場合、または Valkey または Redis OSS (クラスターモードが有効) グループですべてのノードグループのレプリカの数を同じにしたい場合、このパラメータを使用します。この値がノードグループの現在のレプリカの数より大きくない場合、呼び出しは失敗し、例外が発生します。
+ `ReplicaConfiguration` - オプション。各ノードグループのレプリカの数およびアベイラビリティーゾーンを個別に設定できます。各ノードグループを個別に設定する Valkey または Redis OSS (クラスターモードが有効) グループで、このパラメータを使用します。

  `ReplicaConfiguraion` には 3 つのオプションのメンバーがあります。
  + `NodeGroupId` – 設定するノードグループの 4 桁の ID。Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループでは、ノードグループ (シャード) ID は常に `0001` です。Valkey または Redis OSS (クラスターモードが有効) ノードグループの (シャードの) ID を見つけるには、「[シャードの ID を見つける](Shards.md#shard-find-id)」を参照してください。
  + `NewReplicaCount` – このノードグループの、このオペレーションの最後のレプリカの数。この値は、最大 5 で、現在のレプリカの数より大きくなければなりません。この値がノードグループの現在のレプリカの数より大きくない場合、呼び出しは失敗し、例外が発生します。
  + `PreferredAvailabilityZones` – レプリケーショングループのノードが存在するアベイラビリティーゾーンを指定する `PreferredAvailabilityZone` 文字列のリスト。`PreferredAvailabilityZone` 値の数は、プライマリノードに対応する `NewReplicaCount` に 1 を足した数と等しい必要があります。`ReplicaConfiguration` のこのメンバーを省略すると、ElastiCache for Redis OSS は新しいレプリカごとにアベイラビリティーゾーンを選択します。

**重要**  
呼び出しに、`NewReplicaCount` または `ReplicaConfiguration` パラメータのいずれかを含める必要がありますが、両方を含めることはできません。

**Example**  
次の例では、`sample-repl-group` レプリケーショングループでレプリカの数を 3 個に増やします。この例が終了すると、各ノードグループのレプリカは 3 個になります。この数は、単一のノードグループがある Valkey または Redis OSS (クラスターモードが無効) グループ、または、複数のノードグループがある Valkey または Redis OSS (クラスターモードが有効) グループのどちらにも適用されます。  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=3
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```
次の例では、`sample-repl-group` レプリケーショングループで、レプリカの数を、2 つの指定されたノードグループの指定値に増やします。複数のノードグループがある場合、これは Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループです。オプションの `PreferredAvailabilityZones` を指定する場合、リストされているアベイラビリティーゾーンの数は、`NewReplicaCount` に 1 以上を足した値と等しい必要があります。このアプローチは、`NodeGroupId` で指定されるグループのプライマリノードに対応します。  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=3
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```

API を使用したレプリカの数を増やす詳細については、*Amazon ElastiCache API リファレンス*の「[IncreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html)」を参照してください。