本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 搜尋延伸產品
<a name="search-extension-offerings-api-cli-sdk"></a>

使用 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html) API 搭配 `TrainingPlanArn` 參數，為您的訓練計劃尋找可用的延伸產品。

下列範例使用 AWS CLI 命令來搜尋現有訓練計畫的延伸產品。

```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```

此 JSON 文件是來自 SageMaker 訓練計畫 API 的範例回應。回應包含指定訓練計畫`TrainingPlanExtensionOfferings`可用的延伸產品。

```
{
    "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"
        }
    ]
}
```

下列各節定義 API `SearchTrainingPlanOfferings`操作在搜尋延伸項目時的必要和選用輸入請求參數。

## 必要參數
<a name="search-extension-offerings-required-params"></a>

呼叫 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html) API 來搜尋延伸產品時，您必須提供下列值：
+ `TrainingPlanArn`：您要延伸的訓練計畫的 。必須`TrainingPlanArn`參考狀態為 `Active`或 的現有訓練計畫`Scheduled`。

## 選用的參數
<a name="search-extension-offerings-optional-params"></a>

下列各節提供一些選用參數的詳細資訊，您可以在搜尋延伸產品時傳遞給 `SearchTrainingPlanOfferings` API 請求。
+ `DurationHours`：擴充功能的所需持續時間，以小時為單位。`DurationHours` 會四捨五入至最接近的 24 倍數。