Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# SageMaker pembuatan rencana pelatihan menggunakan SageMaker API, atau AWS CLI
SageMaker rencana pelatihan mendukung pembuatan program rencana pelatihan melalui API-nya. Anda dapat berinteraksi dengan API rencana pelatihan menggunakan AWS CLI atau SageMaker SDKs.
SageMaker Tindakan API rencana pelatihan menyediakan alur kerja yang komprehensif untuk mengelola rencana pelatihan secara terprogram:
+ **`SearchTrainingPlanOfferings`:** Memungkinkan pengguna untuk menanyakan dan menemukan sumber daya komputasi yang tersedia dengan menentukan parameter seperti jenis instans, hitungan, dan jendela waktu yang diinginkan. API mengembalikan daftar peringkat penawaran rencana pelatihan yang paling sesuai dengan kebutuhan pengguna.
+ **`CreateTrainingPlan`:** Memungkinkan reservasi penawaran rencana pelatihan tertentu, mengubah kapasitas komputasi potensial menjadi kapasitas cadangan terjadwal dengan rencana pelatihan ARN yang unik.
+ **`ListTrainingPlans`:** Menyediakan metode untuk mengambil dan meninjau semua rencana pelatihan yang ada di AWS akun pengguna, dengan kemampuan penyaringan dan penyortiran opsional.
+ **`DescribeTrainingPlan`:** Menawarkan wawasan terperinci tentang rencana pelatihan tertentu, termasuk tahapan siklus hidupnya dari hingga ke`Pending`. `Active` `Expired`
+ **`ExtendTrainingPlan`:** Memperluas rencana pelatihan yang ada dengan membeli penawaran ekstensi. Untuk informasi selengkapnya, lihat [Perpanjangan rencana pelatihan](training-plan-extension.md).
+ **`DescribeTrainingPlanExtensionHistory`:** Mengambil riwayat ekstensi untuk rencana pelatihan. Untuk informasi selengkapnya, lihat [Perpanjangan rencana pelatihan](training-plan-extension.md).
**Topics**
+ [Cari penawaran rencana pelatihan](search-training-plan-offerings-api-cli-sdk.md)
+ [Pesan rencana pelatihan terbaik](choose-best-training-plan-using-api-cli-sdk.md)
+ [Daftar rencana pelatihan](list-training-plans-using-api-cli-sdk.md)
+ [Lihat detail rencana pelatihan](training-plan-details-using-api-cli-sdk.md)
# Cari penawaran rencana pelatihan
Untuk membuat rencana pelatihan, mulailah dengan memanggil operasi [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API, meneruskan persyaratan paket Anda (seperti jenis instans, hitungan, dan jendela waktu yang diinginkan) sebagai parameter input. Rencana pelatihan khusus untuk sumber daya target mereka. Pastikan Anda menentukan sumber daya target mana yang akan digunakan untuk rencana (`training-job`atau`hyperpod-cluster`). API menampilkan daftar penawaran yang tersedia yang sesuai dengan kebutuhan Anda. Jika tidak ada penawaran yang cocok ditemukan, Anda mungkin perlu menyesuaikan kebutuhan Anda dan mencari lagi.
Panggilan API ini mengambil penawaran rencana pelatihan yang paling sesuai dengan kebutuhan kapasitas Anda. Setiap yang [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanOffering.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanOffering.html)dikembalikan dalam respons diidentifikasi oleh ID penawaran unik. Penawaran pertama dalam daftar mewakili kecocokan terbaik untuk kebutuhan Anda. Jika tidak ada rencana pelatihan yang sesuai tersedia dalam tanggal yang Anda tentukan, daftarnya kosong. Sesuaikan kriteria pencarian Anda dan cari serangkaian penawaran baru.
+ Durasi reservasi tersedia dalam kenaikan 1 hari dari 1 hingga 182 hari.
+ Opsi kuantitas instance reservasi adalah 1, 2, 4, 8, 16, 32 atau 64 instance.
Untuk mempelajari tentang daftar instans yang tersedia yang didukung oleh rencana SageMaker pelatihan, lihat[Jenis instans yang didukung Wilayah AWS,, dan harga](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions).
Contoh berikut menggunakan AWS CLI perintah untuk meminta penawaran rencana pelatihan dengan jenis instans tertentu, jumlah, dan informasi waktu.
```
# List training plan offerings with instance type, instance count, duration in hours, start time after, and end time before.
aws sagemaker search-training-plan-offerings \
--target-resources "training-job" \
--instance-type "ml.p4d.24xlarge" \
--instance-count 1 \
--duration-hours 15 \
--start-time-after "1737484800"
--end-time-before "1737657600"
```
Dokumen JSON ini adalah contoh respons dari API rencana SageMaker pelatihan. Tanggapan tersebut memberikan informasi tentang beberapa penawaran rencana pelatihan yang tersedia yang sesuai dengan persyaratan kapasitas yang ditentukan. Ini mencakup tiga penawaran berbeda dengan durasi yang bervariasi, biaya di muka, dan start/end waktu, semuanya menggunakan jenis instans yang sama dan menargetkan pekerjaan pelatihan.
```
{
"TrainingPlanOfferings": [
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 15,
"DurationMinutes": 51,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 15,
"DurationMinutes": 51,
"StartTime": "2025-01-21T11:39:00-08:00",
"EndTime": "2025-01-22T03:30:00-08:00"
}
]
},
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 39,
"DurationMinutes": 51,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 39,
"DurationMinutes": 51,
"StartTime": "2025-01-21T11:39:00-08:00",
"EndTime": "2025-01-23T03:30:00-08:00"
}
]
},
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 24,
"DurationMinutes": 0,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 24,
"DurationMinutes": 0,
"StartTime": "2025-01-22T03:30:00-08:00",
"EndTime": "2025-01-23T03:30:00-08:00"
}
]
}
]
}
```
Berikut ini adalah contoh perintah tentang cara menggunakan AWS CLI untuk mencari penawaran rencana pelatihan yang mencakup. UltraServers
```
aws sagemaker search-training-plan-offerings \
--ultra-server-type ml.c6i-32xlargesc \
--ultra-server-count 1 \
--duration-hours 24 \
--target-resources hyperpod-cluster
--start-time-after "1737484800" \
--end-time-before "1737657600"
```
```
{
"TrainingPlanOfferings": [
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-07-21T16:59:25.760000+00:00",
"DurationHours": 24,
"DurationMinutes": 0,
"UpfrontFee": "0.24",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"ReservedCapacityType": "UltraServer",
"UltraServerType": "ml.u-p6e-gb200x72",
"UltraServerCount": 1,
"InstanceType": "ml.p6e-gb200.36xlarge",
"InstanceCount": 18,
"AvailabilityZone": "us-east-2a",
"DurationHours": 24,
"DurationMinutes": 0,
"StartTime": "2025-07-22T11:30:00+00:00",
"EndTime": "2025-07-23T11:30:00+00:00"
}
]
}
]
}
```
Bagian berikut menentukan parameter permintaan input wajib dan opsional untuk operasi `SearchTrainingPlanOfferings` API.
## 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 mencantumkan penawaran rencana pelatihan yang memenuhi persyaratan Anda, Anda harus memberikan nilai berikut:
+ `TargetResources`: Sumber daya target (`training-job`atau`hyperpod-cluster`) yang rencananya akan digunakan. Nilai default-nya adalah `training-job`. Rencana pelatihan khusus untuk sumber daya target mereka.
+ Rencana pelatihan yang dirancang untuk pekerjaan SageMaker pelatihan hanya dapat digunakan untuk menjadwalkan dan menjalankan pekerjaan pelatihan.
+ Rencana pelatihan untuk HyperPod cluster dapat digunakan secara eksklusif untuk menyediakan sumber daya komputasi ke grup instance cluster.
+ `InstanceType`: Jenis contoh untuk ketentuan. `InstanceType`Harus dari tipe yang didukung.
Untuk mempelajari tentang daftar instans yang tersedia yang didukung oleh rencana SageMaker pelatihan, lihat[Jenis instans yang didukung Wilayah AWS,, dan harga](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions).
+ `InstanceCount`: Jumlah contoh untuk penyediaan. Jika jumlah instans lebih besar dari 1, itu harus menjadi kekuatan 2.
+ `DurationHour`: Total durasi paket yang Anda minta dalam jam. `DurationHour`Dibulatkan ke kelipatan terdekat dari 24.
## Parameter opsional
Bagian berikut memberikan detail tentang beberapa parameter opsional yang dapat Anda teruskan ke permintaan `SearchTrainingPlanOfferings` API Anda.
+ `StartTimeAfter`: Tentukan waktu mulai rencana yang diminta. Itu `StartTimeAfter` harus menjadi nilai `timestamp` atau `ISO 8601 date/time` nilai di masa depan.
+ `EndTimeBefore`: Tentukan waktu akhir rencana yang diminta dalam `ISO 8601 date/time` format `timestamp` atau format. `EndTimeBefore`Harus setidaknya 24 jam setelah waktu mulai.
+ `UltraServerType`: Tentukan jenis UltraServer yang akan dicari. Untuk informasi lebih lanjut tentang UltraServers, lihat[UltraServers di SageMaker AI](reserve-capacity-with-training-plans.md#training-plans-ultraservers).
+ `UltraServerCount`: Tentukan jumlah UltraServers yang akan dicari.
# Pesan rencana pelatihan terbaik
Setelah meninjau penawaran rencana pelatihan yang tersedia yang paling sesuai dengan kebutuhan Anda, Anda dapat memesan paket tertentu dengan memanggil operasi API. [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) Ketika dibuat, rencana awalnya memasuki `Pending` negara bagian dan tetap di sana sampai proses reservasi selesai. Respons terhadap panggilan API mengembalikan rencana pelatihan Amazon Resource Name (ARN). Catat ARN ini untuk tujuan pelacakan dan pemantauan di kemudian hari. Reservasi rencana pelatihan dipenuhi secara asinkron di backend. Pembayaran untuk jumlah total dikumpulkan secara otomatis sebagai bagian dari proses pemenuhan. Setelah transaksi pembayaran selesai dan kapasitas cadangan yang diminta diamankan, rencana pelatihan diatur ke `Scheduled` negara bagian, dan siap untuk penjadwalan.
**penting**
Rencana pelatihan tidak dapat dimodifikasi setelah dibeli.
Rencana pelatihan tidak dapat dibagikan di seluruh AWS akun atau di dalam AWS Organisasi Anda.
Contoh berikut menggunakan AWS CLI perintah untuk meminta rencana pelatihan tertentu, melewati ID rencana sebagai parameter.
```
aws sagemaker create-training-plan \
--training-plan-offering-id "tpo-SHA-256-hash-value" \
--training-plan-name "name" \
```
Dokumen JSON ini adalah contoh respons dari API rencana SageMaker pelatihan. Tanggapan tersebut berisi Nama Sumber Daya Amazon (ARN) dari rencana pelatihan yang telah berhasil dibuat.
**catatan**
Rencana pelatihan tetap dalam `Pending` status sampai proses pemenuhan selesai.
```
{
"TrainingPlanArn":"arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning"
}
```
Bagian berikut menentukan parameter permintaan input wajib dan opsional untuk operasi [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html)API.
## Parameter yang diperlukan
Saat memanggil [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html)API untuk memesan rencana pelatihan tertentu, Anda harus memberikan nilai berikut:
+ `TrainingPlanOfferingId`: ID paket yang Anda pilih. Anda dapat mengambil ID penawaran paket dalam respons panggilan `SearchTrainingPlanOfferings` API Anda. Formatnya harus dimulai dengan`pto-*`.
+ `TrainingPlanName`: Nama rencana yang Anda buat.
# Daftar rencana pelatihan
Anda dapat membuat daftar semua rencana pelatihan yang telah dibuat di AWS akun dan Wilayah Anda dengan memanggil [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html)API.
Contoh berikut menggunakan AWS CLI perintah untuk mengambil daftar rencana pelatihan Anda.
```
aws sagemaker list-training-plans \
--start-time-after "2024-09-26T00:00:01.000Z"
```
Dokumen JSON ini adalah contoh respons dari API rencana SageMaker pelatihan. Tanggapan tersebut memberikan rincian tentang satu rencana pelatihan yang telah berhasil dibuat dan dipesan.
```
{
"[TrainingPlanSummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html)": [
{
"AvailableInstanceCount": 2,
"CurrencyCode": "USD",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InUseInstanceCount": 2,
"[ReservedCapacitySummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ReservedCapacitySummary.html)": [
{
"AvailabilityZone": "string",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InstanceType": "ml.p5.48xlarge",
"ReservedCapacityArn": "arn:aws:sagemaker:us-east-1:123456789123:reserved-capacity/large-models-fine-tuning-rc1",
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"TotalInstanceCount": 4,
"UltraServerCount": 4,
"UltraServerType": "ml.p6e-gb200.36xlarge"
}
],
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"StatusMessage": "Payment confirmed, training plan scheduled."
"TargetResources": [ "training-job" ],
"TotalInstanceCount": 4,
"TotalUltraServerCount": 4,
"TrainingPlanArn": "arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning",
"TrainingPlanName": "large-models-fine-tuning",
"UpfrontFee": "xxxx.xx"
}
]
}
```
Bagian berikut memberikan rincian beberapa parameter opsional yang dapat Anda teruskan ke permintaan `ListTrainingPlans` API Anda.
## Parameter opsional
Bagian berikut memberikan detail tentang beberapa parameter opsional yang dapat Anda teruskan ke permintaan `ListTrainingPlans` API Anda.
+ `StartTimeAfter`: Waktu mulai dari rentang waktu aktual dari rencana yang terdaftar, ditentukan sebagai a `timestamp` atau`ISO 8601 date/time`.
+ `StartTimeBefore`: Waktu akhir dari rentang waktu aktual dari rencana yang terdaftar, ditentukan sebagai a `timestamp` atau`ISO 8601 date/time`.
+ `Filters`: Kriteria yang digunakan untuk memfilter hasil, dengan hingga 5 pasangan Nama-Nilai di mana “Nama” adalah nama bidang a [TrainingPlanSummary](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html)dan “Nilai” adalah nilai yang perlu dipertimbangkan untuk filter. Sebagai contoh, `Name=Status,Value=Active`.
Contoh berikut menggunakan AWS CLI perintah untuk mengambil daftar rencana pelatihan Anda, menggunakan beberapa parameter opsional yang dijelaskan di atas.
```
aws sagemaker list-training-plans --max-results 10 --sort-by StartTime --sort-order Descending --start-time-after 13000000 --filters Name=Status,Value=Active
```
# Lihat detail rencana pelatihan
Untuk memantau status atau mengambil detail rencana pelatihan, Anda dapat menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html)API. Respons API mencakup `Status` bidang, yang mencerminkan status rencana pelatihan saat ini:
+ Jika pembelian paket gagal, status diatur ke`Failed`.
+ Setelah pembayaran berhasil, status beralih dari `Pending` ke`Scheduled`, berdasarkan tanggal mulai rencana.
+ Ketika rencana mencapai tanggal mulai, status berubah menjadi`Active`.
+ Untuk rencana dengan beberapa kapasitas cadangan terputus-putus, status kembali ke `Scheduled` antara periode aktif, hingga tanggal mulai kapasitas cadangan berikutnya.
+ Setelah tanggal akhir rencana, statusnya menjadi`Expired`.
Setelah statusnya`Scheduled`, Anda dapat memanfaatkan kapasitas yang disediakan dalam rencana untuk pekerjaan SageMaker pelatihan atau beban kerja HyperPod cluster Anda.
**catatan**
Pekerjaan pelatihan yang terkait dengan rencana tetap dalam `Pending` status sampai rencana menjadi`Active`.
Untuk HyperPod klaster yang menggunakan rencana pelatihan untuk kapasitas komputasi, status grup instans muncul seperti `InService` sekali dibuat.
Contoh berikut menggunakan AWS CLI perintah untuk mengambil rincian rencana pelatihan dengan namanya.
```
aws sagemaker describe-training-plan \
--training-plan-name "name"
```
Dokumen JSON ini adalah contoh respons dari API rencana SageMaker pelatihan. Tanggapan ini memberikan rincian tentang rencana pelatihan yang telah berhasil dibuat.
```
{
"AvailableInstanceCount": 2,
"CurrencyCode": "USD",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InUseInstanceCount": 2,
"[ReservedCapacitySummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ReservedCapacitySummary.html)": [
{
"AvailabilityZone": "string",
"DurationHours": 48,
"DurationMinutes": 0,
"EndTime": "2024-09-28T04:30:00-07:00",
"InstanceType": "ml.p5.48xlarge",
"ReservedCapacityArn": "arn:aws:sagemaker:us-east-1:123456789123:reserved-capacity/large-models-fine-tuning-rc1",
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"TotalInstanceCount": 4,
"UltraServerCount": 4,
"UltraServerType": "ml.p6e-gb200.36xlarge"
}
],
"StartTime": "2024-09-26T04:30:00-07:00",
"Status": "Scheduled",
"StatusMessage": "Payment confirmed, training plan scheduled."
"TargetResources": [ "training-job" ],
"TotalInstanceCount": 4,
"TotalUltraServerCount": 4,
"TrainingPlanArn": "arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning",
"TrainingPlanName": "large-models-fine-tuning",
"UpfrontFee": "xxxx.xx"
}
```
Bagian berikut menentukan parameter permintaan input wajib untuk operasi `DescribeTrainingPlan` API.
## Parameter yang diperlukan
+ `TrainingPlanName`: Nama rencana pelatihan yang ingin Anda gambarkan.