Usando armazenamentos de dados globais () CLI - Amazon ElastiCache
Baixando e configurando o AWS CLIUsando o AWS CLI com datastores globais

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando armazenamentos de dados globais () CLI

Você pode usar o AWS Command Line Interface (AWS CLI) para controlar vários AWS serviços na linha de comando e automatizá-los por meio de scripts. Você pode usar o AWS CLI para operações ad hoc (únicas).

Baixando e configurando o AWS CLI

AWS CLI É executado em Windows, macOS ou Linux. Use o procedimento a seguir para fazer download e configurá-la.

Para baixar, instalar e configurar o CLI

  1. Faça o download da AWS CLI página da web na interface da linha de AWS comando.

  2. Siga as instruções para instalar AWS CLI e configurar o AWS CLI no Guia do AWS Command Line Interface usuário.

Usando o AWS CLI com datastores globais

Use as seguintes CLI operações para trabalhar com armazenamentos de dados globais:

  • 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

    A Amazon aplica ElastiCache automaticamente um prefixo ao ID global do armazenamento de dados quando ele é criado. Cada AWS região tem seu próprio prefixo. Por exemplo, um ID de datastore global criado na região Oeste dos EUA (Norte da Califórnia) começa com "virxk" junto com o nome do sufixo fornecido. O sufixo, combinado com o prefixo gerado automaticamente, garante a exclusividade do nome do datastore global em várias regiões.

    A tabela a seguir lista cada AWS região e seu prefixo de ID de armazenamento de dados global.

    Nome da região/região Prefixo

    Região Leste dos EUA (Ohio)

    us-east-2

    fpkhr

    Região Leste dos EUA (Norte da Virgínia)

    us-east-1

    ldgnf

    Região Oeste dos EUA (Norte da Califórnia)

    us-west-1

    virxk

    Região Oeste dos EUA (Oregon)

    us-west-2

    sgaui

    Região Canadá (Central)

    ca-central-1

    bxodz

    Região Ásia-Pacífico (Mumbai)

    ap-south-1

    erpgt

    Região Ásia-Pacífico (Tóquio)

    ap-northeast-1

    quwsw

    Região Ásia-Pacífico (Seul)

    ap-northeast-2

    lfqnh

    Região Ásia-Pacífico (Osaka)

    ap-northeast-3

    nlapn

    Região Ásia-Pacífico (Singapura)

    ap-southeast-1

    vlqxn

    Região Ásia-Pacífico (Sydney)

    ap-southeast-2

    vbgxd

    Região Europa (Frankfurt)

    eu-central-1

    iudkw

    Região Europa (Irlanda)

    eu-west-1

    gxeiz

    Região Europa (Londres)

    eu-west-2

    okuqm

    Região Europa (Paris)

    eu-west-3

    fgjhi

    Região América do Sul (São Paulo)

    sa-east-1

    juxlw

    Região da China (Pequim)

    cn-north-1

    emvgo

    Região da China (Ningxia)

    cn-northwest-1

    ckbem

    Região Ásia-Pacífico (Hong Kong)

    ap-east-1

    knjmp

    AWS GovCloud (Oeste dos EUA)

    us-gov-west-1

    		 sgwui

  • create-replication-group— use essa operação para criar clusters secundários para um armazenamento de dados global fornecendo o nome do armazenamento de dados global ao parâmetro. --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

    Ao chamar essa operação e passar um --global-replication-group-id valor, ElastiCache inferirá os valores do grupo de replicação principal do grupo de replicação global para os seguintes parâmetros. Não passe valores para estes parâmetros:

    "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

    Atualização cruzada de Redis para OSS Valkey para ElastiCache GlobalDataStore

    Você pode atualizar um grupo de replicação OSS global existente do Redis para o Valkey usando o console ou. API CLI

    Se você tiver um grupo de replicação OSS global do Redis existente, poderá fazer o upgrade para o Valkey especificando o novo mecanismo e a versão do mecanismo com. modify-global-replication-group API

    Para Linux, macOS ou Unix:

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

    Para Windows:

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

    Se você tiver um grupo de parâmetros de cache personalizado aplicado ao grupo de replicação OSS global existente do Redis que deseja atualizar, também precisará passar um grupo de parâmetros de cache Valkey personalizado na solicitação. O grupo de parâmetros personalizados Valkey de entrada deve ter os mesmos valores de parâmetros OSS estáticos do Redis que o grupo de parâmetros OSS personalizados do Redis existente.

    Para Linux, macOS ou Unix:

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

    Para Windows:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --engine-version 8.0 ^
   --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-grupo de replicação

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

Use a ajuda para listar todos os comandos disponíveis ElastiCache para Valkey ou RedisOSS.

aws elasticache help

Você também pode usar a ajuda para descrever um comando específico e saber mais sobre seu uso: 

aws elasticache create-global-replication-group help