Sintaksis Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

CreateAutoPredictor

Membuat prediktor Amazon Forecast.

penting

Amazon Forecast tidak lagi tersedia untuk pelanggan baru. Pelanggan Amazon Forecast yang ada dapat terus menggunakan layanan seperti biasa. Pelajari lebih lanjut”

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 prediktor upgrade/retrain yang ada.

Membuat prediktor baru

Parameter berikut diperlukan saat membuat prediktor baru:

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

Saat membuat prediktor baru, jangan tentukan nilai untukReferencePredictorArn.

Meningkatkan dan melatih ulang 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 dataset Anda dan kumpulan data tambahan apa pun.

Tipe: Objek DataConfig

Wajib: Tidak

EncryptionConfig

K AWS Key Management Service unci (KMS) dan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan Amazon Forecast untuk mengakses kunci. Anda dapat menentukan objek opsional ini di 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 membuat perkiraan penjualan item di semua toko Anda, dan kumpulan data 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 “15min” menunjukkan setiap 15 menit. Anda tidak dapat menentukan nilai yang akan tumpang tindih dengan frekuensi berikutnya yang lebih besar. 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 perkiraan setiap minggu, 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, frekuensinya harus sama dengan frekuensi dataset RELATED_TIME_SERIES.

Tipe: 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 perkiraan juga disebut panjang prediksi.

Horizon perkiraan maksimum adalah yang lebih kecil dari 500 langkah waktu atau 1/4 panjang dataset TARGET_TIME_SERIES. Jika Anda melatih ulang yang sudah ada AutoPredictor, maka cakrawala perkiraan maksimum adalah yang lebih kecil dari 500 langkah waktu atau panjang dataset TARGET_ 1/3 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 panjang dalam dataset.

Tipe: Integer

Wajib: Tidak

ForecastTypes

Jenis prakiraan yang digunakan untuk melatih prediktor. Anda dapat menentukan hingga lima jenis perkiraan. Jenis prakiraan 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.

Batasan 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 selengkapnya, lihat Pemantauan https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring.html Prediktor.

Tipe: Objek MonitorConfig

Wajib: Tidak

OptimizationMetric

Metrik akurasi yang digunakan untuk mengoptimalkan prediktor.

Tipe: String

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

Wajib: Tidak

PredictorName

Nama unik untuk prediktor

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

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

Wajib: Ya

ReferencePredictorArn

ARN 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.

Tipe: 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 satu kunci dan satu nilai opsional, yang keduanya Anda tentukan sendiri. Kunci dan nilai tag peka huruf besar/kecil.

Batasan berikut ini 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 dalam UTF-8.
Panjang nilai maksimum: 256 karakter Unicode dalam 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 awalan tetapi kuncinya tidak, Forecast menganggapnya aws sebagai tag pengguna dan akan dihitung terhadap batas 50 tag. Tag dengan hanya awalan kunci 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

Batas waktu Prakiraan 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, Prakiraan 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.

Tipe: 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 menggunakan 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

Layanan Amazon Forecast

CreateDataset