Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Recherche d’offres de plans d’entraînement

Pour créer un plan d’entraînement, commencez par appeler l’opération d’API SearchTrainingPlanOfferings, en transmettant les exigences de votre plan (telles que le type d’instance, le nombre et la fenêtre temporelle souhaitée) en tant que paramètres d’entrée. Les plans d’entraînement sont spécifiques à la ressource cible. Veillez à spécifier la ressource cible pour laquelle le plan sera utilisé (training-job ou hyperpod-cluster). L’API renvoie la liste des offres disponibles qui correspondent à vos exigences. Si aucune offre appropriée n’est trouvée, vous devrez peut-être ajuster vos exigences et effectuer une nouvelle recherche.

Cet appel d’API permet d’extraire les offres de plans d’entraînement qui répondent le mieux à vos besoins en capacité. Chaque élément TrainingPlanOffering renvoyé en réponse est identifié par un identifiant d’offre unique. La première offre de la liste représente celle qui correspond le mieux à vos exigences. Si aucun plan d’entraînement adapté n’est disponible aux dates que vous avez spécifiées, la liste est vide. Ajustez vos critères de recherche et recherchez un nouvel ensemble d’offres.

Pour en savoir plus sur la liste des instances disponibles prises en charge par les plans de SageMaker formation, consultezTypes d'instances pris Régions AWS en charge et tarifs.

L'exemple suivant utilise une AWS CLI commande pour demander des offres de plan de formation avec un type d'instance, un nombre et des informations temporelles spécifiés.

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

Ce document JSON est un exemple de réponse provenant de l'API des plans de SageMaker formation. Cette réponse fournit des informations sur plusieurs offres de plans d’entraînement disponibles qui répondent aux exigences de capacité spécifiées. Il comprend trois offres distinctes avec des durées, des frais initiaux et des start/end durées variables, qui utilisent toutes le même type d'instance et ciblent les tâches de formation.

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

Voici un exemple de commande expliquant comment utiliser le AWS CLI pour rechercher des offres de plans de formation qui incluent 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"
                }
            ]
        }
    ]
}

Les sections suivantes définissent les paramètres de demande d’entrée obligatoires et facultatifs pour l’opération d’API SearchTrainingPlanOfferings.

Paramètres requis

Lorsque vous appelez l’API SearchTrainingPlanOfferings pour répertorier les offres de plans d’entraînement qui répondent à vos exigences, vous devez fournir les valeurs suivantes :

Paramètres facultatifs

Les sections suivantes fournissent des détails sur certains paramètres facultatifs que vous pouvez transmettre à votre demande d’API SearchTrainingPlanOfferings.