aws-sdk-dynamodb 1.2.0 → 1.3.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 2468c7fbb6fa0dd6df1289b1da98304e28998130
4
- data.tar.gz: f583a56343d7ed3225fab3ff9c530777d04fed0b
3
+ metadata.gz: c297fd9c2cba62284e16a8037c25c2a707254b35
4
+ data.tar.gz: fd20ab0c77b14576086037e986d57a9aa494169e
5
5
  SHA512:
6
- metadata.gz: 95fbd56b43c71a079e7c094761b18c2e719506a699920190c94951b629c35bda51374021e8e13509254fb954b2a393e1a93a7e7265f4d58ad442612a6232d317
7
- data.tar.gz: 13d4c74fc6b44a4be2b6861592359f8b73920bac6120e7593c4475ff4a41dc58ac0bd71f6be0c2d56f3ce9794bcb213238e7e35bb951a341ca78d58fb2daca53
6
+ metadata.gz: f44bfdd581a8983b9b7ffcdf04b6b03d98401a1c36942aaf1c59d136c3b6395b3a0a764268717aef6669988d8946226b413ebbe88334c48b7c999c9bdf42ab50
7
+ data.tar.gz: b52d8a140664fa5de5bafe6349318edb9052d06b1a56c8017d812601f5cf99708e24e592ff28296ae591db98ff2e02a7c216a6999541e82e7c0a28b343d35c86
@@ -44,6 +44,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
44
44
  # @service
45
45
  module Aws::DynamoDB
46
46
 
47
- GEM_VERSION = '1.2.0'
47
+ GEM_VERSION = '1.3.0'
48
48
 
49
49
  end
@@ -732,6 +732,131 @@ module Aws::DynamoDB
732
732
  req.send_request(options)
733
733
  end
734
734
 
735
+ # Creates a backup for an existing table.
736
+ #
737
+ # Each time you create an On-Demand Backup, the entire table data is
738
+ # backed up. There is no limit to the number of on-demand backups that
739
+ # can be taken.
740
+ #
741
+ # You can call `CreateBackup` at a maximum rate of 50 times per second.
742
+ #
743
+ # All backups in DynamoDB work without consuming any provisioned
744
+ # throughput on the table. This results in a fast, low-cost, and
745
+ # scalable backup process. In general, the larger the table, the more
746
+ # time it takes to back up. The backup is stored in an S3 data store
747
+ # that is maintained and managed by DynamoDB.
748
+ #
749
+ # Backups incorporate all writes (delete, put, update) that were
750
+ # completed within the last minute before the backup request was
751
+ # initiated. Backups might include some writes (delete, put, update)
752
+ # that were completed before the backup request was finished.
753
+ #
754
+ # For example, if you submit the backup request on 2018-12-14 at
755
+ # 14:25:00, the backup is guaranteed to contain all data committed to
756
+ # the table up to 14:24:00, and data committed after 14:26:00 will not
757
+ # be. The backup may or may not contain data modifications made between
758
+ # 14:24:00 and 14:26:00. On-Demand Backup does not support causal
759
+ # consistency.
760
+ #
761
+ # Along with data, the following are also included on the backups:
762
+ #
763
+ # * Global secondary indexes (GSIs)
764
+ #
765
+ # * Local secondary indexes (LSIs)
766
+ #
767
+ # * Streams
768
+ #
769
+ # * Provisioned read and write capacity
770
+ #
771
+ # @option params [required, String] :table_name
772
+ # The name of the table.
773
+ #
774
+ # @option params [required, String] :backup_name
775
+ # Specified name for the backup.
776
+ #
777
+ # @return [Types::CreateBackupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
778
+ #
779
+ # * {Types::CreateBackupOutput#backup_details #backup_details} => Types::BackupDetails
780
+ #
781
+ # @example Request syntax with placeholder values
782
+ #
783
+ # resp = client.create_backup({
784
+ # table_name: "TableName", # required
785
+ # backup_name: "BackupName", # required
786
+ # })
787
+ #
788
+ # @example Response structure
789
+ #
790
+ # resp.backup_details.backup_arn #=> String
791
+ # resp.backup_details.backup_name #=> String
792
+ # resp.backup_details.backup_size_bytes #=> Integer
793
+ # resp.backup_details.backup_status #=> String, one of "CREATING", "DELETED", "AVAILABLE"
794
+ # resp.backup_details.backup_creation_date_time #=> Time
795
+ #
796
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateBackup AWS API Documentation
797
+ #
798
+ # @overload create_backup(params = {})
799
+ # @param [Hash] params ({})
800
+ def create_backup(params = {}, options = {})
801
+ req = build_request(:create_backup, params)
802
+ req.send_request(options)
803
+ end
804
+
805
+ # Creates a global table from an existing table. A global table creates
806
+ # a replication relationship between two or more DynamoDB tables with
807
+ # the same table name in the provided regions.
808
+ #
809
+ # Tables can only be added as the replicas of a global table group under
810
+ # the following conditions:
811
+ #
812
+ # * The tables must have the same name.
813
+ #
814
+ # * The tables must contain no items.
815
+ #
816
+ # * The tables must have the same hash key and sort key (if present).
817
+ #
818
+ # * The tables must have DynamoDB Streams enabled
819
+ # (NEW\_AND\_OLD\_IMAGES).
820
+ #
821
+ # @option params [required, String] :global_table_name
822
+ # The global table name.
823
+ #
824
+ # @option params [required, Array<Types::Replica>] :replication_group
825
+ # The regions where the global table needs to be created.
826
+ #
827
+ # @return [Types::CreateGlobalTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
828
+ #
829
+ # * {Types::CreateGlobalTableOutput#global_table_description #global_table_description} => Types::GlobalTableDescription
830
+ #
831
+ # @example Request syntax with placeholder values
832
+ #
833
+ # resp = client.create_global_table({
834
+ # global_table_name: "TableName", # required
835
+ # replication_group: [ # required
836
+ # {
837
+ # region_name: "RegionName",
838
+ # },
839
+ # ],
840
+ # })
841
+ #
842
+ # @example Response structure
843
+ #
844
+ # resp.global_table_description.replication_group #=> Array
845
+ # resp.global_table_description.replication_group[0].region_name #=> String
846
+ # resp.global_table_description.global_table_arn #=> String
847
+ # resp.global_table_description.creation_date_time #=> Time
848
+ # resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
849
+ # resp.global_table_description.global_table_name #=> String
850
+ #
851
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateGlobalTable AWS API Documentation
852
+ #
853
+ # @overload create_global_table(params = {})
854
+ # @param [Hash] params ({})
855
+ def create_global_table(params = {}, options = {})
856
+ req = build_request(:create_global_table, params)
857
+ req.send_request(options)
858
+ end
859
+
735
860
  # The `CreateTable` operation adds a new table to your account. In an
736
861
  # AWS account, table names must be unique within each region. That is,
737
862
  # you can have two tables with same name if you create the tables in
@@ -1070,6 +1195,7 @@ module Aws::DynamoDB
1070
1195
  # resp.table_description.table_size_bytes #=> Integer
1071
1196
  # resp.table_description.item_count #=> Integer
1072
1197
  # resp.table_description.table_arn #=> String
1198
+ # resp.table_description.table_id #=> String
1073
1199
  # resp.table_description.local_secondary_indexes #=> Array
1074
1200
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
1075
1201
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -1103,6 +1229,10 @@ module Aws::DynamoDB
1103
1229
  # resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
1104
1230
  # resp.table_description.latest_stream_label #=> String
1105
1231
  # resp.table_description.latest_stream_arn #=> String
1232
+ # resp.table_description.restore_summary.source_backup_arn #=> String
1233
+ # resp.table_description.restore_summary.source_table_arn #=> String
1234
+ # resp.table_description.restore_summary.restore_date_time #=> Time
1235
+ # resp.table_description.restore_summary.restore_in_progress #=> Boolean
1106
1236
  #
1107
1237
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTable AWS API Documentation
1108
1238
  #
@@ -1113,6 +1243,73 @@ module Aws::DynamoDB
1113
1243
  req.send_request(options)
1114
1244
  end
1115
1245
 
1246
+ # Deletes an existing backup of a table.
1247
+ #
1248
+ # You can call `DeleteBackup` at a maximum rate of 10 times per second.
1249
+ #
1250
+ # @option params [required, String] :backup_arn
1251
+ # The ARN associated with the backup.
1252
+ #
1253
+ # @return [Types::DeleteBackupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1254
+ #
1255
+ # * {Types::DeleteBackupOutput#backup_description #backup_description} => Types::BackupDescription
1256
+ #
1257
+ # @example Request syntax with placeholder values
1258
+ #
1259
+ # resp = client.delete_backup({
1260
+ # backup_arn: "BackupArn", # required
1261
+ # })
1262
+ #
1263
+ # @example Response structure
1264
+ #
1265
+ # resp.backup_description.backup_details.backup_arn #=> String
1266
+ # resp.backup_description.backup_details.backup_name #=> String
1267
+ # resp.backup_description.backup_details.backup_size_bytes #=> Integer
1268
+ # resp.backup_description.backup_details.backup_status #=> String, one of "CREATING", "DELETED", "AVAILABLE"
1269
+ # resp.backup_description.backup_details.backup_creation_date_time #=> Time
1270
+ # resp.backup_description.source_table_details.table_name #=> String
1271
+ # resp.backup_description.source_table_details.table_id #=> String
1272
+ # resp.backup_description.source_table_details.table_arn #=> String
1273
+ # resp.backup_description.source_table_details.table_size_bytes #=> Integer
1274
+ # resp.backup_description.source_table_details.key_schema #=> Array
1275
+ # resp.backup_description.source_table_details.key_schema[0].attribute_name #=> String
1276
+ # resp.backup_description.source_table_details.key_schema[0].key_type #=> String, one of "HASH", "RANGE"
1277
+ # resp.backup_description.source_table_details.table_creation_date_time #=> Time
1278
+ # resp.backup_description.source_table_details.provisioned_throughput.read_capacity_units #=> Integer
1279
+ # resp.backup_description.source_table_details.provisioned_throughput.write_capacity_units #=> Integer
1280
+ # resp.backup_description.source_table_details.item_count #=> Integer
1281
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes #=> Array
1282
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].index_name #=> String
1283
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema #=> Array
1284
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema[0].attribute_name #=> String
1285
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
1286
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
1287
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].projection.non_key_attributes #=> Array
1288
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].projection.non_key_attributes[0] #=> String
1289
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes #=> Array
1290
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].index_name #=> String
1291
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].key_schema #=> Array
1292
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].key_schema[0].attribute_name #=> String
1293
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
1294
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
1295
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.non_key_attributes #=> Array
1296
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
1297
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
1298
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
1299
+ # resp.backup_description.source_table_feature_details.stream_description.stream_enabled #=> Boolean
1300
+ # resp.backup_description.source_table_feature_details.stream_description.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
1301
+ # resp.backup_description.source_table_feature_details.time_to_live_description.time_to_live_status #=> String, one of "ENABLING", "DISABLING", "ENABLED", "DISABLED"
1302
+ # resp.backup_description.source_table_feature_details.time_to_live_description.attribute_name #=> String
1303
+ #
1304
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteBackup AWS API Documentation
1305
+ #
1306
+ # @overload delete_backup(params = {})
1307
+ # @param [Hash] params ({})
1308
+ def delete_backup(params = {}, options = {})
1309
+ req = build_request(:delete_backup, params)
1310
+ req.send_request(options)
1311
+ end
1312
+
1116
1313
  # Deletes a single item in a table by primary key. You can perform a
1117
1314
  # conditional delete operation that deletes the item if it exists, or if
1118
1315
  # it has an expected attribute value.
@@ -1461,6 +1658,7 @@ module Aws::DynamoDB
1461
1658
  # resp.table_description.table_size_bytes #=> Integer
1462
1659
  # resp.table_description.item_count #=> Integer
1463
1660
  # resp.table_description.table_arn #=> String
1661
+ # resp.table_description.table_id #=> String
1464
1662
  # resp.table_description.local_secondary_indexes #=> Array
1465
1663
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
1466
1664
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -1494,6 +1692,10 @@ module Aws::DynamoDB
1494
1692
  # resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
1495
1693
  # resp.table_description.latest_stream_label #=> String
1496
1694
  # resp.table_description.latest_stream_arn #=> String
1695
+ # resp.table_description.restore_summary.source_backup_arn #=> String
1696
+ # resp.table_description.restore_summary.source_table_arn #=> String
1697
+ # resp.table_description.restore_summary.restore_date_time #=> Time
1698
+ # resp.table_description.restore_summary.restore_in_progress #=> Boolean
1497
1699
  #
1498
1700
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTable AWS API Documentation
1499
1701
  #
@@ -1504,6 +1706,141 @@ module Aws::DynamoDB
1504
1706
  req.send_request(options)
1505
1707
  end
1506
1708
 
1709
+ # Describes an existing backup of a table.
1710
+ #
1711
+ # You can call `DescribeBackup` at a maximum rate of 10 times per
1712
+ # second.
1713
+ #
1714
+ # @option params [required, String] :backup_arn
1715
+ # The ARN associated with the backup.
1716
+ #
1717
+ # @return [Types::DescribeBackupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1718
+ #
1719
+ # * {Types::DescribeBackupOutput#backup_description #backup_description} => Types::BackupDescription
1720
+ #
1721
+ # @example Request syntax with placeholder values
1722
+ #
1723
+ # resp = client.describe_backup({
1724
+ # backup_arn: "BackupArn", # required
1725
+ # })
1726
+ #
1727
+ # @example Response structure
1728
+ #
1729
+ # resp.backup_description.backup_details.backup_arn #=> String
1730
+ # resp.backup_description.backup_details.backup_name #=> String
1731
+ # resp.backup_description.backup_details.backup_size_bytes #=> Integer
1732
+ # resp.backup_description.backup_details.backup_status #=> String, one of "CREATING", "DELETED", "AVAILABLE"
1733
+ # resp.backup_description.backup_details.backup_creation_date_time #=> Time
1734
+ # resp.backup_description.source_table_details.table_name #=> String
1735
+ # resp.backup_description.source_table_details.table_id #=> String
1736
+ # resp.backup_description.source_table_details.table_arn #=> String
1737
+ # resp.backup_description.source_table_details.table_size_bytes #=> Integer
1738
+ # resp.backup_description.source_table_details.key_schema #=> Array
1739
+ # resp.backup_description.source_table_details.key_schema[0].attribute_name #=> String
1740
+ # resp.backup_description.source_table_details.key_schema[0].key_type #=> String, one of "HASH", "RANGE"
1741
+ # resp.backup_description.source_table_details.table_creation_date_time #=> Time
1742
+ # resp.backup_description.source_table_details.provisioned_throughput.read_capacity_units #=> Integer
1743
+ # resp.backup_description.source_table_details.provisioned_throughput.write_capacity_units #=> Integer
1744
+ # resp.backup_description.source_table_details.item_count #=> Integer
1745
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes #=> Array
1746
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].index_name #=> String
1747
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema #=> Array
1748
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema[0].attribute_name #=> String
1749
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
1750
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
1751
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].projection.non_key_attributes #=> Array
1752
+ # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].projection.non_key_attributes[0] #=> String
1753
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes #=> Array
1754
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].index_name #=> String
1755
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].key_schema #=> Array
1756
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].key_schema[0].attribute_name #=> String
1757
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
1758
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
1759
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.non_key_attributes #=> Array
1760
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
1761
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
1762
+ # resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
1763
+ # resp.backup_description.source_table_feature_details.stream_description.stream_enabled #=> Boolean
1764
+ # resp.backup_description.source_table_feature_details.stream_description.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
1765
+ # resp.backup_description.source_table_feature_details.time_to_live_description.time_to_live_status #=> String, one of "ENABLING", "DISABLING", "ENABLED", "DISABLED"
1766
+ # resp.backup_description.source_table_feature_details.time_to_live_description.attribute_name #=> String
1767
+ #
1768
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeBackup AWS API Documentation
1769
+ #
1770
+ # @overload describe_backup(params = {})
1771
+ # @param [Hash] params ({})
1772
+ def describe_backup(params = {}, options = {})
1773
+ req = build_request(:describe_backup, params)
1774
+ req.send_request(options)
1775
+ end
1776
+
1777
+ # Checks the status of the backup restore settings on the specified
1778
+ # table. If backups are enabled, `ContinuousBackupsStatus` will bet set
1779
+ # to ENABLED.
1780
+ #
1781
+ # You can call `DescribeContinuousBackups` at a maximum rate of 10 times
1782
+ # per second.
1783
+ #
1784
+ # @option params [required, String] :table_name
1785
+ # Name of the table for which the customer wants to check the backup and
1786
+ # restore settings.
1787
+ #
1788
+ # @return [Types::DescribeContinuousBackupsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1789
+ #
1790
+ # * {Types::DescribeContinuousBackupsOutput#continuous_backups_description #continuous_backups_description} => Types::ContinuousBackupsDescription
1791
+ #
1792
+ # @example Request syntax with placeholder values
1793
+ #
1794
+ # resp = client.describe_continuous_backups({
1795
+ # table_name: "TableName", # required
1796
+ # })
1797
+ #
1798
+ # @example Response structure
1799
+ #
1800
+ # resp.continuous_backups_description.continuous_backups_status #=> String, one of "ENABLED", "DISABLED"
1801
+ #
1802
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeContinuousBackups AWS API Documentation
1803
+ #
1804
+ # @overload describe_continuous_backups(params = {})
1805
+ # @param [Hash] params ({})
1806
+ def describe_continuous_backups(params = {}, options = {})
1807
+ req = build_request(:describe_continuous_backups, params)
1808
+ req.send_request(options)
1809
+ end
1810
+
1811
+ # Returns information about the global table.
1812
+ #
1813
+ # @option params [required, String] :global_table_name
1814
+ # The name of the global table.
1815
+ #
1816
+ # @return [Types::DescribeGlobalTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1817
+ #
1818
+ # * {Types::DescribeGlobalTableOutput#global_table_description #global_table_description} => Types::GlobalTableDescription
1819
+ #
1820
+ # @example Request syntax with placeholder values
1821
+ #
1822
+ # resp = client.describe_global_table({
1823
+ # global_table_name: "TableName", # required
1824
+ # })
1825
+ #
1826
+ # @example Response structure
1827
+ #
1828
+ # resp.global_table_description.replication_group #=> Array
1829
+ # resp.global_table_description.replication_group[0].region_name #=> String
1830
+ # resp.global_table_description.global_table_arn #=> String
1831
+ # resp.global_table_description.creation_date_time #=> Time
1832
+ # resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
1833
+ # resp.global_table_description.global_table_name #=> String
1834
+ #
1835
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeGlobalTable AWS API Documentation
1836
+ #
1837
+ # @overload describe_global_table(params = {})
1838
+ # @param [Hash] params ({})
1839
+ def describe_global_table(params = {}, options = {})
1840
+ req = build_request(:describe_global_table, params)
1841
+ req.send_request(options)
1842
+ end
1843
+
1507
1844
  # Returns the current provisioned-capacity limits for your AWS account
1508
1845
  # in a region, both for the region as a whole and for any one DynamoDB
1509
1846
  # table that you create there.
@@ -1703,6 +2040,7 @@ module Aws::DynamoDB
1703
2040
  # resp.table.table_size_bytes #=> Integer
1704
2041
  # resp.table.item_count #=> Integer
1705
2042
  # resp.table.table_arn #=> String
2043
+ # resp.table.table_id #=> String
1706
2044
  # resp.table.local_secondary_indexes #=> Array
1707
2045
  # resp.table.local_secondary_indexes[0].index_name #=> String
1708
2046
  # resp.table.local_secondary_indexes[0].key_schema #=> Array
@@ -1736,6 +2074,10 @@ module Aws::DynamoDB
1736
2074
  # resp.table.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
1737
2075
  # resp.table.latest_stream_label #=> String
1738
2076
  # resp.table.latest_stream_arn #=> String
2077
+ # resp.table.restore_summary.source_backup_arn #=> String
2078
+ # resp.table.restore_summary.source_table_arn #=> String
2079
+ # resp.table.restore_summary.restore_date_time #=> Time
2080
+ # resp.table.restore_summary.restore_in_progress #=> Boolean
1739
2081
  #
1740
2082
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTable AWS API Documentation
1741
2083
  #
@@ -1973,6 +2315,114 @@ module Aws::DynamoDB
1973
2315
  req.send_request(options)
1974
2316
  end
1975
2317
 
2318
+ # List backups associated with an AWS account. To list backups for a
2319
+ # given table, specify `TableName`. `ListBackups` returns a paginated
2320
+ # list of results with at most 1MB worth of items in a page. You can
2321
+ # also specify a limit for the maximum number of entries to be returned
2322
+ # in a page.
2323
+ #
2324
+ # In the request, start time is inclusive but end time is exclusive.
2325
+ # Note that these limits are for the time at which the original backup
2326
+ # was requested.
2327
+ #
2328
+ # You can call `ListBackups` a maximum of 5 times per second.
2329
+ #
2330
+ # @option params [String] :table_name
2331
+ # The backups from the table specified by TableName are listed.
2332
+ #
2333
+ # @option params [Integer] :limit
2334
+ # Maximum number of backups to return at once.
2335
+ #
2336
+ # @option params [Time,DateTime,Date,Integer,String] :time_range_lower_bound
2337
+ # Only backups created after this time are listed. `TimeRangeLowerBound`
2338
+ # is inclusive.
2339
+ #
2340
+ # @option params [Time,DateTime,Date,Integer,String] :time_range_upper_bound
2341
+ # Only backups created before this time are listed.
2342
+ # `TimeRangeUpperBound` is exclusive.
2343
+ #
2344
+ # @option params [String] :exclusive_start_backup_arn
2345
+ # `LastEvaluatedBackupARN` returned by the previous ListBackups call.
2346
+ #
2347
+ # @return [Types::ListBackupsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2348
+ #
2349
+ # * {Types::ListBackupsOutput#backup_summaries #backup_summaries} => Array&lt;Types::BackupSummary&gt;
2350
+ # * {Types::ListBackupsOutput#last_evaluated_backup_arn #last_evaluated_backup_arn} => String
2351
+ #
2352
+ # @example Request syntax with placeholder values
2353
+ #
2354
+ # resp = client.list_backups({
2355
+ # table_name: "TableName",
2356
+ # limit: 1,
2357
+ # time_range_lower_bound: Time.now,
2358
+ # time_range_upper_bound: Time.now,
2359
+ # exclusive_start_backup_arn: "BackupArn",
2360
+ # })
2361
+ #
2362
+ # @example Response structure
2363
+ #
2364
+ # resp.backup_summaries #=> Array
2365
+ # resp.backup_summaries[0].table_name #=> String
2366
+ # resp.backup_summaries[0].table_id #=> String
2367
+ # resp.backup_summaries[0].table_arn #=> String
2368
+ # resp.backup_summaries[0].backup_arn #=> String
2369
+ # resp.backup_summaries[0].backup_name #=> String
2370
+ # resp.backup_summaries[0].backup_creation_date_time #=> Time
2371
+ # resp.backup_summaries[0].backup_status #=> String, one of "CREATING", "DELETED", "AVAILABLE"
2372
+ # resp.backup_summaries[0].backup_size_bytes #=> Integer
2373
+ # resp.last_evaluated_backup_arn #=> String
2374
+ #
2375
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListBackups AWS API Documentation
2376
+ #
2377
+ # @overload list_backups(params = {})
2378
+ # @param [Hash] params ({})
2379
+ def list_backups(params = {}, options = {})
2380
+ req = build_request(:list_backups, params)
2381
+ req.send_request(options)
2382
+ end
2383
+
2384
+ # Lists all the global tables. Only those global tables that have
2385
+ # replicas in the region specified as input are returned.
2386
+ #
2387
+ # @option params [String] :exclusive_start_global_table_name
2388
+ # The first global table name that this operation will evaluate.
2389
+ #
2390
+ # @option params [Integer] :limit
2391
+ # The maximum number of table names to return.
2392
+ #
2393
+ # @option params [String] :region_name
2394
+ # Lists the global tables in a specific region.
2395
+ #
2396
+ # @return [Types::ListGlobalTablesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2397
+ #
2398
+ # * {Types::ListGlobalTablesOutput#global_tables #global_tables} => Array&lt;Types::GlobalTable&gt;
2399
+ # * {Types::ListGlobalTablesOutput#last_evaluated_global_table_name #last_evaluated_global_table_name} => String
2400
+ #
2401
+ # @example Request syntax with placeholder values
2402
+ #
2403
+ # resp = client.list_global_tables({
2404
+ # exclusive_start_global_table_name: "TableName",
2405
+ # limit: 1,
2406
+ # region_name: "RegionName",
2407
+ # })
2408
+ #
2409
+ # @example Response structure
2410
+ #
2411
+ # resp.global_tables #=> Array
2412
+ # resp.global_tables[0].global_table_name #=> String
2413
+ # resp.global_tables[0].replication_group #=> Array
2414
+ # resp.global_tables[0].replication_group[0].region_name #=> String
2415
+ # resp.last_evaluated_global_table_name #=> String
2416
+ #
2417
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListGlobalTables AWS API Documentation
2418
+ #
2419
+ # @overload list_global_tables(params = {})
2420
+ # @param [Hash] params ({})
2421
+ def list_global_tables(params = {}, options = {})
2422
+ req = build_request(:list_global_tables, params)
2423
+ req.send_request(options)
2424
+ end
2425
+
1976
2426
  # Returns an array of table names associated with the current account
1977
2427
  # and endpoint. The output from `ListTables` is paginated, with each
1978
2428
  # page returning a maximum of 100 table names.
@@ -2940,6 +3390,108 @@ module Aws::DynamoDB
2940
3390
  req.send_request(options)
2941
3391
  end
2942
3392
 
3393
+ # Creates a new table from an existing backup. Any number of users can
3394
+ # execute up to 10 concurrent restores in a given account.
3395
+ #
3396
+ # You can call `RestoreTableFromBackup` at a maximum rate of 10 times
3397
+ # per second.
3398
+ #
3399
+ # You must manually set up the following on the restored table:
3400
+ #
3401
+ # * Auto scaling policies
3402
+ #
3403
+ # * IAM policies
3404
+ #
3405
+ # * Cloudwatch metrics and alarms
3406
+ #
3407
+ # * Tags
3408
+ #
3409
+ # * Time to Live (TTL) settings
3410
+ #
3411
+ # @option params [required, String] :target_table_name
3412
+ # The name of the new table to which the backup must be restored.
3413
+ #
3414
+ # @option params [required, String] :backup_arn
3415
+ # The ARN associated with the backup.
3416
+ #
3417
+ # @return [Types::RestoreTableFromBackupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3418
+ #
3419
+ # * {Types::RestoreTableFromBackupOutput#table_description #table_description} => Types::TableDescription
3420
+ #
3421
+ # @example Request syntax with placeholder values
3422
+ #
3423
+ # resp = client.restore_table_from_backup({
3424
+ # target_table_name: "TableName", # required
3425
+ # backup_arn: "BackupArn", # required
3426
+ # })
3427
+ #
3428
+ # @example Response structure
3429
+ #
3430
+ # resp.table_description.attribute_definitions #=> Array
3431
+ # resp.table_description.attribute_definitions[0].attribute_name #=> String
3432
+ # resp.table_description.attribute_definitions[0].attribute_type #=> String, one of "S", "N", "B"
3433
+ # resp.table_description.table_name #=> String
3434
+ # resp.table_description.key_schema #=> Array
3435
+ # resp.table_description.key_schema[0].attribute_name #=> String
3436
+ # resp.table_description.key_schema[0].key_type #=> String, one of "HASH", "RANGE"
3437
+ # resp.table_description.table_status #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE"
3438
+ # resp.table_description.creation_date_time #=> Time
3439
+ # resp.table_description.provisioned_throughput.last_increase_date_time #=> Time
3440
+ # resp.table_description.provisioned_throughput.last_decrease_date_time #=> Time
3441
+ # resp.table_description.provisioned_throughput.number_of_decreases_today #=> Integer
3442
+ # resp.table_description.provisioned_throughput.read_capacity_units #=> Integer
3443
+ # resp.table_description.provisioned_throughput.write_capacity_units #=> Integer
3444
+ # resp.table_description.table_size_bytes #=> Integer
3445
+ # resp.table_description.item_count #=> Integer
3446
+ # resp.table_description.table_arn #=> String
3447
+ # resp.table_description.table_id #=> String
3448
+ # resp.table_description.local_secondary_indexes #=> Array
3449
+ # resp.table_description.local_secondary_indexes[0].index_name #=> String
3450
+ # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
3451
+ # resp.table_description.local_secondary_indexes[0].key_schema[0].attribute_name #=> String
3452
+ # resp.table_description.local_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
3453
+ # resp.table_description.local_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
3454
+ # resp.table_description.local_secondary_indexes[0].projection.non_key_attributes #=> Array
3455
+ # resp.table_description.local_secondary_indexes[0].projection.non_key_attributes[0] #=> String
3456
+ # resp.table_description.local_secondary_indexes[0].index_size_bytes #=> Integer
3457
+ # resp.table_description.local_secondary_indexes[0].item_count #=> Integer
3458
+ # resp.table_description.local_secondary_indexes[0].index_arn #=> String
3459
+ # resp.table_description.global_secondary_indexes #=> Array
3460
+ # resp.table_description.global_secondary_indexes[0].index_name #=> String
3461
+ # resp.table_description.global_secondary_indexes[0].key_schema #=> Array
3462
+ # resp.table_description.global_secondary_indexes[0].key_schema[0].attribute_name #=> String
3463
+ # resp.table_description.global_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
3464
+ # resp.table_description.global_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
3465
+ # resp.table_description.global_secondary_indexes[0].projection.non_key_attributes #=> Array
3466
+ # resp.table_description.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
3467
+ # resp.table_description.global_secondary_indexes[0].index_status #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE"
3468
+ # resp.table_description.global_secondary_indexes[0].backfilling #=> Boolean
3469
+ # resp.table_description.global_secondary_indexes[0].provisioned_throughput.last_increase_date_time #=> Time
3470
+ # resp.table_description.global_secondary_indexes[0].provisioned_throughput.last_decrease_date_time #=> Time
3471
+ # resp.table_description.global_secondary_indexes[0].provisioned_throughput.number_of_decreases_today #=> Integer
3472
+ # resp.table_description.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
3473
+ # resp.table_description.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
3474
+ # resp.table_description.global_secondary_indexes[0].index_size_bytes #=> Integer
3475
+ # resp.table_description.global_secondary_indexes[0].item_count #=> Integer
3476
+ # resp.table_description.global_secondary_indexes[0].index_arn #=> String
3477
+ # resp.table_description.stream_specification.stream_enabled #=> Boolean
3478
+ # resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
3479
+ # resp.table_description.latest_stream_label #=> String
3480
+ # resp.table_description.latest_stream_arn #=> String
3481
+ # resp.table_description.restore_summary.source_backup_arn #=> String
3482
+ # resp.table_description.restore_summary.source_table_arn #=> String
3483
+ # resp.table_description.restore_summary.restore_date_time #=> Time
3484
+ # resp.table_description.restore_summary.restore_in_progress #=> Boolean
3485
+ #
3486
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableFromBackup AWS API Documentation
3487
+ #
3488
+ # @overload restore_table_from_backup(params = {})
3489
+ # @param [Hash] params ({})
3490
+ def restore_table_from_backup(params = {}, options = {})
3491
+ req = build_request(:restore_table_from_backup, params)
3492
+ req.send_request(options)
3493
+ end
3494
+
2943
3495
  # The `Scan` operation returns one or more items and item attributes by
2944
3496
  # accessing every item in a table or a secondary index. To have DynamoDB
2945
3497
  # return fewer items, you can provide a `FilterExpression` operation.
@@ -3461,6 +4013,55 @@ module Aws::DynamoDB
3461
4013
  req.send_request(options)
3462
4014
  end
3463
4015
 
4016
+ # Adds or removes replicas to the specified global table. The global
4017
+ # table should already exist to be able to use this operation.
4018
+ # Currently, the replica to be added should be empty.
4019
+ #
4020
+ # @option params [required, String] :global_table_name
4021
+ # The global table name.
4022
+ #
4023
+ # @option params [required, Array<Types::ReplicaUpdate>] :replica_updates
4024
+ # A list of regions that should be added or removed from the global
4025
+ # table.
4026
+ #
4027
+ # @return [Types::UpdateGlobalTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4028
+ #
4029
+ # * {Types::UpdateGlobalTableOutput#global_table_description #global_table_description} => Types::GlobalTableDescription
4030
+ #
4031
+ # @example Request syntax with placeholder values
4032
+ #
4033
+ # resp = client.update_global_table({
4034
+ # global_table_name: "TableName", # required
4035
+ # replica_updates: [ # required
4036
+ # {
4037
+ # create: {
4038
+ # region_name: "RegionName", # required
4039
+ # },
4040
+ # delete: {
4041
+ # region_name: "RegionName", # required
4042
+ # },
4043
+ # },
4044
+ # ],
4045
+ # })
4046
+ #
4047
+ # @example Response structure
4048
+ #
4049
+ # resp.global_table_description.replication_group #=> Array
4050
+ # resp.global_table_description.replication_group[0].region_name #=> String
4051
+ # resp.global_table_description.global_table_arn #=> String
4052
+ # resp.global_table_description.creation_date_time #=> Time
4053
+ # resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
4054
+ # resp.global_table_description.global_table_name #=> String
4055
+ #
4056
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateGlobalTable AWS API Documentation
4057
+ #
4058
+ # @overload update_global_table(params = {})
4059
+ # @param [Hash] params ({})
4060
+ def update_global_table(params = {}, options = {})
4061
+ req = build_request(:update_global_table, params)
4062
+ req.send_request(options)
4063
+ end
4064
+
3464
4065
  # Edits an existing item's attributes, or adds a new item to the table
3465
4066
  # if it does not already exist. You can put, delete, or add attribute
3466
4067
  # values. You can also perform a conditional update on an existing item
@@ -4048,6 +4649,7 @@ module Aws::DynamoDB
4048
4649
  # resp.table_description.table_size_bytes #=> Integer
4049
4650
  # resp.table_description.item_count #=> Integer
4050
4651
  # resp.table_description.table_arn #=> String
4652
+ # resp.table_description.table_id #=> String
4051
4653
  # resp.table_description.local_secondary_indexes #=> Array
4052
4654
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
4053
4655
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -4081,6 +4683,10 @@ module Aws::DynamoDB
4081
4683
  # resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
4082
4684
  # resp.table_description.latest_stream_label #=> String
4083
4685
  # resp.table_description.latest_stream_arn #=> String
4686
+ # resp.table_description.restore_summary.source_backup_arn #=> String
4687
+ # resp.table_description.restore_summary.source_table_arn #=> String
4688
+ # resp.table_description.restore_summary.restore_date_time #=> Time
4689
+ # resp.table_description.restore_summary.restore_in_progress #=> Boolean
4084
4690
  #
4085
4691
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTable AWS API Documentation
4086
4692
  #
@@ -4176,7 +4782,7 @@ module Aws::DynamoDB
4176
4782
  params: params,
4177
4783
  config: config)
4178
4784
  context[:gem_name] = 'aws-sdk-dynamodb'
4179
- context[:gem_version] = '1.2.0'
4785
+ context[:gem_version] = '1.3.0'
4180
4786
  Seahorse::Client::Request.new(handlers, context)
4181
4787
  end
4182
4788