Uso de almacenes de datos globales (CLI) - Amazon ElastiCache
Descargar y configurar el 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 AWS Command Line Interface (AWS CLI) para controlar varios AWS servicios desde la línea de comandos y automatizarlos mediante scripts. Puede usar la AWS CLI para operaciones ad hoc (únicas).

Descargar y configurar el AWS CLI

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

Para descargar, instalar y configurar la CLI

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

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

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 aplica ElastiCache automáticamente un prefijo al ID del almacén de datos global cuando se crea. Cada AWS región 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 muestra cada AWS región y su prefijo de ID de almacén de datos global.

    Nombre de la región/Región Prefijo

    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 (EE. UU.-Oeste)

    us-gov-west-1

    		 sgwui

  • create-replication-group— Utilice esta operación para crear clústeres secundarios para un almacén de datos global proporcionando 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 --global-replication-group-id valor, 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 multimotor de Redis a OSS Valkey para ElastiCache GlobalDataStore

    Puede actualizar un grupo de replicación global de Redis OSS existente a 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-grupo de replicación

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

Utilice la ayuda para enumerar todos los comandos disponibles 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