Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Erweiterung der Trainingspläne
SageMaker Mit Schulungsplänen können Sie Ihre bestehenden Schulungspläne erweitern, um Unterbrechungen der Arbeitsbelastung zu vermeiden. Wenn sich ein Trainingsplan dem Ablauf nähert, können Sie ihn direkt über die SageMaker KI-Konsole oder programmgesteuert mithilfe der API oder verlängern. AWS CLI Dadurch entfällt die Notwendigkeit, einen neuen Plan zu erstellen und Ihre Arbeitslast mit einem neuen Trainingsplan ARN neu zu konfigurieren.
Mit den Erweiterungen des Trainingsplans funktionieren Ihre laufenden SageMaker Trainingsjobs oder SageMaker HyperPod Cluster weiterhin reibungslos und ohne Unterbrechung, sobald der Plan verlängert wurde. Der erweiterte Plan spiegelt das neue Enddatum wider, und Sie können den Verlauf aller Verlängerungen für Ihren Trainingsplan abrufen.
**Wichtig**
Bitte beachte, dass Verlängerungen nicht storniert oder geändert werden können, um Instanzen hinzuzufügen oder zu entfernen.
## Schlüssel-Features
+ Erweitern Sie Ihre Trainingspläne über die Konsole oder die API
+ Verlängern Sie die Tarife in Schritten von einem Tag auf bis zu 14 Tage oder in Schritten von 7 Tagen auf bis zu 182 Tage
+ Verlängern Sie einen Plan beliebig oft
+ Den Verlauf der Erweiterungen für deine Trainingspläne in der Konsole oder über die API anzeigen/auflisten
+ Nahtlose Fortsetzung der Ausführung von Workloads in SageMaker KI ohne Neukonfiguration
## Voraussetzungen
Bevor Sie einen Schulungsplan verlängern, stellen Sie Folgendes sicher:
+ Der Schulungsplan muss den Status `Active` oder haben`Scheduled`.
+ Der `Payment Pending` Status des Plans darf keine Verlängerungen aufweisen.
+ Verlängerungen können bis zu mindestens 1 Stunde oder maximal 56 Tage vor Ablauf des Plans beantragt werden.
**Topics**
+ [Schlüssel-Features](#training-plan-extension-features)
+ [Voraussetzungen](#training-plan-extension-prerequisites)
+ [Verlängern Sie einen Trainingsplan mithilfe der SageMaker KI-Konsole](training-plan-extension-using-console.md)
+ [Verlängern Sie einen Schulungsplan mithilfe der SageMaker API oder AWS CLI](training-plan-extension-using-api-cli-sdk.md)
# Verlängern Sie einen Trainingsplan mithilfe der SageMaker KI-Konsole
SageMaker Trainingspläne bieten eine bequeme Möglichkeit, Ihre bestehenden Trainingspläne über die Benutzeroberfläche der SageMaker KI-Konsole zu erweitern. Dieser Leitfaden führt dich durch den Prozess der Erweiterung eines Trainingsplans für SageMaker Trainingsjobs und SageMaker HyperPod -cluster mithilfe der SageMaker KI-Konsole.
So verlängern Sie einen Trainingsplan mithilfe der Konsole:
1. Navigieren Sie zur SageMaker AI-Konsole unter [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Wählen Sie im linken Navigationsbereich **Trainingspläne** aus.
1. Wählen Sie den Trainingsplan, den Sie erweitern möchten, aus der Liste aus.
1. Wählen Sie die Schaltfläche „**Verlängern**“.
1. Geben Sie das gewünschte Enddatum für Ihre Verlängerung ein und wählen Sie **Suchen, um nach** verfügbaren Erweiterungsangeboten zu suchen.
1. Sehen Sie sich die Liste der Verlängerungsangebote an, die Details wie Dauer, Verfügbarkeitszone, Vorauszahlung sowie Start- und Endzeiten enthält.
1. Wählen Sie das Verlängerungsangebot aus, das Ihren Anforderungen am besten entspricht.
1. Überprüfen Sie die Erweiterungsdetails im Bestätigungsdialogfeld und klicken Sie dann auf **Absenden**, um Ihren Kauf zu bestätigen.
Nach dem Kauf der Verlängerung wird das Enddatum des Schulungsplans aktualisiert, um der neuen Verlängerungsdauer Rechnung zu tragen.
## Verlauf der Verlängerung anzeigen
Um den Verlauf der Verlängerungen für einen Schulungsplan einzusehen:
1. Navigiere in der SageMaker AI-Konsole zur Seite „**Trainingspläne**“.
1. Wählen Sie den Trainingsplan aus, den Sie sich ansehen möchten.
1. Auf der Seite mit den Details zum Trainingsplan findest du im Abschnitt **Erweiterungen** alle vergangenen Verlängerungen, einschließlich der ID des Erweiterungsangebots, Start- und Enddatum, Status und Zeitpunkt der Erstellung der Verlängerung.
## Werte für den Erweiterungsstatus
Erweiterungen können die folgenden Statuswerte haben:
+ `Pending`: Die Verlängerung wurde angefordert und wartet auf die Zahlungsabwicklung.
+ `Active`: Die Erweiterung wurde erfolgreich gekauft und ist aktiv.
+ `Scheduled`: Die Verlängerung soll zu einem future Zeitpunkt beginnen.
+ `Failed`: Der Kauf der Erweiterung ist fehlgeschlagen (z. B. aufgrund von Zahlungsproblemen).
+ `Expired`: Der Verlängerungszeitraum ist abgelaufen.
# Verlängern Sie einen Schulungsplan mithilfe der SageMaker API oder AWS CLI
SageMaker Trainingspläne unterstützen die programmatische Erweiterung von Trainingsplänen über ihre API. Du kannst mit der Trainingsplan-API interagieren, indem du das AWS CLI oder verwendest. SageMaker SDKs
Die Erweiterung des Trainingsplans umfasst die folgenden API-Aktionen:
+ **`SearchTrainingPlanOfferings`:** Suchen Sie nach verfügbaren Verlängerungsangeboten, indem Sie den ARN Ihres Schulungsplans und die gewünschte Verlängerungsdauer angeben. Die API gibt Erweiterungsangebote im `TrainingPlanExtensionOfferings` Feld zurück.
+ **`ExtendTrainingPlan`:** Erwerben Sie ein spezielles Erweiterungsangebot, um Ihren Schulungsplan zu erweitern, indem Sie die bereitstellen`TrainingPlanExtensionOfferingId`. Dadurch wird die zusätzliche Rechenkapazität reserviert und das Enddatum Ihres Trainingsplans aktualisiert.
+ **`DescribeTrainingPlanExtensionHistory`:** Sieh dir den kompletten Verlängerungshistorie für einen Trainingsplan an, einschließlich aller vergangenen Verlängerungen mit deren Status, Datum und Zahlungsinformationen.
**Topics**
+ [Suchen Sie nach Erweiterungsangeboten](search-extension-offerings-api-cli-sdk.md)
+ [Erwerben Sie eine Verlängerung](extend-training-plan-api-cli-sdk.md)
+ [Verlauf der Erweiterungen anzeigen](describe-extension-history-api-cli-sdk.md)
# Suchen Sie nach Erweiterungsangeboten
Verwenden Sie die [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API mit dem `TrainingPlanArn` Parameter, um verfügbare Erweiterungsangebote für Ihren Schulungsplan zu finden.
Im folgenden Beispiel wird ein AWS CLI Befehl verwendet, um nach Erweiterungsangeboten für einen vorhandenen Schulungsplan zu suchen.
```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```
Dieses JSON-Dokument ist eine Beispielantwort aus der SageMaker Trainingsplan-API. Die Antwort `TrainingPlanExtensionOfferings` enthält auch verfügbare Erweiterungsangebote für den angegebenen Trainingsplan.
```
{
"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"
}
]
}
```
In den folgenden Abschnitten werden die obligatorischen und optionalen Eingabeanforderungsparameter für den `SearchTrainingPlanOfferings` API-Vorgang bei der Suche nach Erweiterungsangeboten definiert.
## Erforderliche Parameter
Wenn Sie die [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API aufrufen, um nach Erweiterungsangeboten zu suchen, müssen Sie den folgenden Wert angeben:
+ `TrainingPlanArn`: Der des Schulungsplans, den Sie verlängern möchten. Der `TrainingPlanArn` muss auf einen vorhandenen Schulungsplan mit dem Status `Active` oder verweisen`Scheduled`.
## Optionale Parameter
In den folgenden Abschnitten finden Sie Einzelheiten zu einigen optionalen Parametern, die Sie bei der Suche nach Erweiterungsangeboten an Ihre `SearchTrainingPlanOfferings` API-Anfrage übergeben können.
+ `DurationHours`: Die gewünschte Dauer in Stunden für die Verlängerung. Der `DurationHours` wird auf das nächste Vielfache von 24 aufgerundet.
# Erwerben Sie eine Verlängerung
Nachdem Sie ein Erweiterungsangebot ausgewählt haben, verwenden Sie die [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API, um die Erweiterung zu erwerben.
Im folgenden Beispiel wird ein AWS CLI Befehl verwendet, um einen Trainingsplan zu erweitern.
```
aws sagemaker extend-training-plan \
--training-plan-extension-offering-id "tpeo-SHA-256-hash-value"
```
Dieses JSON-Dokument ist eine Beispielantwort aus der SageMaker Trainingsplan-API. Die Antwort enthält die Liste der Erweiterungen für den Trainingsplan.
```
{
"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"
}
]
}
```
Im folgenden Abschnitt wird der obligatorische Eingabeanforderungsparameter für den `ExtendTrainingPlan` API-Vorgang definiert.
## Erforderliche Parameter
Wenn Sie die [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API aufrufen, um einen Trainingsplan zu erweitern, müssen Sie den folgenden Wert angeben:
+ `TrainingPlanExtensionOfferingId`: Die ID des Erweiterungsangebots, das Sie kaufen. Sie können diese ID `TrainingPlanExtensionOfferings` in der Antwort auf Ihren `SearchTrainingPlanOfferings` API-Aufruf abrufen. Das Format sollte mit beginnen`tpeo-*`.
# Verlauf der Erweiterungen anzeigen
Verwenden Sie die [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API, um den vollständigen Verlauf der Erweiterungen für einen Schulungsplan einzusehen.
Im folgenden Beispiel wird ein AWS CLI Befehl verwendet, um die Erweiterungshistorie abzurufen.
```
aws sagemaker describe-training-plan-extension-history \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan"
```
Dieses JSON-Dokument ist eine Beispielantwort aus der SageMaker Trainingsplan-API. Die Antwort enthält eine paginierte Liste aller Erweiterungen für den Trainingsplan.
```
{
"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
}
```
In den folgenden Abschnitten werden die obligatorischen und optionalen Eingabeanforderungsparameter für den `DescribeTrainingPlanExtensionHistory`-API-Vorgang definiert.
## Erforderliche Parameter
Wenn Sie die [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API aufrufen, müssen Sie den folgenden Wert angeben:
+ `TrainingPlanArn`: Der Trainingsplan, für den der Erweiterungshistorie abgerufen werden soll.
## Optionale Parameter
Die folgenden Abschnitte enthalten Einzelheiten zu einigen optionalen Parametern, die Sie an Ihre `DescribeTrainingPlanExtensionHistory`-API-Anfrage übergeben können.
+ `NextToken`: Wenn die vorherige Antwort gekürzt wurde, erhalten Sie dieses Token. Verwenden Sie es in Ihrer nächsten Anfrage, um die nächsten Ergebnisse zu erhalten.
+ `MaxResults`: Die maximale Anzahl von Erweiterungen, die in der Antwort zurückgegeben werden sollen.
## Werte für den Erweiterungsstatus
Erweiterungen können die folgenden Statuswerte haben:
+ `Pending`: Die Verlängerung wurde angefordert und wartet auf die Zahlungsabwicklung.
+ `Active`: Die Erweiterung wurde erfolgreich gekauft und ist aktiv.
+ `Scheduled`: Die Verlängerung soll zu einem future Zeitpunkt beginnen.
+ `Failed`: Der Kauf der Erweiterung ist fehlgeschlagen (z. B. aufgrund von Zahlungsproblemen).
+ `Expired`: Der Verlängerungszeitraum ist abgelaufen.