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