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

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

Erstellt 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“

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

Um die Erklärbarkeit von Forecast zu aktivieren, muss Ihr Prädiktor mindestens eines der folgenden Elemente enthalten: verwandte Zeitreihen, Elementmetadaten oder zusätzliche Datensätze wie Feiertage und Wetterindex.

Anmerkung

Die Modelle ARIMA (AutoRegressive Integrierter gleitender Durchschnitt), ETS (Exponential Smoothing State Space Model) und NPTS (Nichtparametrische Zeitreihen) beziehen keine externen Zeitreihendaten ein. Daher erstellen diese Modelle keinen Bericht zur Erklärbarkeit, selbst wenn Sie die zusätzlichen Datensätze einbeziehen.

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

CreateExplainability mit einem Prädiktor ARN

Anmerkung

Pro Prädiktor kann nur eine Erklärbarkeitsressource verwendet werden. Wenn Sie es bereits aktiviert ExplainPredictor habenCreateAutoPredictor, verfügt dieser Prädiktor bereits über eine Erklärbarkeitsressource.

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

  • 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 „SPECIFIC“ TimeSeriesGranularity ist.

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

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

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

CreateExplainability mit einer Forecast ARN

Anmerkung

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

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

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

  • ResourceArn- Der Kern der Prognose.

  • TimePointGranularity- Entweder „ALL“ oder „SPECIFIC“.

  • TimeSeriesGranularity- Entweder „ALL“ oder „SPECIFIC“.

Wenn Sie TimeSeriesGranularity auf „SPECIFIC“ setzen, 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 aufgelisteten Attribute und Attributtypen.

Wenn Sie TimePointGranularity auf „SPECIFIC“ setzen, 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 Anfrage 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 AWS Konsole angezeigt werden kann.

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-Dd:mm:ss (BeispielTHH: 2015-01-01T 20:00:00)

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 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 Forecast, 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-Dd:mm:ss (BeispielTHH: 2015-01-01T 20:00:00)

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 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 Wertlänge: 256 Unicode-Zeichen in UTF -8.

  • Zulässige Zeichen: alle Buchstaben und Zahlen, Leerzeichen, die durch UTF -8 dargestellt werden können, und + - =. _:/@. 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 Benutzertag und wird auf das Limit von 50 Tags angerechnet. Tags, die nur das key prefix von enthalten, werden aws nicht auf Ihre Stichwörter pro Ressourcenlimit 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 Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst 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 oder einen Wert enthält, der den gültigen Bereich überschreitet.

HTTPStatuscode: 400

LimitExceededException

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

HTTPStatuscode: 400

ResourceAlreadyExistsException

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

HTTPStatuscode: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTPStatuscode: 400

ResourceNotFoundException

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

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: