DeleteTable - Amazon DynamoDB
DescriptionRequêtesRéponsesErreurs spécialesExemplesActions connexes

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.

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 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.

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.
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 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"
}