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.

# Vea la información de la partición mediante el AWS CLI
<a name="describe-topic-partitions-cli"></a>

Ejecute el siguiente comando y *ClusterArn* sustitúyalo por el nombre de recurso de Amazon (ARN) del clúster y *TopicName* por el nombre del tema.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName
```

El resultado de este comando tendrá un aspecto similar al siguiente.

```
{
    "partitions": [
        {
            "partition": 0,
            "leader": 1,
            "replicas": [1, 2, 3],
            "isr": [1, 2, 3]
        },
        {
            "partition": 1,
            "leader": 2,
            "replicas": [2, 3, 1],
            "isr": [2, 3, 1]
        },
        {
            "partition": 2,
            "leader": 3,
            "replicas": [3, 1, 2],
            "isr": [3, 1]
        }
    ]
}
```

## Entender la información de las particiones
<a name="describe-topic-partitions-fields"></a>

La respuesta incluye la siguiente información para cada partición:
+ **partición**: el número de partición. Las particiones se numeran empezando por 0.
+ **líder**: el ID de intermediario del líder de esta partición. El líder gestiona todas las solicitudes de lectura y escritura de la partición.
+ **réplicas**: la lista de corredores IDs que tienen réplicas de esta partición. Esto incluye tanto las réplicas como las sincronizadas. out-of-sync
+ **isr**: la lista de corredores IDs que son réplicas sincronizadas. Estas réplicas están totalmente alineadas con el líder y, si es necesario, pueden asumir el papel de líder.

En el ejemplo anterior, la partición 2 tiene una out-of-sync réplica. La `replicas` lista incluye al corredor 2, pero no. `isr` Esto indica que el corredor 2 no está completamente al mismo nivel que el líder de esta partición.

## Paginación de resultados
<a name="describe-topic-partitions-pagination"></a>

Si el tema tiene muchas particiones, puede usar la paginación para recuperar los resultados en lotes más pequeños. Utilice el `--max-results` parámetro para especificar el número máximo de particiones que se van a devolver y utilice el `--next-token` parámetro para recuperar la siguiente página de resultados.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10
```

Si hay más resultados disponibles, la respuesta incluye un `nextToken` valor. Utilice este token para recuperar la siguiente página de resultados.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10 --next-token NextToken
```

## Casos de uso comunes
<a name="describe-topic-partitions-use-cases"></a>

La visualización de la información de las particiones es útil en varios escenarios:
+ **Identificación de las particiones infrarreplicadas**: compare las `isr` listas `replicas` y para identificar las particiones en las que algunas réplicas no están sincronizadas. Esto puede indicar problemas de rendimiento o problemas con los intermediarios.
+ **Supervisión de la distribución de** las particiones: compruebe que los líderes de las particiones estén distribuidos uniformemente entre los corredores para garantizar una carga equilibrada.
+ **Solución de problemas de replicación**: examine la lista de ISR para identificar qué intermediarios tienen problemas para mantener el ritmo de la replicación.
+ **Planear el reequilibrio de particiones**: utilice esta información para comprender el diseño actual de las particiones antes de realizar las operaciones de reequilibrio.