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.
# 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.