Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memperluas rencana pelatihan menggunakan SageMaker API atau AWS CLI
SageMaker rencana pelatihan mendukung perluasan rencana pelatihan secara terprogram melalui API-nya. Anda dapat berinteraksi dengan API rencana pelatihan menggunakan AWS CLI atau SageMaker SDKs.
Ekstensi rencana pelatihan melibatkan tindakan API berikut:
+ **`SearchTrainingPlanOfferings`:** Cari penawaran ekstensi yang tersedia dengan menentukan ARN rencana pelatihan Anda dan durasi ekstensi yang diinginkan. API mengembalikan penawaran ekstensi di bidang. `TrainingPlanExtensionOfferings`
+ **`ExtendTrainingPlan`:** Beli penawaran ekstensi khusus untuk memperpanjang rencana pelatihan Anda dengan menyediakan`TrainingPlanExtensionOfferingId`. Ini mencadangkan kapasitas komputasi tambahan dan memperbarui tanggal akhir rencana pelatihan Anda.
+ **`DescribeTrainingPlanExtensionHistory`:** Lihat riwayat ekstensi lengkap untuk rencana pelatihan, termasuk semua ekstensi sebelumnya dengan status, tanggal, dan informasi pembayarannya.
**Topics**
+ [Cari penawaran ekstensi](search-extension-offerings-api-cli-sdk.md)
+ [Beli ekstensi](extend-training-plan-api-cli-sdk.md)
+ [Lihat riwayat ekstensi](describe-extension-history-api-cli-sdk.md)
# Cari penawaran ekstensi
Gunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API dengan `TrainingPlanArn` parameter untuk menemukan penawaran ekstensi yang tersedia untuk rencana pelatihan Anda.
Contoh berikut menggunakan AWS CLI perintah untuk mencari penawaran ekstensi untuk rencana pelatihan yang ada.
```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```
Dokumen JSON ini adalah contoh respons dari API rencana SageMaker pelatihan. Tanggapan termasuk `TrainingPlanExtensionOfferings` berisi penawaran ekstensi yang tersedia untuk rencana pelatihan yang ditentukan.
```
{
"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"
}
]
}
```
Bagian berikut menentukan parameter permintaan input wajib dan opsional untuk operasi `SearchTrainingPlanOfferings` API saat mencari penawaran ekstensi.
## Parameter yang diperlukan
Saat memanggil [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API untuk mencari penawaran ekstensi, Anda harus memberikan nilai berikut:
+ `TrainingPlanArn`: Rencana pelatihan yang ingin Anda perpanjang. `TrainingPlanArn`Harus mereferensikan rencana pelatihan yang ada dengan status `Active` atau`Scheduled`.
## Parameter opsional
Bagian berikut memberikan detail tentang beberapa parameter opsional yang dapat Anda teruskan ke permintaan `SearchTrainingPlanOfferings` API saat mencari penawaran ekstensi.
+ `DurationHours`: Durasi yang diinginkan dalam jam untuk ekstensi. `DurationHours`Dibulatkan ke kelipatan terdekat dari 24.
# Beli ekstensi
Setelah memilih penawaran ekstensi, gunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API untuk membeli ekstensi.
Contoh berikut menggunakan AWS CLI perintah untuk memperpanjang rencana pelatihan.
```
aws sagemaker extend-training-plan \
--training-plan-extension-offering-id "tpeo-SHA-256-hash-value"
```
Dokumen JSON ini adalah contoh respons dari API rencana SageMaker pelatihan. Tanggapan tersebut mencakup daftar ekstensi untuk rencana pelatihan.
```
{
"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"
}
]
}
```
Bagian berikut mendefinisikan parameter permintaan input wajib untuk operasi `ExtendTrainingPlan` API.
## Parameter yang diperlukan
Saat memanggil [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API untuk memperpanjang rencana pelatihan, Anda harus memberikan nilai berikut:
+ `TrainingPlanExtensionOfferingId`: ID dari penawaran ekstensi yang Anda beli. Anda dapat mengambil ID ini dari `TrainingPlanExtensionOfferings` respons panggilan `SearchTrainingPlanOfferings` API Anda. Formatnya harus dimulai dengan`tpeo-*`.
# Lihat riwayat ekstensi
Gunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API untuk melihat riwayat ekstensi lengkap untuk rencana pelatihan.
Contoh berikut menggunakan AWS CLI perintah untuk mengambil riwayat ekstensi.
```
aws sagemaker describe-training-plan-extension-history \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan"
```
Dokumen JSON ini adalah contoh respons dari API rencana SageMaker pelatihan. Tanggapan tersebut mencakup daftar paginasi semua ekstensi untuk rencana pelatihan.
```
{
"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
}
```
Bagian berikut menentukan parameter permintaan input wajib dan opsional untuk operasi `DescribeTrainingPlanExtensionHistory` API.
## Parameter yang diperlukan
Saat memanggil [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API, Anda harus memberikan nilai berikut:
+ `TrainingPlanArn`: Rencana pelatihan untuk mengambil riwayat ekstensi untuk.
## Parameter opsional
Bagian berikut memberikan detail tentang beberapa parameter opsional yang dapat Anda teruskan ke permintaan `DescribeTrainingPlanExtensionHistory` API Anda.
+ `NextToken`: Jika respons sebelumnya terpotong, Anda menerima token ini. Gunakan dalam permintaan Anda berikutnya untuk menerima set hasil berikutnya.
+ `MaxResults`: Jumlah maksimum ekstensi untuk kembali dalam respons.
## Nilai status ekstensi
Ekstensi dapat memiliki nilai status berikut:
+ `Pending`: Perpanjangan telah diminta dan sedang menunggu pemrosesan pembayaran.
+ `Active`: Ekstensi telah berhasil dibeli dan aktif.
+ `Scheduled`: Perpanjangan dijadwalkan untuk dimulai di masa depan.
+ `Failed`: Pembelian ekstensi gagal (misalnya, karena masalah pembayaran).
+ `Expired`: Periode perpanjangan telah berakhir.