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à.
# Estensione dei piani di formazione
SageMaker i piani di formazione consentono di estendere i piani di allenamento esistenti per evitare interruzioni del carico di lavoro. Quando un piano di formazione sta per scadere, puoi estenderlo direttamente tramite la console SageMaker AI o a livello di codice utilizzando l'API o. AWS CLI Ciò elimina la necessità di creare un nuovo piano e riconfigurare il carico di lavoro con un nuovo piano di formazione ARN.
Con le estensioni del piano di formazione, i job o SageMaker HyperPod i cluster di SageMaker formazione in corso continuano a funzionare senza interruzioni una volta esteso il piano. Il piano esteso riflette la nuova data di fine ed è possibile recuperare la cronologia di tutte le estensioni del piano di allenamento.
**Importante**
Tieni presente che le estensioni non possono essere annullate o modificate per aggiungere o rimuovere istanze.
## Funzionalità principali
+ Estendi i piani di formazione tramite la console o l'API
+ Estendi i piani con incrementi di 1 giorno fino a 14 giorni o incrementi di 7 giorni fino a 182 giorni
+ Estendi un piano un numero qualsiasi di volte
+ Visualizza/ elenca la cronologia delle estensioni dei tuoi piani di allenamento nella console o tramite l'API
+ Continuazione senza interruzioni dell'esecuzione dei carichi di lavoro in AI senza riconfigurazione SageMaker
## Prerequisiti
Prima di estendere un piano di formazione, assicurati quanto segue:
+ Il piano di formazione deve avere lo status di `Active` o`Scheduled`.
+ Lo `Payment Pending` status del piano non deve essere esteso.
+ Le estensioni possono essere richieste fino a un minimo di 1 ora o un massimo di 56 giorni prima della scadenza del piano.
**Topics**
+ [Funzionalità principali](#training-plan-extension-features)
+ [Prerequisiti](#training-plan-extension-prerequisites)
+ [Estendi un piano di allenamento utilizzando la console SageMaker AI](training-plan-extension-using-console.md)
+ [Estendi un piano di formazione utilizzando l' SageMaker API o AWS CLI](training-plan-extension-using-api-cli-sdk.md)
# Estendi un piano di allenamento utilizzando la console SageMaker AI
SageMaker i piani di formazione offrono un modo conveniente per estendere i piani di allenamento esistenti tramite l'interfaccia utente della console SageMaker AI. Questa guida illustra il processo di estensione di un piano di formazione per lavori e SageMaker HyperPod cluster di SageMaker formazione utilizzando la console SageMaker AI.
Per estendere un piano di formazione utilizzando la console:
1. Vai alla console SageMaker AI all'indirizzo [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Scegli **Piani di allenamento** nel riquadro di navigazione a sinistra.
1. Seleziona il piano di allenamento che desideri estendere dall'elenco.
1. Scegli il pulsante **Estendi**.
1. Inserisci la data di fine desiderata per l'estensione e scegli **Cerca** per trovare le offerte di estensione disponibili.
1. Consulta l'elenco delle offerte di estensione, che include dettagli come durata, zona di disponibilità, tariffa anticipata e orari di inizio e fine.
1. Seleziona l'offerta di estensione che meglio soddisfa i tuoi requisiti.
1. Controlla i dettagli dell'estensione nella finestra di dialogo di conferma, quindi scegli **Invia** per confermare l'acquisto.
Dopo l'acquisto dell'estensione, la data di fine del piano di formazione viene aggiornata in base alla nuova durata estesa.
## Visualizza la cronologia delle estensioni
Per visualizzare la cronologia delle estensioni di un piano di allenamento:
1. Vai alla pagina **Piani di allenamento** nella console SageMaker AI.
1. Seleziona il piano di allenamento che desideri visualizzare.
1. Nella pagina dei dettagli del piano di formazione, visualizza la sezione **Estensioni** per vedere tutte le estensioni precedenti, tra cui l'ID dell'offerta dell'estensione, le date di inizio e di fine, lo stato e la data di creazione dell'estensione.
## 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.
# 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.