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 tables sont uniques parmi celles associées au AWS compte qui émet la demande et à la AWS région qui reçoit 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 appelées « »MyTable, l'une dans dynamodb.us-west-2.amazonaws.com et l'autre dans dynamodb.us-west-1.amazonaws.com, elles sont totalement indépendantes et ne partagent aucune donnée ; la suppression de l'une ne supprime pas 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 : chaîne	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. veuillez consulter Mode de capacité provisionnée.
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 : chaîne
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 : chaîne

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

• DescribeTables