Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. Scopri di più»
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateExplainability
Nota
La spiegabilità è disponibile solo per le previsioni e i predittori generati da un () AutoPredictor CreateAutoPredictor
Crea una spiegabilità di Amazon Forecast.
Importante
Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. Scopri di più»
La spiegabilità ti aiuta a capire meglio in che modo gli attributi dei tuoi set di dati influiscono sulle previsioni. Amazon Forecast utilizza una metrica denominata Impact Score per quantificare l'impatto relativo di ciascun attributo e determinare se aumentano o diminuiscono i valori delle previsioni.
Per abilitare la spiegabilità delle previsioni, il tuo predittore deve includere almeno uno dei seguenti: serie temporali correlate, metadati degli articoli o set di dati aggiuntivi come le festività e l'indice meteorologico.
Nota
I modelli ARIMA (AutoRegressive Integrated Moving Average), ETS (Exponential Smoothing State Space Model) e NPTS (Non-Parametric Time Series) non incorporano dati di serie temporali esterne. Pertanto, questi modelli non creano un rapporto di spiegabilità, anche se si includono i set di dati aggiuntivi.
CreateExplainability accetta un Predictor ARN o un Forecast ARN. Per ricevere punteggi di impatto aggregati per tutte le serie temporali e i punti temporali nei tuoi set di dati, fornisci un Predictor ARN. Per ricevere i punteggi di Impact per serie temporali e punti temporali specifici, fornisci un ARN previsionale.
CreateExplainability con un Predictor ARN
Nota
È possibile disporre di una sola risorsa Explainability per predittore. Se hai già attivato ExplainPredictor l'accessoCreateAutoPredictor, quel predittore dispone già di una risorsa Explainability.
I seguenti parametri sono obbligatori quando si fornisce un Predictor ARN:
-
ExplainabilityName- Un nome univoco per l'Explainability. -
ResourceArn- L'Arn del predittore. -
TimePointGranularity- Deve essere impostato su «ALL». -
TimeSeriesGranularity- Deve essere impostato su «ALL».
Non specificate un valore per i seguenti parametri:
-
DataSource- Valido solo quando TimeSeriesGranularity è «SPECIFICO». -
Schema- Valido solo quando TimeSeriesGranularity è «SPECIFICO». -
StartDateTime- Valido solo quando TimePointGranularity è «SPECIFICO». -
EndDateTime- Valido solo quando TimePointGranularity è «SPECIFICO».
CreateExplainability con un ARN previsionale
Nota
È possibile specificare un massimo di 50 serie temporali e 500 punti temporali.
I seguenti parametri sono obbligatori per fornire un Predictor ARN:
-
ExplainabilityName- Un nome univoco per l'Explainability. -
ResourceArn- L'Arn della previsione. -
TimePointGranularity- «TUTTO» o «SPECIFICO». -
TimeSeriesGranularity- «TUTTO» o «SPECIFICO».
Se TimeSeriesGranularity imposti su «SPECIFICO», devi fornire anche quanto segue:
-
DataSource- La posizione S3 del file CSV che specifica le serie temporali. -
Schema- Lo schema definisce gli attributi e i tipi di attributi elencati nell'origine dati.
Se si imposta TimePointGranularity su «SPECIFICO», è necessario fornire anche quanto segue:
-
StartDateTime- Il primo timestamp nell'intervallo di punti temporali. -
EndDateTime- L'ultimo timestamp nell'intervallo di punti temporali.
Sintassi della richiesta
{
"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"
}
]
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- DataSource
-
L'origine dei dati, un ruolo AWS Identity and Access Management (IAM) che consente ad Amazon Forecast di accedere ai dati e, facoltativamente, una chiave AWS Key Management Service (KMS).
Tipo: oggetto DataSource
Obbligatorio: no
- EnableVisualization
-
Crea una visualizzazione di Explainability visualizzabile all'interno della console. AWS
Tipo: Booleano
Obbligatorio: no
- EndDateTime
-
Se
TimePointGranularityè impostato suSPECIFIC, definisci l'ultimo punto temporale per l'Explainability.Usa il seguente formato di timestamp: yyyy- (esempio: 2015-01-01) MM-ddTHH:mm:ss T20:00:00
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 19.
Modello:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$Obbligatorio: no
- ExplainabilityConfig
-
Le impostazioni di configurazione che definiscono la granularità delle serie temporali e dei punti temporali per l'Explainability.
Tipo: oggetto ExplainabilityConfig
Obbligatorio: sì
- ExplainabilityName
-
Un nome univoco per l'Explainability.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z][a-zA-Z0-9_]*Obbligatorio: sì
- ResourceArn
-
L'Amazon Resource Name (ARN) del Predictor o Forecast utilizzato per creare l'Explainability.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+Obbligatorio: sì
- Schema
-
Definisce i campi di un set di dati.
Tipo: oggetto Schema
Obbligatorio: no
- StartDateTime
-
Se
TimePointGranularityè impostato suSPECIFIC, definisci il primo punto per l'Explainability.Usa il seguente formato di timestamp: yyyy- (esempio: 2015-01-01) MM-ddTHH:mm:ss T20:00:00
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 19.
Modello:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$Obbligatorio: no
- Tags
-
Metadati opzionali per aiutarti a classificare e organizzare le tue risorse. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili. I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
Ai tag si applicano le limitazioni seguenti:
-
Per ogni risorsa, ogni chiave di tag deve essere univoca e ogni chiave di tag deve avere un valore.
-
Numero massimo di tag per risorsa: 50.
-
Lunghezza massima della chiave: 128 caratteri Unicode in. UTF-8
-
Lunghezza massima del valore: 256 caratteri Unicode in. UTF-8
-
Caratteri accettati: tutte le lettere e i numeri, gli spazi rappresentabili in UTF-8 e + - =. _:/@. Se il tuo schema di tagging viene utilizzato in altri servizi e risorse, si applicano anche le restrizioni relative ai caratteri di tali servizi.
-
I prefissi chiave non possono includere alcuna combinazione maiuscola o minuscola di o.
aws:AWS:I valori possono avere questo prefisso. Se un valore di tag haawscome prefisso ma la chiave no, Forecast lo considera un tag utente e verrà conteggiato nel limite di 50 tag. I tag con il solo prefisso chiave diawsnon vengono conteggiati nel calcolo dei tag per limite di risorse. Non è possibile modificare o eliminare le chiavi dei tag con questo prefisso.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Obbligatorio: no
-
Sintassi della risposta
{
"ExplainabilityArn": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- ExplainabilityArn
-
L'Amazon Resource Name (ARN) dell'Explainability.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+
Errori
- InvalidInputException
-
Non possiamo elaborare la richiesta perché include un valore non valido o un valore che supera l'intervallo valido.
Codice di stato HTTP: 400
- LimitExceededException
-
Il limite del numero di risorse per account è stato superato.
Codice di stato HTTP: 400
- ResourceAlreadyExistsException
-
Esiste già una risorsa con questo nome. Riprova con un nome diverso.
Codice di stato HTTP: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Non riusciamo a trovare una risorsa con tale Amazon Resource Name (ARN). Controlla l'ARN e riprova.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
