View a markdown version of this page

CreateExplainability - Amazon Forecast
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateExplainability

Anmerkung

Erklärbarkeit ist nur für Prognosen und Prädiktoren verfügbar, die aus einem () generiert wurden AutoPredictor CreateAutoPredictor

Erzeugt eine Amazon-Forecast-Erklärbarkeit.

Wichtig

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

Erklärbarkeit hilft Ihnen, besser zu verstehen, wie sich die Attribute in Ihren Datensätzen auf Prognosen auswirken. Amazon Forecast verwendet eine Metrik namens Impact Scores, um die relative Auswirkung der einzelnen Attribute zu quantifizieren und festzustellen, ob sie die Prognosewerte erhöhen oder verringern.

Um die Erklärbarkeit von Prognosen zu ermöglichen, muss Ihr Prädiktor mindestens eine der folgenden Angaben enthalten: verwandte Zeitreihen, Elementmetadaten oder zusätzliche Datensätze wie Feiertage und den Wetterindex.

Anmerkung

Die Modelle ARIMA (AutoRegressive Integrated Moving Average), ETS (Exponential Smoothing State Space Model) und NPTS (Non-Parametric Time Series) enthalten keine externen Zeitreihendaten. Daher erstellen diese Modelle keinen Erklärbarkeitsbericht, auch wenn Sie die zusätzlichen Datensätze einbeziehen.

CreateExplainability akzeptiert entweder einen Prädiktor-ARN oder einen Prognose-ARN. Um aggregierte Impact-Werte für alle Zeitreihen und Zeitpunkte in Ihren Datensätzen zu erhalten, geben Sie einen Prädiktor-ARN an. Um Impact-Werte für bestimmte Zeitreihen und Zeitpunkte zu erhalten, geben Sie einen Prognose-ARN an.

CreateExplainability mit einem Prädiktor-ARN

Anmerkung

Sie können nur eine Erklärbarkeitsressource pro Prädiktor haben. Wenn Sie den Prädiktor bereits aktiviert ExplainPredictor habenCreateAutoPredictor, verfügt dieser Prädiktor bereits über eine Erklärbarkeitsressource.

Die folgenden Parameter sind für die Bereitstellung eines Prädiktor-ARN erforderlich:

  • ExplainabilityName— Ein eindeutiger Name für die Erklärbarkeit.

  • ResourceArn- Der Arn des Prädiktors.

  • TimePointGranularity- Muss auf „ALL“ gesetzt sein.

  • TimeSeriesGranularity- Muss auf „ALL“ gesetzt sein.

Geben Sie keinen Wert für die folgenden Parameter an:

  • DataSource- Nur gültig, wenn „SPEZIFISCH“ angegeben TimeSeriesGranularity ist.

  • Schema- Nur gültig, wenn „SPEZIFISCH“ TimeSeriesGranularity ist.

  • StartDateTime- Nur gültig, wenn „SPEZIFISCH“ TimePointGranularity ist.

  • EndDateTime- Nur gültig, wenn „SPEZIFISCH“ TimePointGranularity ist.

CreateExplainability mit einem Prognose-ARN

Anmerkung

Sie können maximal 50 Zeitreihen und 500 Zeitpunkte angeben.

Die folgenden Parameter sind erforderlich, wenn Sie einen Prädiktor-ARN angeben:

  • ExplainabilityName— Ein eindeutiger Name für die Erklärbarkeit.

  • ResourceArn- Der Sinn der Prognose.

  • TimePointGranularity- Entweder „ALLE“ oder „SPEZIFISCH“.

  • TimeSeriesGranularity- Entweder „ALLE“ oder „SPEZIFISCH“.

Wenn Sie „ TimeSeriesGranularity SPEZIFISCH“ wählen, müssen Sie außerdem Folgendes angeben:

  • DataSource— Der S3-Speicherort der CSV-Datei, die Ihre Zeitreihe angibt.

  • Schema— Das Schema definiert die in der Datenquelle aufgeführten Attribute und Attributtypen.

Wenn Sie „ TimePointGranularity SPEZIFISCH“ wählen, müssen Sie außerdem Folgendes angeben:

  • StartDateTime- Der erste Zeitstempel im Bereich der Zeitpunkte.

  • EndDateTime- Der letzte Zeitstempel im Bereich der Zeitpunkte.

Anforderungssyntax

{
   "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"
      }
   ]
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

DataSource

Die Quelle Ihrer Daten, eine AWS Identity and Access Management (IAM) -Rolle, die Amazon Forecast den Zugriff auf die Daten ermöglicht, und optional ein AWS Key Management Service (KMS-) Schlüssel.

Typ: DataSource Objekt

Erforderlich: Nein

EnableVisualization

Erstellen Sie eine Erklärbarkeitsvisualisierung, die in der Konsole angezeigt werden kann. AWS

Typ: Boolesch

Erforderlich: Nein

EndDateTime

Wenn auf gesetzt TimePointGranularity istSPECIFIC, definieren Sie den letzten Zeitpunkt für die Erklärbarkeit.

Verwenden Sie das folgende Zeitstempelformat: yyyy- MM-ddTHH:mm:ss (Beispiel: 2015-01-01) T20:00:00

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 19.

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

Erforderlich: Nein

ExplainabilityConfig

Die Konfigurationseinstellungen, die die Granularität von Zeitreihen und Zeitpunkten für die Erklärbarkeit definieren.

Typ: ExplainabilityConfig Objekt

Erforderlich: Ja

ExplainabilityName

Ein eindeutiger Name für die Erklärbarkeit.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.

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

Erforderlich: Ja

ResourceArn

Der Amazon-Ressourcenname (ARN) des Prädiktors oder der Prognose, der zur Erstellung der Erklärbarkeit verwendet wurde.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

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

Erforderlich: Ja

Schema

Definiert die Felder eines Datensatzes.

Typ: Schema Objekt

Erforderlich: Nein

StartDateTime

Wenn auf gesetzt TimePointGranularity istSPECIFIC, definieren Sie den ersten Punkt für die Erklärbarkeit.

Verwenden Sie das folgende Zeitstempelformat: yyyy- MM-ddTHH:mm:ss (Beispiel: 2015-01-01) T20:00:00

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 19.

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

Erforderlich: Nein

Tags

Optionale Metadaten, die Ihnen helfen, Ihre Ressourcen zu kategorisieren und zu organisieren. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen. Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

Für Tags gelten die folgenden Einschränkungen:

  • Für jede Ressource muss jeder Tag-Schlüssel eindeutig sein und jeder Tag-Schlüssel muss einen Wert haben.

  • Maximale Anzahl von Tags pro Ressource: 50.

  • Maximale Schlüssellänge: 128 Unicode-Zeichen in UTF-8.

  • Maximale Wertelänge: 256 Unicode-Zeichen in UTF-8.

  • Zulässige Zeichen: alle Buchstaben und Zahlen, Leerzeichen, die in UTF-8 und + - = dargestellt werden können. _:/@. Wenn Ihr Tagging-Schema für andere Dienste und Ressourcen verwendet wird, gelten auch die Zeichenbeschränkungen dieser Dienste.

  • Schlüsselpräfixe dürfen keine Groß- oder Kleinbuchstabenkombination von oder enthalten. aws: AWS: Werte können dieses Präfix haben. Wenn ein Tag-Wert ein Präfix hataws, der Schlüssel jedoch nicht, betrachtet Forecast ihn als Benutzer-Tag und wird auf das Limit von 50 Tags angerechnet. Tags, die nur das Schlüsselpräfix von aws haben, werden nicht auf das Limit für Stichwörter pro Ressource angerechnet. Sie können Tag-Schlüssel mit diesem Präfix nicht bearbeiten oder löschen.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

Antwortsyntax

{
   "ExplainabilityArn": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

ExplainabilityArn

Der Amazon-Ressourcenname (ARN) der Erklärbarkeit.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

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

Fehler

InvalidInputException

Wir können die Anfrage nicht bearbeiten, da sie einen ungültigen Wert enthält oder einen Wert, der den gültigen Bereich überschreitet.

HTTP-Statuscode: 400

LimitExceededException

Das Limit für die Anzahl der Ressourcen pro Konto wurde überschritten.

HTTP-Statuscode: 400

ResourceAlreadyExistsException

Es gibt bereits eine Ressource mit diesem Namen. Versuchen Sie es erneut mit einem anderen Namen.

HTTP-Statuscode: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP-Statuscode: 400

ResourceNotFoundException

Wir können keine Ressource mit diesem Amazon-Ressourcennamen (ARN) finden. Überprüfen Sie den ARN und versuchen Sie es erneut.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: