Cambio del número de réplicas
Puede aumentar o disminuir dinámicamente el número de réplicas de lectura del clúster de MemoryDB mediante la AWS Management Console, la AWS CLI o la API de MemoryDB. Todas las particiones deben tener el mismo número de réplicas.
Aumento del número de réplicas de un clúster
Puede aumentar el número de réplicas de un clúster de MemoryDB hasta un máximo de cinco por partición. Para ello, utilice la AWS Management Console, la AWS CLI o la API de MemoryDB.
Uso de la AWS Management Console
Para aumentar el número de réplicas en un clúster de MemoryDB (consola), consulte Agregar/eliminar nodos de un clúster.
Uso de la AWS CLI
Para aumentar el número de réplicas de un clúster de MemoryDB, utilice el comando update-cluster con los parámetros siguientes:
-
--cluster-name: obligatorio. Identifica el clúster en el que desea aumentar el número de réplicas. -
--replica-configuration: obligatorio. Le permite establecer el número de réplicas. Para aumentar el número de réplicas, establezca la propiedadReplicaCounten el número de réplicas que desea incluir en la partición al final de la operación.
En el siguiente ejemplo, se aumenta el número de réplicas del clúster my-cluster a 2.
Para Linux, macOS o Unix:
aws memorydb update-cluster \ --cluster-name my-cluster \ --replica-configuration \ ReplicaCount=2
Para Windows:
aws memorydb update-cluster ^ --cluster-name my-cluster ^ --replica-configuration ^ ReplicaCount=2
Devuelve la siguiente respuesta JSON:
{ "Cluster": { "Name": "my-cluster", "Status": "updating", "NumberOfShards": 1, "ClusterEndpoint": { "Address":"clustercfg.my-cluster.xxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN":"arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "DataTiering": "false", "AutoMinorVersionUpgrade": true } }
Para ver los detalles del clúster actualizado una vez que su estado cambie de actualizado a disponible, utilice el siguiente comando:
Para Linux, macOS o Unix:
aws memorydb describe-clusters \ --cluster-name my-cluster --show-shard-details
Para Windows:
aws memorydb describe-clusters ^ --cluster-name my-cluster --show-shard-details
Devuelve la siguiente respuesta JSON:
{ "Clusters": [ { "Name": "my-cluster", "Status": "available", "NumberOfShards": 1, "Shards": [ { "Name": "0001", "Status": "available", "Slots": "0-16383", "Nodes": [ { "Name": "my-cluster-0001-001", "Status": "available", "AvailabilityZone": "us-east-1a", "CreateTime": "2021-08-21T20:22:12.405000-07:00", "Endpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 } }, { "Name": "my-cluster-0001-002", "Status": "available", "AvailabilityZone": "us-east-1b", "CreateTime": "2021-08-21T20:22:12.405000-07:00", "Endpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 } }, { "Name": "my-cluster-0001-003", "Status": "available", "AvailabilityZone": "us-east-1a", "CreateTime": "2021-08-22T12:59:31.844000-07:00", "Endpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 } } ], "NumberOfNodes": 3 } ], "ClusterEndpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN":"arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "ACLName": "my-acl", "DataTiering": "false", "AutoMinorVersionUpgrade": true } ] }
Para obtener más información acerca de cómo aumentar el número de réplicas mediante la CLI, consulte update-cluster en la Referencia de comandos de la AWS CLI.
Uso de la API de MemoryDB
Para aumentar el número de réplicas de una partición de MemoryDB, utilice la acción UpdateCluster con los parámetros siguientes:
-
ClusterName: obligatorio. Identifica el clúster en el que desea aumentar el número de réplicas. -
ReplicaConfiguration: obligatorio. Le permite establecer el número de réplicas. Para aumentar el número de réplicas, establezca la propiedadReplicaCounten el número de réplicas que desea incluir en la partición al final de la operación.
En el siguiente ejemplo, se aumenta el número de réplicas del clúster sample-cluster a tres. Al finalizar el ejemplo, existirán tres réplicas en cada partición. Este número se aplica tanto si se trata de un clúster de MemoryDB con una única partición como de un clúster de MemoryDB con varias particiones.
https://memory-db.us-east-1.amazonaws.com/ ?Action=UpdateCluster &ReplicaConfiguration.ReplicaCount=3 &ClusterName=sample-cluster &Version=2021-01-01 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20210802T192317Z &X-Amz-Credential=<credential>
Para obtener más información acerca de cómo aumentar el número de réplicas mediante la API, consulte UpdateCluster.
Reducción del número de réplicas de un clúster
Puede reducir el número de réplicas de una partición de MemoryDB. Puede reducir el número de réplicas a cero, pero no puede realizar una conmutación por error a una réplica si el nodo principal falla.
Puede utilizar la AWS Management Console, la AWS CLI o la API de MemoryDB para reducir el número de réplicas de un clúster.
Uso de la AWS Management Console
Para reducir el número de réplicas en un clúster de MemoryDB (consola), consulte Agregar/eliminar nodos de un clúster.
Uso de la AWS CLI
Para reducir el número de réplicas de un clúster de MemoryDB, utilice el comando update-cluster con los parámetros siguientes:
-
--cluster-name: obligatorio. Identifica el clúster en el que se desea reducir el número de réplicas. -
--replica-configuration: obligatorio.ReplicaCount: defina esta propiedad para especificar el número de nodos de réplica que desea.
En el siguiente ejemplo, se utiliza --replica-configuration para reducir el número de réplicas del clúster my-cluster al valor especificado.
Para Linux, macOS o Unix:
aws memorydb update-cluster \ --cluster-name my-cluster \ --replica-configuration \ ReplicaCount=1
Para Windows:
aws memorydb update-cluster ^ --cluster-name my-cluster ^ --replica-configuration ^ ReplicaCount=1 ^
Devuelve la siguiente respuesta JSON:
{ "Cluster": { "Name": "my-cluster", "Status": "updating", "NumberOfShards": 1, "ClusterEndpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN":"arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "DataTiering": "false", "AutoMinorVersionUpgrade": true } }
Para ver los detalles del clúster actualizado una vez que su estado cambie de actualizado a disponible, utilice el siguiente comando:
Para Linux, macOS o Unix:
aws memorydb describe-clusters \ --cluster-name my-cluster --show-shard-details
Para Windows:
aws memorydb describe-clusters ^ --cluster-name my-cluster --show-shard-details
Devuelve la siguiente respuesta JSON:
{ "Clusters": [ { "Name": "my-cluster", "Status": "available", "NumberOfShards": 1, "Shards": [ { "Name": "0001", "Status": "available", "Slots": "0-16383", "Nodes": [ { "Name": "my-cluster-0001-001", "Status": "available", "AvailabilityZone": "us-east-1a", "CreateTime": "2021-08-21T20:22:12.405000-07:00", "Endpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 } }, { "Name": "my-cluster-0001-002", "Status": "available", "AvailabilityZone": "us-east-1b", "CreateTime": "2021-08-21T20:22:12.405000-07:00", "Endpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 } } ], "NumberOfNodes": 2 } ], "ClusterEndpoint": { "Address":"clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN":"arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "ACLName": "my-acl", "DataTiering": "false", "AutoMinorVersionUpgrade": true } ] }
Para obtener más información acerca de cómo reducir el número de réplicas mediante la CLI, consulte update-cluster en la Referencia de comandos de la AWS CLI.
Uso de la API de MemoryDB
Para reducir el número de réplicas de un clúster de MemoryDB, utilice la acción UpdateCluster con los parámetros siguientes:
-
ClusterName: obligatorio. Identifica el clúster en el que se desea reducir el número de réplicas. -
ReplicaConfiguration: obligatorio. Le permite establecer el número de réplicas.ReplicaCount: defina esta propiedad para especificar el número de nodos de réplica que desea.
En el siguiente ejemplo, se utiliza ReplicaCount para reducir el número de réplicas del clúster sample-cluster a una. Al finalizar el ejemplo, existirá una réplica en cada partición. Este número se aplica tanto si se trata de un clúster de MemoryDB con una única partición como de un clúster de MemoryDB con varias particiones.
https://memory-db.us-east-1.amazonaws.com/ ?Action=UpdateCluster &ReplicaConfiguration.ReplicaCount=1 &ClusterName=sample-cluster &Version=2021-01-01 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20210802T192317Z &X-Amz-Credential=<credential>
Para obtener más información acerca de cómo reducir el número de réplicas mediante la API, consulte UpdateCluster.
