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á.

# Pesquise ofertas de extensão
<a name="search-extension-offerings-api-cli-sdk"></a>

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
<a name="search-extension-offerings-required-params"></a>

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
<a name="search-extension-offerings-optional-params"></a>

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.