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.
# Extension des plans de formation
SageMaker les plans de formation vous permettent d'étendre vos plans de formation existants afin d'éviter les interruptions de charge de travail. Lorsqu'un plan de formation arrive à expiration, vous pouvez le prolonger directement via la console SageMaker AI ou par programmation à l'aide de l'API ou. AWS CLI Il n'est donc plus nécessaire de créer un nouveau plan et de reconfigurer votre charge de travail avec un nouveau plan de formation ARN.
Avec les extensions du plan de SageMaker formation, vos tâches ou SageMaker HyperPod clusters de formation en cours continuent de fonctionner sans interruption une fois le plan prolongé. Le plan prolongé reflète la nouvelle date de fin, et vous pouvez récupérer l'historique de toutes les extensions de votre plan de formation.
**Important**
Veuillez noter que les extensions ne peuvent pas être annulées ou modifiées pour ajouter ou supprimer des instances.
## Fonctions principales
+ Étendre les plans de formation par le biais de la console ou de l'API
+ Prolongez les forfaits par tranches d'un jour jusqu'à 14 jours, ou par tranches de 7 jours jusqu'à 182 jours
+ Prolongez un plan autant de fois que vous le souhaitez
+ Afficher/répertorier l'historique des extensions de vos plans d'entraînement dans la console ou via l'API
+ Continuation fluide de l'exécution des charges de travail dans l' SageMaker IA sans reconfiguration
## Conditions préalables
Avant de prolonger un plan de formation, assurez-vous de ce qui suit :
+ Le plan de formation doit avoir le statut de `Active` ou`Scheduled`.
+ Le `Payment Pending` statut du plan ne doit pas être prolongé.
+ Des prolongations peuvent être demandées jusqu'à un minimum d'une heure ou un maximum de 56 jours avant l'expiration du plan.
**Topics**
+ [Fonctions principales](#training-plan-extension-features)
+ [Conditions préalables](#training-plan-extension-prerequisites)
+ [Étendre un plan de formation à l'aide de la console SageMaker AI](training-plan-extension-using-console.md)
+ [Prolongez un plan de formation à l'aide de SageMaker l'API ou AWS CLI](training-plan-extension-using-api-cli-sdk.md)
# Étendre un plan de formation à l'aide de la console SageMaker AI
SageMaker les plans d'entraînement constituent un moyen pratique d'étendre vos plans de formation existants via l'interface utilisateur de la console SageMaker AI. Ce guide explique le processus d'extension d'un plan de formation pour SageMaker les postes de formation et les SageMaker HyperPod clusters à l'aide de la console d' SageMaker intelligence artificielle.
Pour étendre un plan d'entraînement à l'aide de la console :
1. Accédez à la console SageMaker AI à l'adresse [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Choisissez **Training Plans** dans le volet de navigation de gauche.
1. Sélectionnez le plan de formation que vous souhaitez étendre dans la liste.
1. Cliquez sur le bouton **Étendre**.
1. Entrez la date de fin souhaitée pour votre extension et choisissez **Rechercher** pour trouver les offres d'extension disponibles.
1. Consultez la liste des offres d'extension, qui inclut des informations telles que la durée, la zone de disponibilité, les frais initiaux et les heures de début et de fin.
1. Sélectionnez l'offre d'extension qui répond le mieux à vos besoins.
1. Vérifiez les détails de l'extension dans la boîte de dialogue de confirmation, puis choisissez **Soumettre** pour confirmer votre achat.
Une fois l'extension achetée, la date de fin du plan de formation est mise à jour pour refléter la nouvelle durée prolongée.
## Afficher l'historique des extensions
Pour consulter l'historique des extensions d'un plan de formation, procédez comme suit :
1. Accédez à la page **Plans d'entraînement** dans la console SageMaker AI.
1. Sélectionnez le plan d'entraînement que vous souhaitez consulter.
1. Sur la page des détails du plan de formation, consultez la section **Extensions** pour voir toutes les extensions passées, y compris l'identifiant de l'offre d'extension, les dates de début et de fin, le statut et la date de création de l'extension.
## 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.
# 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.