Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
penting
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Untuk dokumentasi tentang level rendah saat iniAPI, lihat Referensi Amazon DynamoDB API.
Deskripsi
Menghapus satu item dalam tabel dengan kunci primer. Anda dapat melakukan operasi penghapusan bersyarat yang menghapus item jika ada, atau jika item memiliki nilai atribut yang diharapkan.
catatan
Jika Anda menentukan DeleteItem tanpa atribut atau nilai, semua atribut untuk item tersebut akan dihapus.
Kecuali jika Anda menentukan syarat, DeleteItem adalah operasi idempotensi; menjalankannya beberapa kali pada item atau atribut yang sama tidak menghasilkan respons kesalahan.
Penghapusan bersyarat hanya berguna untuk menghapus item dan atribut jika syarat tertentu terpenuhi. Jika syarat terpenuhi, DynamoDB melakukan penghapusan. Jika tidak, item tersebut tidak akan dihapus.
Anda dapat melakukan pemeriksaan bersyarat yang diharapkan pada satu atribut per operasi.
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.DeleteItem content-type: application/x-amz-json-1.0 {"TableName":"Table1", "Key": {"HashKeyElement":{"S":"AttributeValue1"},"RangeKeyElement":{"N":"AttributeValue2"}}, "Expected":{"AttributeName3":{"Value":{"S":"AttributeValue3"}}}, "ReturnValues":"ALL_OLD"} }
| Nama | Deskripsi | Wajib |
|---|---|---|
TableName
|
Nama tabel yang berisi item untuk dihapus. Jenis: String |
Ya |
Key
|
Kunci primer yang menentukan item. Untuk informasi selengkapnya tentang kunci primer, lihat Kunci primer. Jenis: Peta |
Ya |
Expected
|
Menunjuk atribut untuk penghapusan bersyarat. Parameter Jenis: Peta nama atribut. |
Tidak |
Expected:AttributeName
|
Nama atribut untuk penempatan bersyarat. Jenis: String |
Tidak |
Expected:AttributeName: ExpectedAttributeValue |
Gunakan parameter ini untuk menentukan apakah nilai sudah ada atau belum untuk pasangan nama-nilai atribut. JSONNotasi berikut menghapus item jika atribut “Warna” tidak ada untuk item tersebut: JSONNotasi berikut memeriksa untuk melihat apakah atribut dengan nama “Warna” memiliki nilai “Kuning” yang ada sebelum menghapus item: Secara default, jika Anda menggunakan parameter catatanJika Anda menentukan |
Tidak |
ReturnValues
|
Gunakan parameter ini jika Anda ingin mendapatkan pasangan nama-nilai atribut sebelum pasangan tersebut dihapus. Nilai parameter yang memungkinkan adalah Jenis: String |
Tidak |
Respons
Sintaks
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 353
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"Attributes":
{"AttributeName3":{"SS":["AttributeValue3","AttributeValue4","AttributeValue5"]},
"AttributeName2":{"S":"AttributeValue2"},
"AttributeName1":{"N":"AttributeValue1"}
},
"ConsumedCapacityUnits":1
}| Nama | Deskripsi |
|---|---|
Attributes
|
Jika parameter Jenis: Array pasangan nama-nilai atribut. |
ConsumedCapacityUnits |
Jumlah unit kapasitas tulis yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Permintaan hapus pada item yang tidak ada mengonsumsi 1 unit kapasitas tulis. Untuk informasi selengkapnya, lihat DynamoDB menyediakan mode kapasitas. Jenis: Angka |
Kesalahan khusus
| Kesalahan | Deskripsi |
|---|---|
ConditionalCheckFailedException
|
Pemeriksaan bersyarat gagal. Nilai atribut yang diharapkan tidak ditemukan. |
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.DeleteItem content-type: application/x-amz-json-1.0 {"TableName":"comp-table", "Key": {"HashKeyElement":{"S":"Mingus"},"RangeKeyElement":{"N":"200"}}, "Expected": {"status":{"Value":{"S":"shopping"}}}, "ReturnValues":"ALL_OLD" }
Respons sampel
HTTP/1.1 200 OK
x-amzn-RequestId: U9809LI6BBFJA5N2R0TB0P017JVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 353
Date: Tue, 12 Jul 2011 22:31:23 GMT
{"Attributes":
{"friends":{"SS":["Dooley","Ben","Daisy"]},
"status":{"S":"shopping"},
"time":{"N":"200"},
"user":{"S":"Mingus"}
},
"ConsumedCapacityUnits":1
}Tindakan terkait
