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á.
# Extensão dos planos de treinamento
SageMaker os planos de treinamento permitem que você estenda seus planos de treinamento existentes para evitar interrupções na carga de trabalho. Quando um plano de treinamento está prestes a expirar, você pode estendê-lo diretamente por meio do console de SageMaker IA ou programaticamente usando a API ou. AWS CLI Isso elimina a necessidade de criar um novo plano e reconfigurar sua carga de trabalho com um novo ARN do plano de treinamento.
Com as extensões do plano de treinamento, seus trabalhos ou SageMaker HyperPod grupos de SageMaker treinamento em execução continuam funcionando perfeitamente, sem interrupção, uma vez que o plano é estendido. O plano estendido reflete a nova data de término e você pode recuperar o histórico de todas as extensões do seu plano de treinamento.
**Importante**
Observe que as extensões não podem ser canceladas ou modificadas para adicionar ou remover instâncias.
## Recursos principais do
+ Estenda os planos de treinamento por meio do console ou da API
+ Estenda os planos em incrementos de 1 dia até 14 dias ou incrementos de 7 dias até 182 dias
+ Estenda um plano várias vezes
+ Visualize/liste o histórico de extensões de seus planos de treinamento no console ou por meio da API
+ Continuação perfeita da execução de cargas de trabalho em SageMaker IA sem reconfiguração
## Pré-requisitos
Antes de estender um plano de treinamento, certifique-se do seguinte:
+ O plano de treinamento deve ter um status de `Active` ou`Scheduled`.
+ O plano não deve ter nenhuma extensão de `Payment Pending` status.
+ As extensões podem ser solicitadas até no mínimo 1 hora ou no máximo 56 dias antes da expiração do plano.
**Topics**
+ [Recursos principais do](#training-plan-extension-features)
+ [Pré-requisitos](#training-plan-extension-prerequisites)
+ [Estenda um plano de treinamento usando o console de SageMaker IA](training-plan-extension-using-console.md)
+ [Estenda um plano de treinamento usando a SageMaker API ou AWS CLI](training-plan-extension-using-api-cli-sdk.md)
# Estenda um plano de treinamento usando o console de SageMaker IA
SageMaker os planos de treinamento oferecem uma maneira conveniente de ampliar seus planos de treinamento existentes por meio da interface do console de SageMaker IA. Este guia explica o processo de extensão de um plano de treinamento para trabalhos e SageMaker HyperPod clusters de SageMaker treinamento usando o console de SageMaker IA.
Para estender um plano de treinamento usando o console:
1. Navegue até o console de SageMaker IA em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Escolha **Planos de treinamento** no painel de navegação esquerdo.
1. Selecione o plano de treinamento que você deseja estender na lista.
1. Escolha o botão **Estender**.
1. Insira a data de término desejada para sua extensão e escolha **Pesquisar** para encontrar as ofertas de extensão disponíveis.
1. Analise a lista de ofertas de extensão, que inclui detalhes como duração, zona de disponibilidade, taxa inicial e horários de início e término.
1. Selecione a oferta de extensão que melhor atenda às suas necessidades.
1. Revise os detalhes da extensão na caixa de diálogo de confirmação e escolha **Enviar** para confirmar sua compra.
Depois que a extensão é comprada, a data de término do plano de treinamento é atualizada para refletir a nova duração estendida.
## Exibir histórico de extensões
Para ver o histórico de extensões de um plano de treinamento:
1. Navegue até a página **Planos de treinamento** no console de SageMaker IA.
1. Selecione o plano de treinamento que você deseja visualizar.
1. Na página de detalhes do plano de treinamento, consulte a seção **Extensões** para ver todas as extensões anteriores, incluindo ID da oferta da extensão, datas de início e término, status e quando a extensão foi criada.
## 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.
# 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.