ElastiCache for Valkey のノードベースクラスターは CreateCacheCluster ではなく CreateReplicationGroup で作る

JDBC Wrapper の Valkey キャッシュ検証で ElastiCache for Valkey のノードベースクラスターを作ろうとして嵌った。

Redis OSS と同じ感覚で create-cache-cluster を使ったらエラーになった。

Terminal

aws elasticache create-cache-cluster \
  --cache-cluster-id my-valkey \
  --engine valkey \
  --cache-node-type cache.t3.micro \
  --num-cache-nodes 1

Output

An error occurred (InvalidParameterValue) when calling the CreateCacheCluster
operation: This API doesn't support Valkey engine. Please use
CreateReplicationGroup API for Valkey cluster creation.

Valkey エンジンは単一ノードであっても create-replication-group が必要だ。

Terminal

aws elasticache create-replication-group \
  --replication-group-id my-valkey \
  --replication-group-description "Single node Valkey" \
  --engine valkey \
  --cache-node-type cache.t3.micro \
  --num-cache-clusters 1 \
  --no-transit-encryption-enabled

エラーメッセージが親切なので気づけるが、Redis OSS からの移行時やスクリプトの書き換え時に見落としやすい。