Cerca le offerte relative ai piani di formazione

Per creare un piano di formazione, inizia chiamando l'operatore dell'SearchTrainingPlanOfferingsAPI e inserendo i requisiti del piano (come il tipo di istanza, il conteggio e la finestra temporale desiderata) come parametri di input. I piani di formazione sono specifici per la risorsa target. Assicurati di specificare per quale risorsa target verrà utilizzato il piano (training-jobohyperpod-cluster). L'API restituisce un elenco di offerte disponibili che soddisfano i tuoi requisiti. Se non vengono trovate offerte adatte, potrebbe essere necessario modificare i requisiti ed effettuare nuovamente la ricerca.

Questa chiamata API recupera le offerte di piani di formazione che meglio soddisfano le vostre esigenze di capacità. Ogni elemento TrainingPlanOfferingrestituito nella risposta è identificato da un ID di offerta univoco. La prima offerta dell'elenco rappresenta la soluzione migliore per le tue esigenze. Se non è disponibile un piano di allenamento adeguato entro le date specificate, l'elenco è vuoto. Modifica i criteri di ricerca e cerca una nuova serie di offerte.

Per maggiori informazioni sull'elenco delle istanze disponibili supportate dai piani di SageMaker formazione, consulta. Tipi di istanze supportati e prezzi Regioni AWS

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 più offerte di piani di formazione disponibili che soddisfano i requisiti di capacità specificati. Include tre offerte distinte con durate diverse, tariffe anticipate e orari di inizio/fine, 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"
                }
            ]
        }
    ]
}

Le sezioni seguenti definiscono i parametri di richiesta di input obbligatori e facoltativi per il funzionamento dell'API. SearchTrainingPlanOfferings

Parametri obbligatori

Quando chiami l'SearchTrainingPlanOfferingsAPI per elencare le offerte di piani di formazione che soddisfano i tuoi requisiti, devi fornire i seguenti valori:

Parametri facoltativi

Le seguenti sezioni forniscono dettagli su alcuni parametri opzionali che puoi passare alla tua richiesta SearchTrainingPlanOfferings API.