調用UpdateTable介面更新指定表的預留讀輸送量或預留寫輸送量設定,新設定將於更新成功一分鐘內生效。

請求訊息結構

message UpdateTableRequest {
    required string table_name = 1;
    optional ReservedThroughput reserved_throughput = 2;
    optional TableOptions table_options = 3;
    optional StreamSpecification stream_spec = 4;
}
名稱 類型 是否必選 描述
table_name string 更改預留讀寫輸送量設定的資料表對應的表名稱。
reserved_throughput ReservedThroughput 將要更改的表的預留讀輸送量或者預留寫輸送量設定,該設定將於一分鐘後生效。

capacity_unit中read和write應至少有一個非空,否則請求失敗,返回錯誤。

table_options TableOptions 主要設定TimeToLive和最大版本數。
StreamSpecification StreamSpecification 描述是否開啟Stream等Stream相關的屬性。

響應訊息結構

message UpdateTableResponse {
    required ReservedThroughputDetails reserved_throughput_details = 1;
    required TableOptions table_options = 2;
}
名稱 類型 描述
capacity_unit_details ReservedThroughputDetails 更新後,該表的預留讀輸送量或者預留寫輸送量設定資訊除了包含當前的預留讀輸送量或者預留寫輸送量設定值之外,還包含了最近一次更新該表的預留讀輸送量或者預留寫輸送量設定的時間和當日已下調預留讀輸送量或者預留寫輸送量的次數。
说明
  • 調整每個表預留讀輸送量或者預留寫輸送量的最小時間間隔為2分鐘,如果本次UpdateTable操作距上次不到2分鐘將被拒絕。
  • 每個自然日(UTC時間00:00:00到第二天的00:00:00)內每個表上調和下調預留讀寫輸送量次數不限。
table_options TableOptions 修改後,最新的table_options參數值。

使用SDK