aws-sdk 2.1395.0 → 2.1396.0

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.
@@ -86,6 +86,12 @@
86
86
  "input_token": "NextToken",
87
87
  "limit_key": "MaxResults",
88
88
  "output_token": "NextToken"
89
+ },
90
+ "ListUsers": {
91
+ "input_token": "NextToken",
92
+ "limit_key": "MaxResults",
93
+ "output_token": "NextToken",
94
+ "result_key": "Users"
89
95
  }
90
96
  }
91
97
  }
@@ -20,11 +20,11 @@ declare class AmplifyUIBuilder extends Service {
20
20
  */
21
21
  createComponent(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.CreateComponentResponse) => void): Request<AmplifyUIBuilder.Types.CreateComponentResponse, AWSError>;
22
22
  /**
23
- * Creates a new form for an Amplify app.
23
+ * Creates a new form for an Amplify.
24
24
  */
25
25
  createForm(params: AmplifyUIBuilder.Types.CreateFormRequest, callback?: (err: AWSError, data: AmplifyUIBuilder.Types.CreateFormResponse) => void): Request<AmplifyUIBuilder.Types.CreateFormResponse, AWSError>;
26
26
  /**
27
- * Creates a new form for an Amplify app.
27
+ * Creates a new form for an Amplify.
28
28
  */
29
29
  createForm(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.CreateFormResponse) => void): Request<AmplifyUIBuilder.Types.CreateFormResponse, AWSError>;
30
30
  /**
@@ -91,6 +91,14 @@ declare class AmplifyUIBuilder extends Service {
91
91
  * Exports theme configurations to code that is ready to integrate into an Amplify app.
92
92
  */
93
93
  exportThemes(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.ExportThemesResponse) => void): Request<AmplifyUIBuilder.Types.ExportThemesResponse, AWSError>;
94
+ /**
95
+ * Returns an existing code generation job.
96
+ */
97
+ getCodegenJob(params: AmplifyUIBuilder.Types.GetCodegenJobRequest, callback?: (err: AWSError, data: AmplifyUIBuilder.Types.GetCodegenJobResponse) => void): Request<AmplifyUIBuilder.Types.GetCodegenJobResponse, AWSError>;
98
+ /**
99
+ * Returns an existing code generation job.
100
+ */
101
+ getCodegenJob(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.GetCodegenJobResponse) => void): Request<AmplifyUIBuilder.Types.GetCodegenJobResponse, AWSError>;
94
102
  /**
95
103
  * Returns an existing component for an Amplify app.
96
104
  */
@@ -123,6 +131,14 @@ declare class AmplifyUIBuilder extends Service {
123
131
  * Returns an existing theme for an Amplify app.
124
132
  */
125
133
  getTheme(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.GetThemeResponse) => void): Request<AmplifyUIBuilder.Types.GetThemeResponse, AWSError>;
134
+ /**
135
+ * Retrieves a list of code generation jobs for a specified Amplify app and backend environment.
136
+ */
137
+ listCodegenJobs(params: AmplifyUIBuilder.Types.ListCodegenJobsRequest, callback?: (err: AWSError, data: AmplifyUIBuilder.Types.ListCodegenJobsResponse) => void): Request<AmplifyUIBuilder.Types.ListCodegenJobsResponse, AWSError>;
138
+ /**
139
+ * Retrieves a list of code generation jobs for a specified Amplify app and backend environment.
140
+ */
141
+ listCodegenJobs(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.ListCodegenJobsResponse) => void): Request<AmplifyUIBuilder.Types.ListCodegenJobsResponse, AWSError>;
126
142
  /**
127
143
  * Retrieves a list of components for a specified Amplify app and backend environment.
128
144
  */
@@ -163,6 +179,14 @@ declare class AmplifyUIBuilder extends Service {
163
179
  * Refreshes a previously issued access token that might have expired.
164
180
  */
165
181
  refreshToken(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.RefreshTokenResponse) => void): Request<AmplifyUIBuilder.Types.RefreshTokenResponse, AWSError>;
182
+ /**
183
+ * Starts a code generation job for for a specified Amplify app and backend environment.
184
+ */
185
+ startCodegenJob(params: AmplifyUIBuilder.Types.StartCodegenJobRequest, callback?: (err: AWSError, data: AmplifyUIBuilder.Types.StartCodegenJobResponse) => void): Request<AmplifyUIBuilder.Types.StartCodegenJobResponse, AWSError>;
186
+ /**
187
+ * Starts a code generation job for for a specified Amplify app and backend environment.
188
+ */
189
+ startCodegenJob(callback?: (err: AWSError, data: AmplifyUIBuilder.Types.StartCodegenJobResponse) => void): Request<AmplifyUIBuilder.Types.StartCodegenJobResponse, AWSError>;
166
190
  /**
167
191
  * Updates an existing component.
168
192
  */
@@ -227,7 +251,217 @@ declare namespace AmplifyUIBuilder {
227
251
  */
228
252
  state?: MutationActionSetStateParameter;
229
253
  }
254
+ export type AppId = string;
255
+ export type AssociatedFieldsList = String[];
230
256
  export type Boolean = boolean;
257
+ export interface CodegenFeatureFlags {
258
+ /**
259
+ * Specifes whether a code generation job supports data relationships.
260
+ */
261
+ isRelationshipSupported?: Boolean;
262
+ /**
263
+ * Specifies whether a code generation job supports non models.
264
+ */
265
+ isNonModelSupported?: Boolean;
266
+ }
267
+ export interface CodegenGenericDataEnum {
268
+ /**
269
+ * The list of enum values in the generic data schema.
270
+ */
271
+ values: CodegenGenericDataEnumValuesList;
272
+ }
273
+ export type CodegenGenericDataEnumValuesList = String[];
274
+ export type CodegenGenericDataEnums = {[key: string]: CodegenGenericDataEnum};
275
+ export interface CodegenGenericDataField {
276
+ /**
277
+ * The data type for the generic data field.
278
+ */
279
+ dataType: CodegenGenericDataFieldDataType;
280
+ /**
281
+ * The value of the data type for the generic data field.
282
+ */
283
+ dataTypeValue: String;
284
+ /**
285
+ * Specifies whether the generic data field is required.
286
+ */
287
+ required: Boolean;
288
+ /**
289
+ * Specifies whether the generic data field is read-only.
290
+ */
291
+ readOnly: Boolean;
292
+ /**
293
+ * Specifies whether the generic data field is an array.
294
+ */
295
+ isArray: Boolean;
296
+ /**
297
+ * The relationship of the generic data schema.
298
+ */
299
+ relationship?: CodegenGenericDataRelationshipType;
300
+ }
301
+ export type CodegenGenericDataFieldDataType = "ID"|"String"|"Int"|"Float"|"AWSDate"|"AWSTime"|"AWSDateTime"|"AWSTimestamp"|"AWSEmail"|"AWSURL"|"AWSIPAddress"|"Boolean"|"AWSJSON"|"AWSPhone"|"Enum"|"Model"|"NonModel"|string;
302
+ export type CodegenGenericDataFields = {[key: string]: CodegenGenericDataField};
303
+ export interface CodegenGenericDataModel {
304
+ /**
305
+ * The fields in the generic data model.
306
+ */
307
+ fields: CodegenGenericDataFields;
308
+ /**
309
+ * Specifies whether the generic data model is a join table.
310
+ */
311
+ isJoinTable?: Boolean;
312
+ /**
313
+ * The primary keys of the generic data model.
314
+ */
315
+ primaryKeys: CodegenPrimaryKeysList;
316
+ }
317
+ export type CodegenGenericDataModels = {[key: string]: CodegenGenericDataModel};
318
+ export interface CodegenGenericDataNonModel {
319
+ /**
320
+ * The fields in a generic data schema non model.
321
+ */
322
+ fields: CodegenGenericDataNonModelFields;
323
+ }
324
+ export type CodegenGenericDataNonModelFields = {[key: string]: CodegenGenericDataField};
325
+ export type CodegenGenericDataNonModels = {[key: string]: CodegenGenericDataNonModel};
326
+ export interface CodegenGenericDataRelationshipType {
327
+ /**
328
+ * The data relationship type.
329
+ */
330
+ type: GenericDataRelationshipType;
331
+ /**
332
+ * The name of the related model in the data relationship.
333
+ */
334
+ relatedModelName: String;
335
+ /**
336
+ * The related model fields in the data relationship.
337
+ */
338
+ relatedModelFields?: RelatedModelFieldsList;
339
+ /**
340
+ * Specifies whether the relationship can unlink the associated model.
341
+ */
342
+ canUnlinkAssociatedModel?: Boolean;
343
+ /**
344
+ * The name of the related join field in the data relationship.
345
+ */
346
+ relatedJoinFieldName?: String;
347
+ /**
348
+ * The name of the related join table in the data relationship.
349
+ */
350
+ relatedJoinTableName?: String;
351
+ /**
352
+ * The value of the belongsTo field on the related data model.
353
+ */
354
+ belongsToFieldOnRelatedModel?: String;
355
+ /**
356
+ * The associated fields of the data relationship.
357
+ */
358
+ associatedFields?: AssociatedFieldsList;
359
+ /**
360
+ * Specifies whether the @index directive is supported for a hasMany data relationship.
361
+ */
362
+ isHasManyIndex?: Boolean;
363
+ }
364
+ export interface CodegenJob {
365
+ /**
366
+ * The unique ID for the code generation job.
367
+ */
368
+ id: Uuid;
369
+ /**
370
+ * The ID of the Amplify app associated with the code generation job.
371
+ */
372
+ appId: AppId;
373
+ /**
374
+ * The name of the backend environment associated with the code generation job.
375
+ */
376
+ environmentName: String;
377
+ renderConfig?: CodegenJobRenderConfig;
378
+ genericDataSchema?: CodegenJobGenericDataSchema;
379
+ /**
380
+ * Specifies whether to autogenerate forms in the code generation job.
381
+ */
382
+ autoGenerateForms?: Boolean;
383
+ features?: CodegenFeatureFlags;
384
+ /**
385
+ * The status of the code generation job.
386
+ */
387
+ status?: CodegenJobStatus;
388
+ /**
389
+ * The customized status message for the code generation job.
390
+ */
391
+ statusMessage?: String;
392
+ /**
393
+ * The CodegenJobAsset to use for the code generation job.
394
+ */
395
+ asset?: CodegenJobAsset;
396
+ /**
397
+ * One or more key-value pairs to use when tagging the code generation job.
398
+ */
399
+ tags?: Tags;
400
+ /**
401
+ * The time that the code generation job was created.
402
+ */
403
+ createdAt?: SyntheticTimestamp_date_time;
404
+ /**
405
+ * The time that the code generation job was modified.
406
+ */
407
+ modifiedAt?: SyntheticTimestamp_date_time;
408
+ }
409
+ export interface CodegenJobAsset {
410
+ /**
411
+ * The URL to use to access the asset.
412
+ */
413
+ downloadUrl?: String;
414
+ }
415
+ export interface CodegenJobGenericDataSchema {
416
+ /**
417
+ * The type of the data source for the schema. Currently, the only valid value is an Amplify DataStore.
418
+ */
419
+ dataSourceType: CodegenJobGenericDataSourceType;
420
+ /**
421
+ * The name of a CodegenGenericDataModel.
422
+ */
423
+ models: CodegenGenericDataModels;
424
+ /**
425
+ * The name of a CodegenGenericDataEnum.
426
+ */
427
+ enums: CodegenGenericDataEnums;
428
+ /**
429
+ * The name of a CodegenGenericDataNonModel.
430
+ */
431
+ nonModels: CodegenGenericDataNonModels;
432
+ }
433
+ export type CodegenJobGenericDataSourceType = "DataStore"|string;
434
+ export interface CodegenJobRenderConfig {
435
+ /**
436
+ * The name of the ReactStartCodegenJobData object.
437
+ */
438
+ react?: ReactStartCodegenJobData;
439
+ }
440
+ export type CodegenJobStatus = "in_progress"|"failed"|"succeeded"|string;
441
+ export interface CodegenJobSummary {
442
+ /**
443
+ * The unique ID of the Amplify app associated with the code generation job.
444
+ */
445
+ appId: AppId;
446
+ /**
447
+ * The name of the backend environment associated with the code generation job.
448
+ */
449
+ environmentName: String;
450
+ /**
451
+ * The unique ID for the code generation job summary.
452
+ */
453
+ id: Uuid;
454
+ /**
455
+ * The time that the code generation job summary was created.
456
+ */
457
+ createdAt?: SyntheticTimestamp_date_time;
458
+ /**
459
+ * The time that the code generation job summary was modified.
460
+ */
461
+ modifiedAt?: SyntheticTimestamp_date_time;
462
+ }
463
+ export type CodegenJobSummaryList = CodegenJobSummary[];
464
+ export type CodegenPrimaryKeysList = String[];
231
465
  export interface Component {
232
466
  /**
233
467
  * The unique ID of the Amplify app associated with the component.
@@ -1241,6 +1475,27 @@ declare namespace AmplifyUIBuilder {
1241
1475
  name: FormName;
1242
1476
  }
1243
1477
  export type FormSummaryList = FormSummary[];
1478
+ export type GenericDataRelationshipType = "HAS_MANY"|"HAS_ONE"|"BELONGS_TO"|string;
1479
+ export interface GetCodegenJobRequest {
1480
+ /**
1481
+ * The unique ID of the Amplify app associated with the code generation job.
1482
+ */
1483
+ appId: AppId;
1484
+ /**
1485
+ * The name of the backend environment that is a part of the Amplify app associated with the code generation job.
1486
+ */
1487
+ environmentName: String;
1488
+ /**
1489
+ * The unique ID of the code generation job.
1490
+ */
1491
+ id: Uuid;
1492
+ }
1493
+ export interface GetCodegenJobResponse {
1494
+ /**
1495
+ * The configuration settings for the code generation job.
1496
+ */
1497
+ job?: CodegenJob;
1498
+ }
1244
1499
  export interface GetComponentRequest {
1245
1500
  /**
1246
1501
  * The unique ID of the Amplify app.
@@ -1319,7 +1574,39 @@ declare namespace AmplifyUIBuilder {
1319
1574
  }
1320
1575
  export type IdentifierList = String[];
1321
1576
  export type Integer = number;
1577
+ export type JSModule = "es2020"|"esnext"|string;
1578
+ export type JSScript = "jsx"|"tsx"|"js"|string;
1579
+ export type JSTarget = "es2015"|"es2020"|string;
1322
1580
  export type LabelDecorator = "required"|"optional"|"none"|string;
1581
+ export type ListCodegenJobsLimit = number;
1582
+ export interface ListCodegenJobsRequest {
1583
+ /**
1584
+ * The unique ID for the Amplify app.
1585
+ */
1586
+ appId: AppId;
1587
+ /**
1588
+ * The name of the backend environment that is a part of the Amplify app.
1589
+ */
1590
+ environmentName: String;
1591
+ /**
1592
+ * The token to request the next page of results.
1593
+ */
1594
+ nextToken?: String;
1595
+ /**
1596
+ * The maximum number of jobs to retrieve.
1597
+ */
1598
+ maxResults?: ListCodegenJobsLimit;
1599
+ }
1600
+ export interface ListCodegenJobsResponse {
1601
+ /**
1602
+ * The list of code generation jobs for the Amplify app.
1603
+ */
1604
+ entities: CodegenJobSummaryList;
1605
+ /**
1606
+ * The pagination token that's included if more results are available.
1607
+ */
1608
+ nextToken?: String;
1609
+ }
1323
1610
  export type ListComponentsLimit = number;
1324
1611
  export interface ListComponentsRequest {
1325
1612
  /**
@@ -1474,6 +1761,28 @@ declare namespace AmplifyUIBuilder {
1474
1761
  */
1475
1762
  body: PutMetadataFlagBody;
1476
1763
  }
1764
+ export interface ReactStartCodegenJobData {
1765
+ /**
1766
+ * The JavaScript module type.
1767
+ */
1768
+ module?: JSModule;
1769
+ /**
1770
+ * The ECMAScript specification to use.
1771
+ */
1772
+ target?: JSTarget;
1773
+ /**
1774
+ * The file type to use for a JavaScript project.
1775
+ */
1776
+ script?: JSScript;
1777
+ /**
1778
+ * Specifies whether the code generation job should render type declaration files.
1779
+ */
1780
+ renderTypeDeclarations?: Boolean;
1781
+ /**
1782
+ * Specifies whether the code generation job should render inline source maps.
1783
+ */
1784
+ inlineSourceMap?: Boolean;
1785
+ }
1477
1786
  export interface RefreshTokenRequest {
1478
1787
  /**
1479
1788
  * The third-party provider for the token. The only valid value is figma.
@@ -1504,6 +1813,7 @@ declare namespace AmplifyUIBuilder {
1504
1813
  */
1505
1814
  expiresIn: Integer;
1506
1815
  }
1816
+ export type RelatedModelFieldsList = String[];
1507
1817
  export interface SectionalElement {
1508
1818
  /**
1509
1819
  * The type of sectional element. Valid values are Heading, Text, and Divider.
@@ -1544,6 +1854,52 @@ declare namespace AmplifyUIBuilder {
1544
1854
  direction: SortDirection;
1545
1855
  }
1546
1856
  export type SortPropertyList = SortProperty[];
1857
+ export interface StartCodegenJobData {
1858
+ /**
1859
+ * The code generation configuration for the codegen job.
1860
+ */
1861
+ renderConfig: CodegenJobRenderConfig;
1862
+ /**
1863
+ * The data schema to use for a code generation job.
1864
+ */
1865
+ genericDataSchema?: CodegenJobGenericDataSchema;
1866
+ /**
1867
+ * Specifies whether to autogenerate forms in the code generation job.
1868
+ */
1869
+ autoGenerateForms?: Boolean;
1870
+ /**
1871
+ * The feature flags for a code generation job.
1872
+ */
1873
+ features?: CodegenFeatureFlags;
1874
+ /**
1875
+ * One or more key-value pairs to use when tagging the code generation job data.
1876
+ */
1877
+ tags?: Tags;
1878
+ }
1879
+ export interface StartCodegenJobRequest {
1880
+ /**
1881
+ * The unique ID for the Amplify app.
1882
+ */
1883
+ appId: AppId;
1884
+ /**
1885
+ * The name of the backend environment that is a part of the Amplify app.
1886
+ */
1887
+ environmentName: String;
1888
+ /**
1889
+ * The idempotency token used to ensure that the code generation job request completes only once.
1890
+ */
1891
+ clientToken?: String;
1892
+ /**
1893
+ * The code generation job resource configuration.
1894
+ */
1895
+ codegenJobToCreate: StartCodegenJobData;
1896
+ }
1897
+ export interface StartCodegenJobResponse {
1898
+ /**
1899
+ * The code generation job for a UI component that is associated with an Amplify app.
1900
+ */
1901
+ entity?: CodegenJob;
1902
+ }
1547
1903
  export type StorageAccessLevel = "public"|"protected"|"private"|string;
1548
1904
  export type StrValues = String[];
1549
1905
  export type String = string;
@@ -23,11 +23,11 @@ declare class DynamoDB extends DynamoDBCustomizations {
23
23
  */
24
24
  batchExecuteStatement(callback?: (err: AWSError, data: DynamoDB.Types.BatchExecuteStatementOutput) => void): Request<DynamoDB.Types.BatchExecuteStatementOutput, AWSError>;
25
25
  /**
26
- * The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items. BatchGetItem returns a partial result if the response size limit is exceeded, the table's provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned, the operation returns a value for UnprocessedKeys. You can use this value to retry the operation starting with the next item to get. If you request more than 100 items, BatchGetItem returns a ValidationException with the message "Too many items requested for the BatchGetItem call." For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52 items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so you can get the next page of results. If desired, your application can include its own logic to assemble the pages of results into one dataset. If none of the items can be processed due to insufficient provisioned throughput on all of the tables in the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If at least one of the items is successfully processed, then BatchGetItem completes successfully, while returning the keys of the unread items in UnprocessedKeys. If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If you delay the batch operation using exponential backoff, the individual requests in the batch are much more likely to succeed. For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide. By default, BatchGetItem performs eventually consistent reads on every table in the request. If you want strongly consistent reads instead, you can set ConsistentRead to true for any or all tables. In order to minimize response latency, BatchGetItem may retrieve items in parallel. When designing your application, keep in mind that DynamoDB does not return items in any particular order. To help parse the response by item, include the primary key values for the items in your request in the ProjectionExpression parameter. If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
26
+ * The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items. BatchGetItem returns a partial result if the response size limit is exceeded, the table's provisioned throughput is exceeded, more than 1MB per partition is requested, or an internal processing failure occurs. If a partial result is returned, the operation returns a value for UnprocessedKeys. You can use this value to retry the operation starting with the next item to get. If you request more than 100 items, BatchGetItem returns a ValidationException with the message "Too many items requested for the BatchGetItem call." For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52 items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so you can get the next page of results. If desired, your application can include its own logic to assemble the pages of results into one dataset. If none of the items can be processed due to insufficient provisioned throughput on all of the tables in the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If at least one of the items is successfully processed, then BatchGetItem completes successfully, while returning the keys of the unread items in UnprocessedKeys. If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If you delay the batch operation using exponential backoff, the individual requests in the batch are much more likely to succeed. For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide. By default, BatchGetItem performs eventually consistent reads on every table in the request. If you want strongly consistent reads instead, you can set ConsistentRead to true for any or all tables. In order to minimize response latency, BatchGetItem may retrieve items in parallel. When designing your application, keep in mind that DynamoDB does not return items in any particular order. To help parse the response by item, include the primary key values for the items in your request in the ProjectionExpression parameter. If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
27
27
  */
28
28
  batchGetItem(params: DynamoDB.Types.BatchGetItemInput, callback?: (err: AWSError, data: DynamoDB.Types.BatchGetItemOutput) => void): Request<DynamoDB.Types.BatchGetItemOutput, AWSError>;
29
29
  /**
30
- * The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items. BatchGetItem returns a partial result if the response size limit is exceeded, the table's provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned, the operation returns a value for UnprocessedKeys. You can use this value to retry the operation starting with the next item to get. If you request more than 100 items, BatchGetItem returns a ValidationException with the message "Too many items requested for the BatchGetItem call." For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52 items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so you can get the next page of results. If desired, your application can include its own logic to assemble the pages of results into one dataset. If none of the items can be processed due to insufficient provisioned throughput on all of the tables in the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If at least one of the items is successfully processed, then BatchGetItem completes successfully, while returning the keys of the unread items in UnprocessedKeys. If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If you delay the batch operation using exponential backoff, the individual requests in the batch are much more likely to succeed. For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide. By default, BatchGetItem performs eventually consistent reads on every table in the request. If you want strongly consistent reads instead, you can set ConsistentRead to true for any or all tables. In order to minimize response latency, BatchGetItem may retrieve items in parallel. When designing your application, keep in mind that DynamoDB does not return items in any particular order. To help parse the response by item, include the primary key values for the items in your request in the ProjectionExpression parameter. If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
30
+ * The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items. BatchGetItem returns a partial result if the response size limit is exceeded, the table's provisioned throughput is exceeded, more than 1MB per partition is requested, or an internal processing failure occurs. If a partial result is returned, the operation returns a value for UnprocessedKeys. You can use this value to retry the operation starting with the next item to get. If you request more than 100 items, BatchGetItem returns a ValidationException with the message "Too many items requested for the BatchGetItem call." For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52 items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so you can get the next page of results. If desired, your application can include its own logic to assemble the pages of results into one dataset. If none of the items can be processed due to insufficient provisioned throughput on all of the tables in the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If at least one of the items is successfully processed, then BatchGetItem completes successfully, while returning the keys of the unread items in UnprocessedKeys. If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If you delay the batch operation using exponential backoff, the individual requests in the batch are much more likely to succeed. For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide. By default, BatchGetItem performs eventually consistent reads on every table in the request. If you want strongly consistent reads instead, you can set ConsistentRead to true for any or all tables. In order to minimize response latency, BatchGetItem may retrieve items in parallel. When designing your application, keep in mind that DynamoDB does not return items in any particular order. To help parse the response by item, include the primary key values for the items in your request in the ProjectionExpression parameter. If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
31
31
  */
32
32
  batchGetItem(callback?: (err: AWSError, data: DynamoDB.Types.BatchGetItemOutput) => void): Request<DynamoDB.Types.BatchGetItemOutput, AWSError>;
33
33
  /**
@@ -226,7 +226,7 @@ declare namespace DynamoDBStreams {
226
226
  */
227
227
  eventVersion?: String;
228
228
  /**
229
- * The AWS service from which the stream record originated. For DynamoDB Streams, this is aws:dynamodb.
229
+ * The Amazon Web Services service from which the stream record originated. For DynamoDB Streams, this is aws:dynamodb.
230
230
  */
231
231
  eventSource?: String;
232
232
  /**
@@ -282,7 +282,7 @@ declare namespace DynamoDBStreams {
282
282
  */
283
283
  TableName?: TableName;
284
284
  /**
285
- * A timestamp, in ISO 8601 format, for this stream. Note that LatestStreamLabel is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique: the AWS customer ID. the table name the StreamLabel
285
+ * A timestamp, in ISO 8601 format, for this stream. Note that LatestStreamLabel is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique: the Amazon Web Services customer ID. the table name the StreamLabel
286
286
  */
287
287
  StreamLabel?: String;
288
288
  }
@@ -293,7 +293,7 @@ declare namespace DynamoDBStreams {
293
293
  */
294
294
  StreamArn?: StreamArn;
295
295
  /**
296
- * A timestamp, in ISO 8601 format, for this stream. Note that LatestStreamLabel is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique: the AWS customer ID. the table name the StreamLabel
296
+ * A timestamp, in ISO 8601 format, for this stream. Note that LatestStreamLabel is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique: the Amazon Web Services customer ID. the table name the StreamLabel
297
297
  */
298
298
  StreamLabel?: String;
299
299
  /**
@@ -328,7 +328,7 @@ declare namespace DynamoDBStreams {
328
328
  export type StreamList = Stream[];
329
329
  export interface StreamRecord {
330
330
  /**
331
- * The approximate date and time when the stream record was created, in UNIX epoch time format.
331
+ * The approximate date and time when the stream record was created, in UNIX epoch time format and rounded down to the closest second.
332
332
  */
333
333
  ApproximateCreationDateTime?: _Date;
334
334
  /**