All Products
Search

This Product

    Tablestore:UpdateTable

    Document Center

    Tablestore:UpdateTable

    Last Updated:Aug 23, 2024

    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

    No

    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 them empty at the same time, the request fails and an error message is returned.

    table_options

    TableOptions

    No

    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;
    optional StreamDetails stream_details = 3;
}

    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.

    stream_details

    StreamDetails

    The Stream configuration, including whether the Stream feature is enabled for the table, the log expiration time, and the last time when the Stream feature was enabled.

    Use Tablestore SDKs

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