Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1453442446.0 KB

Updates settings for a global table.

This operation only applies to Version 2017.11.29 (Legacy) of global tables. We recommend using Version 2019.11.21 (Current) when creating new global tables, as it provides greater flexibility, higher efficiency and consumes less write capacity than 2017.11.29 (Legacy). To determine which version you are using, see Determining the version. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Updating global tables.

post/#X-Amz-Target=DynamoDB_20120810.UpdateGlobalTableSettings

Headers

X-Amz-Target'DynamoDB_20120810.UpdateGlobalTableSettings' required

Request body

GlobalTableNamestring required

The name of the global table

GlobalTableBillingMode'PROVISIONED' | 'PAY_PER_REQUEST'
<p>The billing mode of the global table. If <code>GlobalTableBillingMode</code> is not specified, the global table defaults to <code>PROVISIONED</code> capacity billing mode.</p> <ul> <li> <p> <code>PROVISIONED</code> - We recommend using <code>PROVISIONED</code> for predictable workloads. <code>PROVISIONED</code> sets the billing mode to <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual">Provisioned Mode</a>.</p> </li> <li> <p> <code>PAY_PER_REQUEST</code> - We recommend using <code>PAY_PER_REQUEST</code> for unpredictable workloads. <code>PAY_PER_REQUEST</code> sets the billing mode to <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand">On-Demand Mode</a>. </p> </li> </ul>
GlobalTableProvisionedWriteCapacityUnitsinteger

The maximum number of writes consumed per second before DynamoDB returns a <code>ThrottlingException.</code>

Response

Success

GlobalTableNamestring

The name of the global table.