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
**Important**
***Cette section fait référence à l'API version 2011-12-05 qui est obsolète et ne doit pas être utilisée pour de nouvelles applications.***
**Pour une documentation sur l'API de bas niveau actuelle, consultez la [Référence d'API Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**
## Description
L'opération `CreateTable` ajoute une table à votre compte
Le nom de la table doit être unique parmi ceux associés au compte AWS émettant la demande, et à la région AWS recevant la demande (par exemple dynamodb.us-west-2.amazonaws.com). Chaque point de terminaison DynamoDB est entièrement indépendant. Par exemple, si vous avez deux tables nommées « MyTable », l'une dans la région dynamodb.us-west-2.amazonaws.com et l'autre dans la région dynamodb.us-west-1.amazonaws.com, ces tables sont complètement indépendantes et ne partagent aucune donnée.
L'opération `CreateTable` déclenche un flux asynchrone pour commencer à créer la table. DynamoDB renvoie immédiatement l'état de la table (`CREATING`) jusqu'à ce que la table soit dans l'état `ACTIVE`. Une fois la table dans l'état `ACTIVE`, vous pouvez effectuer des opérations de plan de données.
Utilisez l'opération [DescribeTables](API_DescribeTables_v20111205.md) pour vérifier l'état de la table.
## Requêtes
### Syntaxe
```
// This header is abbreviated.
// For a sample of a complete header, see API de bas niveau de DynamoDB.
POST / HTTP/1.1
x-amz-target: DynamoDB_20111205.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
****
| Name (Nom) | Description | Obligatoire |
| --- | --- | --- |
| TableName | Nom de la table à créer.Les caractères autorisés sont a-z, A-Z, 0-9, « \$1 » (trait de soulignement), « - » (tiret) et « . » (point). Les noms peuvent comporter entre 3 et 255 caractères. Type : String | Oui |
| KeySchema | Structure (simple ou composite) de la clé primaire pour la table. Une paire nom-valeur pour l'élément `HashKeyElement` est obligatoire, et une paire nom-valeur pour l'élément `RangeKeyElement` est facultatif (obligatoire uniquement pour les clés primaires composites). Pour plus d'informations sur les clés primaires, consultez [Clé primaire](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Les noms d'élément de clé primaire peuvent comporter entre 1 et 255 caractères sans restriction quant au type de caractère. Les valeurs possibles pour AttributeType sont « S » (chaîne), « N » (numérique) ou « B » (binaire).Type : mappage de `HashKeyElement`, ou de `HashKeyElement` et `RangeKeyElement` pour une clé primaire composite. | Oui |
| ProvisionedThroughput | Nouveau débit pour la table spécifiée, composé de valeurs pour ReadCapacityUnits et WriteCapacityUnits. Pour en savoir plus, consultez [Mode de capacité provisionnée DynamoDB](provisioned-capacity-mode.md). Pour connaître les valeurs maximum/minimum actuelles, consultez [Quotas dans Amazon DynamoDB](ServiceQuotas.md). Type : Array | Oui |
| ProvisionedThroughput: ReadCapacityUnits | Définit le nombre minimum de `ReadCapacityUnits` cohérentes consommées par seconde pour la table spécifiée avant que DynamoDB équilibre la charge avec d'autres opérations. Des opérations de lecture éventuellement cohérente nécessitant moins d'effort qu'une opération de lecture cohérente, un paramètre de 50 `ReadCapacityUnits` par seconde fournit 100 `ReadCapacityUnits` éventuellement cohérentes par seconde. Type : nombre | Oui |
| ProvisionedThroughput: WriteCapacityUnits | Définit le nombre minimum de WriteCapacityUnits consommées par seconde pour la table spécifiée avant que DynamoDB équilibre la charge avec d'autres opérations. Type : nombre | Oui |
## Réponses
### Syntaxe
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"CREATING"
}
}
```
****
| Name (Nom) | Description |
| --- | --- |
| TableDescription | Conteneur pour les propriétés de la table. |
| CreationDateTime | Date à laquelle la table a été créée au format d'[heure UNIX](http://www.epochconverter.com/).Type : nombre |
| KeySchema | Structure (simple ou composite) de la clé primaire pour la table. Une paire nom-valeur pour l'élément `HashKeyElement` est obligatoire, et une paire nom-valeur pour l'élément `RangeKeyElement` est facultatif (obligatoire uniquement pour les clés primaires composites). Pour plus d'informations sur les clés primaires, consultez [Clé primaire](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Type : mappage de `HashKeyElement`, ou de `HashKeyElement` et `RangeKeyElement` pour une clé primaire composite. |
| ProvisionedThroughput | Débit pour la table spécifiée, composé de valeurs pour `ReadCapacityUnits` et `WriteCapacityUnits`. Consultez [Mode de capacité provisionnée DynamoDB](provisioned-capacity-mode.md). Type : Array |
| ProvisionedThroughput :ReadCapacityUnits | Nombre minimum de `ReadCapacityUnits` consommées par seconde avant que DynamoDB équilibre la charge avec d'autres opérationsType : nombre |
| ProvisionedThroughput :WriteCapacityUnits | Nombre minimum de `ReadCapacityUnits` consommées par seconde avant que `WriteCapacityUnits` équilibre la charge avec d'autres opérationsType : nombre |
| TableName | Nom de la table créée. Type : String |
| TableStatus | État actuel de la table (`CREATING`). Une fois la table dans l'état `ACTIVE`, vous pouvez y insérer des données.Utilisez l'API [DescribeTables](API_DescribeTables_v20111205.md) pour vérifier l'état de la table.Type : String |
## Erreurs spéciales
****
| Erreur | Description |
| --- | --- |
| ResourceInUseException | Essayez de recréer une table existante. |
| LimitExceededException | Le nombre de demandes de table simultanées (nombre cumulé de tables dans l'état `CREATING`, `DELETING` ou `UPDATING`) dépasse le maximum autorisé. Pour connaître les valeurs maximum/minimum actuelles, consultez [Quotas dans Amazon DynamoDB](ServiceQuotas.md). . |
## Exemples
L'exemple suivant crée une table avec une clé primaire composite contenant une chaîne et un nombre. Pour des exemples d'utilisation du kit SDK AWS, consultez [Utilisation de tables et de données dans DynamoDB](WorkingWithTables.md).
### Exemple de demande
```
// This header is abbreviated.
// For a sample of a complete header, see API de bas niveau de DynamoDB.
POST / HTTP/1.1
x-amz-target: DynamoDB_20111205.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"comp-table",
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
### Exemple de réponse
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"comp-table",
"TableStatus":"CREATING"
}
}
```
## Actions connexes
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)