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.
# Prolongez un plan de formation à l'aide de SageMaker l'API ou AWS CLI
SageMaker les plans de formation prennent en charge l'extension des plans de formation par programmation via son API. Vous pouvez interagir avec l'API des plans de formation à l'aide du AWS CLI ou SageMaker SDKs.
L'extension du plan de formation implique les actions d'API suivantes :
+ **`SearchTrainingPlanOfferings`:** recherchez les offres d'extension disponibles en spécifiant l'ARN de votre plan de formation et la durée de prolongation souhaitée. L'API renvoie les offres d'extension `TrainingPlanExtensionOfferings` sur le terrain.
+ **`ExtendTrainingPlan`:** Achetez une offre d'extension spécifique pour étendre votre plan de formation en fournissant le`TrainingPlanExtensionOfferingId`. Cela permet de réserver la capacité de calcul supplémentaire et de mettre à jour la date de fin de votre plan de formation.
+ **`DescribeTrainingPlanExtensionHistory`:** consultez l'historique complet des extensions d'un plan de formation, y compris toutes les extensions passées avec leur statut, leurs dates et leurs informations de paiement.
**Topics**
+ [Rechercher des offres d'extension](search-extension-offerings-api-cli-sdk.md)
+ [Acheter une extension](extend-training-plan-api-cli-sdk.md)
+ [Afficher l'historique des extensions](describe-extension-history-api-cli-sdk.md)
# Rechercher des offres d'extension
Utilisez l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API avec le `TrainingPlanArn` paramètre pour trouver les offres d'extension disponibles pour votre plan de formation.
L'exemple suivant utilise une AWS CLI commande pour rechercher des offres d'extension pour un plan de formation existant.
```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```
Ce document JSON est un exemple de réponse provenant de l'API des plans de SageMaker formation. La réponse `TrainingPlanExtensionOfferings` contient des offres d'extension disponibles pour le plan de formation spécifié.
```
{
"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"
}
]
}
```
Les sections suivantes définissent les paramètres de demande d'entrée obligatoires et facultatifs pour le fonctionnement de l'`SearchTrainingPlanOfferings`API lors de la recherche d'offres d'extension.
## Paramètres requis
Lorsque vous appelez l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API pour rechercher des offres d'extension, vous devez fournir la valeur suivante :
+ `TrainingPlanArn`: Le plan de formation que vous souhaitez prolonger. Ils `TrainingPlanArn` doivent faire référence à un plan de formation existant dont le statut est `Active` ou`Scheduled`.
## Paramètres facultatifs
Les sections suivantes fournissent des détails sur certains paramètres facultatifs que vous pouvez transmettre à votre demande d'`SearchTrainingPlanOfferings`API lorsque vous recherchez des offres d'extension.
+ `DurationHours`: durée souhaitée en heures pour la prolongation. La valeur de `DurationHours` est arrondie au multiple de 24 le plus proche.
# Acheter une extension
Après avoir sélectionné une offre d'extension, utilisez l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API pour acheter l'extension.
L'exemple suivant utilise une AWS CLI commande pour étendre un plan d'entraînement.
```
aws sagemaker extend-training-plan \
--training-plan-extension-offering-id "tpeo-SHA-256-hash-value"
```
Ce document JSON est un exemple de réponse provenant de l'API des plans de SageMaker formation. La réponse inclut la liste des extensions du plan de formation.
```
{
"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"
}
]
}
```
La section suivante définit le paramètre de demande d'entrée obligatoire pour le fonctionnement de l'`ExtendTrainingPlan`API.
## Paramètres requis
Lorsque vous appelez l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API pour étendre un plan de formation, vous devez fournir la valeur suivante :
+ `TrainingPlanExtensionOfferingId`: ID de l'offre d'extension que vous êtes en train d'acheter. Vous pouvez récupérer cet identifiant `TrainingPlanExtensionOfferings` dans la réponse à votre appel d'`SearchTrainingPlanOfferings`API. Son format doit commencer par `tpeo-*`.
# Afficher l'historique des extensions
Utilisez l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API pour consulter l'historique complet des extensions d'un plan de formation.
L'exemple suivant utilise une AWS CLI commande pour récupérer l'historique de l'extension.
```
aws sagemaker describe-training-plan-extension-history \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan"
```
Ce document JSON est un exemple de réponse provenant de l'API des plans de SageMaker formation. La réponse inclut une liste paginée de toutes les extensions du plan de formation.
```
{
"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
}
```
Les sections suivantes définissent les paramètres de demande d’entrée obligatoires et facultatifs pour l’opération d’API `DescribeTrainingPlanExtensionHistory`.
## Paramètres requis
Lorsque vous appelez l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API, vous devez fournir la valeur suivante :
+ `TrainingPlanArn`: du plan de formation pour lequel récupérer l'historique des extensions.
## Paramètres facultatifs
Les sections suivantes fournissent des détails sur certains paramètres facultatifs que vous pouvez transmettre à votre demande d’API `DescribeTrainingPlanExtensionHistory`.
+ `NextToken`: Si la réponse précédente a été tronquée, vous recevez ce jeton. Utilisez-le dans votre prochaine demande pour recevoir la prochaine série de résultats.
+ `MaxResults`: le nombre maximum d'extensions à renvoyer dans la réponse.
## Valeurs d'état de l'extension
Les extensions peuvent avoir les valeurs de statut suivantes :
+ `Pending`: La prolongation a été demandée et attend le traitement du paiement.
+ `Active`: L'extension a été achetée avec succès et est active.
+ `Scheduled`: Il est prévu que l'extension commence à une date future.
+ `Failed`: L'achat de l'extension a échoué (par exemple, en raison de problèmes de paiement).
+ `Expired`: La période de prolongation est terminée.