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ù»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 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](API_CreateAutoPredictor.md) 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ù»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) La spiegabilità ti aiuta a comprendere 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. **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 set di dati aggiuntivi. 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 i 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'accesso[CreateAutoPredictor](API_CreateAutoPredictor.md), 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](#API_CreateExplainability_RequestSyntax) ** 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](API_DataSource.md) Obbligatorio: no ** [EnableVisualization](#API_CreateExplainability_RequestSyntax) ** Crea una visualizzazione di spiegabilità visualizzabile all'interno della console. AWS Tipo: Booleano Obbligatorio: no ** [EndDateTime](#API_CreateExplainability_RequestSyntax) ** Se `TimePointGranularity` è impostato su`SPECIFIC`, 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: String Vincoli di lunghezza: lunghezza massima di 19. Modello: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` Obbligatorio: no ** [ExplainabilityConfig](#API_CreateExplainability_RequestSyntax) ** Le impostazioni di configurazione che definiscono la granularità delle serie temporali e dei punti temporali per la spiegabilità. Tipo: oggetto [ExplainabilityConfig](API_ExplainabilityConfig.md) Obbligatorio: sì ** [ExplainabilityName](#API_CreateExplainability_RequestSyntax) ** Un nome univoco per Explainability. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri. Modello: `^[a-zA-Z][a-zA-Z0-9_]*` Obbligatorio: sì ** [ResourceArn](#API_CreateExplainability_RequestSyntax) ** L'Amazon Resource Name (ARN) del Predictor o Forecast utilizzato per creare l'Explainability. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` Obbligatorio: sì ** [Schema](#API_CreateExplainability_RequestSyntax) ** Definisce i campi di un set di dati. Tipo: oggetto [Schema](API_Schema.md) Obbligatorio: no ** [StartDateTime](#API_CreateExplainability_RequestSyntax) ** Se `TimePointGranularity` è impostato su`SPECIFIC`, 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: String Vincoli di lunghezza: lunghezza massima di 19. Modello: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` Obbligatorio: no ** [Tags](#API_CreateExplainability_RequestSyntax) ** 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 \$1 - =. \$1:/@. 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 ha `aws` come 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 di `aws` non 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](API_Tag.md) 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](#API_CreateExplainability_ResponseSyntax) ** L'Amazon Resource Name (ARN) dell'Explainability. Tipo: String 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 una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateExplainability) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateExplainability) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateExplainability) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateExplainability) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateExplainability) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainability) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateExplainability) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateExplainability) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateExplainability) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainability)