Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Visualizza le informazioni sulla partizione utilizzando il AWS CLI
<a name="describe-topic-partitions-cli"></a>

Esegui il comando seguente, sostituendolo *ClusterArn* con l'Amazon Resource Name (ARN) del cluster e *TopicName* con il nome dell'argomento.

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

L'output di questo comando è simile all'esempio JSON seguente.

```
{
    "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]
        }
    ]
}
```

## Comprensione delle informazioni sulla partizione
<a name="describe-topic-partitions-fields"></a>

La risposta include le seguenti informazioni per ogni partizione:
+ **partizione**: il numero della partizione. Le partizioni sono numerate a partire da 0.
+ **leader**: l'ID del broker del leader per questa partizione. Il leader gestisce tutte le richieste di lettura e scrittura per la partizione.
+ **repliche**: l'elenco dei broker IDs che dispongono di repliche di questa partizione. Ciò include sia le repliche in-sync che quelle in-sync. out-of-sync
+ **isr**: l'elenco dei broker IDs che sono repliche sincronizzate. Queste repliche sono pienamente in contatto con il leader e possono subentrare come leader, se necessario.

Nell'esempio precedente, la partizione 2 ha una out-of-sync replica. L'`replicas`elenco include il broker 2, ma l'`isr`elenco no. Ciò indica che il broker 2 non è completamente al passo con il leader di questa partizione.

## Impaginazione dei risultati
<a name="describe-topic-partitions-pagination"></a>

Se l'argomento ha molte partizioni, puoi utilizzare l'impaginazione per recuperare i risultati in batch più piccoli. Utilizzate il `--max-results` parametro per specificare il numero massimo di partizioni da restituire e utilizzate il `--next-token` parametro per recuperare la pagina successiva di risultati.

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

Se sono disponibili più risultati, la risposta include un `nextToken` valore. Usa questo token per recuperare la pagina successiva di risultati.

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

## Casi di utilizzo comune
<a name="describe-topic-partitions-use-cases"></a>

La visualizzazione delle informazioni sulle partizioni è utile per diversi scenari:
+ **Identificazione delle partizioni poco replicate**: confronta `isr` gli elenchi `replicas` and per identificare le partizioni in cui alcune repliche non sono sincronizzate. Ciò può indicare problemi di prestazioni o problemi di broker.
+ **Monitoraggio della distribuzione delle partizioni**: verifica che i leader delle partizioni siano distribuiti uniformemente tra i broker per garantire un carico bilanciato.
+ **Risoluzione dei problemi di replica: identifica quali broker hanno problemi** a tenere il passo con la replica esaminando l'elenco ISR.
+ **Pianificazione del ribilanciamento delle partizioni**: utilizzate queste informazioni per comprendere il layout corrente delle partizioni prima di eseguire le operazioni di ribilanciamento.