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.
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 chiamata Impact score per quantificare l'impatto relativo di ogni attributo e determinare se aumenta o diminuisce i valori di previsione.
Per abilitare Forecast Explainability, il tuo predittore deve includere almeno uno dei seguenti elementi: serie temporali correlate, metadati degli articoli o set di dati aggiuntivi come Holidays e Weather Index.
CreateExplainability accetta un Predictor ARN o 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 punteggi di impatto per serie temporali e punti temporali specifici, fornisci un Forecast ARN.
CreateExplainability con un Predictor ARN
Nota
Puoi avere solo una risorsa di spiegabilità per predittore. Se hai già abilitato ExplainPredictor l'accessoCreateAutoPredictor, quel predittore dispone già di una risorsa Explainability.
I seguenti parametri sono necessari quando si fornisce un Predictor ARN:
-
ExplainabilityName- Un nome univoco per l'esplicabilità. -
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 Forecast ARN
Nota
È possibile specificare un massimo di 50 serie temporali e 500 punti temporali.
I seguenti parametri sono necessari quando si fornisce un Predictor ARN:
-
ExplainabilityName- Un nome univoco per l'esplicabilità. -
ResourceArn- L'Arn della previsione. -
TimePointGranularity- «TUTTO» o «SPECIFICO». -
TimeSeriesGranularity- «TUTTO» o «SPECIFICO».
Se è TimeSeriesGranularity impostato su «SPECIFICO», è inoltre necessario fornire 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
Campo obbligatorio: no
- EnableVisualization
-
Crea una visualizzazione di spiegabilità visualizzabile all'interno della console. AWS
Tipo: Booleano
Campo obbligatorio: no
- EndDateTime
-
Se
TimePointGranularityè impostato suSPECIFIC, definisci l'ultimo punto temporale per l'esplicabilità.Utilizza il seguente formato di timestamp: YYYY-MM-DDTHH:mm:ss (esempio: 2015-01-01T 20: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}$Campo obbligatorio: no
- ExplainabilityConfig
-
Le impostazioni di configurazione che definiscono la granularità delle serie temporali e dei punti temporali per la spiegabilità.
Tipo: oggetto ExplainabilityConfig
Campo obbligatorio: sì
- ExplainabilityName
-
Un nome univoco per Explainability.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z][a-zA-Z0-9_]*Campo 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:.*:.*:.+Campo obbligatorio: sì
- Schema
-
Definisce i campi di un set di dati.
Tipo: oggetto Schema
Campo obbligatorio: no
- StartDateTime
-
Se
TimePointGranularityè impostato suSPECIFIC, definisci il primo punto per l'esplicabilità.Utilizza il seguente formato di timestamp: YYYY-MM-DDTHH:mm:ss (esempio: 2015-01-01T 20: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}$Campo 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 unica 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 lo schema di etichettatura 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 il valore di un tag haawscome prefisso ma la chiave no, Forecast lo considera un tag utente e verrà conteggiato nel limite di 50 tag. I tag con solo il prefisso chiave diawsnon vengono conteggiati ai fini del limite di tag per risorsa. 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.
Campo 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 questo 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:
