Parâmetros necessários Parâmetros opcionais

Pesquisar ofertas de planos de treinamento

Para criar um plano de treinamento, comece chamando a operação da SearchTrainingPlanOfferingsAPI, passando os requisitos do plano (como tipo de instância, contagem e janela de tempo desejada) como parâmetros de entrada. Os planos de treinamento são específicos para seu recurso alvo. Certifique-se de especificar para qual recurso de destino o plano será usado (training-jobouhyperpod-cluster). A API retorna uma lista de ofertas disponíveis que atendem aos seus requisitos. Se nenhuma oferta adequada for encontrada, talvez seja necessário ajustar seus requisitos e pesquisar novamente.

Essa chamada de API recupera as ofertas do plano de treinamento que melhor atendem às suas necessidades de capacidade. Cada resposta TrainingPlanOfferingretornada é identificada por um ID de oferta exclusivo. A primeira oferta da lista representa a melhor opção para suas necessidades. Se nenhum plano de treinamento adequado estiver disponível nas datas especificadas, a lista estará vazia. Ajuste seus critérios de pesquisa e procure um novo conjunto de ofertas.

As durações das reservas estão disponíveis em incrementos de 1 dia, de 1 a 182 dias.
As opções de quantidade de instâncias de reserva são 1, 2, 4, 8, 16, 32 ou 64 instâncias.

Para saber mais sobre a lista de instâncias disponíveis suportadas pelos planos de SageMaker treinamento, consulteTipos de instância Regiões da AWS e preços suportados.

O exemplo a seguir usa um AWS CLI comando para solicitar ofertas de planos de treinamento com informações específicas sobre tipo de instância, contagem e horário.


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

Este documento JSON é um exemplo de resposta da API de planos de SageMaker treinamento. A resposta fornece informações sobre várias ofertas de planos de treinamento disponíveis que atendem aos requisitos de capacidade especificados. Inclui três ofertas distintas com durações, taxas iniciais e start/end horários variados, todas usando o mesmo tipo de instância e visando trabalhos de treinamento.


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

A seguir está um exemplo de comando de como usar o AWS CLI para pesquisar ofertas de planos de treinamento que UltraServers incluam.


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

As seções a seguir definem os parâmetros de solicitação de entrada obrigatórios e opcionais para a operação SearchTrainingPlanOfferings da API.

Parâmetros necessários

Ao chamar a SearchTrainingPlanOfferingsAPI para listar ofertas de planos de treinamento que atendam aos seus requisitos, você deve fornecer os seguintes valores:

TargetResources: os recursos-alvo (training-jobouhyperpod-cluster) para os quais o plano será usado. O valor padrão é training-job. Os planos de treinamento são específicos para seu recurso alvo.
- Um plano de treinamento projetado para trabalhos de SageMaker treinamento só pode ser usado para agendar e executar trabalhos de treinamento.
- Um plano de treinamento para HyperPod clusters pode ser usado exclusivamente para fornecer recursos computacionais ao grupo de instâncias de um cluster.
InstanceType: o tipo de instância a ser provisionada. O InstanceType deve ser de um tipo compatível.

Para saber mais sobre a lista de instâncias disponíveis suportadas pelos planos de SageMaker treinamento, consulteTipos de instância Regiões da AWS e preços suportados.
InstanceCount: o número de instâncias a serem provisionadas. Se o número de instâncias for maior que 1, deve ser uma potência de 2.
DurationHour: A duração total do plano solicitado em horas. O DurationHour é arredondado para o múltiplo mais próximo de 24.

Parâmetros opcionais

As seções a seguir fornecem detalhes sobre alguns parâmetros opcionais que você pode passar para sua solicitação de SearchTrainingPlanOfferings API.

StartTimeAfter: especifique a hora de início solicitada do plano. StartTimeAfterDeve ser um timestamp ou um ISO 8601 date/time valor no futuro.
EndTimeBefore: especifique a hora de término solicitada do plano em um ISO 8601 date/time formato timestamp ou em um. EndTimeBeforeDeve ser pelo menos 24 horas após o horário de início.
UltraServerType: especifique o tipo UltraServer de pesquisa. Para obter mais informações sobre UltraServers, consulteUltraServers em SageMaker IA.
UltraServerCount: especifique o número de UltraServers a serem pesquisados.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Crie um plano de treinamento programaticamente

Reserve o melhor plano de treinamento