Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Estendi un piano di formazione utilizzando l' SageMaker API o AWS CLI
SageMaker i piani di formazione supportano l'estensione programmatica dei piani di formazione tramite la relativa API. Puoi interagire con l'API dei piani di formazione utilizzando o. AWS CLI SageMaker SDKs
L'estensione del piano di formazione prevede le seguenti azioni API:
+ **`SearchTrainingPlanOfferings`:** cerca le offerte di estensione disponibili specificando l'ARN del piano di formazione e la durata dell'estensione desiderata. L'API restituisce le offerte di estensione disponibili sul campo. `TrainingPlanExtensionOfferings`
+ **`ExtendTrainingPlan`:** Acquista un'offerta di estensione specifica per estendere il tuo piano di formazione fornendo il`TrainingPlanExtensionOfferingId`. Ciò consente di riservare la capacità di elaborazione aggiuntiva e di aggiornare la data di fine del piano di allenamento.
+ **`DescribeTrainingPlanExtensionHistory`:** Visualizza la cronologia completa delle estensioni di un piano di formazione, incluse tutte le estensioni precedenti con il relativo stato, le date e le informazioni di pagamento.
**Topics**
+ [Cerca le offerte di estensione](search-extension-offerings-api-cli-sdk.md)
+ [Acquista un'estensione](extend-training-plan-api-cli-sdk.md)
+ [Visualizza la cronologia delle estensioni](describe-extension-history-api-cli-sdk.md)
# Cerca le offerte di estensione
Utilizza l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API con il `TrainingPlanArn` parametro per trovare le offerte di estensione disponibili per il tuo piano di formazione.
L'esempio seguente utilizza un AWS CLI comando per cercare offerte di estensione per un piano di formazione esistente.
```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```
Questo documento JSON è un esempio di risposta dall'API dei piani SageMaker di formazione. La risposta `TrainingPlanExtensionOfferings` include le offerte di estensione disponibili per il piano di formazione specificato.
```
{
"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"
}
]
}
```
Le sezioni seguenti definiscono i parametri di richiesta di input obbligatori e facoltativi per il funzionamento dell'`SearchTrainingPlanOfferings`API durante la ricerca di offerte di estensione.
## Parametri obbligatori
Quando si chiama l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API per cercare offerte di estensione, è necessario fornire il seguente valore:
+ `TrainingPlanArn`: Il piano di allenamento che desideri estendere. `TrainingPlanArn`Devono fare riferimento a un piano di formazione esistente con stato `Active` o`Scheduled`.
## Parametri facoltativi
Le sezioni seguenti forniscono dettagli su alcuni parametri opzionali che è possibile passare alla richiesta `SearchTrainingPlanOfferings` API durante la ricerca di offerte di estensione.
+ `DurationHours`: La durata desiderata in ore per l'estensione. `DurationHours` viene arrotondato per eccesso al multiplo di 24 più vicino.
# Acquista un'estensione
Dopo aver selezionato un'offerta di estensione, utilizza l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API per acquistare l'estensione.
L'esempio seguente utilizza un AWS CLI comando per estendere un piano di allenamento.
```
aws sagemaker extend-training-plan \
--training-plan-extension-offering-id "tpeo-SHA-256-hash-value"
```
Questo documento JSON è un esempio di risposta dell'API dei piani SageMaker di formazione. La risposta include l'elenco delle estensioni per il piano di formazione.
```
{
"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 sezione seguente definisce il parametro di richiesta di input obbligatorio per il funzionamento dell'`ExtendTrainingPlan`API.
## Parametri obbligatori
Quando si chiama l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API per estendere un piano di formazione, è necessario fornire il seguente valore:
+ `TrainingPlanExtensionOfferingId`: L'ID dell'offerta di estensione che stai acquistando. Puoi recuperare questo ID da `TrainingPlanExtensionOfferings` nella risposta alla tua chiamata `SearchTrainingPlanOfferings` API. L’ID dovrebbe iniziare con `tpeo-*`.
# Visualizza la cronologia delle estensioni
Utilizza l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API per visualizzare la cronologia completa delle estensioni per un piano di formazione.
L'esempio seguente utilizza un AWS CLI comando per recuperare la cronologia delle estensioni.
```
aws sagemaker describe-training-plan-extension-history \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan"
```
Questo documento JSON è un esempio di risposta dell'API dei piani SageMaker di formazione. La risposta include un elenco impaginato di tutte le estensioni del piano di formazione.
```
{
"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
}
```
Le sezioni seguenti definiscono i parametri di richiesta di input obbligatori e facoltativi per l’operazione API `DescribeTrainingPlanExtensionHistory`.
## Parametri obbligatori
Quando si chiama l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API, è necessario fornire il seguente valore:
+ `TrainingPlanArn`: Il piano di allenamento per cui recuperare la cronologia delle estensioni.
## Parametri facoltativi
Le sezioni seguenti forniscono dettagli su alcuni parametri facoltativi che puoi passare alla richiesta API `DescribeTrainingPlanExtensionHistory`.
+ `NextToken`: Se la risposta precedente è stata troncata, riceverai questo token. Usalo nella tua prossima richiesta per ricevere il prossimo set di risultati.
+ `MaxResults`: Il numero massimo di estensioni da restituire nella risposta.
## Valori dello stato dell'estensione
Le estensioni possono avere i seguenti valori di stato:
+ `Pending`: L'estensione è stata richiesta ed è in attesa di elaborazione del pagamento.
+ `Active`: L'estensione è stata acquistata con successo ed è attiva.
+ `Scheduled`: l'inizio dell'estensione è pianificato in un momento futuro.
+ `Failed`: L'acquisto dell'estensione non è riuscito (ad esempio, a causa di problemi di pagamento).
+ `Expired`: Il periodo di estensione è terminato.