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.

# Reserva del mejor plan de entrenamiento
<a name="choose-best-training-plan-using-api-cli-sdk"></a>

Tras revisar las ofertas de planes de entrenamiento disponibles que mejor se adapten a sus necesidades, puede reservar un plan específico llamando a la operación de la API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html). Cuando se crea, el plan tiene inicialmente al estado `Pending` y lo mantiene hasta que se complete el proceso de reserva. La respuesta a la llamada a la API devuelve un Nombre de recurso de Amazon (ARN) de plan de entrenamiento. Anote este ARN para el seguimiento y supervisión futuras. La reserva del plan de entrenamiento se realiza de forma asíncrona en el backend. El pago del importe total se cobra automáticamente como parte del proceso de cumplimiento. Una vez finalizada la transacción de pago y aseguradas las capacidades reservadas solicitadas, el plan de entrenamiento pasa a tener el estado `Scheduled` y ya se puede programar.

**importante**  
Los planes de entrenamiento no se pueden modificar una vez comprados.
Los planes de formación no se pueden compartir entre AWS cuentas ni dentro de su AWS organización.

En el siguiente ejemplo, se utiliza el AWS CLI comando an para solicitar un plan de formación específico, pasando el identificador del plan como parámetro.

```
aws sagemaker create-training-plan \
--training-plan-offering-id "tpo-SHA-256-hash-value" \
--training-plan-name "name" \
```

Este documento JSON es un ejemplo de respuesta de la API de planes de SageMaker formación. La respuesta contiene el nombre de recurso de Amazon (ARN) del plan de entrenamiento que se ha creado correctamente.

**nota**  
El plan de entrenamiento conserva el estado `Pending` hasta que se complete el proceso de cumplimiento.

```
{
   "TrainingPlanArn":"arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning"
}
```

En las siguientes secciones se definen los parámetros de solicitud de entrada obligatorios y opcionales para la operación de la API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html).

## Parámetros necesarios
<a name="choose-best-training-plan-using-api-cli-sdk-required-params"></a>

Al llamar a la API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) para reservar un plan de entrenamiento concreto, debe proporcionar los siguientes valores:
+ `TrainingPlanOfferingId`: es el ID del plan que va a elegir. Puede obtener el ID de la oferta de un plan en respuesta a su llamada a la API `SearchTrainingPlanOfferings`. Su formato debe empezar por `pto-*`.
+ `TrainingPlanName`: es el nombre del plan que está creando.