Sintaksis Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

CreateAutoPredictor

Membuat prediktor Amazon Forecast.

Amazon Forecast membuat prediktor dengan AutoPredictor, yang melibatkan penerapan kombinasi algoritma yang optimal untuk setiap deret waktu dalam kumpulan data Anda. Anda dapat menggunakan CreateAutoPredictor untuk membuat prediktor baru atau meningkatkan/melatih kembali prediktor yang ada.

Membuat prediktor baru

Parameter berikut diperlukan saat membuat prediktor baru:

PredictorName- Nama unik untuk prediktor.
DatasetGroupArn- ARN dari grup dataset yang digunakan untuk melatih prediktor.
ForecastFrequency- Perincian perkiraan Anda (per jam, harian, mingguan, dll).
ForecastHorizon- Jumlah langkah waktu yang diprediksi model. Cakrawala ramalan juga disebut panjang prediksi.

Saat membuat prediktor baru, jangan tentukan nilai untukReferencePredictorArn.

Meningkatkan dan melatih kembali prediktor

Parameter berikut diperlukan saat melatih ulang atau meningkatkan prediktor:

PredictorName- Nama unik untuk prediktor.
ReferencePredictorArn- ARN prediktor untuk melatih ulang atau meningkatkan.

Saat memutakhirkan atau melatih ulang prediktor, hanya tentukan nilai untuk dan. ReferencePredictorArn PredictorName

Sintaksis Permintaan


{
   "DataConfig": { 
      "AdditionalDatasets": [ 
         { 
            "Configuration": { 
               "string" : [ "string" ]
            },
            "Name": "string"
         }
      ],
      "AttributeConfigs": [ 
         { 
            "AttributeName": "string",
            "Transformations": { 
               "string" : "string" 
            }
         }
      ],
      "DatasetGroupArn": "string"
   },
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "ExplainPredictor": boolean,
   "ForecastDimensions": [ "string" ],
   "ForecastFrequency": "string",
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "MonitorConfig": { 
      "MonitorName": "string"
   },
   "OptimizationMetric": "string",
   "PredictorName": "string",
   "ReferencePredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeAlignmentBoundary": { 
      "DayOfMonth": number,
      "DayOfWeek": "string",
      "Hour": number,
      "Month": "string"
   }
}

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

DataConfig

Konfigurasi data untuk grup kumpulan data Anda dan kumpulan data tambahan apa pun.

Tipe: Objek DataConfig

Wajib: Tidak

EncryptionConfig

Kunci AWS Key Management Service (KMS) dan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan Amazon Forecast untuk mengakses kunci tersebut. Anda dapat menentukan objek opsional ini dalam CreatePredictor permintaan CreateDataset dan.

Tipe: Objek EncryptionConfig

Wajib: Tidak

ExplainPredictor

Buat sumber daya Explainability untuk prediktor.

Tipe: Boolean

Wajib: Tidak

ForecastDimensions

Array nama dimensi (bidang) yang menentukan cara mengelompokkan perkiraan yang dihasilkan.

Misalnya, jika Anda menghasilkan perkiraan untuk penjualan barang di semua toko Anda, dan kumpulan data Anda berisi store_id bidang, Anda akan menentukan store_id sebagai dimensi untuk mengelompokkan perkiraan penjualan untuk setiap toko.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 10 item.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

Pola: ^[a-zA-Z][a-zA-Z0-9_]*

Wajib: Tidak

ForecastFrequency

Frekuensi prediksi dalam perkiraan.

Interval yang valid adalah bilangan bulat diikuti oleh Y (Tahun), M (Bulan), W (Minggu), D (Hari), H (Jam), dan min (Menit). Misalnya, “1D” menunjukkan setiap hari dan “15 menit” menunjukkan setiap 15 menit. Anda tidak dapat menentukan nilai yang akan tumpang tindih dengan frekuensi yang lebih besar berikutnya. Itu berarti, misalnya, Anda tidak dapat menentukan frekuensi 60 menit, karena itu setara dengan 1 jam. Nilai yang valid untuk setiap frekuensi adalah sebagai berikut:

Menit - 1-59
Jam - 1-23
Hari - 1-6
Minggu - 1-4
Bulan - 1-11
Tahun - 1

Jadi, jika Anda ingin setiap prakiraan minggu lainnya, tentukan “2W”. Atau, jika Anda ingin perkiraan triwulanan, Anda menentukan “3M”.

Frekuensi harus lebih besar dari atau sama dengan frekuensi dataset TARGET_TIME_SERIES.

Ketika dataset RELATED_TIME_SERIES disediakan, frekuensi harus sama dengan frekuensi dataset RELATED_TIME_SERIES.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 5.

Pola: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Wajib: Tidak

ForecastHorizon

Jumlah langkah waktu yang diprediksi model. Cakrawala ramalan juga disebut panjang prediksi.

Cakrawala perkiraan maksimum adalah kurang dari 500 langkah waktu atau 1/4 dari panjang set data TARGET_TIME_SERIES. Jika Anda melatih ulang yang sudah ada AutoPredictor, maka cakrawala perkiraan maksimum adalah kurang dari 500 langkah waktu atau 1/3 dari panjang set data TARGET_TIME_SERIES.

Jika Anda memutakhirkan ke AutoPredictor atau melatih ulang yang sudah ada AutoPredictor, Anda tidak dapat memperbarui parameter horizon perkiraan. Anda dapat memenuhi persyaratan ini dengan menyediakan deret waktu yang lebih lama dalam kumpulan data.

Tipe: Integer

Wajib: Tidak

ForecastTypes

Jenis perkiraan yang digunakan untuk melatih prediktor. Anda dapat menentukan hingga lima jenis perkiraan. Jenis Forecast dapat berupa kuantil dari 0,01 hingga 0,99, dengan kenaikan 0,01 atau lebih tinggi. Anda juga dapat menentukan perkiraan rata-rata denganmean.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 20 item.

Kendala Panjang: Panjang minimum 2. Panjang maksimum 4.

Pola: (^0?\.\d\d?$|^mean$)

Wajib: Tidak

MonitorConfig

Detail konfigurasi untuk pemantauan prediktor. Berikan nama untuk sumber daya monitor untuk mengaktifkan pemantauan prediktor.

Pemantauan prediktor memungkinkan Anda untuk melihat bagaimana kinerja prediktor Anda berubah dari waktu ke waktu. Untuk informasi lebih lanjut, lihat Pemantauan Prediktor.

Tipe: Objek MonitorConfig

Wajib: Tidak

OptimizationMetric

Metrik akurasi yang digunakan untuk mengoptimalkan prediktor.

Jenis: String

Nilai yang Valid: WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

Wajib: Tidak

PredictorName

Nama unik untuk prediktor

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

Pola: ^[a-zA-Z][a-zA-Z0-9_]*

Wajib: Ya

ReferencePredictorArn

ARN dari prediktor untuk melatih ulang atau meningkatkan. Parameter ini hanya digunakan saat melatih ulang atau meningkatkan prediktor. Saat membuat prediktor baru, jangan tentukan nilai untuk parameter ini.

Saat memutakhirkan atau melatih ulang prediktor, hanya tentukan nilai untuk dan. ReferencePredictorArn PredictorName Nilai untuk PredictorName harus berupa nama prediktor yang unik.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):forecast:.*:.*:.+

Wajib: Tidak

Tags

Metadata opsional untuk membantu Anda mengkategorikan dan mengatur prediktor Anda. Setiap tag terdiri dari kunci dan nilai opsional, yang keduanya Anda tentukan. Kunci dan nilai tanda peka huruf besar-kecil.

Pembatasan berikut berlaku untuk tag:

Untuk setiap sumber daya, setiap kunci tag harus unik dan setiap kunci tag harus memiliki satu nilai.
Jumlah maksimum tag per sumber daya: 50.
Panjang kunci maksimum: 128 karakter Unicode di UTF-8.
Panjang nilai maksimum: 256 karakter Unicode di UTF-8.
Karakter yang diterima: semua huruf dan angka, spasi yang dapat direpresentasikan dalam UTF-8, dan + - =. _:/@. Jika skema penandaan Anda digunakan di seluruh layanan dan sumber daya lain, pembatasan karakter layanan tersebut juga berlaku.
Awalan kunci tidak dapat menyertakan kombinasi huruf besar atau kecil dari atau. aws: AWS: Nilai dapat memiliki awalan ini. Jika nilai tag memiliki aws awalan tetapi kuncinya tidak, Forecast menganggapnya sebagai tag pengguna dan akan dihitung terhadap batas 50 tag. Tag dengan hanya key prefix dari aws tidak dihitung terhadap tag Anda per batas sumber daya. Anda tidak dapat mengedit atau menghapus kunci tag dengan awalan ini.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Wajib: Tidak

TimeAlignmentBoundary

Time boundary Forecast digunakan untuk menyelaraskan dan menggabungkan data apa pun yang tidak selaras dengan frekuensi perkiraan Anda. Berikan satuan waktu dan batas waktu sebagai pasangan nilai kunci. Untuk informasi selengkapnya tentang menentukan batas waktu, lihat Menentukan Batas Waktu. Jika Anda tidak memberikan batas waktu, Forecast menggunakan satu set Batas Waktu Default.

Tipe: Objek TimeAlignmentBoundary

Wajib: Tidak

Sintaksis Respons


{
   "PredictorArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

PredictorArn

Nama Sumber Daya Amazon (ARN) dari prediktor.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):forecast:.*:.*:.+

Kesalahan

InvalidInputException

Kami tidak dapat memproses permintaan karena menyertakan nilai yang tidak valid atau nilai yang melebihi rentang yang valid.

Kode Status HTTP: 400

LimitExceededException

Batas jumlah sumber daya per akun telah terlampaui.

Kode Status HTTP: 400

ResourceAlreadyExistsException

Sudah ada sumber daya dengan nama ini. Coba lagi dengan nama yang berbeda.

Kode Status HTTP: 400

ResourceInUseException

Sumber daya yang ditentukan sedang digunakan.

Kode Status HTTP: 400

ResourceNotFoundException

Kami tidak dapat menemukan sumber daya dengan Nama Sumber Daya Amazon (ARN) itu. Periksa ARN dan coba lagi.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Amazon Forecast Layanan

CreateDataset