シャードのレプリカの数を増やす - Amazon ElastiCache

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

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

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

の使用 AWS Management Console

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

シャードのレプリカの数を増やすには
  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/elasticache/ で ElastiCache コンソールを開きます。

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

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

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

  5. [Add Replicas to Shards (シャードにレプリカを追加)] ページを完了します。

    • [New number of replicas/shard (シャード当たりの新しいレプリカ数)] に、選択したすべてのシャードが持つようになるレプリカの数を入力します。この値は、[Current Number of Replicas per shard (現在のシャード当たりのレプリカ数)] 以上で、5 以下である必要があります。最小の実行として、レプリカを少なくとも 2 つにすることをお勧めします。

    • [アベイラビリティーゾーン] では、[指定なし] を選択して新しいレプリカごとにアベイラビリティーゾーンを ElastiCache が選択するようにするか、アベイラビリティーゾーンの指定] を選択して、新しいレプリカごとにアベイラビリティーゾーンを選択します。

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

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

の使用 AWS CLI

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 を見つける」を参照してください。

    • NewReplicaCount – このノードグループの、このオペレーションの最後のレプリカの数。この値は、最大 5 で、現在のレプリカの数より大きくなければなりません。この値がノードグループの現在のレプリカの数より大きくない場合、呼び出しは失敗し、例外が発生します。

    • PreferredAvailabilityZones – レプリケーショングループのノードが存在するアベイラビリティーゾーンを指定する PreferredAvailabilityZone 文字列のリスト。PreferredAvailabilityZone 値の数は、プライマリノードに対応する NewReplicaCount に 1 を足した数と等しい必要があります。のこのメンバー--replica-configurationを省略すると、ElastiCache for Redis OSS は新しいレプリカごとにアベイラビリティーゾーンを選択します。

重要

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

次の例では、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」を参照してください。

ElastiCache API の使用

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 を見つける」を参照してください。

    • NewReplicaCount – このノードグループの、このオペレーションの最後のレプリカの数。この値は、最大 5 で、現在のレプリカの数より大きくなければなりません。この値がノードグループの現在のレプリカの数より大きくない場合、呼び出しは失敗し、例外が発生します。

    • PreferredAvailabilityZones – レプリケーショングループのノードが存在するアベイラビリティーゾーンを指定する PreferredAvailabilityZone 文字列のリスト。PreferredAvailabilityZone 値の数は、プライマリノードに対応する NewReplicaCount に 1 を足した数と等しい必要があります。のこのメンバーReplicaConfigurationを省略すると、ElastiCache for Redis OSS は新しいレプリカごとにアベイラビリティーゾーンを選択します。

重要

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

次の例では、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」を参照してください。