Suchen Sie nach Angeboten für Schulungspläne

Um einen Schulungsplan zu erstellen, rufen Sie zunächst den SearchTrainingPlanOfferingsAPI-Vorgang auf und übergeben Sie Ihre Plananforderungen (wie Instanztyp, Anzahl und gewünschtes Zeitfenster) als Eingabeparameter. Trainingspläne sind spezifisch für die jeweilige Zielressource. Stellen Sie sicher, dass Sie angeben, für welche Zielressource der Plan verwendet werden soll (training-joboderhyperpod-cluster). Die API gibt eine Liste verfügbarer Angebote zurück, die Ihren Anforderungen entsprechen. Wenn keine geeigneten Angebote gefunden werden, müssen Sie möglicherweise Ihre Anforderungen anpassen und erneut suchen.

Dieser API-Aufruf ruft die Schulungsplan-Angebote ab, die Ihren Kapazitätsanforderungen am besten entsprechen. Jedes in der Antwort TrainingPlanOfferingzurückgegebene Objekt wird durch eine eindeutige Angebots-ID identifiziert. Das erste Angebot in der Liste entspricht Ihren Anforderungen am besten. Wenn innerhalb der von Ihnen angegebenen Daten kein geeigneter Trainingsplan verfügbar ist, ist die Liste leer. Passen Sie Ihre Suchkriterien an und suchen Sie nach neuen Angeboten.

Informationen zur Liste der verfügbaren Instances, die von SageMaker Schulungsplänen unterstützt werden, finden Sie unterUnterstützte Instanztypen und Preise AWS-Regionen.

Im folgenden Beispiel wird ein AWS CLI Befehl verwendet, um Trainingsplanangebote mit einem bestimmten Instanztyp, einer bestimmten Anzahl und Zeitinformationen anzufordern.

# 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"

Dieses JSON-Dokument ist eine Beispielantwort aus der SageMaker Schulungsplan-API. Die Antwort enthält Informationen zu mehreren verfügbaren Schulungsplanangeboten, die den angegebenen Kapazitätsanforderungen entsprechen. Es umfasst drei unterschiedliche Angebote mit unterschiedlichen Laufzeiten, Vorabgebühren und Start-/Endzeiten, die alle denselben Instance-Typ verwenden und auf Schulungsjobs ausgerichtet sind.

{
    "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"
                }
            ]
        }
    ]
}

In den folgenden Abschnitten werden die obligatorischen und optionalen Eingabeanforderungsparameter für den API-Vorgang definiert. SearchTrainingPlanOfferings

Erforderliche Parameter

Wenn Sie die SearchTrainingPlanOfferingsAPI aufrufen, um Angebote für Schulungspläne aufzulisten, die Ihren Anforderungen entsprechen, müssen Sie die folgenden Werte angeben:

Optionale Parameter

In den folgenden Abschnitten finden Sie Einzelheiten zu einigen optionalen Parametern, die Sie an Ihre SearchTrainingPlanOfferings API-Anfrage übergeben können.