

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.

# 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 [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
<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) 