View a markdown version of this page

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

CreateExplainability

catatan

Keterjelasan hanya tersedia untuk Prakiraan dan Prediktor yang dihasilkan dari () AutoPredictor CreateAutoPredictor

Membuat Penjelasan Prakiraan Amazon.

penting

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

Keterjelasan membantu Anda lebih memahami bagaimana atribut dalam kumpulan data Anda memengaruhi perkiraan. Amazon Forecast menggunakan metrik yang disebut skor Dampak untuk mengukur dampak relatif dari setiap atribut dan menentukan apakah mereka meningkatkan atau mengurangi nilai perkiraan.

Untuk mengaktifkan Forecast Explainability, prediktor Anda harus menyertakan setidaknya satu dari berikut ini: deret waktu terkait, metadata item, atau kumpulan data tambahan seperti Liburan dan Indeks Cuaca.

catatan

Model ARIMA (AutoRegressive Integrated Moving Average), ETS (Exponential Smoothing State Space Model), dan NPTS (Non-Parametric Time Series) tidak menggabungkan data deret waktu eksternal. Oleh karena itu, model ini tidak membuat laporan keterjelasan, bahkan jika Anda menyertakan kumpulan data tambahan.

CreateExplainability menerima Predictor ARN atau Forecast ARN. Untuk menerima skor Dampak agregat untuk semua deret waktu dan titik waktu dalam kumpulan data Anda, berikan ARN Prediktor. Untuk menerima skor Dampak untuk deret waktu dan titik waktu tertentu, berikan Arn Prakiraan.

CreateExplainability dengan Predictor ARN

catatan

Anda hanya dapat memiliki satu sumber daya Explainability per prediktor. Jika Anda sudah mengaktifkan ExplainPredictorCreateAutoPredictor, prediktor itu sudah memiliki sumber daya Explainability.

Parameter berikut diperlukan saat menyediakan Predictor ARN:

  • ExplainabilityName- Nama unik untuk Explainability.

  • ResourceArn- Arn dari prediktor.

  • TimePointGranularity- Harus diatur ke “SEMUA”.

  • TimeSeriesGranularity- Harus diatur ke “SEMUA”.

Jangan tentukan nilai untuk parameter berikut:

  • DataSource- Hanya berlaku TimeSeriesGranularity bila “SPESIFIK”.

  • Schema- Hanya berlaku TimeSeriesGranularity bila “SPESIFIK”.

  • StartDateTime- Hanya berlaku TimePointGranularity bila “SPESIFIK”.

  • EndDateTime- Hanya berlaku TimePointGranularity bila “SPESIFIK”.

CreateExplainability dengan Prakiraan ARN

catatan

Anda dapat menentukan maksimum 50 deret waktu dan 500 titik waktu.

Parameter berikut diperlukan saat menyediakan Predictor ARN:

  • ExplainabilityName- Nama unik untuk Explainability.

  • ResourceArn- Arn dari ramalan.

  • TimePointGranularity- Baik “SEMUA” atau “SPESIFIK”.

  • TimeSeriesGranularity- Baik “SEMUA” atau “SPESIFIK”.

Jika Anda menyet TimeSeriesGranularity el ke “SPESIFIK”, Anda juga harus memberikan yang berikut:

  • DataSource- Lokasi S3 dari file CSV yang menentukan deret waktu Anda.

  • Schema- Skema mendefinisikan atribut dan jenis atribut yang tercantum dalam Sumber Data.

Jika Anda menyet TimePointGranularity el ke “SPESIFIK”, Anda juga harus memberikan yang berikut:

  • StartDateTime- Stempel waktu pertama dalam kisaran titik waktu.

  • EndDateTime- Stempel waktu terakhir dalam kisaran titik waktu.

Sintaksis Permintaan

{
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "EnableVisualization": boolean,
   "EndDateTime": "string",
   "ExplainabilityConfig": { 
      "TimePointGranularity": "string",
      "TimeSeriesGranularity": "string"
   },
   "ExplainabilityName": "string",
   "ResourceArn": "string",
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "StartDateTime": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

DataSource

Sumber data Anda, peran AWS Identity and Access Management (IAM) yang memungkinkan Amazon Forecast mengakses data dan, secara opsional, kunci AWS Key Management Service (KMS).

Tipe: Objek DataSource

Wajib: Tidak

EnableVisualization

Buat visualisasi Keterjelasan yang dapat dilihat di dalam konsol. AWS

Tipe: Boolean

Wajib: Tidak

EndDateTime

Jika TimePointGranularity disetel keSPECIFIC, tentukan titik waktu terakhir untuk Explainability.

Gunakan format stempel waktu berikut: yyyy- MM-ddTHH:mm:ss (contoh: 2015-01-01) T20:00:00

Tipe: String

Batasan Panjang: Panjang maksimum 19.

Pola: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

Wajib: Tidak

ExplainabilityConfig

Pengaturan konfigurasi yang menentukan perincian deret waktu dan titik waktu untuk Explainability.

Tipe: Objek ExplainabilityConfig

Wajib: Ya

ExplainabilityName

Nama unik untuk Explainability.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

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

Wajib: Ya

ResourceArn

Nama Sumber Daya Amazon (ARN) dari Prediktor atau Prakiraan yang digunakan untuk membuat Explainability.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

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

Wajib: Ya

Schema

Mendefinisikan bidang dataset.

Tipe: Objek Schema

Wajib: Tidak

StartDateTime

Jika TimePointGranularity disetel keSPECIFIC, tentukan titik pertama untuk Explainability.

Gunakan format stempel waktu berikut: yyyy- MM-ddTHH:mm:ss (contoh: 2015-01-01) T20:00:00

Tipe: String

Batasan Panjang: Panjang maksimum 19.

Pola: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

Wajib: Tidak

Tags

Metadata opsional untuk membantu Anda mengkategorikan dan mengatur sumber daya 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

Sintaksis Respons

{
   "ExplainabilityArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

ExplainabilityArn

Nama Sumber Daya Amazon (ARN) dari Penjelasan.

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: