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

# Exibir histórico de extensões
<a name="describe-extension-history-api-cli-sdk"></a>

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

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

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
<a name="extension-status-values-api"></a>

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.