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.
# Amazon Timestream Write
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
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
```
{
"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
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) **
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
Obligatoire : non
** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
Type : objet [DataModelConfiguration](API_DataModelConfiguration.md)
Obligatoire : non
** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
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) **
Type : Long
Obligatoire : non
** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
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) **
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) **
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
```
{
"TaskId": "string"
}
```
## Eléments de réponse
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) **
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
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"DatabaseName": "string",
"KmsKeyId": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Paramètres de demande
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) **
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) **
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) **
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
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Eléments de réponse
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) **
La nouvelle base de données Timestream.
Type : objet [Database](API_Database.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"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
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) **
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) **
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) **
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) **
Schéma de la table.
Type : objet [Schema](API_Schema.md)
Obligatoire : non
** [TableName](#API_CreateTable_RequestSyntax) **
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) **
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
```
{
"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
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) **
La table Timestream nouvellement créée.
Type : objet [Table](API_Table.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"DatabaseName": "string"
}
```
## Paramètres de demande
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) **
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
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"DatabaseName": "string",
"TableName": "string"
}
```
## Paramètres de demande
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) **
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) **
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
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"TaskId": "string"
}
```
## Paramètres de demande
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) **
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
```
{
"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
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) **
Description de la tâche de chargement par lots.
Type : objet [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"DatabaseName": "string"
}
```
## Paramètres de demande
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) **
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
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Eléments de réponse
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) **
Nom de la table Timestream.
Type : objet [Database](API_Database.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"Endpoints": [
{
"Address": "string",
"CachePeriodInMinutes": number
}
]
}
```
## Eléments de réponse
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) **
Un `Endpoints` objet est renvoyé lorsqu'une `DescribeEndpoints` demande est faite.
Type : tableau d’objets [Endpoint](API_Endpoint.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"DatabaseName": "string",
"TableName": "string"
}
```
## Paramètres de demande
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) **
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) **
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
```
{
"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
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) **
Le tableau Timestream.
Type : objet [Table](API_Table.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"MaxResults": number,
"NextToken": "string",
"TaskStatus": "string"
}
```
## Paramètres de demande
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) **
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) **
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) **
É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
```
{
"BatchLoadTasks": [
{
"CreationTime": number,
"DatabaseName": "string",
"LastUpdatedTime": number,
"ResumableUntil": number,
"TableName": "string",
"TaskId": "string",
"TaskStatus": "string"
}
],
"NextToken": "string"
}
```
## Eléments de réponse
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) **
Liste des détails des tâches de chargement par lots.
Type : tableau d’objets [BatchLoadTask](API_BatchLoadTask.md)
** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) **
Jeton permettant de spécifier où commencer la pagination. Fournissez le suivant ListBatchLoadTasksRequest.
Type : Chaîne
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Paramètres de demande
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) **
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) **
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
```
{
"Databases": [
{
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
],
"NextToken": "string"
}
```
## Eléments de réponse
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) **
Liste des noms de bases de données.
Type : tableau d’objets [Database](API_Database.md)
** [NextToken](#API_ListDatabases_ResponseSyntax) **
Le jeton de pagination. Ce paramètre est renvoyé lorsque la réponse est tronquée.
Type : Chaîne
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"DatabaseName": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## Paramètres de demande
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) **
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) **
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) **
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
```
{
"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
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) **
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) **
Une liste de tables.
Type : tableau d’objets [Table](API_Table.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
Répertorie tous les tags d'une ressource Timestream.
## Syntaxe de la requête
```
{
"ResourceARN": "string"
}
```
## Paramètres de demande
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) **
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
```
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Eléments de réponse
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) **
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
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
## Syntaxe de la requête
```
{
"TaskId": "string"
}
```
## Paramètres de demande
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) **
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
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Paramètres de demande
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) **
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) **
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
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
Supprime l'association de balises d'une ressource Timestream.
## Syntaxe de la requête
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## Paramètres de demande
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) **
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) **
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
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"DatabaseName": "string",
"KmsKeyId": "string"
}
```
## Paramètres de demande
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) **
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) **
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
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Eléments de réponse
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) **
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
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"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
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) **
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) **
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) **
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) **
Schéma de la table.
Type : objet [Schema](API_Schema.md)
Obligatoire : non
** [TableName](#API_UpdateTable_RequestSyntax) **
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
```
{
"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
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) **
La table Timestream mise à jour.
Type : objet [Table](API_Table.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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
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
```
{
"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
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) **
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) **
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) **
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) **
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
```
{
"RecordsIngested": {
"MagneticStore": number,
"MemoryStore": number,
"Total": number
}
}
```
## Eléments de réponse
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) **
Informations sur les enregistrements ingérés par cette demande.
Type : objet [RecordsIngested](API_RecordsIngested.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
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)