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 Explainability 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”

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

Untuk mengaktifkan Forecast Explainability, prediktor Anda harus menyertakan setidaknya satu dari yang berikut: 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 memasukkan data deret waktu eksternal. Oleh karena itu, model ini tidak membuat laporan penjelasan, bahkan jika Anda menyertakan kumpulan data tambahan.

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

CreateExplainability dengan prediktor ARN

catatan

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

Parameter berikut diperlukan saat menyediakan PrediktorARN:

  • ExplainabilityName- Nama unik untuk Explainability.

  • ResourceArn- Arn dari prediktor.

  • TimePointGranularity- Harus diatur ke “ALL”.

  • TimeSeriesGranularity- Harus diatur ke “ALL”.

Jangan tentukan nilai untuk parameter berikut:

  • DataSource- Hanya berlaku TimeSeriesGranularity ketika “SPECIFIC”.

  • Schema- Hanya berlaku TimeSeriesGranularity ketika “SPECIFIC”.

  • StartDateTime- Hanya berlaku TimePointGranularity ketika “SPECIFIC”.

  • EndDateTime- Hanya berlaku TimePointGranularity ketika “SPECIFIC”.

CreateExplainability dengan Forecast ARN

catatan

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

Parameter berikut diperlukan saat menyediakan PrediktorARN:

  • ExplainabilityName- Nama unik untuk Explainability.

  • ResourceArn- Arn ramalan.

  • TimePointGranularity- Entah “ALL” atau “SPECIFIC”.

  • TimeSeriesGranularity- Entah “ALL” atau “SPECIFIC”.

Jika Anda menyetel TimeSeriesGranularity ke “SPECIFIC”, Anda juga harus memberikan yang berikut:

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

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

Jika Anda menyetel TimePointGranularity ke “SPECIFIC”, Anda juga harus memberikan yang berikut:

  • StartDateTime- Stempel waktu pertama dalam rentang titik waktu.

  • EndDateTime- Stempel waktu terakhir dalam rentang 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 JSON format.

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 Explainability yang dapat dilihat di dalam konsol. AWS

Tipe: Boolean

Wajib: Tidak

EndDateTime

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

Gunakan format stempel waktu berikut: THH YYYY-MM-DD: MM: SS (contoh: 2015-01-01T 20:00:00)

Tipe: String

Kendala 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 Keterjelasan.

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

Amazon Resource Name (ARN) dari Predictor atau Forecast digunakan untuk membuat Explainability.

Jenis: 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 diatur keSPECIFIC, tentukan poin pertama untuk Explainability.

Gunakan format stempel waktu berikut: THH YYYY-MM-DD: MM: SS (contoh: 2015-01-01T 20:00:00)

Tipe: String

Kendala 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 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

Sintaksis Respons

{
   "ExplainabilityArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

ExplainabilityArn

Nama Sumber Daya Amazon (ARN) dari Keterjelasan.

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: