Modifies the reserved read/write throughput settings of a table. The new settings take effect within one minute.

Request syntax

message UpdateTableRequest {
    required string table_name = 1;
    optional ReservedThroughput reserved_throughput = 2;
    optional TableOptions table_options = 3;
    optional StreamSpecification stream_spec = 4;
}
Parameter Type Required Description
table_name string Yes The name of the data table for which you want to modify the reserved read/write throughput settings.
reserved_throughput ReservedThroughput Yes The new reserved read/write throughput settings of the table. New settings take effect within one minute after a successful update.

The read and write parameters of capacity_unit cannot be left empty at the same time. If you leave the read and write parameters empty at the same time, the request fails and an error message is returned.

table_options TableOptions Yes The time to live and the maximum number of versions.
StreamSpecification StreamSpecification No Specifies whether to enable Stream-related attributes.

Response syntax

message UpdateTableResponse {
    required ReservedThroughputDetails reserved_throughput_details = 1;
    required TableOptions table_options = 2;
}
Parameter Type Description
capacity_unit_details ReservedThroughputDetails After a successful update, the reserved read/write throughput settings of the table include the most recent reserved read/write throughput value, the time when the reserved read/write throughput value was last updated, and the number of times that the reserved read/write throughput value was decreased on the current day.
Note
  • The reserved read/write throughput settings of a table are updated at a minimum interval of 2 minutes. If you call the UpdateTable operation again within 2 minutes after the previous request, the current request is rejected.
  • The number of times that you can increase or decrease the reserved read/write throughput settings of a table within a single day (from 00:00:00 to 00:00:00 on the next day in UTC) is not limited.
table_options TableOptions The value of the table_options parameter after the update.

Use Tablestore SDKs

You can use the following Tablestore SDKs to modify the reserved read/write throughput settings of a table: