As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Reservar o melhor plano de treinamento
<a name="choose-best-training-plan-using-api-cli-sdk"></a>

Depois de analisar as ofertas de plano de treinamento disponíveis que melhor atendem às suas necessidades, você pode reservar um plano específico chamando a operação de API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html). Quando criado, a princípio o plano entra em um estado `Pending` e permanece nele até que o processo de reserva seja concluído. A resposta à chamada de API exibirá o nome do recurso da Amazon (ARN) do plano de treinamento. Anote esse ARN para fins de rastreamento e monitoramento posteriores. A reserva do plano de treinamento é preenchida de forma assíncrona no backend. O pagamento do valor total é cobrado como parte do processo de atendimento. Depois que a transação de pagamento é concluída e as capacidades reservadas solicitadas são garantidas, o plano de treinamento é definido com o estado `Scheduled` e está pronto para ser agendado.

**Importante**  
Os planos de treinamento não podem ser modificados após a compra.
Os planos de treinamento não podem ser compartilhados entre AWS contas ou dentro AWS da sua organização.

O exemplo a seguir usa o AWS CLI comando an para solicitar um plano de treinamento específico, passando o ID do plano como parâmetro.

```
aws sagemaker create-training-plan \
--training-plan-offering-id "tpo-SHA-256-hash-value" \
--training-plan-name "name" \
```

Este documento JSON é um exemplo de resposta da API de planos de SageMaker treinamento. A resposta contém o nome do recurso da Amazon (ARN) do plano de treinamento que foi criado com êxito.

**nota**  
O plano de treinamento permanece no status `Pending` até que o processo de atendimento seja concluído.

```
{
   "TrainingPlanArn":"arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning"
}
```

As seções a seguir definem os parâmetros de solicitação de entrada obrigatórios e opcionais para a operação de API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html).

## Parâmetros necessários
<a name="choose-best-training-plan-using-api-cli-sdk-required-params"></a>

Ao chamar a API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) para reservar um plano de treinamento específico, você deve fornecer os seguintes valores:
+ `TrainingPlanOfferingId`: o ID do plano que você está escolhendo. Você pode recuperar o ID de uma oferta de plano na resposta da chamada de API `SearchTrainingPlanOfferings`. O formato deve começar com `pto-*`.
+ `TrainingPlanName`: o nome do plano que você está criando.