Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
UpdateTable
penting
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Untuk dokumentasi tentang API tingkat rendah saat ini, lihat Referensi API Amazon DynamoDB.
Deskripsi
Memperbarui throughput yang disediakan untuk tabel yang ditentukan. Mengatur throughput untuk tabel membantu Anda mengelola performa dan merupakan bagian dari fitur throughput yang disediakan dalam DynamoDB. Untuk informasi selengkapnya, lihat Mode kapasitas yang disediakan DynamoDB.
Nilai throughput yang disediakan dapat ditingkatkan atau diturunkan berdasarkan nilai maksimum dan minimum yang tercantum dalam Kuota di Amazon DynamoDB.
Tabel harus dalam ACTIVE
keadaan agar operasi ini berhasil. UpdateTable adalah operasi asinkron; saat menjalankan operasi, tabel dalam keadaan. UPDATING
Meskipun berada dalam status UPDATING
, tabel masih memiliki throughput yang disediakan sejak sebelum panggilan. Pengaturan throughput baru yang disediakan hanya berlaku ketika tabel kembali ke ACTIVE
status setelah operasi. UpdateTable
Permintaan
Sintaks
// This header is abbreviated. // For a sample of a complete header, see API tingkat rendah DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"Table1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }
Nama | Deskripsi | Wajib |
---|---|---|
TableName
|
Nama tabel yang akan diperbarui. Jenis: String |
Ya |
ProvisionedThroughput
|
Throughput baru untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk Jenis: Array |
Ya |
ProvisionedThroughput
:ReadCapacityUnits |
Menetapkan jumlah minimum Operasi bacaan akhir konsisten memerlukan lebih sedikit usaha daripada operasi baca konsisten, jadi pengaturan 50 Jenis: Angka |
Ya |
ProvisionedThroughput
:WriteCapacityUnits |
Menetapkan jumlah minimum Jenis: Angka |
Ya |
Respons
Sintaks
HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG Content-Type: application/json Content-Length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"UPDATING"}}
Nama | Deskripsi |
---|---|
CreationDateTime |
Tanggal ketika tabel dibuat. Jenis: Angka |
KeySchema
|
Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk Jenis: Peta |
ProvisionedThroughput |
Pengaturan throughput saat ini untuk tabel yang ditentukan, termasuk nilai untuk Jenis: Array |
TableName
|
Nama tabel yang diperbarui. Jenis: String |
TableStatus
|
Status tabel saat ini (CREATING , ACTIVE , DELETING , atau UPDATING ), yang seharusnya UPDATING . Gunakan operasi DescribeTables untuk memeriksa status tabel. Jenis: String |
Kesalahan khusus
Kesalahan | Deskripsi |
---|---|
ResourceNotFoundException
|
Tabel yang ditentukan tidak ditemukan. |
ResourceInUseException |
Tabel ini tidak berada dalam status ACTIVE . |
Contoh
Permintaan sampel
// This header is abbreviated. // For a sample of a complete header, see API tingkat rendah DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"comp1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }
Respons sampel
HTTP/1.1 200 OK content-type: application/x-amz-json-1.0 content-length: 390 Date: Sat, 19 Nov 2011 00:46:47 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"comp1", "TableStatus":"UPDATING"} }