

 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à.

# CreateWhatIfForecast
<a name="API_CreateWhatIfForecast"></a>

Una previsione what-if è una previsione creata da una versione modificata della previsione di base. Ogni previsione what-if incorpora un set di dati sostitutivo o un insieme di trasformazioni rispetto al set di dati originale. 

**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/) 

## Sintassi della richiesta
<a name="API_CreateWhatIfForecast_RequestSyntax"></a>

```
{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeSeriesReplacementsDataSource": { 
      "Format": "string",
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      },
      "Schema": { 
         "Attributes": [ 
            { 
               "AttributeName": "string",
               "AttributeType": "string"
            }
         ]
      },
      "TimestampFormat": "string"
   },
   "TimeSeriesTransformations": [ 
      { 
         "Action": { 
            "AttributeName": "string",
            "Operation": "string",
            "Value": number
         },
         "TimeSeriesConditions": [ 
            { 
               "AttributeName": "string",
               "AttributeValue": "string",
               "Condition": "string"
            }
         ]
      }
   ],
   "WhatIfAnalysisArn": "string",
   "WhatIfForecastName": "string"
}
```

## Parametri della richiesta
<a name="API_CreateWhatIfForecast_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Tags](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-Tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) da applicare alla previsione what if.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

 ** [TimeSeriesReplacementsDataSource](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesReplacementsDataSource"></a>
Il set di dati delle serie temporali sostitutivo, che contiene le righe che si desidera modificare nel set di dati della serie temporale correlata. Non è necessario che una serie temporale sostitutiva contenga tutte le righe presenti nella serie temporale relativa alla linea di base. Includi solo le righe (combinazioni misura-dimensione) che desideri includere nella previsione what-if.  
Questo set di dati viene unito alla serie temporale originale per creare un set di dati trasformato che viene utilizzato per l'analisi what-if.  
Questo set di dati deve contenere gli elementi da modificare (come item\$1id o workforce\$1type), tutte le dimensioni pertinenti, la colonna timestamp e almeno una delle colonne relative alle serie temporali. Questo file non deve contenere timestamp duplicati per la stessa serie temporale. Questo file deve essere in formato CSV.  
I timestamp e gli item\$1id non inclusi in questo set di dati non sono inclusi nell'analisi what-if.   
Tipo: oggetto [TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md)  
Obbligatorio: no

 ** [TimeSeriesTransformations](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesTransformations"></a>
Le trasformazioni applicate alle serie temporali di base. Ogni trasformazione contiene un'azione e un insieme di condizioni. Un'azione viene applicata solo quando tutte le condizioni sono soddisfatte. Se non viene fornita alcuna condizione, l'azione viene applicata a tutti gli elementi.  
Tipo: matrice di oggetti [TimeSeriesTransformation](API_TimeSeriesTransformation.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 30 articoli.  
Obbligatorio: no

 ** [WhatIfAnalysisArn](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfAnalysisArn"></a>
L'Amazon Resource Name (ARN) dell'analisi what-if.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obbligatorio: sì

 ** [WhatIfForecastName](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfForecastName"></a>
Il nome della previsione what-if. I nomi devono essere univoci all'interno di ogni analisi what-if.  
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ì

## Sintassi della risposta
<a name="API_CreateWhatIfForecast_ResponseSyntax"></a>

```
{
   "WhatIfForecastArn": "string"
}
```

## Elementi di risposta
<a name="API_CreateWhatIfForecast_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [WhatIfForecastArn](#API_CreateWhatIfForecast_ResponseSyntax) **   <a name="forecast-CreateWhatIfForecast-response-WhatIfForecastArn"></a>
L'Amazon Resource Name (ARN) della previsione what-if.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 300.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## Errori
<a name="API_CreateWhatIfForecast_Errors"></a>

 ** 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
<a name="API_CreateWhatIfForecast_SeeAlso"></a>

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/CreateWhatIfForecast) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecast) 