Skip to content

Commit e5ef504

Browse files
author
AWS
committed
Amazon DynamoDB Update: This release includes supports the new WarmThroughput feature for DynamoDB. You can now provide an optional WarmThroughput attribute for CreateTable or UpdateTable APIs to pre-warm your table or global secondary index. You can also use DescribeTable to see the latest WarmThroughput value.
1 parent 8a7141b commit e5ef504

File tree

2 files changed

+92
-0
lines changed

2 files changed

+92
-0
lines changed

‎.changes/next-release/feature-AmazonDynamoDB-7de31d4.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon DynamoDB",
4+
"contributor": "",
5+
"description": "This release includes supports the new WarmThroughput feature for DynamoDB. You can now provide an optional WarmThroughput attribute for CreateTable or UpdateTable APIs to pre-warm your table or global secondary index. You can also use DescribeTable to see the latest WarmThroughput value."
6+
}

‎services/dynamodb/src/main/resources/codegen-resources/dynamodb/service-2.json‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1977,6 +1977,10 @@
19771977
"OnDemandThroughput":{
19781978
"shape":"OnDemandThroughput",
19791979
"documentation":"<p>The maximum number of read and write units for the global secondary index being created. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>, <code>MaxWriteRequestUnits</code>, or both.</p>"
1980+
},
1981+
"WarmThroughput":{
1982+
"shape":"WarmThroughput",
1983+
"documentation":"<p>Represents the warm throughput value (in read units per second and write units per second) when creating a secondary index.</p>"
19801984
}
19811985
},
19821986
"documentation":"<p>Represents a new global secondary index to be added to an existing table.</p>"
@@ -2105,6 +2109,10 @@
21052109
"shape":"DeletionProtectionEnabled",
21062110
"documentation":"<p>Indicates whether deletion protection is to be enabled (true) or disabled (false) on the table.</p>"
21072111
},
2112+
"WarmThroughput":{
2113+
"shape":"WarmThroughput",
2114+
"documentation":"<p>Represents the warm throughput (in read units per second and write units per second) for creating a table.</p>"
2115+
},
21082116
"ResourcePolicy":{
21092117
"shape":"ResourcePolicy",
21102118
"documentation":"<p>An Amazon Web Services resource-based policy document in JSON format that will be attached to the table.</p> <p>When you attach a resource-based policy while creating a table, the policy application is <i>strongly consistent</i>.</p> <p>The maximum size supported for a resource-based policy document is 20 KB. DynamoDB counts whitespaces when calculating the size of a policy against this limit. For a full list of all considerations that apply for resource-based policies, see <a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-considerations.html\">Resource-based policy considerations</a>.</p> <note> <p>You need to specify the <code>CreateTable</code> and <code>PutResourcePolicy</code> IAM actions for authorizing a user to create a table with a resource-based policy.</p> </note>"
@@ -3214,6 +3222,10 @@
32143222
"OnDemandThroughput":{
32153223
"shape":"OnDemandThroughput",
32163224
"documentation":"<p>The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>, <code>MaxWriteRequestUnits</code>, or both.</p>"
3225+
},
3226+
"WarmThroughput":{
3227+
"shape":"WarmThroughput",
3228+
"documentation":"<p>Represents the warm throughput value (in read units per second and write units per second) for the specified secondary index. If you use this parameter, you must specify <code>ReadUnitsPerSecond</code>, <code>WriteUnitsPerSecond</code>, or both.</p>"
32173229
}
32183230
},
32193231
"documentation":"<p>Represents the properties of a global secondary index.</p>"
@@ -3276,6 +3288,10 @@
32763288
"OnDemandThroughput":{
32773289
"shape":"OnDemandThroughput",
32783290
"documentation":"<p>The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>, <code>MaxWriteRequestUnits</code>, or both.</p>"
3291+
},
3292+
"WarmThroughput":{
3293+
"shape":"GlobalSecondaryIndexWarmThroughputDescription",
3294+
"documentation":"<p>Represents the warm throughput value (in read units per second and write units per second) for the specified secondary index.</p>"
32793295
}
32803296
},
32813297
"documentation":"<p>Represents the properties of a global secondary index.</p>"
@@ -3333,6 +3349,24 @@
33333349
"type":"list",
33343350
"member":{"shape":"GlobalSecondaryIndexUpdate"}
33353351
},
3352+
"GlobalSecondaryIndexWarmThroughputDescription":{
3353+
"type":"structure",
3354+
"members":{
3355+
"ReadUnitsPerSecond":{
3356+
"shape":"PositiveLongObject",
3357+
"documentation":"<p>Represents warm throughput read units per second value for a global secondary index.</p>"
3358+
},
3359+
"WriteUnitsPerSecond":{
3360+
"shape":"PositiveLongObject",
3361+
"documentation":"<p>Represents warm throughput write units per second value for a global secondary index.</p>"
3362+
},
3363+
"Status":{
3364+
"shape":"IndexStatus",
3365+
"documentation":"<p>Represents the warm throughput status being created or updated on a global secondary index. The status can only be <code>UPDATING</code> or <code>ACTIVE</code>.</p>"
3366+
}
3367+
},
3368+
"documentation":"<p>The description of the warm throughput value on a global secondary index.</p>"
3369+
},
33363370
"GlobalSecondaryIndexes":{
33373371
"type":"list",
33383372
"member":{"shape":"GlobalSecondaryIndexInfo"}
@@ -4908,6 +4942,10 @@
49084942
"shape":"OnDemandThroughputOverride",
49094943
"documentation":"<p>Overrides the maximum on-demand throughput settings for the specified replica table.</p>"
49104944
},
4945+
"WarmThroughput":{
4946+
"shape":"TableWarmThroughputDescription",
4947+
"documentation":"<p>Represents the warm throughput value for this replica.</p>"
4948+
},
49114949
"GlobalSecondaryIndexes":{
49124950
"shape":"ReplicaGlobalSecondaryIndexDescriptionList",
49134951
"documentation":"<p>Replica-specific global secondary index settings.</p>"
@@ -4992,6 +5030,10 @@
49925030
"OnDemandThroughputOverride":{
49935031
"shape":"OnDemandThroughputOverride",
49945032
"documentation":"<p>Overrides the maximum on-demand throughput for the specified global secondary index in the specified replica table.</p>"
5033+
},
5034+
"WarmThroughput":{
5035+
"shape":"GlobalSecondaryIndexWarmThroughputDescription",
5036+
"documentation":"<p>Represents the warm throughput of the global secondary index for this replica.</p>"
49955037
}
49965038
},
49975039
"documentation":"<p>Represents the properties of a replica global secondary index.</p>"
@@ -5933,6 +5975,10 @@
59335975
"OnDemandThroughput":{
59345976
"shape":"OnDemandThroughput",
59355977
"documentation":"<p>The maximum number of read and write units for the specified on-demand table. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>, <code>MaxWriteRequestUnits</code>, or both.</p>"
5978+
},
5979+
"WarmThroughput":{
5980+
"shape":"TableWarmThroughputDescription",
5981+
"documentation":"<p>Describes the warm throughput value of the base table.</p>"
59365982
}
59375983
},
59385984
"documentation":"<p>Represents the properties of a table.</p>"
@@ -5979,6 +6025,24 @@
59796025
"ARCHIVED"
59806026
]
59816027
},
6028+
"TableWarmThroughputDescription":{
6029+
"type":"structure",
6030+
"members":{
6031+
"ReadUnitsPerSecond":{
6032+
"shape":"PositiveLongObject",
6033+
"documentation":"<p>Represents the base table's warm throughput value in read units per second.</p>"
6034+
},
6035+
"WriteUnitsPerSecond":{
6036+
"shape":"PositiveLongObject",
6037+
"documentation":"<p>Represents the base table's warm throughput value in write units per second.</p>"
6038+
},
6039+
"Status":{
6040+
"shape":"TableStatus",
6041+
"documentation":"<p>Represents warm throughput value of the base table..</p>"
6042+
}
6043+
},
6044+
"documentation":"<p>Represents the warm throughput value (in read units per second and write units per second) of the base table.</p>"
6045+
},
59826046
"Tag":{
59836047
"type":"structure",
59846048
"required":[
@@ -6350,6 +6414,10 @@
63506414
"OnDemandThroughput":{
63516415
"shape":"OnDemandThroughput",
63526416
"documentation":"<p>Updates the maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>, <code>MaxWriteRequestUnits</code>, or both.</p>"
6417+
},
6418+
"WarmThroughput":{
6419+
"shape":"WarmThroughput",
6420+
"documentation":"<p>Represents the warm throughput value of the new provisioned throughput settings to be applied to a global secondary index.</p>"
63536421
}
63546422
},
63556423
"documentation":"<p>Represents the new provisioned throughput settings to be applied to a global secondary index.</p>"
@@ -6630,6 +6698,10 @@
66306698
"OnDemandThroughput":{
66316699
"shape":"OnDemandThroughput",
66326700
"documentation":"<p>Updates the maximum number of read and write units for the specified table in on-demand capacity mode. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>, <code>MaxWriteRequestUnits</code>, or both.</p>"
6701+
},
6702+
"WarmThroughput":{
6703+
"shape":"WarmThroughput",
6704+
"documentation":"<p>Represents the warm throughput (in read units per second and write units per second) for updating a table.</p>"
66336705
}
66346706
},
66356707
"documentation":"<p>Represents the input of an <code>UpdateTable</code> operation.</p>"
@@ -6699,6 +6771,20 @@
66996771
}
67006772
}
67016773
},
6774+
"WarmThroughput":{
6775+
"type":"structure",
6776+
"members":{
6777+
"ReadUnitsPerSecond":{
6778+
"shape":"LongObject",
6779+
"documentation":"<p>Represents the number of read operations your base table can instantaneously support.</p>"
6780+
},
6781+
"WriteUnitsPerSecond":{
6782+
"shape":"LongObject",
6783+
"documentation":"<p>Represents the number of write operations your base table can instantaneously support.</p>"
6784+
}
6785+
},
6786+
"documentation":"<p>Provides visibility into the number of read and write operations your table or secondary index can instantaneously support. The settings can be modified using the <code>UpdateTable</code> operation to meet the throughput requirements of an upcoming peak event.</p>"
6787+
},
67026788
"WriteRequest":{
67036789
"type":"structure",
67046790
"members":{

0 commit comments

Comments
 (0)