Uso de almacenes de datos globales (CLI) - Amazon ElastiCache
Descarga y configuración de la AWS CLIUso de la AWS CLI con almacenes de datos globales

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de almacenes de datos globales (CLI)

Puede usar la AWS Command Line Interface (AWS CLI) para controlar varios servicios de AWS desde la línea de comandos y automatizarlos mediante scripts. Puede utilizar la AWS CLI para operaciones ad hoc (únicas).

Descarga y configuración de la AWS CLI

La AWS CLI se ejecuta en Windows, macOS o Linux. Utilice el siguiente procedimiento para descargarlo y configurarlo.

Para descargar, instalar y configurar la CLI

  1. Descargue la CLI de AWS en la página web de Interfaz de línea de comandos de AWS.

  2. Siga las instrucciones para instalar la AWS CLI y configurar la AWS CLI en la Guía del usuario de la AWS Command Line Interface.

Uso de la AWS CLI con almacenes de datos globales

Utilice las siguientes operaciones de la CLI para trabajar con almacenes de datos globales:

  • 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 ElastiCache aplica de forma automática un prefijo al ID de almacén de datos global en el momento de la creación. Cada región de AWS tiene su propio prefijo. Por ejemplo, un ID de almacén de datos global creado en la región de oeste de EE. UU. (Norte de California) comienza con “virxk” junto con el nombre del sufijo que proporcione. El sufijo, en conjunto con el prefijo autogenerado, garantiza la exclusividad del nombre del almacén de datos global en varias regiones.

    En la siguiente tabla se enumera cada región de AWS y su prefijo de ID de almacén de datos global.

    Nombre de la región/Región Prefix

    Región del Este de EE. UU. (Ohio)

    us-east-2

    fpkhr

    Región del Este de EE. UU (Norte de Virginia)

    us-east-1

    ldgnf

    Región del Oeste de EE. UU (Norte de California)

    us-west-1

    virxk

    Región del Oeste de EE. UU (Oregón)

    us-west-2

    sgaui

    Región de Canadá (centro)

    ca-central-1

    bxodz

    Región de Asia-Pacífico (Bombay)

    ap-south-1

    erpgt

    Asia Pacífico (Tokio)

    ap-northeast-1

    quwsw

    Región de Asia-Pacífico (Seúl)

    ap-northeast-2

    lfqnh

    Región Asia-Pacífico (Osaka)

    ap-northeast-3

    nlapn

    Región de Asia-Pacífico (Singapur)

    ap-southeast-1

    vlqxn

    Región de Asia-Pacífico (Sídney)

    ap-southeast-2

    vbgxd

    Región de Europa (Fráncfort)

    eu-central-1

    iudkw

    Región de Europa (Irlanda)

    eu-west-1

    gxeiz

    Región de Europa (Londres)

    eu-west-2

    okuqm

    Región EU (París)

    eu-west-3

    fgjhi

    Región de América del Sur (São Paulo)

    sa-east-1

    juxlw

    Región China (Pekín)

    cn-north-1

    emvgo

    Región China (Ningxia)

    cn-northwest-1

    ckbem

    Región de Asia-Pacífico (Hong Kong)

    ap-east-1

    knjmp

    AWS GovCloud (Oeste de EE. UU.)

    us-gov-west-1

    		 sgwui

  • create-replication-group: utilice esta operación con el fin de crear clústeres secundarios para un almacén de datos global al proporcionar el nombre del almacén de datos global al 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

    Al llamar a esta operación y pasar un valor de --global-replication-group-id, ElastiCache deducirá los valores del grupo de replicación principal del grupo de replicación global para los siguientes parámetros. No ingrese valores para estos 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

    Actualización entre motores de Redis OSS a Valkey para GlobalDataStore de ElastiCache

    Puede actualizar un grupo de replicación global de Redis OSS existente en Valkey mediante la consola, la API o la CLI.

    Si ya tiene un grupo de replicación global de Redis OSS, puede actualizarlo a Valkey especificando el nuevo motor y la versión del motor con la API modify-global-replication-group.

    Para Linux, macOS o 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

    Si tiene un grupo de parámetros de caché personalizado aplicado al grupo de replicación global de Redis OSS existente que desea actualizar, también tendrá que incluir un grupo de parámetros de caché de Valkey personalizado en la solicitud. El grupo de parámetros personalizados de Valkey de entrada debe tener los mismos valores de parámetros estáticos de Redis OSS que el grupo de parámetros personalizados de Redis OSS existente.

    Para Linux, macOS o 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-replication-group

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

Utilice la ayuda para mostrar todos los comandos disponibles de ElastiCache para Valkey o Redis OSS.

aws elasticache help

También puede utilizar la ayuda para describir un comando específico y obtener más información sobre su uso: 

aws elasticache create-global-replication-group help