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à.
# Creazione dei piani di addestramento
Per riservare la capacità di calcolo utilizzando la funzionalità dei piani di SageMaker formazione, procedi nel seguente modo:
1. **Identifica la risorsa di destinazione:** inizia determinando se hai bisogno di capacità per SageMaker corsi di formazione o SageMaker HyperPod cluster.
1. **Specifica i requisiti di capacità:** definisci in dettaglio le tue esigenze in termini di capacità. Questo prevede la selezione del tipo di istanza appropriato per il carico di lavoro, la determinazione del numero di istanze necessarie e la specifica della durata di utilizzo. Per informazioni sui tipi di istanze supportati in una determinata opzione Regione AWS, di durata e di quantità, consulta[Tipi di istanze supportati e prezzi Regioni AWS](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions).
1. **Cerca le offerte di piani di formazione disponibili:** una volta specificati i requisiti, utilizza la funzionalità di ricerca dei piani di SageMaker formazione per trovare le offerte di piani di formazione disponibili in uno o più segmenti. Ogni offerta include dettagli quali l’ora di inizio, la specifica zona di disponibilità per la capacità riservata e il prezzo del piano. Esamina queste offerte, considerando fattori come la convenienza, le preferenze geografiche e l’allineamento alle tue esigenze specifiche.
Se non è disponibile un piano adatto, modifica i criteri di ricerca e cerca una nuova serie di offerte.
1. **Crea un piano di addestramento basato su un’offerta adatta:** dopo aver identificato un’offerta adatta, procedi con la creazione del tuo piano di addestramento. Questo processo prevede la selezione dell’offerta scelta e l’avvio della prenotazione.
+ La prenotazione del piano di addestramento crea una fattura.
+ Il pagamento dell’importo totale viene riscosso durante il processo di evasione dell’ordine. Una volta completato il pagamento, il piano è pronto per la pianificazione dei lavori di formazione o la creazione di cluster. SageMaker HyperPod
Per informazioni su come utilizzare i piani di formazione per i tuoi lavori di SageMaker formazione, consulta. [Utilizzo dei piani di formazione per lavori di SageMaker formazione](training-plan-utilization-for-training-jobs.md)
Per ulteriori informazioni su come utilizzare i piani di formazione per HyperPod i cluster, consulta[Utilizzo dei piani di formazione per i cluster Amazon SageMaker HyperPod](training-plan-utilization-for-hyperpod.md).
Puoi creare un piano di allenamento utilizzando la console SageMaker AI o metodi programmatici. La console SageMaker AI offre un'interfaccia grafica e visiva con una visione completa delle opzioni disponibili, mentre la creazione programmatica può essere effettuata utilizzando l'API dei piani di formazione AWS CLI o SageMaker SDKs interagendo direttamente con essa.
Per le istruzioni step-by-step sulla console e i riferimenti dettagliati alle API, consulta le rispettive sezioni di questa documentazione.
**Topics**
+ [SageMaker creazione di piani di allenamento utilizzando la console SageMaker AI](training-plan-creation-using-console.md)
+ [SageMaker creazione di piani di formazione utilizzando l' SageMaker API, oppure AWS CLI](training-plan-creation-using-api-cli-sdk.md)
# SageMaker creazione di piani di allenamento utilizzando la console SageMaker AI
SageMaker i piani di formazione offrono un modo conveniente per creare piani di formazione tramite l'interfaccia utente della console SageMaker AI, consentendo agli utenti di pianificare facilmente le proprie risorse di formazione sull'apprendimento automatico. Questa guida illustra il processo di creazione di un piano di formazione per la SageMaker formazione di lavori e SageMaker HyperPod cluster utilizzando la console SageMaker AI. Con queste fasi, cercherai le offerte dei piani di addestramento, esaminerai le opzioni disponibili e acquisterai il piano più adatto alle tue esigenze.
Per creare visivamente un piano di addestramento con un’interfaccia utente:
1. Inizia accedendo alla console SageMaker AI all'indirizzo. [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)
1. Scegli **Piani di addestramento** nel menu del riquadro a sinistra.
1. Qui, scegli il pulsante **Crea piano di addestramento** nell’area dei contenuti principale per avviare il processo di impostazione della pianificazione di addestramento personalizzata.
![\[SageMaker Console AI che mostra la pagina dei piani di allenamento. L’interfaccia mostra informazioni su come funzionano i piani di addestramento, incluse le fasi per richiedere, monitorare e utilizzare un piano. Il riquadro di navigazione a sinistra evidenzia l’opzione “Piani di addestramento” e il pulsante “Crea piano di addestramento” è visibile nell’area dei contenuti principale.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/training-plans/tp-console.png)
A questo punto, cerca le offerte dei piani che soddisfano i tuoi requisiti di calcolo.
**Topics**
+ [Ricerca delle offerte dei piani di addestramento](search-training-plan-offerings.md)
+ [Prenotazione del piano di addestramento ottimale](choose-best-training-plan.md)
+ [Elenco dei piani di addestramento](list-training-plans.md)
+ [Visualizzazione dei dettagli del piano di addestramento](training-plan-details.md)
# Ricerca delle offerte dei piani di addestramento
Dopo aver scelto **Piani di allenamento** nel riquadro sinistro della console SageMaker AI e quindi **Crea piano di allenamento**, viene visualizzato il modulo **Trova piano di allenamento**. Questo modulo consente di specificare i requisiti e cercare le offerte dei piani di addestramento ottimali.
Segui questa procedura per compilare il modulo:
1. Identifica la **destinazione**: i piani di addestramento sono specifici per la risorsa di destinazione. Specificate se desiderate utilizzare un piano per eseguire lavori o SageMaker HyperPod cluster di SageMaker formazione.
1. Per il **tipo di elaborazione**, puoi scegliere tra **Instance** o. **UltraServer** UltraServers connettono più istanze Amazon EC2 utilizzando un'interconnessione acceleratrice a bassa latenza e larghezza di banda elevata. Per ulteriori informazioni, consulta [Amazon EC2 UltraServers](https://aws.amazon.com/ec2/ultraservers/). Per ulteriori informazioni su come utilizzare l'intelligenza artificiale, consulta. UltraServers SageMaker [UltraServers nell'intelligenza artificiale SageMaker](reserve-capacity-with-training-plans.md#training-plans-ultraservers)
1. Scegli il **tipo di istanza** e il **numero di istanze** che preferisci: per i tipi di istanze disponibili in un determinato periodo Regione AWS, tra cui le opzioni relative alla durata e alla quantità, consulta[Tipi di istanze supportati e prezzi Regioni AWS](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions).
1. Definisci i parametri temporali: scegli le date di inizio e fine desiderate e specifica la durata del piano all’interno di questa finestra.
1. Scegli **Trova piani di addestramento**.
![\[SageMaker Console AI che mostra la pagina delle offerte dei piani di formazione di Search. L'interfaccia mostra le opzioni per selezionare la risorsa di destinazione per il piano (Training job o HyperPod cluster), specificare il tipo e il numero di istanze, impostare le date di inizio e fine e la durata dell'input. Il pulsante Trova piani di addestramento è visibile nella parte inferiore del modulo.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/training-plans/tp-search-training-plan-offerings.png)
SageMaker i piani di formazione cercano le offerte che soddisfano i requisiti di capacità. Le corrispondenze trovate nell’intervallo di tempo specificato vengono visualizzate nella parte inferiore della pagina. Ogni offerta del piano di addestramento include i seguenti dettagli:
+ Durata totale del piano
+ Date di inizio e fine
+ Prezzo anticipato totale:
Passa il mouse sul prezzo per visualizzare la ripartizione dettagliata della tariffa oraria dell’istanza, del numero di istanze e delle ore totali
+ Il numero totale dei segmenti del piano
Facendo clic sul link relativo ai dettagli del segmento si apre una visualizzazione modale con dettagli specifici del segmento:
+ Durata
+ Date di inizio e fine
+ Availability zone (Zona di disponibilità)
![\[SageMaker La console di intelligenza artificiale mostra la pagina Cerca offerte di piani di formazione con campi di immissione per i requisiti del piano e la sezione Piani disponibili che mostra i dettagli di tre piani trovati con durate, prezzi e stato di disponibilità diversi.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/training-plans/tp-available-offerings.png)
Se non viene trovato alcun piano adatto o se i piani disponibili non soddisfano le tue esigenze, modifica i criteri di ricerca cambiando i parametri nel modulo **Requisiti dei piani di addestramento**. Una volta trovata l’offerta adatta, selezionala e scegli **Avanti** per passare alla pagina di prenotazione del piano. In questa pagina puoi assegnare un nome al piano e quindi puoi rivedere e confermare la selezione prima di finalizzare la prenotazione.
**Nota**
I piani contrassegnati con `Immediately available` vengono avviati entro 30 minuti, a condizione che il pagamento venga completato non meno di 5 minuti prima dell’orario di inizio previsto.
# Prenotazione del piano di addestramento ottimale
La ricerca di un piano di addestramento ha restituito offerte adatte alle tue esigenze di capacità e al tuo budget.
1. Immetti un nome per il piano, quindi scegli **Avanti**.
1. Esamina e **Invia** l’ordine d’acquisto.
**Importante**
I piani di addestramento non possono essere modificati una volta acquistati.
I piani di formazione non possono essere condivisi tra più AWS account o all'interno dell'organizzazione. AWS
Dopo aver inviato l’ordine
+ Il piano di addestramento appare inizialmente come `Pending` nell’elenco dei piani di addestramento.
+ Una fattura viene generata automaticamente alla ricezione dell’ordine.
+ Il pagamento totale viene riscosso durante il processo di evasione dell’ordine.
+ Una volta che il pagamento è stato elaborato correttamente, lo stato del piano cambia in `Scheduled` e il piano può essere utilizzato.
![\[SageMaker Console AI che mostra la pagina «Rivedi e acquista» per un piano di allenamento. La pagina mostra i dettagli del piano di addestramento, le informazioni sui segmenti, il prezzo, il nome del piano e i tag. Sono disponibili opzioni per modificare, annullare, tornare indietro o creare il piano.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/training-plans/tp-review-and-purchase-training-plan.png)
# Elenco dei piani di addestramento
Per visualizzare i tuoi piani di addestramento:
1. Vai alla console SageMaker AI all'indirizzo [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Scegli **Piani di addestramento** nel menu del riquadro a sinistra. Viene visualizzato un elenco di tutti i piani di addestramento, inclusi i nomi, lo stato, il tipo di risorsa di destinazione e altri dettagli chiave.
Dopo aver acquistato un piano, verrà visualizzato questo elenco. I piani appena creati vengono visualizzati con stato `Pending` fino al completamento del pagamento. Lo stato in genere viene aggiornato entro pochi minuti dall’elaborazione del pagamento.
![\[SageMaker Console AI che mostra la pagina con l'elenco dei piani di allenamento. La pagina include una tabella che elenca i piani di addestramento con dettagli come nome, stato, numero totale di istanze, istanze in uso, zona, data di inizio e data di fine. È visibile un pulsante per creare un nuovo piano di addestramento.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/training-plans/tp-list-training-plans.png)
# Visualizzazione dei dettagli del piano di addestramento
Dall’elenco dei piani di addestramento, segui il nome di un piano per visualizzarne i dettagli. In particolare, puoi controllare l’utilizzo attuale della capacità ed elencare i carichi di lavoro nella pagina dei dettagli del piano.
La pagina dei dettagli mostra:
+ Una panoramica del piano di addestramento: stato, destinazione, tipo di istanza e durata.
+ Sezioni espandibili per i dettagli sul segmento, i prezzi, il nome del piano e i tag.
+ Utilizzo della capacità:
+ Totale: numero totale di istanze riservate in questo piano di addestramento.
+ In uso: numero di istanze attualmente utilizzate in questo piano di addestramento.
+ Istanze disponibili: numero di istanze attualmente disponibili in questo piano di addestramento.
Nella parte inferiore della pagina, un collegamento consente di visualizzare i lavori di formazione o l'elenco dei gruppi di istanze di SageMaker HyperPod cluster associati a questo piano, a seconda della risorsa di destinazione.
![\[SageMaker Pagina della console AI che mostra i dettagli di un piano di allenamento. La pagina mostra le informazioni di base sul piano, lo stato e i dettagli dell’istanza. Di seguito sono riportate le sezioni espandibili che visualizzano ulteriori dettagli. Nella parte inferiore, una sezione sull’utilizzo della capacità mostra le istanze totali, in uso e disponibili per il piano.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/training-plans/tp-view-training-plan.png)
# SageMaker creazione di piani di formazione utilizzando l' SageMaker API, oppure AWS CLI
SageMaker i piani di formazione supportano la creazione programmatica di piani di formazione tramite la relativa API. Puoi interagire con l'API dei piani di formazione utilizzando AWS CLI o SageMaker SDKs.
SageMaker Le azioni API dei piani di formazione forniscono un flusso di lavoro completo per la gestione programmatica dei piani di formazione:
+ **`SearchTrainingPlanOfferings`:** consente agli utenti di eseguire query e rilevare le risorse di calcolo disponibili specificando parametri come il tipo di istanza, il conteggio e la finestra temporale desiderati. L’API restituisce un elenco classificato di offerte dei piani di addestramento più rispondenti ai requisiti dell’utente.
+ **`CreateTrainingPlan`:** consente di riservare una specifica offerta del piano di addestramento, trasformando una potenziale capacità di calcolo in capacità riservata programmata con un ARN del piano di addestramento univoco.
+ **`ListTrainingPlans`:** fornisce un metodo per recuperare e rivedere tutti i piani di formazione esistenti nell' AWS account di un utente, con funzionalità opzionali di filtraggio e ordinamento.
+ **`DescribeTrainingPlan`:** offre informazioni approfondite su un piano di addestramento specifico, comprese le fasi del ciclo di vita da `Pending` a `Active` a `Expired`.
+ **`ExtendTrainingPlan`:** estende un piano di formazione esistente acquistando un'offerta di estensione. Per ulteriori informazioni, consulta [Estensione dei piani di formazione](training-plan-extension.md).
+ **`DescribeTrainingPlanExtensionHistory`:** recupera la cronologia delle estensioni per un piano di allenamento. Per ulteriori informazioni, consulta [Estensione dei piani di formazione](training-plan-extension.md).
**Topics**
+ [Ricerca delle offerte dei piani di addestramento](search-training-plan-offerings-api-cli-sdk.md)
+ [Prenotazione del piano di addestramento ottimale](choose-best-training-plan-using-api-cli-sdk.md)
+ [Elenco dei piani di addestramento](list-training-plans-using-api-cli-sdk.md)
+ [Visualizzazione dei dettagli del piano di addestramento](training-plan-details-using-api-cli-sdk.md)
# Ricerca delle offerte dei piani di addestramento
Per creare un piano di addestramento, inizia chiamando l’operazione API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html) e inserendo i requisiti del piano (ad esempio, il tipo di istanza, il conteggio e la finestra temporale desiderata) come parametri di input. I piani di addestramento sono specifici per la risorsa di destinazione. Assicurati di specificare per quale risorsa di destinazione verrà utilizzato il piano (`training-job` o `hyperpod-cluster`). L’API restituisce un elenco delle offerte disponibili che corrispondono ai requisiti impostati. Se non vengono trovate offerte adatte, potrebbe essere necessario modificare i requisiti ed effettuare nuovamente la ricerca.
Questa chiamata API recupera le offerte dei piani di addestramento più rispondenti alle tue esigenze di capacità. Ogni [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanOffering.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanOffering.html) restituito nella risposta viene identificato da un ID di offerta univoco. La prima offerta dell’elenco rappresenta la soluzione più rispondente alle tue esigenze. Se non è disponibile un piano di addestramento adeguato all’interno delle date specificate, l’elenco sarà vuoto. Modifica i criteri di ricerca e cerca una nuova serie di offerte.
+ Le durate delle prenotazioni sono disponibili in incrementi di 1 giorno e vanno da 1 a 182 giorni.
+ Opzioni relative al numero di istanze della prenotazione: 1, 2, 4, 8, 16, 32 o 64.
Per ulteriori informazioni sull'elenco delle istanze disponibili supportate dai piani di SageMaker formazione, consulta. [Tipi di istanze supportati e prezzi Regioni AWS](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions)
L'esempio seguente utilizza un AWS CLI comando per richiedere offerte di piani di formazione con informazioni specifiche sul tipo di istanza, sul conteggio e sull'ora.
```
# List training plan offerings with instance type, instance count, duration in hours, start time after, and end time before.
aws sagemaker search-training-plan-offerings \
--target-resources "training-job" \
--instance-type "ml.p4d.24xlarge" \
--instance-count 1 \
--duration-hours 15 \
--start-time-after "1737484800"
--end-time-before "1737657600"
```
Questo documento JSON è un esempio di risposta dall'API dei piani SageMaker di formazione. La risposta fornisce informazioni su diverse offerte dei piani di addestramento disponibili che soddisfano i requisiti di capacità specificati. Include tre offerte distinte con durate, tariffe anticipate e start/end orari diversi, tutte basate sullo stesso tipo di istanza e destinate ai lavori di formazione.
```
{
"TrainingPlanOfferings": [
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 15,
"DurationMinutes": 51,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 15,
"DurationMinutes": 51,
"StartTime": "2025-01-21T11:39:00-08:00",
"EndTime": "2025-01-22T03:30:00-08:00"
}
]
},
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 39,
"DurationMinutes": 51,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 39,
"DurationMinutes": 51,
"StartTime": "2025-01-21T11:39:00-08:00",
"EndTime": "2025-01-23T03:30:00-08:00"
}
]
},
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 24,
"DurationMinutes": 0,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 24,
"DurationMinutes": 0,
"StartTime": "2025-01-22T03:30:00-08:00",
"EndTime": "2025-01-23T03:30:00-08:00"
}
]
}
]
}
```
Di seguito è riportato un esempio di comando da utilizzare per cercare offerte di piani AWS CLI di formazione che includono. UltraServers
```
aws sagemaker search-training-plan-offerings \
--ultra-server-type ml.c6i-32xlargesc \
--ultra-server-count 1 \
--duration-hours 24 \
--target-resources hyperpod-cluster
--start-time-after "1737484800" \
--end-time-before "1737657600"
```
```
{
"TrainingPlanOfferings": [
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-07-21T16:59:25.760000+00:00",
"DurationHours": 24,
"DurationMinutes": 0,
"UpfrontFee": "0.24",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"ReservedCapacityType": "UltraServer",
"UltraServerType": "ml.u-p6e-gb200x72",
"UltraServerCount": 1,
"InstanceType": "ml.p6e-gb200.36xlarge",
"InstanceCount": 18,
"AvailabilityZone": "us-east-2a",
"DurationHours": 24,
"DurationMinutes": 0,
"StartTime": "2025-07-22T11:30:00+00:00",
"EndTime": "2025-07-23T11:30:00+00:00"
}
]
}
]
}
```
Le sezioni seguenti definiscono i parametri di richiesta di input obbligatori e facoltativi per l’operazione API `SearchTrainingPlanOfferings`.
## Parametri obbligatori
Quando chiami l’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html) per elencare le offerte dei piani di addestramento che soddisfano i tuoi requisiti, devi fornire i seguenti valori:
+ `TargetResources`: le risorse di destinazione (`training-job` o `hyperpod-cluster`) per le quali verrà utilizzato il piano. Il valore predefinito è `training-job`. I piani di addestramento sono specifici per la risorsa di destinazione.
+ Un piano di formazione progettato per i lavori di SageMaker formazione può essere utilizzato solo per pianificare ed eseguire lavori di formazione.
+ Un piano di formazione per HyperPod i cluster può essere utilizzato esclusivamente per fornire risorse di calcolo al gruppo di istanze di un cluster.
+ `InstanceType`: il tipo di istanza da allocare. `InstanceType` deve essere un tipo supportato.
Per maggiori informazioni sull'elenco delle istanze disponibili supportate dai piani di SageMaker formazione, consulta. [Tipi di istanze supportati e prezzi Regioni AWS](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions)
+ `InstanceCount`: il numero di istanze da allocare. Se il numero di istanze è maggiore di 1, deve essere una potenza di 2.
+ `DurationHour`: la durata totale del piano richiesto espressa in ore. `DurationHour` viene arrotondato per eccesso al multiplo di 24 più vicino.
## Parametri facoltativi
Le sezioni seguenti forniscono dettagli su alcuni parametri facoltativi che puoi passare alla richiesta API `SearchTrainingPlanOfferings`.
+ `StartTimeAfter`: specifica l’ora di inizio richiesta del piano. `StartTimeAfter` dovrebbe essere un valore `timestamp` o `ISO 8601 date/time` nel futuro.
+ `EndTimeBefore`: specifica l’ora di fine richiesta del piano in formato `timestamp` o `ISO 8601 date/time`. `EndTimeBefore` deve essere successivo di almeno 24 ore rispetto all’ora di inizio.
+ `UltraServerType`: Specificare il tipo di UltraServer oggetto da cercare. Per ulteriori informazioni su UltraServers, vedere[UltraServers nell'intelligenza artificiale SageMaker](reserve-capacity-with-training-plans.md#training-plans-ultraservers).
+ `UltraServerCount`: Specificare il numero UltraServers di elementi da cercare.
# Prenotazione del piano di addestramento ottimale
Dopo aver esaminato le offerte dei piani di addestramento disponibili più rispondenti alle tue esigenze, puoi prenotare un piano specifico chiamando l’operazione API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html). Una volta creato, il piano entra in stato `Pending` e vi resta fino al completamento del processo di prenotazione. La risposta alla chiamata API restituisce un nome della risorsa Amazon (ARN) del piano di addestramento. Prendi nota dell’ARN per le operazioni di tracciamento e monitoraggio successive. La prenotazione del piano di addestramento viene effettuata in modo asincrono nel backend. Il pagamento dell’importo totale viene riscosso automaticamente durante il processo di evasione dell’ordine. Dopo aver completato la transazione di pagamento e aver prenotato le capacità riservate richieste, il piano di addestramento viene impostato sullo stato `Scheduled` ed è pronto per la pianificazione.
**Importante**
I piani di addestramento non possono essere modificati una volta acquistati.
I piani di formazione non possono essere condivisi tra AWS account o all'interno AWS dell'organizzazione.
L'esempio seguente utilizza il AWS CLI comando an per richiedere un piano di allenamento specifico, passando l'ID del piano come parametro.
```
aws sagemaker create-training-plan \
--training-plan-offering-id "tpo-SHA-256-hash-value" \
--training-plan-name "name" \
```
Questo documento JSON è un esempio di risposta dell'API dei piani SageMaker di formazione. La risposta contiene il nome della risorsa Amazon (ARN) del piano di addestramento creato correttamente.
**Nota**
Il piano di addestramento rimane in stato `Pending` finché non viene completato il processo di evasione dell’ordine.
```
{
"TrainingPlanArn":"arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning"
}
```
Le sezioni seguenti definiscono i parametri di richiesta di input obbligatori e facoltativi per l’operazione API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html).
## Parametri obbligatori
Quando chiami l’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) per prenotare un particolare piano di addestramento, devi fornire i seguenti valori:
+ `TrainingPlanOfferingId`: l’ID del piano che stai scegliendo. Puoi recuperare l’ID dell’offerta di un piano nella risposta alla tua chiamata API `SearchTrainingPlanOfferings`. L’ID dovrebbe iniziare con `pto-*`.
+ `TrainingPlanName`: il nome del piano che stai creando.
# Elenco dei piani di addestramento
Puoi elencare tutti i piani di allenamento che sono stati creati nel tuo AWS account e nella tua regione chiamando l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html)API.
L'esempio seguente utilizza un AWS CLI comando per recuperare l'elenco dei piani di allenamento.
```
aws sagemaker list-training-plans \
--start-time-after "2024-09-26T00:00:01.000Z"
```
Questo documento JSON è un esempio di risposta dell'API dei piani SageMaker di formazione. La risposta fornisce dettagli su un piano di addestramento creato e prenotato correttamente.
```
{
"[TrainingPlanSummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html)": [
{
"AvailableInstanceCount": 2,
"CurrencyCode": "USD",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InUseInstanceCount": 2,
"[ReservedCapacitySummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ReservedCapacitySummary.html)": [
{
"AvailabilityZone": "string",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InstanceType": "ml.p5.48xlarge",
"ReservedCapacityArn": "arn:aws:sagemaker:us-east-1:123456789123:reserved-capacity/large-models-fine-tuning-rc1",
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"TotalInstanceCount": 4,
"UltraServerCount": 4,
"UltraServerType": "ml.p6e-gb200.36xlarge"
}
],
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"StatusMessage": "Payment confirmed, training plan scheduled."
"TargetResources": [ "training-job" ],
"TotalInstanceCount": 4,
"TotalUltraServerCount": 4,
"TrainingPlanArn": "arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning",
"TrainingPlanName": "large-models-fine-tuning",
"UpfrontFee": "xxxx.xx"
}
]
}
```
Le sezioni seguenti forniscono dettagli su alcuni parametri facoltativi che puoi passare alla richiesta API `ListTrainingPlans`.
## Parametri facoltativi
Le sezioni seguenti forniscono dettagli su alcuni parametri facoltativi che puoi passare alla richiesta API `ListTrainingPlans`.
+ `StartTimeAfter`: l’ora di inizio dell’intervallo di tempo effettivo dei piani elencati, specificata come `timestamp` o `ISO 8601 date/time`.
+ `StartTimeBefore`: l’ora di fine dell’intervallo di tempo effettivo dei piani elencati, specificata come `timestamp` o `ISO 8601 date/time`.
+ `Filters`: Criteri utilizzati per filtrare i risultati, con un massimo di 5 coppie nome-valore in cui «Nome» è il nome di un campo di a [TrainingPlanSummary](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html)e «Valore» è il valore da considerare per il filtro. Ad esempio, `Name=Status,Value=Active`.
L'esempio seguente utilizza un AWS CLI comando per recuperare l'elenco dei piani di allenamento, utilizzando alcuni dei parametri opzionali sopra descritti.
```
aws sagemaker list-training-plans --max-results 10 --sort-by StartTime --sort-order Descending --start-time-after 13000000 --filters Name=Status,Value=Active
```
# Visualizzazione dei dettagli del piano di addestramento
Per monitorare lo stato o recuperare i dettagli di un piano di addestramento, puoi utilizzare l’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html). La risposta dell’API include un campo `Status` che riflette lo stato attuale del piano di addestramento:
+ Se l’acquisto del piano non riesce, lo stato viene impostato su `Failed`.
+ Una volta completato il pagamento, lo stato passa da `Pending` a `Scheduled`, in base alla data di inizio del piano.
+ Quando il piano raggiunge la data di inizio, lo stato cambia in `Active`.
+ Per i piani con più capacità riservate discontinue, lo stato torna su `Scheduled` tra un periodo di attività e l’altro, finché non viene raggiunta la data di inizio della capacità riservata successiva.
+ Dopo la data di fine del piano, lo stato diventa `Expired`.
Una volta raggiunto lo stato`Scheduled`, è possibile utilizzare la capacità riservata nel piano per i lavori di SageMaker formazione o i carichi di lavoro HyperPod del cluster.
**Nota**
I job di addestramento associati al piano rimangono nello stato `Pending` fino a quando il piano non diventa `Active`.
Per HyperPod i cluster che utilizzano un piano di formazione per la capacità di calcolo, lo stato del gruppo di istanze viene visualizzato come una volta creato. `InService`
L'esempio seguente utilizza un AWS CLI comando per recuperare i dettagli di un piano di allenamento in base al nome.
```
aws sagemaker describe-training-plan \
--training-plan-name "name"
```
Questo documento JSON è un esempio di risposta dall'API dei piani SageMaker di formazione. Questa risposta fornisce dettagli su un piano di addestramento creato correttamente.
```
{
"AvailableInstanceCount": 2,
"CurrencyCode": "USD",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InUseInstanceCount": 2,
"[ReservedCapacitySummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ReservedCapacitySummary.html)": [
{
"AvailabilityZone": "string",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InstanceType": "ml.p5.48xlarge",
"ReservedCapacityArn": "arn:aws:sagemaker:us-east-1:123456789123:reserved-capacity/large-models-fine-tuning-rc1",
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"TotalInstanceCount": 4,
"UltraServerCount": 4,
"UltraServerType": "ml.p6e-gb200.36xlarge"
}
],
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"StatusMessage": "Payment confirmed, training plan scheduled."
"TargetResources": [ "training-job" ],
"TotalInstanceCount": 4,
"TotalUltraServerCount": 4,
"TrainingPlanArn": "arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning",
"TrainingPlanName": "large-models-fine-tuning",
"UpfrontFee": "xxxx.xx"
}
```
Le sezioni seguenti definiscono il parametro di richiesta di input obbligatorio per l’operazione API `DescribeTrainingPlan`.
## Parametri obbligatori
+ `TrainingPlanName`: il nome del piano di addestramento da descrivere.