シャードのレプリカの数を減らす - Amazon ElastiCache
の使用 AWS Management Consoleの使用 AWS CLIElastiCache API の使用

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

シャードのレプリカの数を減らす

Valkey または Redis OSS (クラスターモードが有効) のシャード、または Valkey または Redis OSS (クラスターモードが無効) のレプリケーショングループのレプリカ数を減らすことができます。

  • Valkey または Redis OSS (クラスターモードが無効) のレプリカ数は、マルチ AZ が有効な場合は 1 まで減らし、マルチ AZ が有効でない場合はゼロまで減らすことができます。

  • Valkey または Redis OSS (クラスターモードが有効) のレプリカ数はゼロまで減らすことができます。ただし、プライマリノードが失敗した場合はレプリカにフェイルオーバーできません。

AWS Management Console、、 AWS CLI または ElastiCache API を使用して、ノードグループ (シャード) またはレプリケーショングループのレプリカの数を減らすことができます。

の使用 AWS Management Console

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

Valkey または Redis OSS シャードのレプリカの数を減らすには

  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/elasticache/ で ElastiCache コンソールを開きます。

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

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

  4. [Delete replicas (レプリカの削除)] を選択します。

  5. [Delete Replicas from Shards (シャードからのレプリカの削除)] ページを完了します。

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

    2. [Delete (削除)] を選択してレプリカを削除するか、[Cancel (キャンセル)] を選択してオペレーションをキャンセルします。

重要

  • 削除するレプリカノードを指定しない場合、ElastiCache for Redis OSS は削除対象のレプリカノードを自動的に選択します。その間、ElastiCache for Redis OSS はレプリケーショングループのマルチ AZ アーキテクチャを保持し、プライマリでレプリケーションラグを最小限に抑えながらレプリカを保持しようとします。

  • プライマリまたはレプリケーショングループ内のプライマリノードを削除することはできません。プライマリノードを削除するように指定すると、オペレーションは失敗し、プライマリノードが削除のために選択されたことを示すエラーイベントが示されます。

の使用 AWS CLI

Valkey または Redis OSS シャードでレプリカの数を減らすには、以下のパラメータを設定して decrease-replica-count コマンドを使用します。

  • --replication-group-id – 必須。レプリカの数を減らすレプリケーショングループを指定します。

  • --apply-immediately または --no-apply-immediately – 必須。レプリカの数をすぐに減らすか (--apply-immediately)、次のメンテナンスウィンドウで減らすか (--no-apply-immediately) を指定します。現在、--no-apply-immediately はサポートされていません。

  • --new-replica-count - オプション。レプリカノードの数を指定します。--new-replica-count の値は、ノードグループの現在のレプリカの数よりも小さい有効な値である必要があります。最小許容値については、「シャードのレプリカの数を減らす」を参照してください。--new-replica-count の値がこの要件を満たさない場合、呼び出しは失敗します。

  • --replicas-to-remove - オプション。削除するレプリカノードを指定するノード ID のリストが含まれます。

  • --replica-configuration - オプション。各ノードグループのレプリカの数およびアベイラビリティーゾーンを個別に設定できます。各ノードグループを個別に設定する Valkey または Redis OSS (クラスターモードが有効) グループで、このパラメータを使用します。

    --replica-configuration には 3 つのオプションのメンバーがあります。

    • NodeGroupId – 設定するノードグループの 4 桁の ID。Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループでは、シャード ID は常に 0001 です。Valkey または Redis OSS (クラスターモードが有効) ノードグループの (シャードの) ID を見つけるには、「シャードの ID を見つける」を参照してください。

    • NewReplicaCount – レプリカノードの数を指定するオプションのパラメータ。NewReplicaCount の値は、ノードグループの現在のレプリカの数よりも小さい有効な値である必要があります。最小許容値については、「シャードのレプリカの数を減らす」を参照してください。NewReplicaCount の値がこの要件を満たさない場合、呼び出しは失敗します。

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

重要

--new-replica-count、--replicas-to-remove、または --replica-configuration パラメータのいずれか 1 つのみを含める必要があります。

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

Linux、macOS、Unix の場合:

aws elasticache decrease-replica-count
    --replication-group-id sample-repl-group \
    --new-replica-count 1 \
    --apply-immediately

Windows の場合:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 1 ^
    --apply-immediately

次の例では、ノードグループから 2 つの指定されたレプリカ (0001 と 0003) を削除して、sample-repl-group レプリケーショングループのレプリカの数を減らします。

Linux、macOS、Unix の場合:

aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replicas-to-remove 0001,0003 \
    --apply-immediately

Windows の場合:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replicas-to-remove 0001,0003 \
    --apply-immediately

次の例では、--replica-configuration を使用して、sample-repl-group レプリケーショングループで、レプリカの数を、2 つの指定されたノードグループの指定値に減らします。複数のノードグループがある場合、これは Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループです。オプションの PreferredAvailabilityZones を指定する場合、リストされているアベイラビリティーゾーンの数は、NewReplicaCount に 1 以上を足した値と等しい必要があります。このアプローチは、NodeGroupId で指定されるグループのプライマリノードに対応します。

Linux、macOS、Unix の場合:

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

Windows の場合:

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

CLI を使用したレプリカの数を減らす詳細については、Amazon ElastiCache コマンドラインリファレンスの「decrease-replica-count」を参照してください。

ElastiCache API の使用

Valkey または Redis OSS シャードでレプリカの数を減らすには、以下のパラメータを設定して DecreaseReplicaCount アクションを使用します。

  • ReplicationGroupId – 必須。レプリカの数を減らすレプリケーショングループを指定します。

  • ApplyImmediately – 必須。レプリカの数をすぐに減らすか (ApplyImmediately=True)、次のメンテナンスウィンドウで減らすか (ApplyImmediately=False) を指定します。現在、ApplyImmediately=False はサポートされていません。

  • NewReplicaCount - オプション。レプリカノードの数を指定します。NewReplicaCount の値は、ノードグループの現在のレプリカの数よりも小さい有効な値である必要があります。最小許容値については、「シャードのレプリカの数を減らす」を参照してください。--new-replica-count の値がこの要件を満たさない場合、呼び出しは失敗します。

  • ReplicasToRemove - オプション。削除するレプリカノードを指定するノード ID のリストが含まれます。

  • ReplicaConfiguration - オプション。各ノードグループのレプリカの数およびアベイラビリティーゾーンを個別に設定するノードグループのリストが含まれます。各ノードグループを個別に設定する Valkey または Redis OSS (クラスターモードが有効) グループで、このパラメータを使用します。

    ReplicaConfiguraion には 3 つのオプションのメンバーがあります。

    • NodeGroupId – 設定するノードグループの 4 桁の ID。Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループでは、ノードグループ ID は常に 0001 です。Valkey または Redis OSS (クラスターモードが有効) ノードグループの (シャードの) ID を見つけるには、「シャードの ID を見つける」を参照してください。

    • NewReplicaCount – このノードグループの、このオペレーションの最後のレプリカの数。この値は、現在のレプリカの数よりも小さくし、マルチ AZ が有効な場合は最小 1、自動フェイルオーバーを備えたマルチ AZ が有効でない場合は最小 0 にする必要があります。この値がノードグループの現在のレプリカの数より小さくない場合、呼び出しは失敗し、例外が発生します。

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

重要

NewReplicaCount、ReplicasToRemove、または ReplicaConfiguration パラメータのいずれか 1 つのみを含める必要があります。

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

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=1
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

次の例では、ノードグループから 2 つの指定されたレプリカ (0001 と 0003) を削除して、sample-repl-group レプリケーショングループのレプリカの数を減らします。

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicasToRemove.ReplicaToRemove.1=0001
      &ReplicasToRemove.ReplicaToRemove.2=0003
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

次の例では、ReplicaConfiguration を使用して、sample-repl-group レプリケーショングループで、レプリカの数を、2 つの指定されたノードグループの指定値に減らします。複数のノードグループがある場合、これは Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループです。オプションの PreferredAvailabilityZones を指定する場合、リストされているアベイラビリティーゾーンの数は、NewReplicaCount に 1 以上を足した値と等しい必要があります。このアプローチは、NodeGroupId で指定されるグループのプライマリノードに対応します。

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=1
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &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 リファレンスの「DecreaseReplicaCount」を参照してください。