

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 particiones
<a name="shards"></a>

Una partición es una colección de uno a seis nodos. Puede crear un clúster con un mayor número de particiones y un menor número de réplicas con un total de hasta 500 nodos por clúster. Esta configuración de clúster puede variar desde 500 particiones y 0 réplicas hasta 100 particiones y 4 réplicas, que es el número máximo de réplicas permitido. Los datos del clúster están particionados en las distintas particiones del clúster. Si hay más de un nodo en una partición, esta implementa la reproducción con un nodo, siendo el nodo principal de lectura/escritura y los demás, nodos de réplica de solo lectura.

Cuando crea un clúster de MemoryDB usando Consola de administración de AWS, debe especificar el número de particiones del clúster y el número de nodos de las particiones. Para obtener más información, consulte [Creación de un clúster de MemoryDB](getting-started.md#clusters.create).

Los nodos de las particiones tienen las mismas especificaciones de memoria, almacenamiento y computación. La API de MemoryDB le permite controlar los atributos de todo el clúster, como el número de nodos, la configuración de seguridad y los periodos de mantenimiento del sistema.

Para obtener más información, consulte [Cambios en las particiones sin conexión para MemoryDB](cluster-resharding-offline.md) y [Cambios en las particiones con conexión para MemoryDB](cluster-resharding-online.md).

## Búsqueda del nombre de una partición
<a name="shard-find-id"></a>

Puede encontrar el nombre de una partición utilizando la Consola de administración de AWS, la AWS CLI o la API de MemoryDB.

### Uso de Consola de administración de AWS
<a name="shard-find-id-con"></a>

El siguiente procedimiento utiliza la Consola de administración de AWS para buscar los nombres de las particiones de un clúster de MemoryDB.

****

1. Inicie sesión en la Consola de administración de AWS y abra la consola de MemoryDB en [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/).

1. En el panel de navegación izquierdo, elija **Clústeres**.

1. Elija el clúster en **Nombre** cuyos nombres de particiones desee buscar.

1. En la pestaña **Particiones y nodos**, consulte la lista de particiones en **Nombre**. También puede ampliar cada uno de ellos para ver los detalles de sus nodos.

### Uso de AWS CLI
<a name="shard-find-id-cli"></a>

Para encontrar los nombres de las particiones (particiones) para los clústeres de MemoryDB, utilice la operación de la AWS CLI `describe-clusters` con el siguiente parámetro opcional.
+ **`--cluster-name`**: un parámetro opcional que, cuando se utiliza, limita los resultados a los detalles del clúster especificado. Si se omite este parámetro, se devuelven los detalles de hasta 100 clústeres.
+ **`--show-shard-details`**: devuelve los detalles de las particiones, incluidos sus nombres.

Este comando devuelve los detalles de `my-cluster`.

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:

Se agregan saltos de línea para facilitar la lectura.

```
{
    "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.xxxxx.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.xxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        }
                    ],
                    "NumberOfNodes": 2
                }
            ],
            "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:xxxxxexamplearn:cluster/my-cluster",
            "SnapshotRetentionLimit": 0,
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "SnapshotWindow": "04:30-05:30",
            "ACLName": "my-acl",
            "DataTiering": "false",
            "AutoMinorVersionUpgrade": true
        }
    ]
}
```

### Uso de la API de MemoryDB
<a name="shard-find-id-api"></a>

Para encontrar los identificadores de particiones para los clústeres de MemoryDB, utilice la operación de API `DescribeClusters` con el siguiente parámetro opcional.
+ **`ClusterName`**: un parámetro opcional que, cuando se utiliza, limita los resultados a los detalles del clúster especificado. Si se omite este parámetro, se devuelven los detalles de hasta 100 clústeres.
+ **`ShowShardDetails`**: devuelve los detalles de las particiones, incluidos sus nombres.

**Example**  
Este comando devuelve los detalles de `my-cluster`.  
Para Linux, macOS o Unix:  

```
https://memory-db.us-east-1.amazonaws.com/
   ?Action=DescribeClusters
   &ClusterName=sample-cluster
   &ShowShardDetails=true
   &Version=2021-01-01
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20210802T192317Z
   &X-Amz-Credential=<credential>
```