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.
# Extensión de los planes de formación
SageMaker Los planes de formación le permiten ampliar sus planes de formación actuales para evitar interrupciones en la carga de trabajo. Cuando un plan de formación está a punto de caducar, puedes ampliarlo directamente a través de la consola de SageMaker IA o mediante programación mediante la API o. AWS CLI Esto elimina la necesidad de crear un nuevo plan y reconfigurar la carga de trabajo con un nuevo plan de formación (ARN).
Con las ampliaciones del plan de formación, sus tareas de SageMaker formación en ejecución o sus SageMaker HyperPod clústeres seguirán funcionando sin interrupciones una vez que se amplíe el plan. El plan ampliado refleja la nueva fecha de finalización y puedes recuperar el historial de todas las extensiones de tu plan de entrenamiento.
**importante**
Ten en cuenta que las extensiones no se pueden cancelar ni modificar para añadir o eliminar instancias.
## Características principales de
+ Amplíe los planes de formación a través de la consola o la API
+ Amplíe los planes con incrementos de 1 día hasta 14 días o incrementos de 7 días hasta 182 días
+ Amplíe un plan cualquier cantidad de veces
+ Consulta o enumera el historial de extensiones de tus planes de entrenamiento en la consola o a través de la API
+ Continuación perfecta de la ejecución de las cargas de trabajo en la SageMaker IA sin necesidad de volver a configurarlas
## Requisitos previos
Antes de ampliar un plan de formación, asegúrese de lo siguiente:
+ El plan de formación debe tener un estado de `Active` o`Scheduled`.
+ El plan no debe tener ninguna extensión de `Payment Pending` estado.
+ Las extensiones se pueden solicitar hasta un mínimo de 1 hora o un máximo de 56 días antes de que venza el plan.
**Topics**
+ [Características principales de](#training-plan-extension-features)
+ [Requisitos previos](#training-plan-extension-prerequisites)
+ [Amplía un plan de entrenamiento con la consola de SageMaker IA](training-plan-extension-using-console.md)
+ [Amplíe un plan de formación mediante la SageMaker API o AWS CLI](training-plan-extension-using-api-cli-sdk.md)
# Amplía un plan de entrenamiento con la consola de SageMaker IA
SageMaker Los planes de entrenamiento ofrecen una forma cómoda de ampliar los planes de entrenamiento existentes a través de la interfaz de usuario de la consola SageMaker AI. Esta guía te explica el proceso de ampliar un plan de SageMaker formación para formar trabajos y SageMaker HyperPod clústeres mediante la consola de SageMaker IA.
Para ampliar un plan de entrenamiento mediante la consola:
1. Ve a la consola de SageMaker IA en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Selecciona **Planes de entrenamiento** en el panel de navegación izquierdo.
1. Seleccione de la lista el plan de formación que desee ampliar.
1. Pulsa el botón **Ampliar**.
1. Introduzca la fecha de finalización deseada para la extensión y pulse **Buscar** para encontrar las ofertas de extensiones disponibles.
1. Revisa la lista de ofertas de extensiones, que incluye detalles como la duración, la zona de disponibilidad, la tarifa inicial y las horas de inicio y finalización.
1. Seleccione la oferta de extensión que mejor se adapte a sus necesidades.
1. Revisa los detalles de la extensión en el cuadro de diálogo de confirmación y, a continuación, selecciona **Enviar** para confirmar la compra.
Una vez comprada la extensión, la fecha de finalización del plan de formación se actualiza para reflejar la nueva duración ampliada.
## Ver el historial de extensiones
Para ver el historial de extensiones de un plan de formación:
1. Ve a la página **de planes de entrenamiento** en la consola de SageMaker IA.
1. Selecciona el plan de entrenamiento que quieres ver.
1. En la página de detalles del plan de formación, consulta la sección **Extensiones** para ver todas las extensiones anteriores, incluido el identificador de oferta de la extensión, las fechas de inicio y finalización, el estado y la fecha de creación de la extensión.
## Valores del 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.
# 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.