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.
# DeleteTable
**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 `DeleteTable` supprime une table et la totalité de ses éléments. Après une demande `DeleteTable`, la table spécifiée est dans l'état `DELETING` jusqu'à ce que DynamoDB termine la suppression. Si la table est dans l'état `ACTIVE`, vous pouvez la supprimer. Si une table est dans l'état `CREATING` ou `UPDATING`, DynamoDB renvoie un erreur `ResourceInUseException`. Si la table spécifiée n'existe pas, DynamoDB renvoie une erreur `ResourceNotFoundException`. Si la table est déjà dans l'état `DELETING`, aucune erreur n'est renvoyée.
**Note**
DynamoDB peut continuer à accepter les demandes d'opération de plan de données, telles que `GetItem` et `PutItem`, sur une table dans l'état `DELETING` jusqu'à ce que la suppression de celle-ci soit terminée.
Les table sont uniques parmi celles associées au compte AWS émettant la demande, et à la région AWS recevant la demande (par exemple dynamodb.us-west-1.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. La suppression de l'une d'elles n'entraîne pas la suppression de l'autre.
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.DeleteTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1"}
```
****
| Name (Nom) | Description | Obligatoire |
| --- | --- | --- |
| TableName | Nom de la table à supprimer. Type : String | Oui |
## Réponses
### Syntaxe
```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Sun, 14 Aug 2011 22:56:22 GMT
{"TableDescription":
{"CreationDateTime":1.313362508446E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"DELETING"
}
}
```
****
| Name (Nom) | Description |
| --- | --- |
| TableDescription | Conteneur pour les propriétés de la table. |
| CreationDateTime | Date de création de la table.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). |
| ProvisionedThroughput: ReadCapacityUnits | Nombre minimum de `ReadCapacityUnits` consommées par seconde pour la table spécifiée avant que DynamoDB équilibre la charge avec d'autres opérations. Type : nombre |
| ProvisionedThroughput: WriteCapacityUnits | 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 |
| TableName | Nom de la table supprimée. Type : String |
| TableStatus | État actuel de la table (DELETING). Une fois la table supprimée, les demandes suivantes pour la table renvoient resource not found. Utilisez l'opération [DescribeTables](API_DescribeTables_v20111205.md) pour vérifier l'état de la table. Type : String |
## Erreurs spéciales
****
| Erreur | Description |
| --- | --- |
| ResourceInUseException | La table est dans l'état CREATING ou UPDATING et ne peut pas être supprimée. |
## Exemples
### 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.DeleteTable
content-type: application/x-amz-json-1.0
content-length: 40
{"TableName":"favorite-movies-table"}
```
### Exemple de réponse
```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 160
Date: Sun, 14 Aug 2011 17:20:03 GMT
{"TableDescription":
{"CreationDateTime":1.313362508446E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}},
"TableName":"favorite-movies-table",
"TableStatus":"DELETING"
}
```
## Actions connexes
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)