

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Cari penawaran rencana pelatihan
<a name="search-training-plan-offerings-api-cli-sdk"></a>

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
<a name="search-training-plan-options-required-params"></a>

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
<a name="search-training-plan-options-optional-params"></a>

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.