mypy-boto3-dynamodb 1.35.54__py3-none-any.whl → 1.35.74__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -16,6 +16,8 @@ Usage::
16
16
 
17
17
  my_table: dynamodb_resources.Table = resource.Table(...)
18
18
  ```
19
+
20
+ Copyright 2024 Vlad Emelianov
19
21
  """
20
22
 
21
23
  import sys
@@ -27,7 +29,7 @@ from boto3.resources.base import ResourceMeta, ServiceResource
27
29
  from boto3.resources.collection import ResourceCollection
28
30
 
29
31
  from .client import DynamoDBClient
30
- from .literals import TableStatusType
32
+ from .literals import MultiRegionConsistencyType, TableStatusType
31
33
  from .type_defs import (
32
34
  ArchivalSummaryTypeDef,
33
35
  AttributeDefinitionTypeDef,
@@ -58,6 +60,7 @@ from .type_defs import (
58
60
  SSEDescriptionTypeDef,
59
61
  StreamSpecificationTypeDef,
60
62
  TableClassSummaryTypeDef,
63
+ TableWarmThroughputDescriptionTypeDef,
61
64
  UpdateItemInputTableUpdateItemTypeDef,
62
65
  UpdateItemOutputTableTypeDef,
63
66
  UpdateTableInputTableUpdateTypeDef,
@@ -72,14 +75,15 @@ __all__ = ("DynamoDBServiceResource", "ServiceResourceTablesCollection", "Table"
72
75
 
73
76
  class ServiceResourceTablesCollection(ResourceCollection):
74
77
  """
75
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.tables)
78
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/tables.html#DynamoDB.ServiceResource.tables)
76
79
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#serviceresourcetablescollection)
77
80
  """
78
81
  def all(self) -> "ServiceResourceTablesCollection":
79
82
  """
80
- Get all items from the collection, optionally with a custom page size and item count limit.
83
+ Get all items from the collection, optionally with a custom page size and item
84
+ count limit.
81
85
 
82
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.tables)
86
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/tables.html#DynamoDB.ServiceResource.all)
83
87
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#serviceresourcetablescollection)
84
88
  """
85
89
 
@@ -87,9 +91,11 @@ class ServiceResourceTablesCollection(ResourceCollection):
87
91
  self, *, ExclusiveStartTableName: str = ..., Limit: int = ...
88
92
  ) -> "ServiceResourceTablesCollection":
89
93
  """
90
- Get items from the collection, passing keyword arguments along as parameters to the underlying service operation, which are typically used to filter the results.
94
+ Get items from the collection, passing keyword arguments along as parameters to
95
+ the underlying service operation, which are typically used to filter the
96
+ results.
91
97
 
92
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.tables)
98
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/tables.html#filter)
93
99
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#serviceresourcetablescollection)
94
100
  """
95
101
 
@@ -97,7 +103,7 @@ class ServiceResourceTablesCollection(ResourceCollection):
97
103
  """
98
104
  Return at most this many Tables.
99
105
 
100
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.tables)
106
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/tables.html#limit)
101
107
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#serviceresourcetablescollection)
102
108
  """
103
109
 
@@ -105,7 +111,7 @@ class ServiceResourceTablesCollection(ResourceCollection):
105
111
  """
106
112
  Fetch at most this many Tables per service request.
107
113
 
108
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.tables)
114
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/tables.html#page_size)
109
115
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#serviceresourcetablescollection)
110
116
  """
111
117
 
@@ -113,7 +119,7 @@ class ServiceResourceTablesCollection(ResourceCollection):
113
119
  """
114
120
  A generator which yields pages of Tables.
115
121
 
116
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.tables)
122
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/tables.html#pages)
117
123
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#serviceresourcetablescollection)
118
124
  """
119
125
 
@@ -121,16 +127,17 @@ class ServiceResourceTablesCollection(ResourceCollection):
121
127
  """
122
128
  A generator which yields Tables.
123
129
 
124
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.tables)
130
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/tables.html#__iter__)
125
131
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#serviceresourcetablescollection)
126
132
  """
127
133
 
128
134
  class Table(ServiceResource):
129
135
  """
130
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.Table)
136
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/index.html#DynamoDB.Table)
131
137
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#table)
132
138
  """
133
139
 
140
+ name: str
134
141
  attribute_definitions: List[AttributeDefinitionTypeDef]
135
142
  table_name: str
136
143
  key_schema: List[KeySchemaElementTypeDef]
@@ -155,22 +162,23 @@ class Table(ServiceResource):
155
162
  table_class_summary: TableClassSummaryTypeDef
156
163
  deletion_protection_enabled: bool
157
164
  on_demand_throughput: OnDemandThroughputTypeDef
158
- name: str
165
+ warm_throughput: TableWarmThroughputDescriptionTypeDef
166
+ multi_region_consistency: MultiRegionConsistencyType
159
167
  meta: "DynamoDBResourceMeta" # type: ignore
160
168
 
161
- def batch_writer(self, overwrite_by_pkeys: List[str] = ...) -> BatchWriter:
169
+ def get_available_subresources(self) -> Sequence[str]:
162
170
  """
163
- Create a batch writer object.
171
+ Returns a list of all the available sub-resources for this Table.
164
172
 
165
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.batch_writer)
166
- [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablebatch_writer-method)
173
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/get_available_subresources.html)
174
+ [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableget_available_subresources-method)
167
175
  """
168
176
 
169
177
  def delete(self) -> DeleteTableOutputTypeDef:
170
178
  """
171
- The `DeleteTable` operation deletes a table and all of its items.
179
+ The <code>DeleteTable</code> operation deletes a table and all of its items.
172
180
 
173
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.delete)
181
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/delete.html)
174
182
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tabledelete-method)
175
183
  """
176
184
 
@@ -180,87 +188,55 @@ class Table(ServiceResource):
180
188
  """
181
189
  Deletes a single item in a table by primary key.
182
190
 
183
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.delete_item)
191
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/delete_item.html)
184
192
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tabledelete_item-method)
185
193
  """
186
194
 
187
- def get_available_subresources(self) -> Sequence[str]:
188
- """
189
- Returns a list of all the available sub-resources for this Resource.
190
-
191
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.get_available_subresources)
192
- [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableget_available_subresources-method)
193
- """
194
-
195
195
  def get_item(
196
196
  self, **kwargs: Unpack[GetItemInputTableGetItemTypeDef]
197
197
  ) -> GetItemOutputTableTypeDef:
198
198
  """
199
- The `GetItem` operation returns a set of attributes for the item with the given
200
- primary
201
- key.
199
+ The <code>GetItem</code> operation returns a set of attributes for the item
200
+ with the given primary key.
202
201
 
203
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.get_item)
202
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/get_item.html)
204
203
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableget_item-method)
205
204
  """
206
205
 
207
- def load(self) -> None:
208
- """
209
- Calls :py:meth:`DynamoDB.Client.describe_table` to update the attributes of the
210
- Table
211
- resource.
212
-
213
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.load)
214
- [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableload-method)
215
- """
216
-
217
206
  def put_item(
218
207
  self, **kwargs: Unpack[PutItemInputTablePutItemTypeDef]
219
208
  ) -> PutItemOutputTableTypeDef:
220
209
  """
221
210
  Creates a new item, or replaces an old item with a new item.
222
211
 
223
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.put_item)
212
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/put_item.html)
224
213
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableput_item-method)
225
214
  """
226
215
 
227
216
  def query(self, **kwargs: Unpack[QueryInputTableQueryTypeDef]) -> QueryOutputTableTypeDef:
228
217
  """
229
218
  You must provide the name of the partition key attribute and a single value for
230
- that
231
- attribute.
219
+ that attribute.
232
220
 
233
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.query)
221
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/query.html)
234
222
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablequery-method)
235
223
  """
236
224
 
237
- def reload(self) -> None:
238
- """
239
- Calls :py:meth:`DynamoDB.Client.describe_table` to update the attributes of the
240
- Table
241
- resource.
242
-
243
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.reload)
244
- [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablereload-method)
245
- """
246
-
247
225
  def scan(self, **kwargs: Unpack[ScanInputTableScanTypeDef]) -> ScanOutputTableTypeDef:
248
226
  """
249
- The `Scan` operation returns one or more items and item attributes by accessing
250
- every item in a table or a secondary
251
- index.
227
+ The <code>Scan</code> operation returns one or more items and item attributes
228
+ by accessing every item in a table or a secondary index.
252
229
 
253
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.scan)
230
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/scan.html)
254
231
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablescan-method)
255
232
  """
256
233
 
257
234
  def update(self, **kwargs: Unpack[UpdateTableInputTableUpdateTypeDef]) -> "_Table":
258
235
  """
259
236
  Modifies the provisioned throughput settings, global secondary indexes, or
260
- DynamoDB Streams settings for a given
261
- table.
237
+ DynamoDB Streams settings for a given table.
262
238
 
263
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.update)
239
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/update.html)
264
240
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableupdate-method)
265
241
  """
266
242
 
@@ -269,29 +245,48 @@ class Table(ServiceResource):
269
245
  ) -> UpdateItemOutputTableTypeDef:
270
246
  """
271
247
  Edits an existing item's attributes, or adds a new item to the table if it does
272
- not already
273
- exist.
248
+ not already exist.
274
249
 
275
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.update_item)
250
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/update_item.html)
276
251
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableupdate_item-method)
277
252
  """
278
253
 
279
254
  def wait_until_exists(self) -> None:
280
255
  """
281
- Waits until this Table is exists.
256
+ Waits until Table is exists.
282
257
 
283
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.wait_until_exists)
258
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/wait_until_exists.html)
284
259
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablewait_until_exists-method)
285
260
  """
286
261
 
287
262
  def wait_until_not_exists(self) -> None:
288
263
  """
289
- Waits until this Table is not exists.
264
+ Waits until Table is not_exists.
290
265
 
291
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.Table.wait_until_not_exists)
266
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/wait_until_not_exists.html)
292
267
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablewait_until_not_exists-method)
293
268
  """
294
269
 
270
+ def batch_writer(self, overwrite_by_pkeys: List[str] = ...) -> BatchWriter:
271
+ """
272
+ Create a batch writer object.
273
+
274
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/batch_writer.html)
275
+ [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablebatch_writer-method)
276
+ """
277
+
278
+ def load(self) -> None:
279
+ """
280
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/load.html)
281
+ [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tableload-method)
282
+ """
283
+
284
+ def reload(self) -> None:
285
+ """
286
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/table/reload.html)
287
+ [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#tablereload-method)
288
+ """
289
+
295
290
  _Table = Table
296
291
 
297
292
  class DynamoDBResourceMeta(ResourceMeta):
@@ -299,30 +294,29 @@ class DynamoDBResourceMeta(ResourceMeta):
299
294
 
300
295
  class DynamoDBServiceResource(ServiceResource):
301
296
  """
302
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource)
297
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/index.html)
303
298
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/)
304
299
  """
305
300
 
306
301
  meta: "DynamoDBResourceMeta" # type: ignore
307
302
  tables: ServiceResourceTablesCollection
308
303
 
309
- def Table(self, name: str) -> "_Table":
304
+ def get_available_subresources(self) -> Sequence[str]:
310
305
  """
311
- Creates a Table resource.
306
+ Returns a list of all the available sub-resources for this resource.
312
307
 
313
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.Table)
314
- [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#dynamodbserviceresourcetable-method)
308
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/get_available_subresources.html)
309
+ [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#dynamodbserviceresourceget_available_subresources-method)
315
310
  """
316
311
 
317
312
  def batch_get_item(
318
313
  self, **kwargs: Unpack[BatchGetItemInputServiceResourceBatchGetItemTypeDef]
319
314
  ) -> BatchGetItemOutputServiceResourceTypeDef:
320
315
  """
321
- The `BatchGetItem` operation returns the attributes of one or more items from
322
- one or more
323
- tables.
316
+ The <code>BatchGetItem</code> operation returns the attributes of one or more
317
+ items from one or more tables.
324
318
 
325
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.batch_get_item)
319
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/batch_get_item.html)
326
320
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#dynamodbserviceresourcebatch_get_item-method)
327
321
  """
328
322
 
@@ -330,10 +324,10 @@ class DynamoDBServiceResource(ServiceResource):
330
324
  self, **kwargs: Unpack[BatchWriteItemInputServiceResourceBatchWriteItemTypeDef]
331
325
  ) -> BatchWriteItemOutputServiceResourceTypeDef:
332
326
  """
333
- The `BatchWriteItem` operation puts or deletes multiple items in one or more
334
- tables.
327
+ The <code>BatchWriteItem</code> operation puts or deletes multiple items in one
328
+ or more tables.
335
329
 
336
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.batch_write_item)
330
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/batch_write_item.html)
337
331
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#dynamodbserviceresourcebatch_write_item-method)
338
332
  """
339
333
 
@@ -341,16 +335,16 @@ class DynamoDBServiceResource(ServiceResource):
341
335
  self, **kwargs: Unpack[CreateTableInputServiceResourceCreateTableTypeDef]
342
336
  ) -> "_Table":
343
337
  """
344
- The `CreateTable` operation adds a new table to your account.
338
+ The <code>CreateTable</code> operation adds a new table to your account.
345
339
 
346
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.create_table)
340
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/create_table.html)
347
341
  [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#dynamodbserviceresourcecreate_table-method)
348
342
  """
349
343
 
350
- def get_available_subresources(self) -> Sequence[str]:
344
+ def Table(self, name: str) -> "_Table":
351
345
  """
352
- Returns a list of all the available sub-resources for this Resource.
346
+ Creates a Table resource.
353
347
 
354
- [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB.ServiceResource.get_available_subresources)
355
- [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#dynamodbserviceresourceget_available_subresources-method)
348
+ [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb/service-resource/Table.html)
349
+ [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/service_resource/#dynamodbserviceresourcetable-method)
356
350
  """
@@ -10,6 +10,8 @@ Usage::
10
10
 
11
11
  data: ArchivalSummaryTypeDef = ...
12
12
  ```
13
+
14
+ Copyright 2024 Vlad Emelianov
13
15
  """
14
16
 
15
17
  import sys
@@ -43,6 +45,7 @@ from .literals import (
43
45
  InputCompressionTypeType,
44
46
  InputFormatType,
45
47
  KeyTypeType,
48
+ MultiRegionConsistencyType,
46
49
  PointInTimeRecoveryStatusType,
47
50
  ProjectionTypeType,
48
51
  ReplicaStatusType,
@@ -191,6 +194,7 @@ __all__ = (
191
194
  "GlobalSecondaryIndexTypeDef",
192
195
  "GlobalSecondaryIndexUnionTypeDef",
193
196
  "GlobalSecondaryIndexUpdateTypeDef",
197
+ "GlobalSecondaryIndexWarmThroughputDescriptionTypeDef",
194
198
  "GlobalTableDescriptionTypeDef",
195
199
  "GlobalTableGlobalSecondaryIndexSettingsUpdateTypeDef",
196
200
  "GlobalTableTypeDef",
@@ -304,6 +308,7 @@ __all__ = (
304
308
  "TableCreationParametersOutputTypeDef",
305
309
  "TableCreationParametersTypeDef",
306
310
  "TableDescriptionTypeDef",
311
+ "TableWarmThroughputDescriptionTypeDef",
307
312
  "TagResourceInputRequestTypeDef",
308
313
  "TagTypeDef",
309
314
  "TimeToLiveDescriptionTypeDef",
@@ -343,6 +348,7 @@ __all__ = (
343
348
  "UpdateTimeToLiveOutputTypeDef",
344
349
  "UpdateTypeDef",
345
350
  "WaiterConfigTypeDef",
351
+ "WarmThroughputTypeDef",
346
352
  "WriteRequestOutputTypeDef",
347
353
  "WriteRequestServiceResourceOutputTypeDef",
348
354
  "WriteRequestServiceResourceTypeDef",
@@ -485,6 +491,11 @@ class ProvisionedThroughputTypeDef(TypedDict):
485
491
  WriteCapacityUnits: int
486
492
 
487
493
 
494
+ class WarmThroughputTypeDef(TypedDict):
495
+ ReadUnitsPerSecond: NotRequired[int]
496
+ WriteUnitsPerSecond: NotRequired[int]
497
+
498
+
488
499
  ReplicaTypeDef = TypedDict(
489
500
  "ReplicaTypeDef",
490
501
  {
@@ -659,6 +670,12 @@ class GetResourcePolicyInputRequestTypeDef(TypedDict):
659
670
  ResourceArn: str
660
671
 
661
672
 
673
+ class GlobalSecondaryIndexWarmThroughputDescriptionTypeDef(TypedDict):
674
+ ReadUnitsPerSecond: NotRequired[int]
675
+ WriteUnitsPerSecond: NotRequired[int]
676
+ Status: NotRequired[IndexStatusType]
677
+
678
+
662
679
  class ProjectionOutputTypeDef(TypedDict):
663
680
  ProjectionType: NotRequired[ProjectionTypeType]
664
681
  NonKeyAttributes: NotRequired[List[str]]
@@ -743,6 +760,12 @@ class TableClassSummaryTypeDef(TypedDict):
743
760
  LastUpdateDateTime: NotRequired[datetime]
744
761
 
745
762
 
763
+ class TableWarmThroughputDescriptionTypeDef(TypedDict):
764
+ ReadUnitsPerSecond: NotRequired[int]
765
+ WriteUnitsPerSecond: NotRequired[int]
766
+ Status: NotRequired[TableStatusType]
767
+
768
+
746
769
  class RestoreSummaryTypeDef(TypedDict):
747
770
  RestoreDateTime: datetime
748
771
  RestoreInProgress: bool
@@ -1003,6 +1026,7 @@ class UpdateGlobalSecondaryIndexActionTypeDef(TypedDict):
1003
1026
  IndexName: str
1004
1027
  ProvisionedThroughput: NotRequired[ProvisionedThroughputTypeDef]
1005
1028
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
1029
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
1006
1030
 
1007
1031
 
1008
1032
  class CreateGlobalTableInputRequestTypeDef(TypedDict):
@@ -1015,12 +1039,6 @@ class GlobalTableTypeDef(TypedDict):
1015
1039
  ReplicationGroup: NotRequired[List[ReplicaTypeDef]]
1016
1040
 
1017
1041
 
1018
- class ReplicaGlobalSecondaryIndexDescriptionTypeDef(TypedDict):
1019
- IndexName: NotRequired[str]
1020
- ProvisionedThroughputOverride: NotRequired[ProvisionedThroughputOverrideTypeDef]
1021
- OnDemandThroughputOverride: NotRequired[OnDemandThroughputOverrideTypeDef]
1022
-
1023
-
1024
1042
  class ReplicaGlobalSecondaryIndexTypeDef(TypedDict):
1025
1043
  IndexName: str
1026
1044
  ProvisionedThroughputOverride: NotRequired[ProvisionedThroughputOverrideTypeDef]
@@ -1145,6 +1163,13 @@ class ListBackupsInputRequestTypeDef(TypedDict):
1145
1163
  BackupType: NotRequired[BackupTypeFilterType]
1146
1164
 
1147
1165
 
1166
+ class ReplicaGlobalSecondaryIndexDescriptionTypeDef(TypedDict):
1167
+ IndexName: NotRequired[str]
1168
+ ProvisionedThroughputOverride: NotRequired[ProvisionedThroughputOverrideTypeDef]
1169
+ OnDemandThroughputOverride: NotRequired[OnDemandThroughputOverrideTypeDef]
1170
+ WarmThroughput: NotRequired[GlobalSecondaryIndexWarmThroughputDescriptionTypeDef]
1171
+
1172
+
1148
1173
  class GlobalSecondaryIndexInfoTypeDef(TypedDict):
1149
1174
  IndexName: NotRequired[str]
1150
1175
  KeySchema: NotRequired[List[KeySchemaElementTypeDef]]
@@ -1159,6 +1184,7 @@ class GlobalSecondaryIndexOutputTypeDef(TypedDict):
1159
1184
  Projection: ProjectionOutputTypeDef
1160
1185
  ProvisionedThroughput: NotRequired[ProvisionedThroughputTypeDef]
1161
1186
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
1187
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
1162
1188
 
1163
1189
 
1164
1190
  class LocalSecondaryIndexDescriptionTypeDef(TypedDict):
@@ -1187,6 +1213,7 @@ class GlobalSecondaryIndexDescriptionTypeDef(TypedDict):
1187
1213
  ItemCount: NotRequired[int]
1188
1214
  IndexArn: NotRequired[str]
1189
1215
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
1216
+ WarmThroughput: NotRequired[GlobalSecondaryIndexWarmThroughputDescriptionTypeDef]
1190
1217
 
1191
1218
 
1192
1219
  class GlobalSecondaryIndexTypeDef(TypedDict):
@@ -1195,6 +1222,7 @@ class GlobalSecondaryIndexTypeDef(TypedDict):
1195
1222
  Projection: ProjectionTypeDef
1196
1223
  ProvisionedThroughput: NotRequired[ProvisionedThroughputTypeDef]
1197
1224
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
1225
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
1198
1226
 
1199
1227
 
1200
1228
  ProjectionUnionTypeDef = Union[ProjectionTypeDef, ProjectionOutputTypeDef]
@@ -1638,21 +1666,6 @@ class ListGlobalTablesOutputTypeDef(TypedDict):
1638
1666
  ResponseMetadata: ResponseMetadataTypeDef
1639
1667
 
1640
1668
 
1641
- ReplicaDescriptionTypeDef = TypedDict(
1642
- "ReplicaDescriptionTypeDef",
1643
- {
1644
- "RegionName": NotRequired[str],
1645
- "ReplicaStatus": NotRequired[ReplicaStatusType],
1646
- "ReplicaStatusDescription": NotRequired[str],
1647
- "ReplicaStatusPercentProgress": NotRequired[str],
1648
- "KMSMasterKeyId": NotRequired[str],
1649
- "ProvisionedThroughputOverride": NotRequired[ProvisionedThroughputOverrideTypeDef],
1650
- "OnDemandThroughputOverride": NotRequired[OnDemandThroughputOverrideTypeDef],
1651
- "GlobalSecondaryIndexes": NotRequired[List[ReplicaGlobalSecondaryIndexDescriptionTypeDef]],
1652
- "ReplicaInaccessibleDateTime": NotRequired[datetime],
1653
- "ReplicaTableClassSummary": NotRequired[TableClassSummaryTypeDef],
1654
- },
1655
- )
1656
1669
  CreateReplicationGroupMemberActionTypeDef = TypedDict(
1657
1670
  "CreateReplicationGroupMemberActionTypeDef",
1658
1671
  {
@@ -1710,6 +1723,24 @@ class ExportTableToPointInTimeInputRequestTypeDef(TypedDict):
1710
1723
  IncrementalExportSpecification: NotRequired[IncrementalExportSpecificationTypeDef]
1711
1724
 
1712
1725
 
1726
+ ReplicaDescriptionTypeDef = TypedDict(
1727
+ "ReplicaDescriptionTypeDef",
1728
+ {
1729
+ "RegionName": NotRequired[str],
1730
+ "ReplicaStatus": NotRequired[ReplicaStatusType],
1731
+ "ReplicaStatusDescription": NotRequired[str],
1732
+ "ReplicaStatusPercentProgress": NotRequired[str],
1733
+ "KMSMasterKeyId": NotRequired[str],
1734
+ "ProvisionedThroughputOverride": NotRequired[ProvisionedThroughputOverrideTypeDef],
1735
+ "OnDemandThroughputOverride": NotRequired[OnDemandThroughputOverrideTypeDef],
1736
+ "WarmThroughput": NotRequired[TableWarmThroughputDescriptionTypeDef],
1737
+ "GlobalSecondaryIndexes": NotRequired[List[ReplicaGlobalSecondaryIndexDescriptionTypeDef]],
1738
+ "ReplicaInaccessibleDateTime": NotRequired[datetime],
1739
+ "ReplicaTableClassSummary": NotRequired[TableClassSummaryTypeDef],
1740
+ },
1741
+ )
1742
+
1743
+
1713
1744
  class TableCreationParametersOutputTypeDef(TypedDict):
1714
1745
  TableName: str
1715
1746
  AttributeDefinitions: List[AttributeDefinitionTypeDef]
@@ -1740,6 +1771,7 @@ class CreateGlobalSecondaryIndexActionTypeDef(TypedDict):
1740
1771
  Projection: ProjectionUnionTypeDef
1741
1772
  ProvisionedThroughput: NotRequired[ProvisionedThroughputTypeDef]
1742
1773
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
1774
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
1743
1775
 
1744
1776
 
1745
1777
  class LocalSecondaryIndexTypeDef(TypedDict):
@@ -1973,6 +2005,12 @@ class ReplicaGlobalSecondaryIndexSettingsUpdateTypeDef(TypedDict):
1973
2005
  ProvisionedReadCapacityAutoScalingSettingsUpdate: NotRequired[AutoScalingSettingsUpdateTypeDef]
1974
2006
 
1975
2007
 
2008
+ class ReplicationGroupUpdateTypeDef(TypedDict):
2009
+ Create: NotRequired[CreateReplicationGroupMemberActionTypeDef]
2010
+ Update: NotRequired[UpdateReplicationGroupMemberActionTypeDef]
2011
+ Delete: NotRequired[DeleteReplicationGroupMemberActionTypeDef]
2012
+
2013
+
1976
2014
  class GlobalTableDescriptionTypeDef(TypedDict):
1977
2015
  ReplicationGroup: NotRequired[List[ReplicaDescriptionTypeDef]]
1978
2016
  GlobalTableArn: NotRequired[str]
@@ -2006,12 +2044,8 @@ class TableDescriptionTypeDef(TypedDict):
2006
2044
  TableClassSummary: NotRequired[TableClassSummaryTypeDef]
2007
2045
  DeletionProtectionEnabled: NotRequired[bool]
2008
2046
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
2009
-
2010
-
2011
- class ReplicationGroupUpdateTypeDef(TypedDict):
2012
- Create: NotRequired[CreateReplicationGroupMemberActionTypeDef]
2013
- Update: NotRequired[UpdateReplicationGroupMemberActionTypeDef]
2014
- Delete: NotRequired[DeleteReplicationGroupMemberActionTypeDef]
2047
+ WarmThroughput: NotRequired[TableWarmThroughputDescriptionTypeDef]
2048
+ MultiRegionConsistency: NotRequired[MultiRegionConsistencyType]
2015
2049
 
2016
2050
 
2017
2051
  class ImportTableDescriptionTypeDef(TypedDict):
@@ -2072,6 +2106,7 @@ class CreateTableInputRequestTypeDef(TypedDict):
2072
2106
  Tags: NotRequired[Sequence[TagTypeDef]]
2073
2107
  TableClass: NotRequired[TableClassType]
2074
2108
  DeletionProtectionEnabled: NotRequired[bool]
2109
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
2075
2110
  ResourcePolicy: NotRequired[str]
2076
2111
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
2077
2112
 
@@ -2089,6 +2124,7 @@ class CreateTableInputServiceResourceCreateTableTypeDef(TypedDict):
2089
2124
  Tags: NotRequired[Sequence[TagTypeDef]]
2090
2125
  TableClass: NotRequired[TableClassType]
2091
2126
  DeletionProtectionEnabled: NotRequired[bool]
2127
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
2092
2128
  ResourcePolicy: NotRequired[str]
2093
2129
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
2094
2130
 
@@ -2292,7 +2328,9 @@ class UpdateTableInputRequestTypeDef(TypedDict):
2292
2328
  ReplicaUpdates: NotRequired[Sequence[ReplicationGroupUpdateTypeDef]]
2293
2329
  TableClass: NotRequired[TableClassType]
2294
2330
  DeletionProtectionEnabled: NotRequired[bool]
2331
+ MultiRegionConsistency: NotRequired[MultiRegionConsistencyType]
2295
2332
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
2333
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
2296
2334
 
2297
2335
 
2298
2336
  class UpdateTableInputTableUpdateTypeDef(TypedDict):
@@ -2305,7 +2343,9 @@ class UpdateTableInputTableUpdateTypeDef(TypedDict):
2305
2343
  ReplicaUpdates: NotRequired[Sequence[ReplicationGroupUpdateTypeDef]]
2306
2344
  TableClass: NotRequired[TableClassType]
2307
2345
  DeletionProtectionEnabled: NotRequired[bool]
2346
+ MultiRegionConsistency: NotRequired[MultiRegionConsistencyType]
2308
2347
  OnDemandThroughput: NotRequired[OnDemandThroughputTypeDef]
2348
+ WarmThroughput: NotRequired[WarmThroughputTypeDef]
2309
2349
 
2310
2350
 
2311
2351
  WriteRequestUnionTypeDef = Union[WriteRequestTypeDef, WriteRequestOutputTypeDef]