CreateExplainability

catatan

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

Membuat Explainability Amazon Forecast.

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.

CreateExplainability menerima baik 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 Forecast ARN.

CreateExplainability dengan ARN Prediktor

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 ARN Prediktor:

• 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 ketika TimeSeriesGranularity “SPESIFIK”.

• Schema- Hanya berlaku ketika TimeSeriesGranularity “SPESIFIK”.

• StartDateTime- Hanya berlaku ketika TimePointGranularity “SPESIFIK”.

• EndDateTime- Hanya berlaku ketika TimePointGranularity “SPESIFIK”.

CreateExplainability dengan Forecast ARN

catatan

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

Parameter berikut diperlukan saat menyediakan ARN Prediktor:

• ExplainabilityName- Nama unik untuk Explainability.

• ResourceArn- Arn ramalan.

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

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

Jika Anda mengatur TimeSeriesGranularity 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 mengatur TimePointGranularity ke “SPESIFIK”, 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 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 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: YYYY-MM-DDTHH: MM: SS (contoh: 2015-01-01T 20:00:00)

Jenis: 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.

Jenis: 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: YYYY-MM-DDTHH: MM: SS (contoh: 2015-01-01T 20:00:00)

Jenis: 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.

Layanan mengembalikan data berikut dalam format JSON.

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.

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:

• AWS Antarmuka Baris Perintah

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK untuk Python

• AWS SDK for Ruby V3