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
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 DynamoDB menyediakan mode kapasitas.
Nilai throughput yang disediakan dapat ditingkatkan atau diturunkan berdasarkan nilai maksimum dan minimum yang tercantum dalam Layanan, akun, dan tabel 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 DynamoDB tingkat rendah API. 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 DynamoDB tingkat rendah API. 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"}
}