DeleteTable

penting

Bagian ini mengacu pada API versi 2011-12-05, yang sudah usang dan tidak boleh digunakan untuk aplikasi baru.

Untuk dokumentasi tentang API tingkat rendah saat ini, lihat Referensi API Amazon DynamoDB.

Deskripsi

Operasi DeleteTable menghapus tabel beserta semua itemnya. Setelah permintaan DeleteTable, tabel yang ditentukan berada dalam status DELETING hingga DynamoDB menyelesaikan penghapusan. Jika tabel berada dalam status ACTIVE, Anda dapat menghapusnya. Jika tabel berada dalam status CREATING atau UPDATING, DynamoDB mengembalikan kesalahan ResourceInUseException. Jika tabel yang ditentukan tidak ada, DynamoDB mengembalikan ResourceNotFoundException. Jika tabel sudah berada dalam status DELETING, tidak ada kesalahan yang dikembalikan.

catatan

DynamoDB dapat terus menerima permintaan operasi bidang data, seperti GetItem dan PutItem, pada tabel dalam status DELETING hingga penghapusan tabel selesai.

Tabel unik di antara yang terkait dengan AWS Akun yang mengeluarkan permintaan, dan AWS wilayah yang menerima permintaan (seperti dynamodb.us-west-1.amazonaws.com). Setiap titik akhir DynamoDB bersifat independen sepenuhnya. Misalnya, jika Anda memiliki dua tabel yang disebut "MyTable,” satu di dynamodb.us-west-2.amazonaws.com dan satu di dynamodb.us-west-1.amazonaws.com, mereka sepenuhnya independen dan tidak berbagi data apa pun; menghapus satu tidak menghapus yang lain.

Gunakan operasi DescribeTables untuk memeriksa status tabel.

Permintaan

Sintaks

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB tingkat rendah API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.DeleteTable 
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}

Nama	Deskripsi	Wajib
TableName	Nama tabel yang akan dihapus. Jenis: String	Ya

Respons

Sintaks

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

Nama	Deskripsi
TableDescription	Kontainer untuk properti tabel.
CreationDateTime	Tanggal ketika tabel dibuat. Jenis: Angka
KeySchema	Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk HashKeyElement diperlukan, dan pasangan nama-nilai untuk RangeKeyElement bersifat opsional (hanya diperlukan untuk kunci primer komposit). Untuk informasi selengkapnya tentang kunci primer, lihat Kunci primer. Jenis: Peta HashKeyElement, atau HashKeyElement dan RangeKeyElement untuk kunci primer komposit.
ProvisionedThroughput	Throughput untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk ReadCapacityUnits dan WriteCapacityUnits. Lihat DynamoDB menyediakan mode kapasitas.
ProvisionedThroughput: ReadCapacityUnits	Jumlah minimum ReadCapacityUnits yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya. Jenis: Angka
ProvisionedThroughput: WriteCapacityUnits	Jumlah minimum WriteCapacityUnits yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya. Jenis: Angka
TableName	Nama tabel yang dihapus. Jenis: String
TableStatus	Status tabel saat ini (DELETING). Setelah tabel dihapus, permintaan berikutnya untuk tabel mengembalikan resource not found. Gunakan operasi DescribeTables untuk memeriksa status tabel. Jenis: String

Kesalahan khusus

Kesalahan	Deskripsi
ResourceInUseException	Tabel berada dalam status CREATING atau UPDATING dan tidak dapat dihapus.

Contoh

Permintaan sampel

// This header is abbreviated. For a sample of a complete header, see DynamoDB tingkat rendah API.
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"}

Respons sampel

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

Tindakan terkait

• CreateTable

• DescribeTables