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.

# Ver el historial de extensiones
<a name="describe-extension-history-api-cli-sdk"></a>

Usa la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API para ver el historial completo de extensiones de un plan de formación.

En el siguiente ejemplo, se utiliza un AWS CLI comando para recuperar el historial de extensiones.

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

Este documento JSON es un ejemplo de respuesta de la API de planes de SageMaker formación. La respuesta incluye una lista paginada de todas las extensiones del plan de formación.

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

En las siguientes secciones se definen los parámetros de solicitud de entrada obligatorios y opcionales para la operación de la API `DescribeTrainingPlanExtensionHistory`.

## Parámetros necesarios
<a name="describe-extension-history-required-params"></a>

Al llamar a la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API, debes proporcionar el siguiente valor:
+ `TrainingPlanArn`: El del plan de formación del que se va a recuperar el historial de extensiones.

## Parámetros opcionales
<a name="describe-extension-history-optional-params"></a>

En las siguientes secciones, se proporcionan detalles sobre algunos parámetros opcionales que puede transferir a su solicitud de la API `DescribeTrainingPlanExtensionHistory`.
+ `NextToken`: Si la respuesta anterior estaba truncada, recibirás este token. Úsalo en tu próxima solicitud para recibir el siguiente conjunto de resultados.
+ `MaxResults`: el número máximo de extensiones que se devolverán en la respuesta.

## Valores de estado de la extensión
<a name="extension-status-values-api"></a>

Las extensiones pueden tener los siguientes valores de estado:
+ `Pending`: La extensión se ha solicitado y está pendiente de procesamiento de pago.
+ `Active`: La extensión se ha comprado correctamente y está activa.
+ `Scheduled`: Está previsto que la prórroga comience en un futuro.
+ `Failed`: La compra de la extensión no se pudo realizar (por ejemplo, debido a problemas de pago).
+ `Expired`: El período de prórroga ha finalizado.