CreateForecast - Amazon Forecast
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

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

CreateForecast

Membuat perkiraan untuk setiap item dalam TARGET_TIME_SERIES kumpulan data yang digunakan untuk melatih prediktor. Ini dikenal sebagai inferensi. Untuk mengambil perkiraan untuk satu item pada latensi rendah, gunakan operasi. QueryForecast Untuk mengekspor perkiraan lengkap ke bucket Amazon Simple Storage Service (Amazon S3), gunakan operasi ini. CreateForecastExportJob

penting

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

Kisaran perkiraan ditentukan oleh ForecastHorizon nilai, yang Anda tentukan dalam CreatePredictor permintaan. Saat Anda menanyakan perkiraan, Anda dapat meminta rentang tanggal tertentu dalam perkiraan.

Untuk mendapatkan daftar semua perkiraan Anda, gunakan ListForecasts operasi.

catatan

Prakiraan yang dihasilkan oleh Amazon Forecast berada di zona waktu yang sama dengan dataset yang digunakan untuk membuat prediktor.

Untuk informasi selengkapnya, lihat Menghasilkan Prakiraan.

catatan

StatusPerkiraan harus ACTIVE sebelum Anda dapat menanyakan atau mengekspor perkiraan. Gunakan DescribeForecast operasi untuk mendapatkan status.

Secara default, perkiraan mencakup prediksi untuk setiap item (item_id) dalam grup kumpulan data yang digunakan untuk melatih prediktor. Namun, Anda dapat menggunakan TimeSeriesSelector objek untuk menghasilkan perkiraan pada subset deret waktu. Pembuatan Forecast dilewati untuk setiap deret waktu yang Anda tentukan yang tidak ada dalam dataset input. File ekspor perkiraan tidak akan berisi deret waktu ini atau nilai perkiraannya.

Sintaksis Permintaan

{
   "ForecastName": "string",
   "ForecastTypes": [ "string" ],
   "PredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeSeriesSelector": { 
      "TimeSeriesIdentifiers": { 
         "DataSource": { 
            "S3Config": { 
               "KMSKeyArn": "string",
               "Path": "string",
               "RoleArn": "string"
            }
         },
         "Format": "string",
         "Schema": { 
            "Attributes": [ 
               { 
                  "AttributeName": "string",
                  "AttributeType": "string"
               }
            ]
         }
      }
   }
}

Parameter Permintaan

Permintaan menerima data berikut dalam JSON format.

ForecastName

Nama untuk ramalan.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

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

Wajib: Ya

ForecastTypes

Kuantil di mana perkiraan probabilistik dihasilkan. Saat ini Anda dapat menentukan hingga 5 kuantil per perkiraan. Nilai yang diterima termasuk 0.01 to 0.99 (kenaikan 0,01 saja) dan. mean Perkiraan rata-rata berbeda dari median (0,50) ketika distribusi tidak simetris (misalnya, Beta dan Binomial Negatif).

Kuantil default adalah kuantil yang Anda tentukan selama pembuatan prediktor. Jika Anda tidak menentukan kuantil, nilai defaultnya adalah. ["0.1", "0.5", "0.9"]

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

PredictorArn

Nama Sumber Daya Amazon (ARN) dari prediktor yang akan digunakan untuk menghasilkan perkiraan.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

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

Wajib: Ya

Tags

Metadata opsional yang Anda terapkan pada ramalan untuk membantu Anda mengkategorikan dan mengaturnya. Setiap tag terdiri dari kunci dan nilai opsional, yang keduanya Anda tentukan.

Batasan dasar berikut berlaku untuk tag:

  • Jumlah maksimum tag per sumber daya - 50.

  • Untuk setiap sumber daya, setiap kunci tag harus unik, dan setiap kunci tag hanya dapat memiliki satu nilai.

  • Panjang kunci maksimum - 128 karakter Unicode di UTF -8.

  • Panjang nilai maksimum - 256 karakter Unicode di UTF -8.

  • Jika skema penandaan Anda digunakan di beberapa layanan dan sumber daya, ingatlah bahwa layanan lain mungkin memiliki pembatasan pada karakter yang diizinkan. Karakter yang diizinkan secara umum adalah: huruf, angka, dan spasi yang dapat direpresentasikan dalam UTF -8, dan karakter berikut: + - =. _:/@.

  • Kunci dan nilai tanda peka huruf besar-kecil.

  • Jangan gunakanaws:,AWS:, atau kombinasi huruf besar atau kecil seperti awalan untuk kunci karena dicadangkan untuk digunakan. AWS Anda tidak dapat mengedit atau menghapus kunci tag dengan awalan ini. Nilai dapat memiliki awalan ini. Jika nilai tag memiliki aws awalan tetapi kuncinya tidak, maka 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.

Tipe: Array objek Tag

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

Wajib: Tidak

TimeSeriesSelector

Mendefinisikan himpunan deret waktu yang digunakan untuk membuat prakiraan dalam suatu TimeSeriesIdentifiers objek.

TimeSeriesIdentifiersObjek membutuhkan informasi berikut:

  • DataSource

  • Format

  • Schema

Tipe: Objek TimeSeriesSelector

Wajib: Tidak

Sintaksis Respons

{
   "ForecastArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

ForecastArn

Nama Sumber Daya Amazon (ARN) dari perkiraan.

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.

HTTPKode Status: 400

LimitExceededException

Batas jumlah sumber daya per akun telah terlampaui.

HTTPKode Status: 400

ResourceAlreadyExistsException

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

HTTPKode Status: 400

ResourceInUseException

Sumber daya yang ditentukan sedang digunakan.

HTTPKode Status: 400

ResourceNotFoundException

Kami tidak dapat menemukan sumber daya dengan Amazon Resource Name (ARN). Periksa ARN dan coba lagi.

HTTPKode Status: 400

Lihat Juga

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