グローバルデータストアの使用 (CLI） - Amazon ElastiCache
のダウンロードと設定 AWS CLIグローバルデータストアでの AWS CLIの使用

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

グローバルデータストアの使用 (CLI）

AWS Command Line Interface （AWS CLI) を使用して、コマンドラインから複数の AWS サービスを制御し、スクリプトを使用して自動化できます。は AWS CLI、アドホック (1 回限り) オペレーションに使用できます。

のダウンロードと設定 AWS CLI

は Windows、macOSまたは Linux で AWS CLI 実行されます。これをダウンロードして設定するには、次の手順に従います。

をダウンロード、インストール、設定するには CLI

  1. AWS コマンドラインインターフェイスウェブページで AWS CLIをダウンロードします。

  2. AWS Command Line Interface ユーザーガイドの AWS CLI「 のインストール」および AWS 「 の設定CLI」の手順に従います。

グローバルデータストアでの AWS CLIの使用

グローバルデータストアを操作するには、次のCLIオペレーションを使用します。

  • create-global-replication-group

    aws elasticache create-global-replication-group \
   --global-replication-group-id-suffix my global datastore  \
   --primary-replication-group-id sample-repl-group  \
   --global-replication-group-description an optional description of the global datastore

    Amazon は、作成時にグローバルデータストア ID にプレフィックス ElastiCache を自動的に適用します。各 AWS リージョンには独自のプレフィックスがあります。例えば、米国西部 (北カルフォルニア) リージョンで作成された Global Datastore ID は、指定したサフィックス名と共に「virxk」で始まります。サフィックスは、自動生成されたプレフィックスと組み合わされて、複数のリージョンにまたがるグローバルデータストア名の一意性を保証します。

    次の表に、各 AWS リージョンとそのグローバルデータストア ID プレフィックスを示します。

    リージョン名/リージョン プレフィックス

    米国東部 (オハイオ) リージョン

    us-east-2

    fpkhr

    米国東部(バージニア州北部) リージョン

    us-east-1

    ldgnf

    US West (N. California) Region

    us-west-1

    virxk

    米国西部 (オレゴン) リージョン

    us-west-2

    sgaui

    カナダ (中部) リージョン

    ca-central-1

    bxodz

    アジアパシフィック (ムンバイ) リージョン

    ap-south-1

    erpgt

    アジアパシフィック (東京) リージョン

    ap-northeast-1

    quwsw

    アジアパシフィック (ソウル) リージョン

    ap-northeast-2

    lfqnh

    アジアパシフィック（大阪）リージョン

    ap-northeast-3

    nlapn

    アジアパシフィック (シンガポール) リージョン

    ap-southeast-1

    vlqxn

    アジアパシフィック (シドニー) リージョン

    ap-southeast-2

    vbgxd

    欧州 (フランクフルト) リージョン

    eu-central-1

    iudkw

    欧州 (アイルランド) リージョン

    eu-west-1

    gxeiz

    欧州 (ロンドン) リージョン

    eu-west-2

    okuqm

    EU (パリ) リージョン

    eu-west-3

    fgjhi

    南米 (サンパウロ) リージョン

    sa-east-1

    juxlw

    中国 (北京) リージョン

    cn-north-1

    emvgo

    中国 (寧夏) リージョン

    cn-northwest-1

    ckbem

    アジアパシフィック (香港) リージョン

    ap-east-1

    knjmp

    AWS GovCloud （米国西部）

    us-gov-west-1

    		 sgwui

  • create-replication-group – このオペレーションを使用して、グローバルデータストアの名前を --global-replication-group-idパラメータに指定して、グローバルデータストアのセカンダリクラスターを作成します。

    aws elasticache create-replication-group \
  --replication-group-id secondary replication group name \
  --replication-group-description “Replication group description" \
  --global-replication-group-id global datastore name

    このオペレーションを呼び出して--global-replication-group-id値を渡すと、 ElastiCache は、次のパラメータの グローバルレプリケーショングループのプライマリレプリケーショングループから値を推測します。これらのパラメータには値を渡さないでください。

    "PrimaryClusterId",

    "AutomaticFailoverEnabled",

    "NumNodeGroups",

    "CacheParameterGroupName",

    "CacheNodeType",

    "Engine",

    "EngineVersion",

    "CacheSecurityGroupNames",

    "EnableTransitEncryption",

    "AtRestEncryptionEnabled",

    "SnapshotArns",

    "SnapshotName"

  • describe-global-replication-groups

    aws elasticache describe-global-replication-groups \
   --global-replication-group-id my global datastore  \
   --show-member-info an optional parameter that returns a list of the primary and secondary clusters that make up the global datastore

  • modify-global-replication-group

    aws elasticache modify-global-replication-group \
   --global-replication-group-id my global datastore  \
   --automatic-failover-enabled \
   --cache-node-type node type \
   --cache-parameter-group-name parameter group name \ 
   --engine-version engine version \
   -—apply-immediately \
   --global-replication-group-description description

    の Redis から OSS Valkey クロスエンジンへのアップグレード ElastiCache GlobalDataStore

    コンソールAPIまたは を使用して、既存の Redis OSS グローバルレプリケーショングループを Valkey エンジンにアップグレードできますCLI。

    既存の Redis OSS グローバルレプリケーショングループがある場合は、 で modify-global-replication-group新しいエンジンとエンジンバージョンを指定することで、Valkey にアップグレードできますAPI。

    Linux、macOS、Unix の場合:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --apply-immediately \
   --engine-version 7.2

    Windows の場合:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --apply-immediately ^
   --engine-version 7.2

    アップグレードする既存の Redis OSS グローバルレプリケーショングループに適用されたカスタムキャッシュパラメータグループがある場合は、リクエストでカスタム Valkey キャッシュパラメータグループも渡す必要があります。入力 Valkey カスタムパラメータグループには、既存の Redis OSSカスタムパラメータグループと同じ Redis OSS静的パラメータ値が必要です。

    Linux、macOS、Unix の場合:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --engine-version 7.2 \
   --apply-immediately \
   --cache-parameter-group-name myParamGroup

    Windows の場合:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --engine-version 7.2 ^
   --apply-immediately ^
   --cache-parameter-group-name myParamGroup

  • delete-global-replication-group

    aws elasticache delete-global-replication-group \
   --global-replication-group-id my global datastore  \
   --retain-primary-replication-group defaults to true

  • disassociate-global-replication-group

    aws elasticache disassociate-global-replication-group \
   --global-replication-group-id my global datastore  \
   --replication-group-id my secondary cluster  \
   --replication-group-region the AWS Region in which the secondary cluster resides

  • failover-global-replication-group

    aws elasticache failover-replication-group \
   --global-replication-group-id my global datastore \
   --primary-region The AWS Region of the primary cluster \  
   --primary-replication-group-id  The name of the global datastore, including the suffix.

  • increase-node-groups-in-global-replication-group

    aws elasticache increase-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • decrease-node-groups-in-global-replication-group

    aws elasticache decrease-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • rebalance-shards-in-global-レプリケーショングループ

    aws elasticache rebalance-shards-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name

Valkey または Redis ElastiCache で で使用できるすべてのコマンドを一覧表示するには、ヘルプを使用しますOSS。

aws elasticache help

また、ヘルプを使用して、特定コマンドを記述したり、その用法の詳細を確認したりすることもできます。

aws elasticache create-global-replication-group help