Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. [Scopri](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) di più qui.

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

# CreateScheduledQuery
<a name="API_query_CreateScheduledQuery"></a>

 Creare una query pianificata che verrà eseguita per conto dell'utente in base alla pianificazione configurata. Per l'esecuzione della query, a Timestream viene assegnato il ruolo di esecutore nell'ambito del parametro `ScheduledQueryExecutionRoleArn`. È possibile utilizzare il parametro `NotificationConfiguration` per configurare l'invio di una notifica per le operazioni di query pianificate.

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

```
{
   "ClientToken": "string",
   "ErrorReportConfiguration": { 
      "S3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "KmsKeyId": "string",
   "Name": "string",
   "NotificationConfiguration": { 
      "SnsConfiguration": { 
         "TopicArn": "string"
      }
   },
   "QueryString": "string",
   "ScheduleConfiguration": { 
      "ScheduleExpression": "string"
   },
   "ScheduledQueryExecutionRoleArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TargetConfiguration": { 
      "TimestreamConfiguration": { 
         "DatabaseName": "string",
         "DimensionMappings": [ 
            { 
               "DimensionValueType": "string",
               "Name": "string"
            }
         ],
         "MeasureNameColumn": "string",
         "MixedMeasureMappings": [ 
            { 
               "MeasureName": "string",
               "MeasureValueType": "string",
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "SourceColumn": "string",
               "TargetMeasureName": "string"
            }
         ],
         "MultiMeasureMappings": { 
            "MultiMeasureAttributeMappings": [ 
               { 
                  "MeasureValueType": "string",
                  "SourceColumn": "string",
                  "TargetMultiMeasureAttributeName": "string"
               }
            ],
            "TargetMultiMeasureName": "string"
         },
         "TableName": "string",
         "TimeColumn": "string"
      }
   }
}
```

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

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
L'uso di a ClientToken rende la chiamata CreateScheduledQuery idempotente, in altre parole, ripetere la stessa richiesta produrrà lo stesso risultato. Effettuare più CreateScheduledQuery richieste identiche ha lo stesso effetto di fare una singola richiesta.   
+  Se CreateScheduledQuery viene chiamato senza un`ClientToken`, Query SDK genera un `ClientToken` messaggio per conto dell'utente.
+  Dopo 8 ore, qualsiasi richiesta con lo stesso `ClientToken` viene considerata e gestita come una nuova richiesta. 
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 32. La lunghezza massima è 128 caratteri.  
Obbligatorio: no

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Configurazione della segnalazione di errori. I report di errore vengono generati quando si verifica un problema durante la scrittura dei risultati della query.   
Tipo: oggetto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obbligatorio: sì

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
La chiave Amazon KMS utilizzata per crittografare la risorsa di query pianificata, quando i dati sono inattivi. Se la chiave Amazon KMS non viene specificata, la risorsa di query pianificata verrà crittografata con una chiave Amazon KMS di proprietà di Timestream. Per specificare una chiave KMS, utilizzare l'ID o l'ARN della chiave oppure il nome o l'ARN dell'alias. Quando si utilizza un nome alias, aggiungere al nome il prefisso *alias/*   
Se viene ErrorReportConfiguration utilizzato `SSE_KMS` come tipo di crittografia, lo stesso KmsKeyId viene utilizzato per crittografare la segnalazione degli errori a riposo.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: no

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
Nome della query pianificata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obbligatorio: sì

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
Configurazione della notifica per la query pianificata. Quando l'esecuzione di una query pianificata termina oppure lo stato della query viene aggiornato oppure la query viene eliminata, Timestream invia una notifica.   
Tipo: oggetto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obbligatorio: sì

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
La stringa query da eseguire. I nomi dei parametri possono essere specificati nella stringa query dal carattere `@` seguito da un identificatore. Il parametro denominato `@scheduled_runtime` è riservato e può essere utilizzato nella query per ottenere l'ora in cui è pianificata l'esecuzione della query.  
Il timestamp calcolato in base al ScheduleConfiguration parametro sarà il valore del `@scheduled_runtime` parametro per ogni esecuzione di query. Ad esempio, si può considerare un'istanza di una query pianificata in esecuzione alla data/ora 2021-12-01 00:00:00. In questa istanza, il parametro `@scheduled_runtime` viene inizializzato in corrispondenza del timestamp 2021-12-01 00:00:00 quando si richiama la query.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 262144.  
Obbligatorio: sì

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
La configurazione della pianificazione per la query.  
Tipo: oggetto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obbligatorio: sì

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
L'ARN del ruolo IAM che Timestream assumerà durante l'esecuzione della query pianificata.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
Un elenco di coppie chiave-valore per etichettare la query pianificata.  
Tipo: matrice di oggetti [Tag](API_query_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Configurazione utilizzata per scrivere il risultato di una query.  
Tipo: oggetto [TargetConfiguration](API_query_TargetConfiguration.md)  
Obbligatorio: no

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

```
{
   "Arn": "string"
}
```

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

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

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

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN per la query pianificata creata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Impossibile visualizzare i risultati di un sondaggio per una query annullata.   
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

 ** InvalidEndpointException **   
L'endpoint richiesto non è valido.  
Codice di stato HTTP: 400

 ** ServiceQuotaExceededException **   
Hai superato la quota di servizio.  
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

 ** ValidationException **   
 Richiesta non valida o non valida.   
Codice di stato HTTP: 400

## Vedi anche
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)