Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

 Créez une requête planifiée qui sera exécutée en votre nom selon la planification configurée. Timestream endosse le rôle d'exécution fourni dans le cadre du paramètre `ScheduledQueryExecutionRoleArn` pour exécuter la requête. Vous pouvez utiliser le paramètre `NotificationConfiguration` pour configurer la notification pour vos opérations de requêtes planifiées.

## Syntaxe de la requête
<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"
      }
   }
}
```

## Paramètres de demande
<a name="API_query_CreateScheduledQuery_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
L'utilisation de a ClientToken rend l'appel à CreateScheduledQuery idempotent, en d'autres termes, le fait de faire la même demande à plusieurs reprises produira le même résultat. Le fait de faire plusieurs CreateScheduledQuery demandes identiques a le même effet qu'une seule demande.   
+  S'il CreateScheduledQuery est appelé sans un`ClientToken`, le Query SDK en génère un `ClientToken` en votre nom.
+  Après 8 heures, toute demande avec le même `ClientToken` est considérée comme une nouvelle demande. 
Type : Chaîne  
Contraintes de longueur : longueur minimale de 32. Longueur maximale de 128.  
Obligatoire : non

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Configuration pour le signalement d'erreurs. Des rapports d'erreurs seront générés lorsqu'un problème est rencontré au moment de l'écriture des résultats de la requête.   
Type : objet [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obligatoire : oui

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
La clé Amazon KMS utilisée pour chiffrer la ressource de requête planifiée, au repos. Si la clé Amazon KMS n'est pas spécifiée, la ressource de requête planifiée sera chiffrée avec une clé Amazon KMS détenue par Timestream. Pour spécifier une clé KMS, utilisez l'ID de clé, l'ARN de clé, le nom d'alias ou l'ARN d'alias. Lorsque vous utilisez un nom d'alias, préfixez-le avec *alias/*.   
S'il est ErrorReportConfiguration utilisé `SSE_KMS` comme type de chiffrement, le même KmsKeyId est utilisé pour chiffrer le rapport d'erreur au repos.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : non

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
Nom de la requête planifiée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatoire : oui

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
Configuration de la notification pour la requête planifiée. Une notification est envoyée par Timestream lorsque l'exécution d'une requête se termine, lorsque l'état est mis à jour ou lorsque vous la supprimez.   
Type : objet [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obligatoire : oui

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
La chaîne de requête à exécuter. Les noms de paramètres peuvent être spécifiés dans le caractère `@` de la chaîne de requête suivi d'un identifiant. Le paramètre nommé `@scheduled_runtime` est réservé et peut être utilisé dans la requête pour obtenir l'heure à laquelle l'exécution de la requête est planifiée.  
L'horodatage calculé en fonction du ScheduleConfiguration paramètre sera la valeur du `@scheduled_runtime` paramètre pour chaque requête exécutée. Par exemple, imaginez une instance d'une requête planifiée s'exécutant le 01/12/2021 à minuit. Pour cette instance, le paramètre `@scheduled_runtime` est initialisé à l'horodatage 01/12/2021 à minuit lors de l'appel de la requête.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.  
Obligatoire : oui

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
Configuration du planning pour la requête.  
Type : objet [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obligatoire : oui

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
L'ARN du rôle IAM que Timestream endossera lors de l'exécution de la requête planifiée.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
Une liste de paires clé-valeur pour étiqueter la requête planifiée.  
Type : tableau d’objets [Tag](API_query_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Configuration utilisée pour écrire le résultat d'une requête.  
Type : objet [TargetConfiguration](API_query_TargetConfiguration.md)  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_query_CreateScheduledQuery_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_query_CreateScheduledQuery_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN pour la requête planifiée créée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
Code d’état HTTP : 400

 ** ConflictException **   
 Impossible d'interroger les résultats d'une requête annulée.   
Code d’état HTTP : 400

 ** InternalServerException **   
Une erreur interne du serveur s'est produite lors du traitement de la demande.  
Code d’état HTTP : 400

 ** InvalidEndpointException **   
Le point de terminaison demandé n'est pas valide.  
Code d’état HTTP : 400

 ** ServiceQuotaExceededException **   
Vous avez dépassé le quota de service.  
Code d’état HTTP : 400

 ** ThrottlingException **   
La demande a été limitée en raison d'un nombre excessif de demandes.  
Code d’état HTTP : 400

 ** ValidationException **   
 Demande non valide ou mal formée.   
Code d’état HTTP : 400

## Voir aussi
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)