Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Perpanjangan rencana pelatihan
SageMaker rencana pelatihan memungkinkan Anda untuk memperluas rencana pelatihan yang ada untuk menghindari gangguan beban kerja. Saat rencana pelatihan mendekati kedaluwarsa, Anda dapat memperluasnya langsung melalui konsol SageMaker AI atau secara terprogram menggunakan API atau. AWS CLI Ini menghilangkan kebutuhan untuk membuat rencana baru dan mengkonfigurasi ulang beban kerja Anda dengan rencana pelatihan baru ARN.
Dengan ekstensi rencana pelatihan, pekerjaan atau SageMaker HyperPod cluster SageMaker pelatihan lari Anda terus bekerja dengan mulus tanpa gangguan setelah rencana diperpanjang. Rencana yang diperpanjang mencerminkan tanggal akhir yang baru, dan Anda dapat mengambil riwayat semua ekstensi untuk rencana pelatihan Anda.
**penting**
Harap dicatat ekstensi tidak dapat dibatalkan atau dimodifikasi untuk menambah atau menghapus instance.
## Fitur utama
+ Perluas rencana pelatihan melalui konsol atau API
+ Perpanjang paket dengan kenaikan 1 hari hingga 14 hari, atau kenaikan 7 hari hingga 182 hari
+ Perpanjang rencana beberapa kali
+ Lihat/ Daftar riwayat ekstensi untuk rencana pelatihan Anda di konsol atau melalui API
+ Kelanjutan mulus menjalankan beban kerja di SageMaker AI tanpa konfigurasi ulang
## Prasyarat
Sebelum memperpanjang rencana pelatihan, pastikan hal-hal berikut:
+ Rencana pelatihan harus memiliki status `Active` atau`Scheduled`.
+ Paket tidak boleh memiliki ekstensi dalam `Payment Pending` status.
+ Ekstensi dapat diminta hingga minimal 1 jam atau maksimal 56 hari sebelum paket berakhir.
**Topics**
+ [Fitur utama](#training-plan-extension-features)
+ [Prasyarat](#training-plan-extension-prerequisites)
+ [Perpanjang rencana pelatihan menggunakan konsol SageMaker AI](training-plan-extension-using-console.md)
+ [Memperluas rencana pelatihan menggunakan SageMaker API atau AWS CLI](training-plan-extension-using-api-cli-sdk.md)
# Perpanjang rencana pelatihan menggunakan konsol SageMaker AI
SageMaker Rencana pelatihan menawarkan cara mudah untuk memperluas rencana pelatihan Anda yang ada melalui UI konsol SageMaker AI. Panduan ini memandu Anda melalui proses memperluas rencana pelatihan untuk pekerjaan SageMaker pelatihan dan SageMaker HyperPod cluster menggunakan konsol SageMaker AI.
Untuk memperpanjang rencana pelatihan menggunakan konsol:
1. Arahkan ke konsol SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Pilih **Rencana Pelatihan** di panel navigasi kiri.
1. Pilih rencana pelatihan yang ingin Anda perluas dari daftar.
1. Pilih tombol **Perpanjang**.
1. Masukkan tanggal akhir yang diinginkan untuk ekstensi Anda dan pilih **Cari** untuk menemukan penawaran ekstensi yang tersedia.
1. Tinjau daftar penawaran ekstensi, yang mencakup detail seperti durasi, zona ketersediaan, biaya di muka, dan waktu mulai dan akhir.
1. Pilih penawaran ekstensi yang paling sesuai dengan kebutuhan Anda.
1. Tinjau detail ekstensi di dialog konfirmasi, lalu pilih **Kirim** untuk mengonfirmasi pembelian Anda.
Setelah perpanjangan dibeli, tanggal akhir rencana pelatihan diperbarui untuk mencerminkan durasi baru yang diperpanjang.
## Lihat riwayat ekstensi
Untuk melihat riwayat ekstensi untuk rencana pelatihan:
1. Arahkan ke halaman **Rencana Pelatihan** di konsol SageMaker AI.
1. Pilih rencana pelatihan yang ingin Anda lihat.
1. Di halaman detail rencana pelatihan, lihat bagian **Ekstensi** untuk melihat semua ekstensi sebelumnya, termasuk ID penawaran ekstensi, tanggal mulai dan berakhir, status, dan kapan ekstensi dibuat.
## 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.
# 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.