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 la cronologia delle estensioni
<a name="describe-extension-history-api-cli-sdk"></a>

Utilizza l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API per visualizzare la cronologia completa delle estensioni per un piano di formazione.

L'esempio seguente utilizza un AWS CLI comando per recuperare la cronologia delle estensioni.

```
aws sagemaker describe-training-plan-extension-history \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan"
```

Questo documento JSON è un esempio di risposta dell'API dei piani SageMaker di formazione. La risposta include un elenco impaginato di tutte le estensioni del piano di formazione.

```
{
    "TrainingPlanExtensions": [
        {
            "TrainingPlanExtensionOfferingId": "tpeo-SHA-256-hash-value",
            "ExtendedAt": "2025-09-17T10:00:00Z",
            "StartDate": "2025-09-23T12:00:00Z",
            "EndDate": "2025-09-25T12:00:00Z",
            "Status": "Active",
            "PaymentStatus": "Completed",
            "AvailabilityZone": "us-east-2a",
            "DurationHours": 48,
            "UpfrontFee": "xxxx.xx",
            "CurrencyCode": "USD"
        }
    ],
    "NextToken": null
}
```

Le sezioni seguenti definiscono i parametri di richiesta di input obbligatori e facoltativi per l’operazione API `DescribeTrainingPlanExtensionHistory`.

## Parametri obbligatori
<a name="describe-extension-history-required-params"></a>

Quando si chiama l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API, è necessario fornire il seguente valore:
+ `TrainingPlanArn`: Il piano di allenamento per cui recuperare la cronologia delle estensioni.

## Parametri facoltativi
<a name="describe-extension-history-optional-params"></a>

Le sezioni seguenti forniscono dettagli su alcuni parametri facoltativi che puoi passare alla richiesta API `DescribeTrainingPlanExtensionHistory`.
+ `NextToken`: Se la risposta precedente è stata troncata, riceverai questo token. Usalo nella tua prossima richiesta per ricevere il prossimo set di risultati.
+ `MaxResults`: Il numero massimo di estensioni da restituire nella risposta.

## Valori dello stato dell'estensione
<a name="extension-status-values-api"></a>

Le estensioni possono avere i seguenti valori di stato:
+ `Pending`: L'estensione è stata richiesta ed è in attesa di elaborazione del pagamento.
+ `Active`: L'estensione è stata acquistata con successo ed è attiva.
+ `Scheduled`: l'inizio dell'estensione è pianificato in un momento futuro.
+ `Failed`: L'acquisto dell'estensione non è riuscito (ad esempio, a causa di problemi di pagamento).
+ `Expired`: Il periodo di estensione è terminato.