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á.
# Estenda um plano de treinamento usando a SageMaker API ou AWS CLI
SageMaker os planos de treinamento oferecem suporte à extensão programática dos planos de treinamento por meio de sua API. Você pode interagir com a API de planos de treinamento usando o AWS CLI ou SageMaker SDKs.
A extensão do plano de treinamento envolve as seguintes ações de API:
+ **`SearchTrainingPlanOfferings`:** pesquise as ofertas de extensão disponíveis especificando o ARN do seu plano de treinamento e a duração da extensão desejada. A API retorna ofertas de extensão em `TrainingPlanExtensionOfferings` campo.
+ **`ExtendTrainingPlan`:** Adquira uma oferta de extensão específica para ampliar seu plano de treinamento fornecendo `TrainingPlanExtensionOfferingId` o. Isso reserva a capacidade computacional adicional e atualiza a data de término do seu plano de treinamento.
+ **`DescribeTrainingPlanExtensionHistory`:** veja o histórico completo de extensões de um plano de treinamento, incluindo todas as extensões anteriores com status, datas e informações de pagamento.
**Topics**
+ [Pesquise ofertas de extensão](search-extension-offerings-api-cli-sdk.md)
+ [Compre uma extensão](extend-training-plan-api-cli-sdk.md)
+ [Exibir histórico de extensões](describe-extension-history-api-cli-sdk.md)
# Pesquise ofertas de extensão
Use a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API com o `TrainingPlanArn` parâmetro para encontrar ofertas de extensão disponíveis para seu plano de treinamento.
O exemplo a seguir usa um AWS CLI comando para pesquisar ofertas de extensão para um plano de treinamento existente.
```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```
Este documento JSON é um exemplo de resposta da API de planos de SageMaker treinamento. A resposta inclui `TrainingPlanExtensionOfferings` conter as ofertas de extensão disponíveis para o plano de treinamento especificado.
```
{
"TrainingPlanOfferings": [],
"TrainingPlanExtensionOfferings": [
{
"TrainingPlanExtensionOfferingId": "tpeo-SHA-256-hash-value",
"AvailabilityZone": "us-east-2a",
"StartDate": "2025-09-23T12:00:00Z",
"EndDate": "2025-09-25T12:00:00Z",
"DurationHours": 48,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD"
}
]
}
```
As seções a seguir definem os parâmetros de solicitação de entrada obrigatórios e opcionais para a operação da `SearchTrainingPlanOfferings` API ao pesquisar ofertas de extensão.
## Parâmetros necessários
Ao chamar a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API para pesquisar ofertas de extensão, você deve fornecer o seguinte valor:
+ `TrainingPlanArn`: O do plano de treinamento que você deseja estender. Eles `TrainingPlanArn` devem fazer referência a um plano de treinamento existente com um status de `Active` ou`Scheduled`.
## 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 ao pesquisar ofertas de extensão.
+ `DurationHours`: A duração desejada em horas para a extensão. `DurationHours` é arredondado para o próximo múltiplo de 24.
# Compre uma extensão
Depois de selecionar uma oferta de extensão, use a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API para comprar a extensão.
O exemplo a seguir usa um AWS CLI comando para estender um plano de treinamento.
```
aws sagemaker extend-training-plan \
--training-plan-extension-offering-id "tpeo-SHA-256-hash-value"
```
Este documento JSON é um exemplo de resposta da API de planos de SageMaker treinamento. A resposta inclui a lista de extensões do plano de treinamento.
```
{
"TrainingPlanExtensions": [
{
"TrainingPlanExtensionOfferingId": "tpeo-SHA-256-hash-value",
"ExtendedAt": "2025-09-17T10:00:00Z",
"StartDate": "2025-09-23T12:00:00Z",
"EndDate": "2025-09-25T12:00:00Z",
"Status": "Pending",
"PaymentStatus": "Pending",
"AvailabilityZone": "us-east-2a",
"DurationHours": 48,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD"
}
]
}
```
A seção a seguir define o parâmetro de solicitação de entrada obrigatório para a operação `ExtendTrainingPlan` da API.
## Parâmetros necessários
Ao chamar a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API para estender um plano de treinamento, você deve fornecer o seguinte valor:
+ `TrainingPlanExtensionOfferingId`: o ID da oferta de extensão que você está comprando. Você pode recuperar esse ID `TrainingPlanExtensionOfferings` na resposta da sua chamada de `SearchTrainingPlanOfferings` API. O formato deve começar com `tpeo-*`.
# Exibir histórico de extensões
Use a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API para ver o histórico completo de extensões de um plano de treinamento.
O exemplo a seguir usa um AWS CLI comando para recuperar o histórico da extensão.
```
aws sagemaker describe-training-plan-extension-history \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan"
```
Este documento JSON é um exemplo de resposta da API de planos de SageMaker treinamento. A resposta inclui uma lista paginada de todas as extensões do plano de treinamento.
```
{
"TrainingPlanExtensions": [
{
"TrainingPlanExtensionOfferingId": "tpeo-SHA-256-hash-value",
"ExtendedAt": "2025-09-17T10:00:00Z",
"StartDate": "2025-09-23T12:00:00Z",
"EndDate": "2025-09-25T12:00:00Z",
"Status": "Active",
"PaymentStatus": "Completed",
"AvailabilityZone": "us-east-2a",
"DurationHours": 48,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD"
}
],
"NextToken": null
}
```
As seções a seguir definem os parâmetros de solicitação de entrada obrigatórios e opcionais para a operação de API `DescribeTrainingPlanExtensionHistory`.
## Parâmetros necessários
Ao chamar a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API, você deve fornecer o seguinte valor:
+ `TrainingPlanArn`: O do plano de treinamento para o qual recuperar o histórico de extensões.
## Parâmetros opcionais
As seções a seguir fornecem detalhes de alguns parâmetros opcionais que você pode passar para a solicitação de API `DescribeTrainingPlanExtensionHistory`.
+ `NextToken`: se a resposta anterior tiver sido truncada, você receberá esse token. Use-o em sua próxima solicitação para receber o próximo conjunto de resultados.
+ `MaxResults`: o número máximo de extensões a serem retornadas na resposta.
## Valores de status da extensão
As extensões podem ter os seguintes valores de status:
+ `Pending`: A extensão foi solicitada e está aguardando o processamento do pagamento.
+ `Active`: A extensão foi comprada com sucesso e está ativa.
+ `Scheduled`: a extensão está programada para começar futuramente.
+ `Failed`: a compra da extensão falhou (por exemplo, devido a problemas de pagamento).
+ `Expired`: O período de extensão terminou.