Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Réservation du meilleur plan d’entraînement
<a name="choose-best-training-plan-using-api-cli-sdk"></a>

Après avoir examiné les offres de plans d’entraînement disponibles qui répondent le mieux à vos exigences, vous pouvez réserver un plan spécifique en appelant l’opération d’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html). Une fois créé, le plan entre initialement dans un état `Pending` et y reste jusqu’à ce que le processus de réservation soit terminé. La réponse à l’appel d’API renvoie un Amazon Resource Name (ARN) de plan d’entraînement. Notez cet ARN à des fins ultérieures de suivi et de surveillance. La réservation du plan d’entraînement est effectuée de manière asynchrone dans le système dorsal. Le paiement du montant total est automatiquement collecté dans le cadre du processus de réalisation. Une fois que la transaction de paiement est terminée et que les capacités réservées demandées sont sécurisées, le plan d’entraînement passe à l’état `Scheduled` et est prêt pour la planification.

**Important**  
Les plans d’entraînement ne peuvent pas être modifiés une fois achetés.
Les plans de formation ne peuvent pas être partagés entre AWS comptes ou au sein de votre AWS organisation.

L'exemple suivant utilise la AWS CLI commande an pour demander un plan d'entraînement spécifique, en transmettant l'ID du plan en tant que paramètre.

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

Ce document JSON est un exemple de réponse provenant de l'API des plans de SageMaker formation. La réponse contient l’Amazon Resource Name (ARN) du plan d’entraînement qui a été créé avec succès.

**Note**  
Le plan d’entraînement conserve le statut `Pending` jusqu’à ce que le processus de réalisation soit terminé.

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

Les sections suivantes définissent les paramètres de demande d’entrée obligatoires et facultatifs pour l’opération d’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html).

## Paramètres requis
<a name="choose-best-training-plan-using-api-cli-sdk-required-params"></a>

Lorsque vous appelez l’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) pour réserver un plan d’entraînement particulier, vous devez fournir les valeurs suivantes :
+ `TrainingPlanOfferingId` : ID du plan que vous choisissez. Vous pouvez extraire l’ID d’une offre de plan dans la réponse de votre appel d’API `SearchTrainingPlanOfferings`. Son format doit commencer par `pto-*`.
+ `TrainingPlanName` : nom du plan que vous créez.