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.

# Actions
<a name="API_Operations"></a>

Les actions suivantes sont prises en charge par Amazon Timestream Write :
+  [CreateBatchLoadTask](API_CreateBatchLoadTask.md) 
+  [CreateDatabase](API_CreateDatabase.md) 
+  [CreateTable](API_CreateTable.md) 
+  [DeleteDatabase](API_DeleteDatabase.md) 
+  [DeleteTable](API_DeleteTable.md) 
+  [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) 
+  [DescribeDatabase](API_DescribeDatabase.md) 
+  [DescribeEndpoints](API_DescribeEndpoints.md) 
+  [DescribeTable](API_DescribeTable.md) 
+  [ListBatchLoadTasks](API_ListBatchLoadTasks.md) 
+  [ListDatabases](API_ListDatabases.md) 
+  [ListTables](API_ListTables.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateDatabase](API_UpdateDatabase.md) 
+  [UpdateTable](API_UpdateTable.md) 
+  [WriteRecords](API_WriteRecords.md) 

Les actions suivantes sont prises en charge par Amazon Timestream Query :
+  [CancelQuery](API_query_CancelQuery.md) 
+  [CreateScheduledQuery](API_query_CreateScheduledQuery.md) 
+  [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) 
+  [DescribeAccountSettings](API_query_DescribeAccountSettings.md) 
+  [DescribeEndpoints](API_query_DescribeEndpoints.md) 
+  [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) 
+  [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) 
+  [ListScheduledQueries](API_query_ListScheduledQueries.md) 
+  [ListTagsForResource](API_query_ListTagsForResource.md) 
+  [PrepareQuery](API_query_PrepareQuery.md) 
+  [Query](API_query_Query.md) 
+  [TagResource](API_query_TagResource.md) 
+  [UntagResource](API_query_UntagResource.md) 
+  [UpdateAccountSettings](API_query_UpdateAccountSettings.md) 
+  [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) 

# Amazon Timestream Write
<a name="API_Operations_Amazon_Timestream_Write"></a>

Les actions suivantes sont prises en charge par Amazon Timestream Write :
+  [CreateBatchLoadTask](API_CreateBatchLoadTask.md) 
+  [CreateDatabase](API_CreateDatabase.md) 
+  [CreateTable](API_CreateTable.md) 
+  [DeleteDatabase](API_DeleteDatabase.md) 
+  [DeleteTable](API_DeleteTable.md) 
+  [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) 
+  [DescribeDatabase](API_DescribeDatabase.md) 
+  [DescribeEndpoints](API_DescribeEndpoints.md) 
+  [DescribeTable](API_DescribeTable.md) 
+  [ListBatchLoadTasks](API_ListBatchLoadTasks.md) 
+  [ListDatabases](API_ListDatabases.md) 
+  [ListTables](API_ListTables.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateDatabase](API_UpdateDatabase.md) 
+  [UpdateTable](API_UpdateTable.md) 
+  [WriteRecords](API_WriteRecords.md) 

# CreateBatchLoadTask
<a name="API_CreateBatchLoadTask"></a>

Crée une nouvelle tâche de chargement par lots Timestream. Une tâche de chargement par lots traite les données d'une source CSV située dans un emplacement S3 et les écrit dans une table Timestream. Un mappage de la source à la cible est défini dans une tâche de chargement par lots. Les erreurs et les événements sont consignés dans un rapport sur un site S3. Pour le rapport, si la AWS KMS clé n'est pas spécifiée, le rapport sera chiffré avec une clé gérée S3 lorsque `SSE_S3` c'est possible. Dans le cas contraire, une erreur est générée. Pour en savoir plus, consultez [Clés gérées par AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Pour plus de détails, consultez l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html).

## Syntaxe de la requête
<a name="API_CreateBatchLoadTask_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "DataModelConfiguration": { 
      "DataModel": { 
         "DimensionMappings": [ 
            { 
               "DestinationColumn": "string",
               "SourceColumn": "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"
         },
         "TimeColumn": "string",
         "TimeUnit": "string"
      },
      "DataModelS3Configuration": { 
         "BucketName": "string",
         "ObjectKey": "string"
      }
   },
   "DataSourceConfiguration": { 
      "CsvConfiguration": { 
         "ColumnSeparator": "string",
         "EscapeChar": "string",
         "NullValue": "string",
         "QuoteChar": "string",
         "TrimWhiteSpace": boolean
      },
      "DataFormat": "string",
      "DataSourceS3Configuration": { 
         "BucketName": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "RecordVersion": number,
   "ReportConfiguration": { 
      "ReportS3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "KmsKeyId": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "TargetDatabaseName": "string",
   "TargetTableName": "string"
}
```

## Paramètres de demande
<a name="API_CreateBatchLoadTask_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_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ClientToken"></a>
  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Obligatoire : non

 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataModelConfiguration"></a>
  
Type : objet [DataModelConfiguration](API_DataModelConfiguration.md)  
Obligatoire : non

 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataSourceConfiguration"></a>
Définit les détails de configuration de la source de données pour une tâche de chargement par lots.  
Type : objet [DataSourceConfiguration](API_DataSourceConfiguration.md)  
Obligatoire : oui

 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-RecordVersion"></a>
  
Type : Long  
Obligatoire : non

 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ReportConfiguration"></a>
Configuration du rapport pour une tâche de chargement par lots. Il contient des informations sur l'emplacement de stockage des rapports d'erreur.  
Type : objet [ReportConfiguration](API_ReportConfiguration.md)  
Obligatoire : oui

 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetDatabaseName"></a>
Base de données Timestream cible pour une tâche de chargement par lots.  
Type : Chaîne  
Modèle : `[a-zA-Z0-9_.-]+`   
Obligatoire : oui

 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetTableName"></a>
Table Timestream cible pour une tâche de chargement par lots.  
Type : Chaîne  
Modèle : `[a-zA-Z0-9_.-]+`   
Obligatoire : oui

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

```
{
   "TaskId": "string"
}
```

## Eléments de réponse
<a name="API_CreateBatchLoadTask_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.

 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) **   <a name="timestream-CreateBatchLoadTask-response-TaskId"></a>
ID de la tâche de chargement par lots.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 32.  
Modèle : `[A-Z0-9]+` 

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** ConflictException **   
Timestream n'a pas pu traiter cette demande car elle contient une ressource qui existe déjà.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. Il se peut que la ressource ne soit pas spécifiée correctement ou que son statut ne soit pas ACTIF.  
Code d’état HTTP : 400

 ** ServiceQuotaExceededException **   
 Le quota de ressources d'instance a été dépassé pour ce compte.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_CreateBatchLoadTask_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-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) 

# CreateDatabase
<a name="API_CreateDatabase"></a>

Crée une nouvelle base de données Timestream. Si la AWS KMS clé n'est pas spécifiée, la base de données sera chiffrée à l'aide d'une AWS KMS clé gérée par Timestream située dans votre compte. Pour en savoir plus, consultez [Clés gérées par AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Pour plus de détails, consultez l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html). 

## Syntaxe de la requête
<a name="API_CreateDatabase_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "KmsKeyId": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Paramètres de demande
<a name="API_CreateDatabase_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.

 ** [DatabaseName](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-DatabaseName"></a>
Nom de la base de données Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximum de 256.  
Modèle : `[a-zA-Z0-9_.-]+`   
Obligatoire : oui

 ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-KmsKeyId"></a>
La AWS KMS clé de la base de données. Si la AWS KMS clé n'est pas spécifiée, la base de données sera chiffrée à l'aide d'une AWS KMS clé gérée par Timestream située dans votre compte. Pour en savoir plus, consultez [Clés gérées par AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : non

 ** [Tags](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-Tags"></a>
 Liste de paires clé-valeur pour étiqueter la table.   
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

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

```
{
   "Database": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "KmsKeyId": "string",
      "LastUpdatedTime": number,
      "TableCount": number
   }
}
```

## Eléments de réponse
<a name="API_CreateDatabase_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.

 ** [Database](#API_CreateDatabase_ResponseSyntax) **   <a name="timestream-CreateDatabase-response-Database"></a>
La nouvelle base de données Timestream.  
Type : objet [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** ConflictException **   
Timestream n'a pas pu traiter cette demande car elle contient une ressource qui existe déjà.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

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

 ** ServiceQuotaExceededException **   
 Le quota de ressources d'instance a été dépassé pour ce compte.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_CreateDatabase_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-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase) 

# CreateTable
<a name="API_CreateTable"></a>

Ajoute une nouvelle table à une base de données existante de votre compte. Dans un Compte AWS, les noms de table doivent être au moins uniques dans chaque région s'ils se trouvent dans la même base de données. Vous pouvez avoir des noms de table identiques dans la même région si les tables se trouvent dans des bases de données distinctes. Lors de la création de la table, vous devez spécifier le nom de la table, le nom de la base de données et les propriétés de conservation. [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html) pour plus de détails. 

## Syntaxe de la requête
<a name="API_CreateTable_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "MagneticStoreWriteProperties": { 
      "EnableMagneticStoreWrites": boolean,
      "MagneticStoreRejectedDataLocation": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      }
   },
   "RetentionProperties": { 
      "MagneticStoreRetentionPeriodInDays": number,
      "MemoryStoreRetentionPeriodInHours": number
   },
   "Schema": { 
      "CompositePartitionKey": [ 
         { 
            "EnforcementInRecord": "string",
            "Name": "string",
            "Type": "string"
         }
      ]
   },
   "TableName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Paramètres de demande
<a name="API_CreateTable_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.

 ** [DatabaseName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-DatabaseName"></a>
Nom de la base de données Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximum de 256.  
Modèle : `[a-zA-Z0-9_.-]+`   
Obligatoire : oui

 ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-MagneticStoreWriteProperties"></a>
Contient les propriétés à définir sur la table lors de l'activation des écritures sur stockage magnétique.  
Type : objet [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obligatoire : non

 ** [RetentionProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-RetentionProperties"></a>
Durée pendant laquelle les données de vos séries chronologiques doivent être stockées dans la mémoire et dans la mémoire magnétique.  
Type : objet [RetentionProperties](API_RetentionProperties.md)  
Obligatoire : non

 ** [Schema](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Schema"></a>
 Schéma de la table.   
Type : objet [Schema](API_Schema.md)  
Obligatoire : non

 ** [TableName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-TableName"></a>
Nom de la table Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximum de 256.  
Modèle : `[a-zA-Z0-9_.-]+`   
Obligatoire : oui

 ** [Tags](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Tags"></a>
 Liste de paires clé-valeur pour étiqueter la table.   
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

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

```
{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}
```

## Eléments de réponse
<a name="API_CreateTable_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.

 ** [Table](#API_CreateTable_ResponseSyntax) **   <a name="timestream-CreateTable-response-Table"></a>
La table Timestream nouvellement créée.  
Type : objet [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** ConflictException **   
Timestream n'a pas pu traiter cette demande car elle contient une ressource qui existe déjà.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ServiceQuotaExceededException **   
 Le quota de ressources d'instance a été dépassé pour ce compte.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_CreateTable_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-write-2018-11-01/CreateTable) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable) 

# DeleteDatabase
<a name="API_DeleteDatabase"></a>

Supprime une base de données Timestream donnée. *Il s'agit d'une opération irréversible. Après la suppression d'une base de données, les données chronologiques de ses tables ne peuvent pas être récupérées.* 

**Note**  
Toutes les tables de la base de données doivent d'abord être supprimées, sinon une ValidationException erreur sera générée.   
En raison de la nature des nouvelles tentatives distribuées, l'opération peut renvoyer soit un succès, soit un ResourceNotFoundException. Les clients doivent les considérer comme équivalents.

Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_DeleteDatabase_RequestSyntax"></a>

```
{
   "DatabaseName": "string"
}
```

## Paramètres de demande
<a name="API_DeleteDatabase_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.

 ** [DatabaseName](#API_DeleteDatabase_RequestSyntax) **   <a name="timestream-DeleteDatabase-request-DatabaseName"></a>
Nom de la base de données Timestream à supprimer.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

## Éléments de réponse
<a name="API_DeleteDatabase_ResponseElements"></a>

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

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_DeleteDatabase_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-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase) 

# DeleteTable
<a name="API_DeleteTable"></a>

Supprime une table Timestream donnée. Il s'agit d'une opération irréversible. Après la suppression d'une table de base de données Timestream, les données chronologiques stockées dans la table ne peuvent pas être récupérées. 

**Note**  
En raison de la nature des tentatives distribuées, l'opération peut renvoyer soit un succès, soit un ResourceNotFoundException. Les clients doivent les considérer comme équivalents.

Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_DeleteTable_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "TableName": "string"
}
```

## Paramètres de demande
<a name="API_DeleteTable_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.

 ** [DatabaseName](#API_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-DatabaseName"></a>
Nom de la base de données dans laquelle la base de données Timestream doit être supprimée.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

 ** [TableName](#API_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-TableName"></a>
Nom de la table Timestream à supprimer.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

## Éléments de réponse
<a name="API_DeleteTable_ResponseElements"></a>

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

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_DeleteTable_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-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable) 

# DescribeBatchLoadTask
<a name="API_DescribeBatchLoadTask"></a>

Renvoie des informations sur la tâche de chargement par lots, notamment les configurations, les mappages, la progression et d'autres détails. [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_DescribeBatchLoadTask_RequestSyntax"></a>

```
{
   "TaskId": "string"
}
```

## Paramètres de demande
<a name="API_DescribeBatchLoadTask_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.

 ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) **   <a name="timestream-DescribeBatchLoadTask-request-TaskId"></a>
ID de la tâche de chargement par lots.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 32.  
Modèle : `[A-Z0-9]+`   
Obligatoire : oui

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

```
{
   "BatchLoadTaskDescription": { 
      "CreationTime": number,
      "DataModelConfiguration": { 
         "DataModel": { 
            "DimensionMappings": [ 
               { 
                  "DestinationColumn": "string",
                  "SourceColumn": "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"
            },
            "TimeColumn": "string",
            "TimeUnit": "string"
         },
         "DataModelS3Configuration": { 
            "BucketName": "string",
            "ObjectKey": "string"
         }
      },
      "DataSourceConfiguration": { 
         "CsvConfiguration": { 
            "ColumnSeparator": "string",
            "EscapeChar": "string",
            "NullValue": "string",
            "QuoteChar": "string",
            "TrimWhiteSpace": boolean
         },
         "DataFormat": "string",
         "DataSourceS3Configuration": { 
            "BucketName": "string",
            "ObjectKeyPrefix": "string"
         }
      },
      "ErrorMessage": "string",
      "LastUpdatedTime": number,
      "ProgressReport": { 
         "BytesMetered": number,
         "FileFailures": number,
         "ParseFailures": number,
         "RecordIngestionFailures": number,
         "RecordsIngested": number,
         "RecordsProcessed": number
      },
      "RecordVersion": number,
      "ReportConfiguration": { 
         "ReportS3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      },
      "ResumableUntil": number,
      "TargetDatabaseName": "string",
      "TargetTableName": "string",
      "TaskId": "string",
      "TaskStatus": "string"
   }
}
```

## Eléments de réponse
<a name="API_DescribeBatchLoadTask_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.

 ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) **   <a name="timestream-DescribeBatchLoadTask-response-BatchLoadTaskDescription"></a>
Description de la tâche de chargement par lots.  
Type : objet [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. Il se peut que la ressource ne soit pas spécifiée correctement ou que son statut ne soit pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_DescribeBatchLoadTask_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-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 

# DescribeDatabase
<a name="API_DescribeDatabase"></a>

Renvoie des informations sur la base de données, notamment le nom de la base de données, l'heure à laquelle elle a été créée et le nombre total de tables trouvées dans la base de données. [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_DescribeDatabase_RequestSyntax"></a>

```
{
   "DatabaseName": "string"
}
```

## Paramètres de demande
<a name="API_DescribeDatabase_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.

 ** [DatabaseName](#API_DescribeDatabase_RequestSyntax) **   <a name="timestream-DescribeDatabase-request-DatabaseName"></a>
Nom de la base de données Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

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

```
{
   "Database": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "KmsKeyId": "string",
      "LastUpdatedTime": number,
      "TableCount": number
   }
}
```

## Eléments de réponse
<a name="API_DescribeDatabase_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.

 ** [Database](#API_DescribeDatabase_ResponseSyntax) **   <a name="timestream-DescribeDatabase-response-Database"></a>
Nom de la table Timestream.  
Type : objet [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_DescribeDatabase_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-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase) 

# DescribeEndpoints
<a name="API_DescribeEndpoints"></a>

Renvoie une liste des points de terminaison disponibles pour effectuer des appels d'API Timestream. Cette opération d'API est disponible à la fois via Write et Query APIs.

Les Timestream étant SDKs conçus pour fonctionner de manière transparente avec l'architecture du service, y compris la gestion et le mappage des points de terminaison du service, *nous vous déconseillons d'utiliser cette* opération d'API sauf si :
+ Vous utilisez des [points de terminaison VPC ()AWS PrivateLink](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) avec Timestream 
+ Votre application utilise un langage de programmation qui n'est pas encore compatible avec le SDK
+ Vous avez besoin d'un meilleur contrôle de la mise en œuvre côté client

Pour des informations détaillées sur comment et quand utiliser et implémenter DescribeEndpoints, consultez [The Endpoint Discovery Pattern](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery).

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

```
{
   "Endpoints": [ 
      { 
         "Address": "string",
         "CachePeriodInMinutes": number
      }
   ]
}
```

## Eléments de réponse
<a name="API_DescribeEndpoints_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.

 ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-DescribeEndpoints-response-Endpoints"></a>
Un `Endpoints` objet est renvoyé lorsqu'une `DescribeEndpoints` demande est faite.  
Type : tableau d’objets [Endpoint](API_Endpoint.md)

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

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

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_DescribeEndpoints_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-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints) 

# DescribeTable
<a name="API_DescribeTable"></a>

Renvoie des informations sur la table, notamment le nom de la table, le nom de la base de données, la durée de conservation de la mémoire et de la mémoire magnétique. [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html) pour plus de détails. 

## Syntaxe de la requête
<a name="API_DescribeTable_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "TableName": "string"
}
```

## Paramètres de demande
<a name="API_DescribeTable_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.

 ** [DatabaseName](#API_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-DatabaseName"></a>
Nom de la base de données Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

 ** [TableName](#API_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-TableName"></a>
Nom de la table Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

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

```
{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}
```

## Eléments de réponse
<a name="API_DescribeTable_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.

 ** [Table](#API_DescribeTable_ResponseSyntax) **   <a name="timestream-DescribeTable-response-Table"></a>
Le tableau Timestream.  
Type : objet [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_DescribeTable_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-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable) 

# ListBatchLoadTasks
<a name="API_ListBatchLoadTasks"></a>

Fournit une liste des tâches de chargement par lots, ainsi que leur nom, leur statut, la date à laquelle la tâche peut être reprise et d'autres détails. Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_ListBatchLoadTasks_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string",
   "TaskStatus": "string"
}
```

## Paramètres de demande
<a name="API_ListBatchLoadTasks_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.

 ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-MaxResults"></a>
Nombre total d’éléments à renvoyer dans la sortie. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, un NextToken est fourni dans la sortie. Pour reprendre la pagination, fournissez la NextToken valeur comme argument d'un appel d'API ultérieur.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.  
Obligatoire : non

 ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-NextToken"></a>
Jeton permettant de spécifier où commencer la pagination. C'est le résultat NextToken d'une réponse tronquée précédemment.  
Type : chaîne  
Obligatoire : non

 ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-TaskStatus"></a>
État de la tâche de chargement par lots.  
Type : Chaîne  
Valeurs valides : `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Obligatoire : non

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

```
{
   "BatchLoadTasks": [ 
      { 
         "CreationTime": number,
         "DatabaseName": "string",
         "LastUpdatedTime": number,
         "ResumableUntil": number,
         "TableName": "string",
         "TaskId": "string",
         "TaskStatus": "string"
      }
   ],
   "NextToken": "string"
}
```

## Eléments de réponse
<a name="API_ListBatchLoadTasks_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.

 ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-BatchLoadTasks"></a>
Liste des détails des tâches de chargement par lots.  
Type : tableau d’objets [BatchLoadTask](API_BatchLoadTask.md)

 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-NextToken"></a>
Jeton permettant de spécifier où commencer la pagination. Fournissez le suivant ListBatchLoadTasksRequest.  
Type : Chaîne

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_ListBatchLoadTasks_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-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks) 

# ListDatabases
<a name="API_ListDatabases"></a>

Renvoie la liste de vos bases de données Timestream. [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html) pour plus de détails. 

## Syntaxe de la requête
<a name="API_ListDatabases_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Paramètres de demande
<a name="API_ListDatabases_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.

 ** [MaxResults](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-MaxResults"></a>
Nombre total d’éléments à renvoyer dans la sortie. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, un NextToken est fourni dans la sortie. Pour reprendre la pagination, fournissez la NextToken valeur comme argument d'un appel d'API ultérieur.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale de 20.  
Obligatoire : non

 ** [NextToken](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-NextToken"></a>
Le jeton de pagination. Pour reprendre la pagination, fournissez la NextToken valeur comme argument d'un appel d'API ultérieur.  
Type : chaîne  
Obligatoire : non

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

```
{
   "Databases": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "DatabaseName": "string",
         "KmsKeyId": "string",
         "LastUpdatedTime": number,
         "TableCount": number
      }
   ],
   "NextToken": "string"
}
```

## Eléments de réponse
<a name="API_ListDatabases_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.

 ** [Databases](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-Databases"></a>
Liste des noms de bases de données.  
Type : tableau d’objets [Database](API_Database.md)

 ** [NextToken](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-NextToken"></a>
Le jeton de pagination. Ce paramètre est renvoyé lorsque la réponse est tronquée.  
Type : Chaîne

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_ListDatabases_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-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases) 

# ListTables
<a name="API_ListTables"></a>

Fournit une liste de tables, ainsi que le nom, le statut et les propriétés de rétention de chaque table. Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html) pour plus de détails. 

## Syntaxe de la requête
<a name="API_ListTables_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## Paramètres de demande
<a name="API_ListTables_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.

 ** [DatabaseName](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-DatabaseName"></a>
Nom de la base de données Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : non

 ** [MaxResults](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-MaxResults"></a>
Nombre total d’éléments à renvoyer dans la sortie. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, un NextToken est fourni dans la sortie. Pour reprendre la pagination, fournissez la NextToken valeur comme argument d'un appel d'API ultérieur.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale de 20.  
Obligatoire : non

 ** [NextToken](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-NextToken"></a>
Le jeton de pagination. Pour reprendre la pagination, fournissez la NextToken valeur comme argument d'un appel d'API ultérieur.  
Type : chaîne  
Obligatoire : non

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

```
{
   "NextToken": "string",
   "Tables": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "DatabaseName": "string",
         "LastUpdatedTime": number,
         "MagneticStoreWriteProperties": { 
            "EnableMagneticStoreWrites": boolean,
            "MagneticStoreRejectedDataLocation": { 
               "S3Configuration": { 
                  "BucketName": "string",
                  "EncryptionOption": "string",
                  "KmsKeyId": "string",
                  "ObjectKeyPrefix": "string"
               }
            }
         },
         "RetentionProperties": { 
            "MagneticStoreRetentionPeriodInDays": number,
            "MemoryStoreRetentionPeriodInHours": number
         },
         "Schema": { 
            "CompositePartitionKey": [ 
               { 
                  "EnforcementInRecord": "string",
                  "Name": "string",
                  "Type": "string"
               }
            ]
         },
         "TableName": "string",
         "TableStatus": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListTables_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.

 ** [NextToken](#API_ListTables_ResponseSyntax) **   <a name="timestream-ListTables-response-NextToken"></a>
Jeton permettant de spécifier où commencer la pagination. Il s'agit du NextToken résultat d'une réponse tronquée précédemment.  
Type : Chaîne

 ** [Tables](#API_ListTables_ResponseSyntax) **   <a name="timestream-ListTables-response-Tables"></a>
Une liste de tables.  
Type : tableau d’objets [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_ListTables_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-write-2018-11-01/ListTables) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

 Répertorie tous les tags d'une ressource Timestream. 

## Syntaxe de la requête
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string"
}
```

## Paramètres de demande
<a name="API_ListTagsForResource_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.

 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **   <a name="timestream-ListTagsForResource-request-ResourceARN"></a>
 La ressource Timestream avec les balises à répertorier. Cette valeur est un Amazon Resource Name (ARN).   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1011.  
Obligatoire : oui

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

```
{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListTagsForResource_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.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="timestream-ListTagsForResource-response-Tags"></a>
 Les balises actuellement associées à la ressource Timestream.   
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

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

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

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_ListTagsForResource_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-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource) 

# ResumeBatchLoadTask
<a name="API_ResumeBatchLoadTask"></a>

 

## Syntaxe de la requête
<a name="API_ResumeBatchLoadTask_RequestSyntax"></a>

```
{
   "TaskId": "string"
}
```

## Paramètres de demande
<a name="API_ResumeBatchLoadTask_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.

 ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) **   <a name="timestream-ResumeBatchLoadTask-request-TaskId"></a>
ID de la tâche de chargement par lots à reprendre.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 32.  
Modèle : `[A-Z0-9]+`   
Obligatoire : oui

## Éléments de réponse
<a name="API_ResumeBatchLoadTask_ResponseElements"></a>

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

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_ResumeBatchLoadTask_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-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 

# TagResource
<a name="API_TagResource"></a>

 Associe un ensemble de balises à une ressource Timestream. Vous pouvez ensuite activer ces balises définies par l'utilisateur afin qu'elles apparaissent sur la console Billing and Cost Management pour le suivi de la répartition des coûts. 

## Syntaxe de la requête
<a name="API_TagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Paramètres de demande
<a name="API_TagResource_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.

 ** [ResourceARN](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-ResourceARN"></a>
 Identifie la ressource Timestream à laquelle les balises doivent être ajoutées. Cette valeur est un Amazon Resource Name (ARN).   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1011.  
Obligatoire : oui

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-Tags"></a>
 Les balises à attribuer à la ressource Timestream.   
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : oui

## Éléments de réponse
<a name="API_TagResource_ResponseElements"></a>

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

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

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

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ServiceQuotaExceededException **   
 Le quota de ressources d'instance a été dépassé pour ce compte.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_TagResource_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-write-2018-11-01/TagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

 Supprime l'association de balises d'une ressource Timestream. 

## Syntaxe de la requête
<a name="API_UntagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## Paramètres de demande
<a name="API_UntagResource_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.

 ** [ResourceARN](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-ResourceARN"></a>
 La ressource Timestream dont les balises seront supprimées. Cette valeur est un Amazon Resource Name (ARN).   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1011.  
Obligatoire : oui

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-TagKeys"></a>
 Une liste de clés de tags. Les balises existantes de la ressource dont les clés sont membres de cette liste seront supprimées de la ressource Timestream.   
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Obligatoire : oui

## Éléments de réponse
<a name="API_UntagResource_ResponseElements"></a>

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

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

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

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ServiceQuotaExceededException **   
 Le quota de ressources d'instance a été dépassé pour ce compte.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_UntagResource_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-write-2018-11-01/UntagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource) 

# UpdateDatabase
<a name="API_UpdateDatabase"></a>

 Modifie la AWS KMS clé d'une base de données existante. Lors de la mise à jour de la base de données, vous devez spécifier le nom de la base de données et l'identifiant de la nouvelle AWS KMS clé à utiliser (`KmsKeyId`). S'il y a des `UpdateDatabase` demandes simultanées, le premier rédacteur gagne. 

Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_UpdateDatabase_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "KmsKeyId": "string"
}
```

## Paramètres de demande
<a name="API_UpdateDatabase_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.

 ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-DatabaseName"></a>
 Nom de la base de données.   
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-KmsKeyId"></a>
 Identifiant de la nouvelle AWS KMS clé (`KmsKeyId`) à utiliser pour chiffrer les données stockées dans la base de données. Si le contenu `KmsKeyId` actuellement enregistré dans la base de données est le même que celui `KmsKeyId` indiqué dans la demande, aucune mise à jour ne sera effectuée.   
Vous pouvez le spécifier à l'`KmsKeyId`aide de l'une des options suivantes :  
+ ID de clé : `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN de clé : `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nom d'alias : `alias/ExampleAlias` 
+ ARN d'alias : `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

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

```
{
   "Database": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "KmsKeyId": "string",
      "LastUpdatedTime": number,
      "TableCount": number
   }
}
```

## Eléments de réponse
<a name="API_UpdateDatabase_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.

 ** [Database](#API_UpdateDatabase_ResponseSyntax) **   <a name="timestream-UpdateDatabase-response-Database"></a>
Un conteneur de haut niveau pour une table. Les bases de données et les tables sont les concepts de gestion fondamentaux d'Amazon Timestream. Toutes les tables d'une base de données sont chiffrées avec la même AWS KMS clé.  
Type : objet [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ServiceQuotaExceededException **   
 Le quota de ressources d'instance a été dépassé pour ce compte.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_UpdateDatabase_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-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) 

# UpdateTable
<a name="API_UpdateTable"></a>

Modifie la durée de conservation de la mémoire et de la mémoire magnétique de votre table Timestream. Notez que la modification de la durée de conservation prend effet immédiatement. Par exemple, si la période de conservation de la mémoire a été initialement fixée à 2 heures, puis modifiée à 24 heures, la mémoire sera capable de contenir 24 heures de données, mais sera remplie de 24 heures de données 22 heures après cette modification. Timestream ne récupère pas les données de la mémoire magnétique pour alimenter la mémoire. 

Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_UpdateTable_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "MagneticStoreWriteProperties": { 
      "EnableMagneticStoreWrites": boolean,
      "MagneticStoreRejectedDataLocation": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      }
   },
   "RetentionProperties": { 
      "MagneticStoreRetentionPeriodInDays": number,
      "MemoryStoreRetentionPeriodInHours": number
   },
   "Schema": { 
      "CompositePartitionKey": [ 
         { 
            "EnforcementInRecord": "string",
            "Name": "string",
            "Type": "string"
         }
      ]
   },
   "TableName": "string"
}
```

## Paramètres de demande
<a name="API_UpdateTable_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.

 ** [DatabaseName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-DatabaseName"></a>
Nom de la base de données Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-MagneticStoreWriteProperties"></a>
Contient les propriétés à définir sur la table lors de l'activation des écritures sur stockage magnétique.  
Type : objet [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obligatoire : non

 ** [RetentionProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-RetentionProperties"></a>
Durée de conservation de la mémoire et de la mémoire magnétique.  
Type : objet [RetentionProperties](API_RetentionProperties.md)  
Obligatoire : non

 ** [Schema](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-Schema"></a>
 Schéma de la table.   
Type : objet [Schema](API_Schema.md)  
Obligatoire : non

 ** [TableName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-TableName"></a>
Nom de la table Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

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

```
{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}
```

## Eléments de réponse
<a name="API_UpdateTable_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.

 ** [Table](#API_UpdateTable_ResponseSyntax) **   <a name="timestream-UpdateTable-response-Table"></a>
La table Timestream mise à jour.  
Type : objet [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. Il se peut que la ressource ne soit pas spécifiée correctement ou que son statut ne soit pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_UpdateTable_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-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable) 

# WriteRecords
<a name="API_WriteRecords"></a>

Vous permet d'écrire les données de vos séries chronologiques dans Timestream. Vous pouvez spécifier un point de données unique ou un lot de points de données à insérer dans le système. Timestream vous propose un schéma flexible qui détecte automatiquement les noms de colonnes et les types de données de vos tables Timestream en fonction des noms de dimension et des types de données des points de données que vous spécifiez lorsque vous appelez des écritures dans la base de données. 

Timestream prend en charge la cohérence éventuelle de la sémantique de lecture. Cela signifie que lorsque vous interrogez des données immédiatement après avoir écrit un lot de données dans Timestream, les résultats de la requête peuvent ne pas refléter les résultats d'une opération d'écriture récemment terminée. Les résultats peuvent également inclure des données périmées. Si vous répétez la requête après un court laps de temps, les résultats devraient renvoyer les données les plus récentes. [Des quotas de service s'appliquent](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). 

Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html) pour plus de détails.

 **Upserts** 

Vous pouvez utiliser le `Version` paramètre dans une `WriteRecords` demande pour mettre à jour des points de données. Timestream enregistre un numéro de version pour chaque enregistrement. `Version`par défaut, c'est `1` quand il n'est pas spécifié pour l'enregistrement dans la demande. Timestream met à jour la valeur de mesure d'un enregistrement existant ainsi que sa valeur `Version` lorsqu'il reçoit une demande d'écriture avec un `Version` nombre plus élevé pour cet enregistrement. Lorsqu'il reçoit une demande de mise à jour dont la valeur de mesure est identique à celle de l'enregistrement existant, Timestream est toujours mis à jour`Version`, si elle est supérieure à la valeur existante de. `Version` Vous pouvez mettre à jour un point de données autant de fois que vous le souhaitez, à condition que la valeur de augmente `Version` continuellement. 

 Supposons, par exemple, que vous écriviez un nouvel enregistrement sans l'indiquer `Version` dans la demande. Timestream enregistre cet enregistrement et le définit sur`Version`. `1` Supposons maintenant que vous essayiez de mettre à jour cet enregistrement avec une `WriteRecords` demande du même enregistrement avec une valeur de mesure différente mais que, comme auparavant, vous ne la fournissez pas`Version`. Dans ce cas, Timestream rejettera cette mise à jour avec un `RejectedRecordsException` car la version de l'enregistrement mis à jour n'est pas supérieure à la valeur existante de Version. 

Toutefois, si vous renvoyez la demande de mise à jour avec `Version` défini sur`2`, Timestream réussirait alors à mettre à jour la valeur de l'enregistrement, qui `Version` serait définie sur. `2` Supposons ensuite que vous ayez envoyé une `WriteRecords` demande avec le même enregistrement et une valeur de mesure identique, mais avec la valeur `Version` définie sur`3`. Dans ce cas, Timestream sera uniquement mis à jour `Version` vers. `3` Toute mise à jour ultérieure devra envoyer un numéro de version supérieur à`3`, sinon les demandes de mise à jour recevront un`RejectedRecordsException`. 

## Syntaxe de la requête
<a name="API_WriteRecords_RequestSyntax"></a>

```
{
   "CommonAttributes": { 
      "Dimensions": [ 
         { 
            "DimensionValueType": "string",
            "Name": "string",
            "Value": "string"
         }
      ],
      "MeasureName": "string",
      "MeasureValue": "string",
      "MeasureValues": [ 
         { 
            "Name": "string",
            "Type": "string",
            "Value": "string"
         }
      ],
      "MeasureValueType": "string",
      "Time": "string",
      "TimeUnit": "string",
      "Version": number
   },
   "DatabaseName": "string",
   "Records": [ 
      { 
         "Dimensions": [ 
            { 
               "DimensionValueType": "string",
               "Name": "string",
               "Value": "string"
            }
         ],
         "MeasureName": "string",
         "MeasureValue": "string",
         "MeasureValues": [ 
            { 
               "Name": "string",
               "Type": "string",
               "Value": "string"
            }
         ],
         "MeasureValueType": "string",
         "Time": "string",
         "TimeUnit": "string",
         "Version": number
      }
   ],
   "TableName": "string"
}
```

## Paramètres de demande
<a name="API_WriteRecords_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.

 ** [CommonAttributes](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-CommonAttributes"></a>
Un enregistrement qui contient les attributs communs de mesure, de dimension, de temps et de version partagés entre tous les enregistrements de la demande. Les attributs de mesure et de dimension spécifiés seront fusionnés avec les attributs de mesure et de dimension dans l'objet records lorsque les données seront écrites dans Timestream. Les dimensions peuvent ne pas se chevaucher, sinon un `ValidationException` sera projeté. En d'autres termes, un enregistrement doit contenir des dimensions portant des noms uniques.   
Type : objet [Record](API_Record.md)  
Obligatoire : non

 ** [DatabaseName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-DatabaseName"></a>
Nom de la base de données Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

 ** [Records](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-Records"></a>
Tableau d'enregistrements contenant les attributs uniques de mesure, de dimension, de temps et de version pour chaque point de données de série chronologique.  
Type : tableau d’objets [Record](API_Record.md)  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 100 éléments.  
Obligatoire : oui

 ** [TableName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-TableName"></a>
Nom de la table Timestream.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

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

```
{
   "RecordsIngested": { 
      "MagneticStore": number,
      "MemoryStore": number,
      "Total": number
   }
}
```

## Eléments de réponse
<a name="API_WriteRecords_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.

 ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) **   <a name="timestream-WriteRecords-response-RecordsIngested"></a>
Informations sur les enregistrements ingérés par cette demande.  
Type : objet [RecordsIngested](API_RecordsIngested.md)

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

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

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

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

 ** RejectedRecordsException **   
 WriteRecords déclencherait cette exception dans les cas suivants :   
+ Enregistrements contenant des données dupliquées contenant plusieurs enregistrements ayant les mêmes dimensions, horodatages et noms de mesures, mais : 
  + Les valeurs de mesure sont différentes
  + La version n'est pas présente dans la demande *ou* la valeur de la version dans le nouvel enregistrement est égale ou inférieure à la valeur existante

   Dans ce cas, si Timestream rejette les données, le `ExistingVersion` champ de `RejectedRecords` réponse indiquera la version de l'enregistrement en cours. Pour forcer une mise à jour, vous pouvez renvoyer la demande avec une version de l'enregistrement définie sur une valeur supérieure à. `ExistingVersion`
+  Enregistrements dont l'horodatage se situe en dehors de la durée de conservation de la mémoire. 
+  Enregistrements dont les dimensions ou les mesures dépassent les limites définies par Timestream. 
 Pour plus d'informations, consultez la section [Quotas](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) dans le guide du développeur Amazon Timestream.     
 ** RejectedRecords **   
 
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

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

## Voir aussi
<a name="API_WriteRecords_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-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords) 

# Requête Amazon Timestream
<a name="API_Operations_Amazon_Timestream_Query"></a>

Les actions suivantes sont prises en charge par Amazon Timestream Query :
+  [CancelQuery](API_query_CancelQuery.md) 
+  [CreateScheduledQuery](API_query_CreateScheduledQuery.md) 
+  [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) 
+  [DescribeAccountSettings](API_query_DescribeAccountSettings.md) 
+  [DescribeEndpoints](API_query_DescribeEndpoints.md) 
+  [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) 
+  [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) 
+  [ListScheduledQueries](API_query_ListScheduledQueries.md) 
+  [ListTagsForResource](API_query_ListTagsForResource.md) 
+  [PrepareQuery](API_query_PrepareQuery.md) 
+  [Query](API_query_Query.md) 
+  [TagResource](API_query_TagResource.md) 
+  [UntagResource](API_query_UntagResource.md) 
+  [UpdateAccountSettings](API_query_UpdateAccountSettings.md) 
+  [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) 

# CancelQuery
<a name="API_query_CancelQuery"></a>

 Annule une requête qui a été émise. L'annulation n'est accordée que si l'exécution de la requête n'est pas terminée avant que la demande d'annulation ne soit émise. L'annulation étant une opération idempotente, les demandes d'annulation suivantes renverront un`CancellationMessage`, indiquant que la requête a déjà été annulée. Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html) pour plus de détails. 

## Syntaxe de la requête
<a name="API_query_CancelQuery_RequestSyntax"></a>

```
{
   "QueryId": "string"
}
```

## Paramètres de demande
<a name="API_query_CancelQuery_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.

 ** [QueryId](#API_query_CancelQuery_RequestSyntax) **   <a name="timestream-query_CancelQuery-request-QueryId"></a>
 L'ID de la requête qui doit être annulée. `QueryID`est renvoyé dans le cadre du résultat de la requête.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[a-zA-Z0-9]+`   
Obligatoire : oui

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

```
{
   "CancellationMessage": "string"
}
```

## Eléments de réponse
<a name="API_query_CancelQuery_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.

 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **   <a name="timestream-query_CancelQuery-response-CancellationMessage"></a>
 A `CancellationMessage` est renvoyé lorsqu'une `CancelQuery` demande pour la requête spécifiée par `QueryId` a déjà été émise.   
Type : Chaîne

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** 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_CancelQuery_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/CancelQuery) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery) 

# 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 [Types d'erreurs courants](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) 

# DeleteScheduledQuery
<a name="API_query_DeleteScheduledQuery"></a>

Supprime une requête planifiée donnée. Il s'agit d'une opération irréversible. 

## Syntaxe de la requête
<a name="API_query_DeleteScheduledQuery_RequestSyntax"></a>

```
{
   "ScheduledQueryArn": "string"
}
```

## Paramètres de demande
<a name="API_query_DeleteScheduledQuery_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.

 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **   <a name="timestream-query_DeleteScheduledQuery-request-ScheduledQueryArn"></a>
L'ARN de la requête planifiée.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

## Éléments de réponse
<a name="API_query_DeleteScheduledQuery_ResponseElements"></a>

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

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** ResourceNotFoundException **   
La ressource demandée est introuvable.    
 ** ScheduledQueryArn **   
L'ARN de la requête planifiée.
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_DeleteScheduledQuery_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/DeleteScheduledQuery) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery) 

# DescribeAccountSettings
<a name="API_query_DescribeAccountSettings"></a>

Décrit les paramètres de votre compte, notamment le modèle de tarification des requêtes et le maximum configuré que TCUs le service peut utiliser pour votre charge de travail de requêtes.

Vous êtes facturé uniquement pour la durée des unités de calcul utilisées pour vos charges de travail.

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

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "ActiveQueryTCU": number,
         "LastUpdate": { 
            "Status": "string",
            "StatusMessage": "string",
            "TargetQueryTCU": number
         },
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         }
      }
   },
   "QueryPricingModel": "string"
}
```

## Eléments de réponse
<a name="API_query_DescribeAccountSettings_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.

 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-MaxQueryTCU"></a>
Le nombre maximum d'[unités de calcul Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs) que le service utilisera à tout moment pour répondre à vos requêtes. Pour exécuter des requêtes, vous devez définir une capacité minimale de 4 TCU. Vous pouvez définir le nombre maximum de TCU en multiples de 4, par exemple 4, 8, 16, 32, etc. Cette configuration s'applique uniquement à l'utilisation à la demande de (TCUs).   
Type : Integer

 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryCompute"></a>
Objet contenant les paramètres d'utilisation des unités de calcul Timestream (TCUs) de votre compte pour la charge de travail des requêtes. QueryCompute est disponible uniquement dans la région Asie-Pacifique (Mumbai).  
Type : objet [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryPricingModel"></a>
Le modèle de tarification pour les requêtes relatives à votre compte.  
Le `QueryPricingModel` paramètre est utilisé par plusieurs opérations Timestream ; toutefois, l'opération `UpdateAccountSettings` d'API ne reconnaît aucune valeur autre que. `COMPUTE_UNITS`
Type : Chaîne  
Valeurs valides : `BYTES_SCANNED | COMPUTE_UNITS` 

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

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

## Voir aussi
<a name="API_query_DescribeAccountSettings_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/DescribeAccountSettings) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings) 

# DescribeEndpoints
<a name="API_query_DescribeEndpoints"></a>

DescribeEndpoints renvoie une liste des points de terminaison disponibles pour effectuer des appels d'API Timestream. Cette API est disponible à la fois via Write et Query.

Les Timestream étant SDKs conçus pour fonctionner de manière transparente avec l'architecture du service, y compris la gestion et le mappage des points de terminaison du service, *il n'est pas recommandé d'utiliser cette API sauf si* :
+ Vous utilisez des [points de terminaison VPC ()AWS PrivateLink](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) avec Timestream 
+ Votre application utilise un langage de programmation qui n'est pas encore compatible avec le SDK
+ Vous avez besoin d'un meilleur contrôle de la mise en œuvre côté client

Pour des informations détaillées sur comment et quand utiliser et implémenter DescribeEndpoints, consultez [The Endpoint Discovery Pattern](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery).

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

```
{
   "Endpoints": [ 
      { 
         "Address": "string",
         "CachePeriodInMinutes": number
      }
   ]
}
```

## Eléments de réponse
<a name="API_query_DescribeEndpoints_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.

 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-query_DescribeEndpoints-response-Endpoints"></a>
Un `Endpoints` objet est renvoyé lorsqu'une `DescribeEndpoints` demande est faite.  
Type : tableau d’objets [Endpoint](API_query_Endpoint.md)

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

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

 ** InternalServerException **   
Une erreur interne du serveur s'est produite lors du traitement de la demande.  
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_DescribeEndpoints_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/DescribeEndpoints) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints) 

# DescribeScheduledQuery
<a name="API_query_DescribeScheduledQuery"></a>

Fournit des informations détaillées sur une requête planifiée.

## Syntaxe de la requête
<a name="API_query_DescribeScheduledQuery_RequestSyntax"></a>

```
{
   "ScheduledQueryArn": "string"
}
```

## Paramètres de demande
<a name="API_query_DescribeScheduledQuery_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.

 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **   <a name="timestream-query_DescribeScheduledQuery-request-ScheduledQueryArn"></a>
L'ARN de la requête planifiée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

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

```
{
   "ScheduledQuery": { 
      "Arn": "string",
      "CreationTime": number,
      "ErrorReportConfiguration": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "ObjectKeyPrefix": "string"
         }
      },
      "KmsKeyId": "string",
      "LastRunSummary": { 
         "ErrorReportLocation": { 
            "S3ReportLocation": { 
               "BucketName": "string",
               "ObjectKey": "string"
            }
         },
         "ExecutionStats": { 
            "BytesMetered": number,
            "CumulativeBytesScanned": number,
            "DataWrites": number,
            "ExecutionTimeInMillis": number,
            "QueryResultRows": number,
            "RecordsIngested": number
         },
         "FailureReason": "string",
         "InvocationTime": number,
         "QueryInsightsResponse": { 
            "OutputBytes": number,
            "OutputRows": number,
            "QuerySpatialCoverage": { 
               "Max": { 
                  "PartitionKey": [ "string" ],
                  "TableArn": "string",
                  "Value": number
               }
            },
            "QueryTableCount": number,
            "QueryTemporalRange": { 
               "Max": { 
                  "TableArn": "string",
                  "Value": number
               }
            }
         },
         "RunStatus": "string",
         "TriggerTime": number
      },
      "Name": "string",
      "NextInvocationTime": number,
      "NotificationConfiguration": { 
         "SnsConfiguration": { 
            "TopicArn": "string"
         }
      },
      "PreviousInvocationTime": number,
      "QueryString": "string",
      "RecentlyFailedRuns": [ 
         { 
            "ErrorReportLocation": { 
               "S3ReportLocation": { 
                  "BucketName": "string",
                  "ObjectKey": "string"
               }
            },
            "ExecutionStats": { 
               "BytesMetered": number,
               "CumulativeBytesScanned": number,
               "DataWrites": number,
               "ExecutionTimeInMillis": number,
               "QueryResultRows": number,
               "RecordsIngested": number
            },
            "FailureReason": "string",
            "InvocationTime": number,
            "QueryInsightsResponse": { 
               "OutputBytes": number,
               "OutputRows": number,
               "QuerySpatialCoverage": { 
                  "Max": { 
                     "PartitionKey": [ "string" ],
                     "TableArn": "string",
                     "Value": number
                  }
               },
               "QueryTableCount": number,
               "QueryTemporalRange": { 
                  "Max": { 
                     "TableArn": "string",
                     "Value": number
                  }
               }
            },
            "RunStatus": "string",
            "TriggerTime": number
         }
      ],
      "ScheduleConfiguration": { 
         "ScheduleExpression": "string"
      },
      "ScheduledQueryExecutionRoleArn": "string",
      "State": "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"
         }
      }
   }
}
```

## Eléments de réponse
<a name="API_query_DescribeScheduledQuery_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.

 ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) **   <a name="timestream-query_DescribeScheduledQuery-response-ScheduledQuery"></a>
La requête planifiée.  
Type : objet [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md)

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** ResourceNotFoundException **   
La ressource demandée est introuvable.    
 ** ScheduledQueryArn **   
L'ARN de la requête planifiée.
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_DescribeScheduledQuery_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/DescribeScheduledQuery) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery) 

# ExecuteScheduledQuery
<a name="API_query_ExecuteScheduledQuery"></a>

 Vous pouvez utiliser cette API pour exécuter une requête planifiée manuellement. 

Si vous l'avez activée`QueryInsights`, cette API renvoie également des informations et des statistiques relatives à la requête que vous avez exécutée dans le cadre d'une notification Amazon SNS. `QueryInsights`aide à optimiser les performances de votre requête. Pour en savoir plus`QueryInsights`, consultez la section [Utilisation des informations relatives aux requêtes pour optimiser les requêtes dans Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

## Syntaxe de la requête
<a name="API_query_ExecuteScheduledQuery_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "InvocationTime": number,
   "QueryInsights": { 
      "Mode": "string"
   },
   "ScheduledQueryArn": "string"
}
```

## Paramètres de demande
<a name="API_query_ExecuteScheduledQuery_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_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ClientToken"></a>
Non utilisé.   
Type : Chaîne  
Contraintes de longueur : longueur minimale de 32. Longueur maximale de 128.  
Obligatoire : non

 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-InvocationTime"></a>
Horodatage en UTC. La requête sera exécutée comme si elle avait été invoquée à cet horodatage.   
Type : Timestamp  
Obligatoire : oui

 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-QueryInsights"></a>
Encapsule les paramètres à activer`QueryInsights`.  
Activation des informations et des statistiques sur les `QueryInsights` retours dans le cadre de la notification Amazon SNS pour la requête que vous avez exécutée. Vous pouvez l'utiliser `QueryInsights` pour ajuster les performances et le coût de vos requêtes.  
Type : objet [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)  
Obligatoire : non

 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ScheduledQueryArn"></a>
ARN de la requête planifiée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

## Éléments de réponse
<a name="API_query_ExecuteScheduledQuery_ResponseElements"></a>

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

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** ResourceNotFoundException **   
La ressource demandée est introuvable.    
 ** ScheduledQueryArn **   
L'ARN de la requête planifiée.
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

## Exemples
<a name="API_query_ExecuteScheduledQuery_Examples"></a>

### Message de notification de requête planifiée pour le mode ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_1"></a>

L'exemple suivant montre un message de notification de requête planifiée réussie pour le `ENABLED_WITH_RATE_CONTROL` mode du `QueryInsights` paramètre.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1723710546,
        "triggerTimeMillis": 1723710547490,
        "runStatus": "MANUAL_TRIGGER_SUCCESS",
        "executionStats": {
            "executionTimeInMillis": 17343,
            "dataWrites": 1024,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 600,
            "recordsIngested": 1,
            "queryResultRows": 1
        },
        "queryInsightsResponse": {
            "querySpatialCoverage": {
                "max": {
                    "value": 1.0,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable",
                    "partitionKey": [
                        "measure_name"
                    ]
                }
            },
            "queryTemporalRange": {
                "max": {
                    "value": 2399999999999,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable"
                }
            },
            "queryTableCount": 1,
            "outputRows": 1,
            "outputBytes": 59
        }
    }
}
```

### Message de notification de requête planifiée pour le mode DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_2"></a>

L'exemple suivant montre un message de notification de requête planifiée réussie pour le `DISABLED` mode du `QueryInsights` paramètre.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1723711401,
        "triggerTimeMillis": 1723711402144,
        "runStatus": "MANUAL_TRIGGER_SUCCESS",
        "executionStats": {
            "executionTimeInMillis": 17992,
            "dataWrites": 1024,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 600,
            "recordsIngested": 1,
            "queryResultRows": 1
        }
    }
}
```

### Message de notification d'échec pour le mode ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_3"></a>

L'exemple suivant montre un message de notification de requête planifiée ayant échoué pour le `ENABLED_WITH_RATE_CONTROL` mode du `QueryInsights` paramètre.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1727915513,
        "triggerTimeMillis": 1727915513894,
        "runStatus": "MANUAL_TRIGGER_FAILURE",
        "executionStats": {
            "executionTimeInMillis": 10777,
            "dataWrites": 0,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 0,
            "recordsIngested": 0,
            "queryResultRows": 4
        },
        "errorReportLocation": {
            "s3ReportLocation": {
                "bucketName": "amzn-s3-demo-bucket",
                "objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae"
            }
        },
        "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
    }
}
```

### Message de notification d'échec pour le mode DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_4"></a>

L'exemple suivant montre un message de notification de requête planifiée ayant échoué pour le `DISABLED` mode du `QueryInsights` paramètre.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1727915194,
        "triggerTimeMillis": 1727915195119,
        "runStatus": "MANUAL_TRIGGER_FAILURE",
        "executionStats": {
            "executionTimeInMillis": 10777,
            "dataWrites": 0,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 0,
            "recordsIngested": 0,
            "queryResultRows": 4
        },
        "errorReportLocation": {
            "s3ReportLocation": {
                "bucketName": "amzn-s3-demo-bucket",
                "objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98"
            }
        },
        "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
    }
}
```

## Voir aussi
<a name="API_query_ExecuteScheduledQuery_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/ExecuteScheduledQuery) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 

# ListScheduledQueries
<a name="API_query_ListScheduledQueries"></a>

Obtient une liste de toutes les requêtes planifiées dans le compte Amazon et la région de l'appelant. `ListScheduledQueries`est finalement cohérent. 

## Syntaxe de la requête
<a name="API_query_ListScheduledQueries_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Paramètres de demande
<a name="API_query_ListScheduledQueries_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.

 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-MaxResults"></a>
Le nombre maximum d'éléments à renvoyer dans la sortie. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, un `NextToken` est fourni dans la sortie. Pour reprendre la pagination, fournissez la `NextToken` valeur comme argument de l'appel suivant à`ListScheduledQueriesRequest`.  
Type : entier  
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.  
Obligatoire : non

 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-NextToken"></a>
 Un jeton de pagination pour reprendre la pagination.  
Type : chaîne  
Obligatoire : non

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

```
{
   "NextToken": "string",
   "ScheduledQueries": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "ErrorReportConfiguration": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "ObjectKeyPrefix": "string"
            }
         },
         "LastRunStatus": "string",
         "Name": "string",
         "NextInvocationTime": number,
         "PreviousInvocationTime": number,
         "State": "string",
         "TargetDestination": { 
            "TimestreamDestination": { 
               "DatabaseName": "string",
               "TableName": "string"
            }
         }
      }
   ]
}
```

## Eléments de réponse
<a name="API_query_ListScheduledQueries_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.

 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-NextToken"></a>
Jeton permettant de spécifier où commencer la pagination. Il s'agit du NextToken résultat d'une réponse tronquée précédemment.  
Type : Chaîne

 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-ScheduledQueries"></a>
Liste de requêtes planifiées.  
Type : tableau d’objets [ScheduledQuery](API_query_ScheduledQuery.md)

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** 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_ListScheduledQueries_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/ListScheduledQueries) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries) 

# ListTagsForResource
<a name="API_query_ListTagsForResource"></a>

Répertoriez tous les tags d'une ressource de requête Timestream.

## Syntaxe de la requête
<a name="API_query_ListTagsForResource_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string",
   "ResourceARN": "string"
}
```

## Paramètres de demande
<a name="API_query_ListTagsForResource_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.

 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-MaxResults"></a>
Le nombre maximum de balises à renvoyer.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 200.  
Obligatoire : non

 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-NextToken"></a>
Un jeton de pagination pour reprendre la pagination.  
Type : chaîne  
Obligatoire : non

 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-ResourceARN"></a>
La ressource Timestream avec les balises à répertorier. Cette valeur est un Amazon Resource Name (ARN).  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

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

```
{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_query_ListTagsForResource_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.

 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-NextToken"></a>
Un jeton de pagination permettant de reprendre la pagination avec un appel ultérieur à. `ListTagsForResourceResponse`  
Type : Chaîne

 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-Tags"></a>
Les balises actuellement associées à la ressource Timestream.   
Type : tableau d’objets [Tag](API_query_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

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

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

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

 ** ResourceNotFoundException **   
La ressource demandée est introuvable.    
 ** ScheduledQueryArn **   
L'ARN de la requête planifiée.
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_ListTagsForResource_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/ListTagsForResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource) 

# PrepareQuery
<a name="API_query_PrepareQuery"></a>

Opération synchrone qui vous permet de soumettre une requête avec des paramètres à stocker par Timestream pour une exécution ultérieure. Timestream ne prend en charge l'utilisation de cette opération que si elle est `ValidateOnly` définie sur. `true` 

## Syntaxe de la requête
<a name="API_query_PrepareQuery_RequestSyntax"></a>

```
{
   "QueryString": "string",
   "ValidateOnly": boolean
}
```

## Paramètres de demande
<a name="API_query_PrepareQuery_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.

 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-QueryString"></a>
Chaîne de requête Timestream que vous souhaitez utiliser comme instruction préparée. 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.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.  
Obligatoire : oui

 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-ValidateOnly"></a>
En définissant cette valeur sur`true`, Timestream validera uniquement que la chaîne de requête est une requête Timestream valide, et ne stockera pas la requête préparée pour une utilisation ultérieure.  
Type : booléen  
Obligatoire : non

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

```
{
   "Columns": [ 
      { 
         "Aliased": boolean,
         "DatabaseName": "string",
         "Name": "string",
         "TableName": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "Parameters": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "QueryString": "string"
}
```

## Eléments de réponse
<a name="API_query_PrepareQuery_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.

 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Columns"></a>
Liste des colonnes de clause SELECT de la chaîne de requête soumise.   
Type : tableau d’objets [SelectColumn](API_query_SelectColumn.md)

 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Parameters"></a>
Liste des paramètres utilisés dans la chaîne de requête soumise.   
Type : tableau d’objets [ParameterMapping](API_query_ParameterMapping.md)

 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-QueryString"></a>
Chaîne de requête que vous souhaitez préparer.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** 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_PrepareQuery_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/PrepareQuery) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery) 

# Query
<a name="API_query_Query"></a>

 `Query`est une opération synchrone qui vous permet d'exécuter une requête sur vos données Amazon Timestream.

Si vous l'avez activée`QueryInsights`, cette API renvoie également des informations et des statistiques relatives à la requête que vous avez exécutée. `QueryInsights`aide à optimiser les performances de votre requête. Pour en savoir plus`QueryInsights`, consultez la section [Utilisation des informations relatives aux requêtes pour optimiser les requêtes dans Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

**Note**  
Le nombre maximum de demandes d'`Query`API que vous êtes autorisé à effectuer lorsque `QueryInsights` cette option est activée est d'une requête par seconde (QPS). Si vous dépassez ce taux de requêtes, cela peut entraîner un ralentissement.

 `Query`expirera au bout de 60 secondes. Vous devez mettre à jour le délai d'expiration par défaut dans le SDK pour qu'il prenne en charge un délai d'attente de 60 secondes. Consultez l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html) pour plus de détails. 

Votre demande de requête échouera dans les cas suivants :
+  Si vous soumettez une `Query` demande avec le même jeton client en dehors de la fenêtre d'idempuissance de 5 minutes. 
+  Si vous soumettez une `Query` demande avec le même jeton client, mais que vous modifiez d'autres paramètres, dans le délai d'idempotentie de 5 minutes. 
+  Si la taille de la ligne (y compris les métadonnées de la requête) dépasse 1 Mo, la requête échouera avec le message d'erreur suivant : 

   `Query aborted as max page response size has been exceeded by the output result row` 
+  Si le principal IAM de l'initiateur de requête et le lecteur de résultats ne sont pas identiques and/or , l'initiateur de requête et le lecteur de résultats n'ont pas la même chaîne de requête dans les demandes de requête, la requête échouera avec une erreur. `Invalid pagination token` 

## Syntaxe de la requête
<a name="API_query_Query_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "MaxRows": number,
   "NextToken": "string",
   "QueryInsights": { 
      "Mode": "string"
   },
   "QueryString": "string"
}
```

## Paramètres de demande
<a name="API_query_Query_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_Query_RequestSyntax) **   <a name="timestream-query_Query-request-ClientToken"></a>
 Chaîne unique, distinguant majuscules et minuscules, de 64 caractères ASCII maximum spécifiée lors d'une `Query` demande. Fournir un `ClientToken` fait passer l'appel à `Query` *idempotent*. Cela signifie que l'exécution répétée de la même requête produira le même résultat. En d'autres termes, le fait de faire plusieurs `Query` demandes identiques a le même effet qu'une seule demande. Lorsque vous l'utilisez `ClientToken` dans une requête, notez les points suivants :   
+  Si l'API Query est instanciée sans un`ClientToken`, le Query SDK en génère un en votre `ClientToken` nom.
+ Si l'`Query`invocation ne contient que le `ClientToken` mais n'inclut pas un`NextToken`, cet appel de `Query` est supposé être une nouvelle requête exécutée.
+ Si l'invocation contient`NextToken`, cette invocation particulière est supposée être une invocation ultérieure d'un appel antérieur à l'API Query, et un ensemble de résultats est renvoyé.
+  Au bout de 4 heures, toute demande contenant la même chose `ClientToken` est traitée comme une nouvelle demande. 
Type : Chaîne  
Contraintes de longueur : longueur minimale de 32. Longueur maximale de 128.  
Obligatoire : non

 ** [MaxRows](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-MaxRows"></a>
 Le nombre total de lignes à renvoyer dans la `Query` sortie. L'exécution initiale de `Query` avec une `MaxRows` valeur spécifiée renverra le jeu de résultats de la requête dans deux cas :   
+ La taille du résultat est inférieure à`1MB`.
+ Le nombre de lignes du jeu de résultats est inférieur à la valeur de`maxRows`.
Sinon, l'appel initial de renvoie `Query` uniquement a`NextToken`, qui peut ensuite être utilisé lors des appels suivants pour récupérer le jeu de résultats. Pour reprendre la pagination, entrez la `NextToken` valeur dans la commande suivante.  
Si la taille de la ligne est grande (par exemple, une ligne comporte de nombreuses colonnes), Timestream peut renvoyer moins de lignes afin d'empêcher la taille de réponse de dépasser la limite de 1 Mo. Si `MaxRows` ce n'est pas le cas, Timestream enverra le nombre de lignes nécessaire pour respecter la limite de 1 Mo.  
Type : entier  
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.  
Obligatoire : non

 ** [NextToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-NextToken"></a>
 Un jeton de pagination utilisé pour renvoyer un ensemble de résultats. Lorsque l'`Query`API est invoquée en utilisant`NextToken`, cette invocation particulière est supposée être une invocation ultérieure d'un appel précédent à`Query`, et un ensemble de résultats est renvoyé. Toutefois, si l'`Query`invocation ne contient que le`ClientToken`, cet appel de `Query` est supposé être une nouvelle requête exécutée.   
Notez les points suivants lors de l'utilisation NextToken dans une requête :  
+ Un jeton de pagination peut être utilisé pour un maximum de cinq `Query` invocations, OU pour une durée maximale d'une heure, selon la première éventualité.
+ L'utilisation de la même option `NextToken` renverra le même ensemble d'enregistrements. Pour continuer à paginer dans le jeu de résultats, vous devez utiliser le plus récent. `nextToken`
+ Supposons qu'`Query`un appel renvoie deux `NextToken` valeurs, `TokenA` et`TokenB`. S'il `TokenB` est utilisé lors d'un appel ultérieur, `Query` il `TokenA` est alors invalidé et ne peut pas être réutilisé.
+ Pour demander un ensemble de résultats antérieur à partir d'une requête après le début de la pagination, vous devez réinvoquer l'API Query.
+ La dernière `NextToken` doit être utilisée pour paginer jusqu'à ce qu'elle `null` soit renvoyée, après quoi une nouvelle `NextToken` doit être utilisée.
+  Si le principal IAM de l'initiateur de requête et le lecteur de résultats ne sont pas identiques and/or , l'initiateur de requête et le lecteur de résultats n'ont pas la même chaîne de requête dans les demandes de requête, la requête échouera avec une erreur. `Invalid pagination token` 
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : non

 ** [QueryInsights](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryInsights"></a>
Encapsule les paramètres à activer`QueryInsights`.  
L'activation `QueryInsights` renvoie des informations et des métriques en plus des résultats de requête pour la requête que vous avez exécutée. Vous pouvez l'utiliser `QueryInsights` pour optimiser les performances de vos requêtes.  
Type : objet [QueryInsights](API_query_QueryInsights.md)  
Obligatoire : non

 ** [QueryString](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryString"></a>
 Requête à exécuter par Timestream.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.  
Obligatoire : oui

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

```
{
   "ColumnInfo": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": "ColumnInfo",
            "RowColumnInfo": [ 
               "ColumnInfo"
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": "ColumnInfo"
         }
      }
   ],
   "NextToken": "string",
   "QueryId": "string",
   "QueryInsightsResponse": { 
      "OutputBytes": number,
      "OutputRows": number,
      "QuerySpatialCoverage": { 
         "Max": { 
            "PartitionKey": [ "string" ],
            "TableArn": "string",
            "Value": number
         }
      },
      "QueryTableCount": number,
      "QueryTemporalRange": { 
         "Max": { 
            "TableArn": "string",
            "Value": number
         }
      },
      "UnloadPartitionCount": number,
      "UnloadWrittenBytes": number,
      "UnloadWrittenRows": number
   },
   "QueryStatus": { 
      "CumulativeBytesMetered": number,
      "CumulativeBytesScanned": number,
      "ProgressPercentage": number
   },
   "Rows": [ 
      { 
         "Data": [ 
            { 
               "ArrayValue": [ 
                  "Datum"
               ],
               "NullValue": boolean,
               "RowValue": "Row",
               "ScalarValue": "string",
               "TimeSeriesValue": [ 
                  { 
                     "Time": "string",
                     "Value": "Datum"
                  }
               ]
            }
         ]
      }
   ]
}
```

## Eléments de réponse
<a name="API_query_Query_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.

 ** [ColumnInfo](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-ColumnInfo"></a>
 Les types de données de colonne du jeu de résultats renvoyé.   
Type : tableau d’objets [ColumnInfo](API_query_ColumnInfo.md)

 ** [NextToken](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-NextToken"></a>
 Un jeton de pagination qui peut être réutilisé lors d'un `Query` appel pour obtenir la prochaine série de résultats.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.

 ** [QueryId](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryId"></a>
 Un identifiant unique pour la requête donnée.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[a-zA-Z0-9]+` 

 ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryInsightsResponse"></a>
Encapsule `QueryInsights` contenant des informations et des mesures relatives à la requête que vous avez exécutée.  
Type : objet [QueryInsightsResponse](API_query_QueryInsightsResponse.md)

 ** [QueryStatus](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryStatus"></a>
Informations sur l'état de la requête, y compris la progression et les octets analysés.  
Type : objet [QueryStatus](API_query_QueryStatus.md)

 ** [Rows](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-Rows"></a>
 Les lignes du jeu de résultats renvoyées par la requête.   
Type : tableau d’objets [Row](API_query_Row.md)

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](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

 ** QueryExecutionException **   
 Timestream n'a pas pu exécuter correctement la requête.   
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_Query_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/Query) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query) 

# TagResource
<a name="API_query_TagResource"></a>

Associez un ensemble de balises à une ressource Timestream. Vous pouvez ensuite activer ces balises définies par l'utilisateur afin qu'elles apparaissent sur la console Billing and Cost Management pour le suivi de la répartition des coûts. 

## Syntaxe de la requête
<a name="API_query_TagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Paramètres de demande
<a name="API_query_TagResource_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.

 ** [ResourceARN](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-ResourceARN"></a>
Identifie la ressource Timestream à laquelle les balises doivent être ajoutées. Cette valeur est un Amazon Resource Name (ARN).  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

 ** [Tags](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-Tags"></a>
Les balises à attribuer à la ressource Timestream.  
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 : oui

## Éléments de réponse
<a name="API_query_TagResource_ResponseElements"></a>

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

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

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

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

 ** ResourceNotFoundException **   
La ressource demandée est introuvable.    
 ** ScheduledQueryArn **   
L'ARN de la requête planifiée.
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_TagResource_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/TagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource) 

# UntagResource
<a name="API_query_UntagResource"></a>

Supprime l'association de balises d'une ressource de requête Timestream.

## Syntaxe de la requête
<a name="API_query_UntagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## Paramètres de demande
<a name="API_query_UntagResource_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.

 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-ResourceARN"></a>
La ressource Timestream dont les balises seront supprimées. Cette valeur est un Amazon Resource Name (ARN).   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

 ** [TagKeys](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-TagKeys"></a>
Liste des clés de tags. Les balises existantes de la ressource dont les clés sont membres de cette liste seront supprimées de la ressource Timestream.   
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Obligatoire : oui

## Éléments de réponse
<a name="API_query_UntagResource_ResponseElements"></a>

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

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

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

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

 ** ResourceNotFoundException **   
La ressource demandée est introuvable.    
 ** ScheduledQueryArn **   
L'ARN de la requête planifiée.
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_UntagResource_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/UntagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource) 

# UpdateAccountSettings
<a name="API_query_UpdateAccountSettings"></a>

Transfère votre compte pour l'utiliser TCUs pour la tarification des requêtes et modifie le nombre maximal d'unités de calcul des requêtes que vous avez configurées. Si vous réduisez la valeur de `MaxQueryTCU` à la configuration souhaitée, la nouvelle valeur peut prendre jusqu'à 24 heures pour être effective.

**Note**  
Une fois que vous avez transféré votre compte à des TCUs fins de tarification des requêtes, vous ne pouvez plus passer à l'utilisation d'octets scannés pour la tarification des requêtes.

## Syntaxe de la requête
<a name="API_query_UpdateAccountSettings_RequestSyntax"></a>

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         },
         "TargetQueryTCU": number
      }
   },
   "QueryPricingModel": "string"
}
```

## Paramètres de demande
<a name="API_query_UpdateAccountSettings_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.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-MaxQueryTCU"></a>
Le nombre maximum d'unités de calcul que le service utilisera à tout moment pour répondre à vos requêtes. Pour exécuter des requêtes, vous devez définir une capacité minimale de 4 TCU. Vous pouvez définir le nombre maximum de TCU en multiples de 4, par exemple 4, 8, 16, 32, etc. La valeur maximale prise en charge `MaxQueryTCU` est de 1000. Pour demander une augmentation de cette limite souple, contactez le AWS Support. Pour plus d'informations sur le quota par défaut pour MaxQueryTCU, consultez la section Quotas par défaut. Cette configuration s'applique uniquement à l'utilisation à la demande des unités de calcul Timestream ()TCUs.  
La valeur maximale prise en charge `MaxQueryTCU` est de 1000. Pour demander une augmentation de cette limite souple, contactez le AWS Support. Pour plus d'informations sur le quota par défaut pour`maxQueryTCU`, consultez la section [Quotas par défaut](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default).  
Type : Integer  
Obligatoire : non

 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryCompute"></a>
Modifie les paramètres de calcul des requêtes configurés dans votre compte, y compris le modèle de tarification des requêtes et les unités de calcul Timestream (TCUs) fournies dans votre compte. QueryCompute est disponible uniquement dans la région Asie-Pacifique (Mumbai).  
Cette API est idempotente, ce qui signifie que le fait de faire la même demande plusieurs fois aura le même effet que de faire la demande une seule fois.
Type : objet [QueryComputeRequest](API_query_QueryComputeRequest.md)  
Obligatoire : non

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryPricingModel"></a>
Modèle de tarification pour les requêtes relatives à un compte.  
Le `QueryPricingModel` paramètre est utilisé par plusieurs opérations Timestream ; toutefois, l'opération `UpdateAccountSettings` API ne reconnaît aucune valeur autre que. `COMPUTE_UNITS`
Type : Chaîne  
Valeurs valides : `BYTES_SCANNED | COMPUTE_UNITS`   
Obligatoire : non

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

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "ActiveQueryTCU": number,
         "LastUpdate": { 
            "Status": "string",
            "StatusMessage": "string",
            "TargetQueryTCU": number
         },
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         }
      }
   },
   "QueryPricingModel": "string"
}
```

## Eléments de réponse
<a name="API_query_UpdateAccountSettings_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.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-MaxQueryTCU"></a>
Le nombre maximal configuré d'unités de calcul que le service utilisera à tout moment pour répondre à vos requêtes.  
Type : Integer

 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryCompute"></a>
Confirme les paramètres de compte mis à jour pour interroger les données de votre compte. QueryCompute est disponible uniquement dans la région Asie-Pacifique (Mumbai).  
Type : objet [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryPricingModel"></a>
Le modèle de tarification d'un compte.  
Type : Chaîne  
Valeurs valides : `BYTES_SCANNED | COMPUTE_UNITS` 

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** 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_UpdateAccountSettings_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/UpdateAccountSettings) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings) 

# UpdateScheduledQuery
<a name="API_query_UpdateScheduledQuery"></a>

Mettez à jour une requête planifiée.

## Syntaxe de la requête
<a name="API_query_UpdateScheduledQuery_RequestSyntax"></a>

```
{
   "ScheduledQueryArn": "string",
   "State": "string"
}
```

## Paramètres de demande
<a name="API_query_UpdateScheduledQuery_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.

 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-ScheduledQueryArn"></a>
ARN de la requête planifiée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-State"></a>
État de la requête planifiée.   
Type : Chaîne  
Valeurs valides : `ENABLED | DISABLED`   
Obligatoire : oui

## Éléments de réponse
<a name="API_query_UpdateScheduledQuery_ResponseElements"></a>

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

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

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

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.  
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

 ** ResourceNotFoundException **   
La ressource demandée est introuvable.    
 ** ScheduledQueryArn **   
L'ARN de la requête planifiée.
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_UpdateScheduledQuery_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/UpdateScheduledQuery) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery)