aws-sdk-dynamodb 1.2.0 → 1.3.0

Sign up to get free protection for your applications and to get access to all the features.
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