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.
# Amplíe un plan de formación mediante la SageMaker API o AWS CLI
SageMaker los planes de formación permiten ampliar los planes de formación mediante programación a través de su API. Puede interactuar con la API de los planes de formación mediante la AWS CLI o. SageMaker SDKs
La extensión del plan de formación incluye las siguientes acciones de la API:
+ **`SearchTrainingPlanOfferings`:** busque las ofertas de extensión disponibles especificando el ARN de su plan de formación y la duración de la extensión deseada. La API muestra las ofertas de extensión `TrainingPlanExtensionOfferings` sobre el terreno.
+ **`ExtendTrainingPlan`:** Adquiera una oferta de extensión específica para ampliar su plan de formación proporcionando la`TrainingPlanExtensionOfferingId`. Esto reserva la capacidad informática adicional y actualiza la fecha de finalización de su plan de formación.
+ **`DescribeTrainingPlanExtensionHistory`:** Consulta el historial completo de ampliaciones de un plan de formación, incluidas todas las ampliaciones anteriores con su estado, fechas e información de pago.
**Topics**
+ [Busque ofertas de extensiones](search-extension-offerings-api-cli-sdk.md)
+ [Compra una extensión](extend-training-plan-api-cli-sdk.md)
+ [Ver el historial de extensiones](describe-extension-history-api-cli-sdk.md)
# Busque ofertas de extensiones
Utilice la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API con el `TrainingPlanArn` parámetro para encontrar las ofertas de extensión disponibles para su plan de formación.
En el siguiente ejemplo, se utiliza un AWS CLI comando para buscar ofertas de extensión para un plan de formación existente.
```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```
Este documento JSON es un ejemplo de respuesta de la API de planes de SageMaker formación. La respuesta incluye `TrainingPlanExtensionOfferings` las ofertas de extensión disponibles para el plan de formación especificado.
```
{
"TrainingPlanOfferings": [],
"TrainingPlanExtensionOfferings": [
{
"TrainingPlanExtensionOfferingId": "tpeo-SHA-256-hash-value",
"AvailabilityZone": "us-east-2a",
"StartDate": "2025-09-23T12:00:00Z",
"EndDate": "2025-09-25T12:00:00Z",
"DurationHours": 48,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD"
}
]
}
```
En las siguientes secciones se definen los parámetros de solicitud de entrada obligatorios y opcionales para la operación de la `SearchTrainingPlanOfferings` API al buscar ofertas de extensiones.
## Parámetros necesarios
Al llamar a la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API para buscar ofertas de extensiones, debes proporcionar el siguiente valor:
+ `TrainingPlanArn`: El del plan de formación que deseas ampliar. `TrainingPlanArn`Deben hacer referencia a un plan de formación existente con un estado de `Active` o`Scheduled`.
## Parámetros opcionales
En las siguientes secciones se proporcionan detalles sobre algunos parámetros opcionales que puedes incluir en tu solicitud de `SearchTrainingPlanOfferings` API cuando busques ofertas de extensiones.
+ `DurationHours`: La duración deseada en horas para la extensión. La `DurationHours` se redondea al múltiplo de 24 más cercano.
# Compra una extensión
Después de seleccionar una oferta de extensión, usa la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API para comprarla.
En el siguiente ejemplo, se utiliza un AWS CLI comando para ampliar un plan de formación.
```
aws sagemaker extend-training-plan \
--training-plan-extension-offering-id "tpeo-SHA-256-hash-value"
```
Este documento JSON es un ejemplo de respuesta de la API de planes de SageMaker formación. La respuesta incluye la lista de 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": "Pending",
"PaymentStatus": "Pending",
"AvailabilityZone": "us-east-2a",
"DurationHours": 48,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD"
}
]
}
```
En la siguiente sección se define el parámetro de solicitud de entrada obligatorio para la operación de la `ExtendTrainingPlan` API.
## Parámetros necesarios
Al llamar a la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API para ampliar un plan de formación, debes proporcionar el siguiente valor:
+ `TrainingPlanExtensionOfferingId`: El identificador de la oferta de extensión que vas a comprar. Puedes recuperar este identificador `TrainingPlanExtensionOfferings` en la respuesta a tu llamada a la `SearchTrainingPlanOfferings` API. Su formato debe empezar por `tpeo-*`.
# Ver el historial de extensiones
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
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
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
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.