aws-sdk-docdb 1.26.0 → 1.31.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
  SHA256:
3
- metadata.gz: f9f3c2a08f1c743f21dcdd57daa895e245b59e501b9f58d1ea4d8fb432ef6a87
4
- data.tar.gz: 929a2b88c64bb10db486c5708c6e57356cdd8201ef17d1e98b12f6f21a5c1a40
3
+ metadata.gz: b0bf10d800e8d42431d3d8e40536c4c1c37c5c7d811b4d33862cf956160d8b40
4
+ data.tar.gz: 8ef2fa74fba68ea739aa006b47df699923dd21c9517d813c07d35a86cd1877a8
5
5
  SHA512:
6
- metadata.gz: 8c3768d9a04aa43e5bb81db2442cc6ea96434b98a52fa5471cd2f74f9c39d618c9eb298c94405f8497e133e778ab2c93b74766e0c9fa574b5ff55472b000c2d1
7
- data.tar.gz: cd92d30f51a2d6b3a96af8b595bd8c1978435b5a3a285e489a117c097c775416e694d457b1f753229a4bf994337774af3b4d8a93000a84351a2683e92f23de0c
6
+ metadata.gz: 8b09fe0d84e59ca4ef46b3093dfa8c4ab88a21522a8fc79669f6bbe51c62a5328754c19aeeacf83fb05c3b63d492deafc2c52bb7ff7aba0ac3a058dc1c10cfa1
7
+ data.tar.gz: 744bbaa3e86ee776b13aeffc458c0ae9a1939f1cf2f5b4c87822e25ea8d9072ff4b20d299dc08e6d79751ad5666ca801408daf5aeba1038481375bffb1450318
data/CHANGELOG.md ADDED
@@ -0,0 +1,168 @@
1
+ Unreleased Changes
2
+ ------------------
3
+
4
+ 1.31.0 (2021-06-02)
5
+ ------------------
6
+
7
+ * Feature - This SDK release adds support for DocDB global clusters.
8
+
9
+ 1.30.0 (2021-03-29)
10
+ ------------------
11
+
12
+ * Feature - This release adds support for Event Subscriptions to DocumentDB.
13
+
14
+ 1.29.0 (2021-03-10)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.28.0 (2021-02-02)
20
+ ------------------
21
+
22
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
23
+
24
+ 1.27.0 (2020-12-04)
25
+ ------------------
26
+
27
+ * Feature - Support `pre_signed_url` generation for `CopyDBClusterSnapshot` and `CreateDBCluster`.
28
+
29
+ 1.26.0 (2020-10-19)
30
+ ------------------
31
+
32
+ * Feature - Documentation updates for docdb
33
+
34
+ 1.25.0 (2020-09-30)
35
+ ------------------
36
+
37
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
38
+
39
+ 1.24.0 (2020-09-25)
40
+ ------------------
41
+
42
+ * Feature - Documentation updates for docdb
43
+
44
+ 1.23.0 (2020-09-15)
45
+ ------------------
46
+
47
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
48
+
49
+ 1.22.0 (2020-09-14)
50
+ ------------------
51
+
52
+ * Feature - Updated API documentation and added paginators for DescribeCertificates, DescribeDBClusterParameterGroups, DescribeDBClusterParameters, DescribeDBClusterSnapshots and DescribePendingMaintenanceActions
53
+
54
+ 1.21.0 (2020-08-25)
55
+ ------------------
56
+
57
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
58
+
59
+ 1.20.0 (2020-07-02)
60
+ ------------------
61
+
62
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
63
+
64
+ 1.19.0 (2020-06-23)
65
+ ------------------
66
+
67
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
68
+
69
+ 1.18.1 (2020-06-11)
70
+ ------------------
71
+
72
+ * Issue - Republish previous version with correct dependency on `aws-sdk-core`.
73
+
74
+ 1.18.0 (2020-06-10)
75
+ ------------------
76
+
77
+ * Issue - This version has been yanked. (#2327).
78
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
79
+
80
+ 1.17.0 (2020-05-28)
81
+ ------------------
82
+
83
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
84
+
85
+ 1.16.0 (2020-05-07)
86
+ ------------------
87
+
88
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
89
+
90
+ 1.15.0 (2020-03-09)
91
+ ------------------
92
+
93
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
94
+
95
+ 1.14.0 (2020-02-24)
96
+ ------------------
97
+
98
+ * Feature - Documentation updates for docdb
99
+
100
+ 1.13.0 (2020-02-10)
101
+ ------------------
102
+
103
+ * Feature - Added clarifying information that Amazon DocumentDB shares operational technology with Amazon RDS and Amazon Neptune.
104
+
105
+ 1.12.0 (2019-10-23)
106
+ ------------------
107
+
108
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
109
+
110
+ 1.11.0 (2019-10-01)
111
+ ------------------
112
+
113
+ * Feature - This release provides support for describe and modify CA certificates.
114
+
115
+ 1.10.0 (2019-07-25)
116
+ ------------------
117
+
118
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
119
+
120
+ 1.9.0 (2019-07-01)
121
+ ------------------
122
+
123
+ * Feature - This release provides support for cluster delete protection and the ability to stop and start clusters.
124
+
125
+ 1.8.0 (2019-06-17)
126
+ ------------------
127
+
128
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
129
+
130
+ 1.7.0 (2019-05-21)
131
+ ------------------
132
+
133
+ * Feature - API update.
134
+
135
+ 1.6.0 (2019-05-15)
136
+ ------------------
137
+
138
+ * Feature - API update.
139
+
140
+ 1.5.0 (2019-05-14)
141
+ ------------------
142
+
143
+ * Feature - API update.
144
+
145
+ 1.4.0 (2019-03-22)
146
+ ------------------
147
+
148
+ * Feature - API update.
149
+
150
+ 1.3.0 (2019-03-21)
151
+ ------------------
152
+
153
+ * Feature - API update.
154
+
155
+ 1.2.0 (2019-03-18)
156
+ ------------------
157
+
158
+ * Feature - API update.
159
+
160
+ 1.1.0 (2019-03-14)
161
+ ------------------
162
+
163
+ * Feature - API update.
164
+
165
+ 1.0.0 (2019-01-09)
166
+ ------------------
167
+
168
+ * Feature - Initial release of `aws-sdk-docdb`.
data/LICENSE.txt ADDED
@@ -0,0 +1,202 @@
1
+
2
+ Apache License
3
+ Version 2.0, January 2004
4
+ http://www.apache.org/licenses/
5
+
6
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7
+
8
+ 1. Definitions.
9
+
10
+ "License" shall mean the terms and conditions for use, reproduction,
11
+ and distribution as defined by Sections 1 through 9 of this document.
12
+
13
+ "Licensor" shall mean the copyright owner or entity authorized by
14
+ the copyright owner that is granting the License.
15
+
16
+ "Legal Entity" shall mean the union of the acting entity and all
17
+ other entities that control, are controlled by, or are under common
18
+ control with that entity. For the purposes of this definition,
19
+ "control" means (i) the power, direct or indirect, to cause the
20
+ direction or management of such entity, whether by contract or
21
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
22
+ outstanding shares, or (iii) beneficial ownership of such entity.
23
+
24
+ "You" (or "Your") shall mean an individual or Legal Entity
25
+ exercising permissions granted by this License.
26
+
27
+ "Source" form shall mean the preferred form for making modifications,
28
+ including but not limited to software source code, documentation
29
+ source, and configuration files.
30
+
31
+ "Object" form shall mean any form resulting from mechanical
32
+ transformation or translation of a Source form, including but
33
+ not limited to compiled object code, generated documentation,
34
+ and conversions to other media types.
35
+
36
+ "Work" shall mean the work of authorship, whether in Source or
37
+ Object form, made available under the License, as indicated by a
38
+ copyright notice that is included in or attached to the work
39
+ (an example is provided in the Appendix below).
40
+
41
+ "Derivative Works" shall mean any work, whether in Source or Object
42
+ form, that is based on (or derived from) the Work and for which the
43
+ editorial revisions, annotations, elaborations, or other modifications
44
+ represent, as a whole, an original work of authorship. For the purposes
45
+ of this License, Derivative Works shall not include works that remain
46
+ separable from, or merely link (or bind by name) to the interfaces of,
47
+ the Work and Derivative Works thereof.
48
+
49
+ "Contribution" shall mean any work of authorship, including
50
+ the original version of the Work and any modifications or additions
51
+ to that Work or Derivative Works thereof, that is intentionally
52
+ submitted to Licensor for inclusion in the Work by the copyright owner
53
+ or by an individual or Legal Entity authorized to submit on behalf of
54
+ the copyright owner. For the purposes of this definition, "submitted"
55
+ means any form of electronic, verbal, or written communication sent
56
+ to the Licensor or its representatives, including but not limited to
57
+ communication on electronic mailing lists, source code control systems,
58
+ and issue tracking systems that are managed by, or on behalf of, the
59
+ Licensor for the purpose of discussing and improving the Work, but
60
+ excluding communication that is conspicuously marked or otherwise
61
+ designated in writing by the copyright owner as "Not a Contribution."
62
+
63
+ "Contributor" shall mean Licensor and any individual or Legal Entity
64
+ on behalf of whom a Contribution has been received by Licensor and
65
+ subsequently incorporated within the Work.
66
+
67
+ 2. Grant of Copyright License. Subject to the terms and conditions of
68
+ this License, each Contributor hereby grants to You a perpetual,
69
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70
+ copyright license to reproduce, prepare Derivative Works of,
71
+ publicly display, publicly perform, sublicense, and distribute the
72
+ Work and such Derivative Works in Source or Object form.
73
+
74
+ 3. Grant of Patent License. Subject to the terms and conditions of
75
+ this License, each Contributor hereby grants to You a perpetual,
76
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77
+ (except as stated in this section) patent license to make, have made,
78
+ use, offer to sell, sell, import, and otherwise transfer the Work,
79
+ where such license applies only to those patent claims licensable
80
+ by such Contributor that are necessarily infringed by their
81
+ Contribution(s) alone or by combination of their Contribution(s)
82
+ with the Work to which such Contribution(s) was submitted. If You
83
+ institute patent litigation against any entity (including a
84
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
85
+ or a Contribution incorporated within the Work constitutes direct
86
+ or contributory patent infringement, then any patent licenses
87
+ granted to You under this License for that Work shall terminate
88
+ as of the date such litigation is filed.
89
+
90
+ 4. Redistribution. You may reproduce and distribute copies of the
91
+ Work or Derivative Works thereof in any medium, with or without
92
+ modifications, and in Source or Object form, provided that You
93
+ meet the following conditions:
94
+
95
+ (a) You must give any other recipients of the Work or
96
+ Derivative Works a copy of this License; and
97
+
98
+ (b) You must cause any modified files to carry prominent notices
99
+ stating that You changed the files; and
100
+
101
+ (c) You must retain, in the Source form of any Derivative Works
102
+ that You distribute, all copyright, patent, trademark, and
103
+ attribution notices from the Source form of the Work,
104
+ excluding those notices that do not pertain to any part of
105
+ the Derivative Works; and
106
+
107
+ (d) If the Work includes a "NOTICE" text file as part of its
108
+ distribution, then any Derivative Works that You distribute must
109
+ include a readable copy of the attribution notices contained
110
+ within such NOTICE file, excluding those notices that do not
111
+ pertain to any part of the Derivative Works, in at least one
112
+ of the following places: within a NOTICE text file distributed
113
+ as part of the Derivative Works; within the Source form or
114
+ documentation, if provided along with the Derivative Works; or,
115
+ within a display generated by the Derivative Works, if and
116
+ wherever such third-party notices normally appear. The contents
117
+ of the NOTICE file are for informational purposes only and
118
+ do not modify the License. You may add Your own attribution
119
+ notices within Derivative Works that You distribute, alongside
120
+ or as an addendum to the NOTICE text from the Work, provided
121
+ that such additional attribution notices cannot be construed
122
+ as modifying the License.
123
+
124
+ You may add Your own copyright statement to Your modifications and
125
+ may provide additional or different license terms and conditions
126
+ for use, reproduction, or distribution of Your modifications, or
127
+ for any such Derivative Works as a whole, provided Your use,
128
+ reproduction, and distribution of the Work otherwise complies with
129
+ the conditions stated in this License.
130
+
131
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
132
+ any Contribution intentionally submitted for inclusion in the Work
133
+ by You to the Licensor shall be under the terms and conditions of
134
+ this License, without any additional terms or conditions.
135
+ Notwithstanding the above, nothing herein shall supersede or modify
136
+ the terms of any separate license agreement you may have executed
137
+ with Licensor regarding such Contributions.
138
+
139
+ 6. Trademarks. This License does not grant permission to use the trade
140
+ names, trademarks, service marks, or product names of the Licensor,
141
+ except as required for reasonable and customary use in describing the
142
+ origin of the Work and reproducing the content of the NOTICE file.
143
+
144
+ 7. Disclaimer of Warranty. Unless required by applicable law or
145
+ agreed to in writing, Licensor provides the Work (and each
146
+ Contributor provides its Contributions) on an "AS IS" BASIS,
147
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148
+ implied, including, without limitation, any warranties or conditions
149
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150
+ PARTICULAR PURPOSE. You are solely responsible for determining the
151
+ appropriateness of using or redistributing the Work and assume any
152
+ risks associated with Your exercise of permissions under this License.
153
+
154
+ 8. Limitation of Liability. In no event and under no legal theory,
155
+ whether in tort (including negligence), contract, or otherwise,
156
+ unless required by applicable law (such as deliberate and grossly
157
+ negligent acts) or agreed to in writing, shall any Contributor be
158
+ liable to You for damages, including any direct, indirect, special,
159
+ incidental, or consequential damages of any character arising as a
160
+ result of this License or out of the use or inability to use the
161
+ Work (including but not limited to damages for loss of goodwill,
162
+ work stoppage, computer failure or malfunction, or any and all
163
+ other commercial damages or losses), even if such Contributor
164
+ has been advised of the possibility of such damages.
165
+
166
+ 9. Accepting Warranty or Additional Liability. While redistributing
167
+ the Work or Derivative Works thereof, You may choose to offer,
168
+ and charge a fee for, acceptance of support, warranty, indemnity,
169
+ or other liability obligations and/or rights consistent with this
170
+ License. However, in accepting such obligations, You may act only
171
+ on Your own behalf and on Your sole responsibility, not on behalf
172
+ of any other Contributor, and only if You agree to indemnify,
173
+ defend, and hold each Contributor harmless for any liability
174
+ incurred by, or claims asserted against, such Contributor by reason
175
+ of your accepting any such warranty or additional liability.
176
+
177
+ END OF TERMS AND CONDITIONS
178
+
179
+ APPENDIX: How to apply the Apache License to your work.
180
+
181
+ To apply the Apache License to your work, attach the following
182
+ boilerplate notice, with the fields enclosed by brackets "[]"
183
+ replaced with your own identifying information. (Don't include
184
+ the brackets!) The text should be enclosed in the appropriate
185
+ comment syntax for the file format. We also recommend that a
186
+ file or class name and description of purpose be included on the
187
+ same "printed page" as the copyright notice for easier
188
+ identification within third-party archives.
189
+
190
+ Copyright [yyyy] [name of copyright owner]
191
+
192
+ Licensed under the Apache License, Version 2.0 (the "License");
193
+ you may not use this file except in compliance with the License.
194
+ You may obtain a copy of the License at
195
+
196
+ http://www.apache.org/licenses/LICENSE-2.0
197
+
198
+ Unless required by applicable law or agreed to in writing, software
199
+ distributed under the License is distributed on an "AS IS" BASIS,
200
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201
+ See the License for the specific language governing permissions and
202
+ limitations under the License.
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.31.0
data/lib/aws-sdk-docdb.rb CHANGED
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -29,7 +29,7 @@ require_relative 'aws-sdk-docdb/customizations'
29
29
  # structure.
30
30
  #
31
31
  # doc_db = Aws::DocDB::Client.new
32
- # resp = doc_db.add_tags_to_resource(params)
32
+ # resp = doc_db.add_source_identifier_to_subscription(params)
33
33
  #
34
34
  # See {Client} for more information.
35
35
  #
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-docdb/customizations'
49
49
  # @!group service
50
50
  module Aws::DocDB
51
51
 
52
- GEM_VERSION = '1.26.0'
52
+ GEM_VERSION = '1.31.0'
53
53
 
54
54
  end
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -29,6 +29,7 @@ require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
30
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
31
  require 'aws-sdk-core/plugins/protocols/query.rb'
32
+ require 'aws-sdk-docdb/plugins/cross_region_copying.rb'
32
33
 
33
34
  Aws::Plugins::GlobalConfiguration.add_identifier(:docdb)
34
35
 
@@ -75,6 +76,7 @@ module Aws::DocDB
75
76
  add_plugin(Aws::Plugins::HttpChecksum)
76
77
  add_plugin(Aws::Plugins::SignatureV4)
77
78
  add_plugin(Aws::Plugins::Protocols::Query)
79
+ add_plugin(Aws::DocDB::Plugins::CrossRegionCopying)
78
80
 
79
81
  # @overload initialize(options)
80
82
  # @param [Hash] options
@@ -327,6 +329,63 @@ module Aws::DocDB
327
329
 
328
330
  # @!group API Operations
329
331
 
332
+ # Adds a source identifier to an existing event notification
333
+ # subscription.
334
+ #
335
+ # @option params [required, String] :subscription_name
336
+ # The name of the Amazon DocumentDB event notification subscription that
337
+ # you want to add a source identifier to.
338
+ #
339
+ # @option params [required, String] :source_identifier
340
+ # The identifier of the event source to be added:
341
+ #
342
+ # * If the source type is an instance, a `DBInstanceIdentifier` must be
343
+ # provided.
344
+ #
345
+ # * If the source type is a security group, a `DBSecurityGroupName` must
346
+ # be provided.
347
+ #
348
+ # * If the source type is a parameter group, a `DBParameterGroupName`
349
+ # must be provided.
350
+ #
351
+ # * If the source type is a snapshot, a `DBSnapshotIdentifier` must be
352
+ # provided.
353
+ #
354
+ # @return [Types::AddSourceIdentifierToSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
355
+ #
356
+ # * {Types::AddSourceIdentifierToSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
357
+ #
358
+ # @example Request syntax with placeholder values
359
+ #
360
+ # resp = client.add_source_identifier_to_subscription({
361
+ # subscription_name: "String", # required
362
+ # source_identifier: "String", # required
363
+ # })
364
+ #
365
+ # @example Response structure
366
+ #
367
+ # resp.event_subscription.customer_aws_id #=> String
368
+ # resp.event_subscription.cust_subscription_id #=> String
369
+ # resp.event_subscription.sns_topic_arn #=> String
370
+ # resp.event_subscription.status #=> String
371
+ # resp.event_subscription.subscription_creation_time #=> String
372
+ # resp.event_subscription.source_type #=> String
373
+ # resp.event_subscription.source_ids_list #=> Array
374
+ # resp.event_subscription.source_ids_list[0] #=> String
375
+ # resp.event_subscription.event_categories_list #=> Array
376
+ # resp.event_subscription.event_categories_list[0] #=> String
377
+ # resp.event_subscription.enabled #=> Boolean
378
+ # resp.event_subscription.event_subscription_arn #=> String
379
+ #
380
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/AddSourceIdentifierToSubscription AWS API Documentation
381
+ #
382
+ # @overload add_source_identifier_to_subscription(params = {})
383
+ # @param [Hash] params ({})
384
+ def add_source_identifier_to_subscription(params = {}, options = {})
385
+ req = build_request(:add_source_identifier_to_subscription, params)
386
+ req.send_request(options)
387
+ end
388
+
330
389
  # Adds metadata tags to an Amazon DocumentDB resource. You can use these
331
390
  # tags with cost allocation reporting to track costs that are associated
332
391
  # with Amazon DocumentDB resources. or in a `Condition` statement in an
@@ -599,6 +658,10 @@ module Aws::DocDB
599
658
  # @option params [Array<Types::Tag>] :tags
600
659
  # The tags to be assigned to the cluster snapshot.
601
660
  #
661
+ # @option params [String] :source_region
662
+ # The source region of the snapshot. This is only needed when the
663
+ # shapshot is encrypted and in a different region.
664
+ #
602
665
  # @return [Types::CopyDBClusterSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
603
666
  #
604
667
  # * {Types::CopyDBClusterSnapshotResult#db_cluster_snapshot #db_cluster_snapshot} => Types::DBClusterSnapshot
@@ -617,6 +680,7 @@ module Aws::DocDB
617
680
  # value: "String",
618
681
  # },
619
682
  # ],
683
+ # source_region: "String",
620
684
  # })
621
685
  #
622
686
  # @example Response structure
@@ -711,7 +775,7 @@ module Aws::DocDB
711
775
  # The port number on which the instances in the cluster accept
712
776
  # connections.
713
777
  #
714
- # @option params [required, String] :master_username
778
+ # @option params [String] :master_username
715
779
  # The name of the master user for the cluster.
716
780
  #
717
781
  # Constraints:
@@ -722,7 +786,7 @@ module Aws::DocDB
722
786
  #
723
787
  # * Cannot be a reserved word for the chosen database engine.
724
788
  #
725
- # @option params [required, String] :master_user_password
789
+ # @option params [String] :master_user_password
726
790
  # The password for the master database user. This password can contain
727
791
  # any printable ASCII character except forward slash (/), double quote
728
792
  # ("), or the "at" symbol (@).
@@ -807,6 +871,13 @@ module Aws::DocDB
807
871
  # `DeletionProtection` is disabled. `DeletionProtection` protects
808
872
  # clusters from being accidentally deleted.
809
873
  #
874
+ # @option params [String] :global_cluster_identifier
875
+ # The cluster identifier of the new global cluster.
876
+ #
877
+ # @option params [String] :source_region
878
+ # The source region of the snapshot. This is only needed when the
879
+ # shapshot is encrypted and in a different region.
880
+ #
810
881
  # @return [Types::CreateDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
811
882
  #
812
883
  # * {Types::CreateDBClusterResult#db_cluster #db_cluster} => Types::DBCluster
@@ -823,8 +894,8 @@ module Aws::DocDB
823
894
  # engine: "String", # required
824
895
  # engine_version: "String",
825
896
  # port: 1,
826
- # master_username: "String", # required
827
- # master_user_password: "String", # required
897
+ # master_username: "String",
898
+ # master_user_password: "String",
828
899
  # preferred_backup_window: "String",
829
900
  # preferred_maintenance_window: "String",
830
901
  # tags: [
@@ -838,6 +909,8 @@ module Aws::DocDB
838
909
  # pre_signed_url: "String",
839
910
  # enable_cloudwatch_logs_exports: ["String"],
840
911
  # deletion_protection: false,
912
+ # global_cluster_identifier: "GlobalClusterIdentifier",
913
+ # source_region: "String",
841
914
  # })
842
915
  #
843
916
  # @example Response structure
@@ -861,6 +934,9 @@ module Aws::DocDB
861
934
  # resp.db_cluster.master_username #=> String
862
935
  # resp.db_cluster.preferred_backup_window #=> String
863
936
  # resp.db_cluster.preferred_maintenance_window #=> String
937
+ # resp.db_cluster.replication_source_identifier #=> String
938
+ # resp.db_cluster.read_replica_identifiers #=> Array
939
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
864
940
  # resp.db_cluster.db_cluster_members #=> Array
865
941
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
866
942
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -1272,6 +1348,214 @@ module Aws::DocDB
1272
1348
  req.send_request(options)
1273
1349
  end
1274
1350
 
1351
+ # Creates an Amazon DocumentDB event notification subscription. This
1352
+ # action requires a topic Amazon Resource Name (ARN) created by using
1353
+ # the Amazon DocumentDB console, the Amazon SNS console, or the Amazon
1354
+ # SNS API. To obtain an ARN with Amazon SNS, you must create a topic in
1355
+ # Amazon SNS and subscribe to the topic. The ARN is displayed in the
1356
+ # Amazon SNS console.
1357
+ #
1358
+ # You can specify the type of source (`SourceType`) that you want to be
1359
+ # notified of. You can also provide a list of Amazon DocumentDB sources
1360
+ # (`SourceIds`) that trigger the events, and you can provide a list of
1361
+ # event categories (`EventCategories`) for events that you want to be
1362
+ # notified of. For example, you can specify `SourceType = db-instance`,
1363
+ # `SourceIds = mydbinstance1, mydbinstance2` and `EventCategories =
1364
+ # Availability, Backup`.
1365
+ #
1366
+ # If you specify both the `SourceType` and `SourceIds` (such as
1367
+ # `SourceType = db-instance` and `SourceIdentifier = myDBInstance1`),
1368
+ # you are notified of all the `db-instance` events for the specified
1369
+ # source. If you specify a `SourceType` but do not specify a
1370
+ # `SourceIdentifier`, you receive notice of the events for that source
1371
+ # type for all your Amazon DocumentDB sources. If you do not specify
1372
+ # either the `SourceType` or the `SourceIdentifier`, you are notified of
1373
+ # events generated from all Amazon DocumentDB sources belonging to your
1374
+ # customer account.
1375
+ #
1376
+ # @option params [required, String] :subscription_name
1377
+ # The name of the subscription.
1378
+ #
1379
+ # Constraints: The name must be fewer than 255 characters.
1380
+ #
1381
+ # @option params [required, String] :sns_topic_arn
1382
+ # The Amazon Resource Name (ARN) of the SNS topic created for event
1383
+ # notification. Amazon SNS creates the ARN when you create a topic and
1384
+ # subscribe to it.
1385
+ #
1386
+ # @option params [String] :source_type
1387
+ # The type of source that is generating the events. For example, if you
1388
+ # want to be notified of events generated by an instance, you would set
1389
+ # this parameter to `db-instance`. If this value is not specified, all
1390
+ # events are returned.
1391
+ #
1392
+ # Valid values: `db-instance`, `db-cluster`, `db-parameter-group`,
1393
+ # `db-security-group`, `db-snapshot`, `db-cluster-snapshot`
1394
+ #
1395
+ # @option params [Array<String>] :event_categories
1396
+ # A list of event categories for a `SourceType` that you want to
1397
+ # subscribe to.
1398
+ #
1399
+ # @option params [Array<String>] :source_ids
1400
+ # The list of identifiers of the event sources for which events are
1401
+ # returned. If not specified, then all sources are included in the
1402
+ # response. An identifier must begin with a letter and must contain only
1403
+ # ASCII letters, digits, and hyphens; it can't end with a hyphen or
1404
+ # contain two consecutive hyphens.
1405
+ #
1406
+ # Constraints:
1407
+ #
1408
+ # * If `SourceIds` are provided, `SourceType` must also be provided.
1409
+ #
1410
+ # * If the source type is an instance, a `DBInstanceIdentifier` must be
1411
+ # provided.
1412
+ #
1413
+ # * If the source type is a security group, a `DBSecurityGroupName` must
1414
+ # be provided.
1415
+ #
1416
+ # * If the source type is a parameter group, a `DBParameterGroupName`
1417
+ # must be provided.
1418
+ #
1419
+ # * If the source type is a snapshot, a `DBSnapshotIdentifier` must be
1420
+ # provided.
1421
+ #
1422
+ # @option params [Boolean] :enabled
1423
+ # A Boolean value; set to `true` to activate the subscription, set to
1424
+ # `false` to create the subscription but not active it.
1425
+ #
1426
+ # @option params [Array<Types::Tag>] :tags
1427
+ # The tags to be assigned to the event subscription.
1428
+ #
1429
+ # @return [Types::CreateEventSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1430
+ #
1431
+ # * {Types::CreateEventSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
1432
+ #
1433
+ # @example Request syntax with placeholder values
1434
+ #
1435
+ # resp = client.create_event_subscription({
1436
+ # subscription_name: "String", # required
1437
+ # sns_topic_arn: "String", # required
1438
+ # source_type: "String",
1439
+ # event_categories: ["String"],
1440
+ # source_ids: ["String"],
1441
+ # enabled: false,
1442
+ # tags: [
1443
+ # {
1444
+ # key: "String",
1445
+ # value: "String",
1446
+ # },
1447
+ # ],
1448
+ # })
1449
+ #
1450
+ # @example Response structure
1451
+ #
1452
+ # resp.event_subscription.customer_aws_id #=> String
1453
+ # resp.event_subscription.cust_subscription_id #=> String
1454
+ # resp.event_subscription.sns_topic_arn #=> String
1455
+ # resp.event_subscription.status #=> String
1456
+ # resp.event_subscription.subscription_creation_time #=> String
1457
+ # resp.event_subscription.source_type #=> String
1458
+ # resp.event_subscription.source_ids_list #=> Array
1459
+ # resp.event_subscription.source_ids_list[0] #=> String
1460
+ # resp.event_subscription.event_categories_list #=> Array
1461
+ # resp.event_subscription.event_categories_list[0] #=> String
1462
+ # resp.event_subscription.enabled #=> Boolean
1463
+ # resp.event_subscription.event_subscription_arn #=> String
1464
+ #
1465
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/CreateEventSubscription AWS API Documentation
1466
+ #
1467
+ # @overload create_event_subscription(params = {})
1468
+ # @param [Hash] params ({})
1469
+ def create_event_subscription(params = {}, options = {})
1470
+ req = build_request(:create_event_subscription, params)
1471
+ req.send_request(options)
1472
+ end
1473
+
1474
+ # Creates an Amazon DocumentDB global cluster that can span multiple
1475
+ # multiple AWS Regions. The global cluster contains one primary cluster
1476
+ # with read-write capability, and up-to give read-only secondary
1477
+ # clusters. Global clusters uses storage-based fast replication across
1478
+ # regions with latencies less than one second, using dedicated
1479
+ # infrastructure with no impact to your workload’s performance.
1480
+ #
1481
+ #
1482
+ #
1483
+ # You can create a global cluster that is initially empty, and then add
1484
+ # a primary and a secondary to it. Or you can specify an existing
1485
+ # cluster during the create operation, and this cluster becomes the
1486
+ # primary of the global cluster.
1487
+ #
1488
+ # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
1489
+ #
1490
+ # </note>
1491
+ #
1492
+ # @option params [required, String] :global_cluster_identifier
1493
+ # The cluster identifier of the new global cluster.
1494
+ #
1495
+ # @option params [String] :source_db_cluster_identifier
1496
+ # The Amazon Resource Name (ARN) to use as the primary cluster of the
1497
+ # global cluster. This parameter is optional.
1498
+ #
1499
+ # @option params [String] :engine
1500
+ # The name of the database engine to be used for this cluster.
1501
+ #
1502
+ # @option params [String] :engine_version
1503
+ # The engine version of the global cluster.
1504
+ #
1505
+ # @option params [Boolean] :deletion_protection
1506
+ # The deletion protection setting for the new global cluster. The global
1507
+ # cluster can't be deleted when deletion protection is enabled.
1508
+ #
1509
+ # @option params [String] :database_name
1510
+ # The name for your database of up to 64 alpha-numeric characters. If
1511
+ # you do not provide a name, Amazon DocumentDB will not create a
1512
+ # database in the global cluster you are creating.
1513
+ #
1514
+ # @option params [Boolean] :storage_encrypted
1515
+ # The storage encryption setting for the new global cluster.
1516
+ #
1517
+ # @return [Types::CreateGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1518
+ #
1519
+ # * {Types::CreateGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
1520
+ #
1521
+ # @example Request syntax with placeholder values
1522
+ #
1523
+ # resp = client.create_global_cluster({
1524
+ # global_cluster_identifier: "GlobalClusterIdentifier", # required
1525
+ # source_db_cluster_identifier: "String",
1526
+ # engine: "String",
1527
+ # engine_version: "String",
1528
+ # deletion_protection: false,
1529
+ # database_name: "String",
1530
+ # storage_encrypted: false,
1531
+ # })
1532
+ #
1533
+ # @example Response structure
1534
+ #
1535
+ # resp.global_cluster.global_cluster_identifier #=> String
1536
+ # resp.global_cluster.global_cluster_resource_id #=> String
1537
+ # resp.global_cluster.global_cluster_arn #=> String
1538
+ # resp.global_cluster.status #=> String
1539
+ # resp.global_cluster.engine #=> String
1540
+ # resp.global_cluster.engine_version #=> String
1541
+ # resp.global_cluster.database_name #=> String
1542
+ # resp.global_cluster.storage_encrypted #=> Boolean
1543
+ # resp.global_cluster.deletion_protection #=> Boolean
1544
+ # resp.global_cluster.global_cluster_members #=> Array
1545
+ # resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
1546
+ # resp.global_cluster.global_cluster_members[0].readers #=> Array
1547
+ # resp.global_cluster.global_cluster_members[0].readers[0] #=> String
1548
+ # resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
1549
+ #
1550
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/CreateGlobalCluster AWS API Documentation
1551
+ #
1552
+ # @overload create_global_cluster(params = {})
1553
+ # @param [Hash] params ({})
1554
+ def create_global_cluster(params = {}, options = {})
1555
+ req = build_request(:create_global_cluster, params)
1556
+ req.send_request(options)
1557
+ end
1558
+
1275
1559
  # Deletes a previously provisioned cluster. When you delete a cluster,
1276
1560
  # all automated backups for that cluster are deleted and can't be
1277
1561
  # recovered. Manual DB cluster snapshots of the specified cluster are
@@ -1350,6 +1634,9 @@ module Aws::DocDB
1350
1634
  # resp.db_cluster.master_username #=> String
1351
1635
  # resp.db_cluster.preferred_backup_window #=> String
1352
1636
  # resp.db_cluster.preferred_maintenance_window #=> String
1637
+ # resp.db_cluster.replication_source_identifier #=> String
1638
+ # resp.db_cluster.read_replica_identifiers #=> Array
1639
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
1353
1640
  # resp.db_cluster.db_cluster_members #=> Array
1354
1641
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
1355
1642
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -1595,6 +1882,93 @@ module Aws::DocDB
1595
1882
  req.send_request(options)
1596
1883
  end
1597
1884
 
1885
+ # Deletes an Amazon DocumentDB event notification subscription.
1886
+ #
1887
+ # @option params [required, String] :subscription_name
1888
+ # The name of the Amazon DocumentDB event notification subscription that
1889
+ # you want to delete.
1890
+ #
1891
+ # @return [Types::DeleteEventSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1892
+ #
1893
+ # * {Types::DeleteEventSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
1894
+ #
1895
+ # @example Request syntax with placeholder values
1896
+ #
1897
+ # resp = client.delete_event_subscription({
1898
+ # subscription_name: "String", # required
1899
+ # })
1900
+ #
1901
+ # @example Response structure
1902
+ #
1903
+ # resp.event_subscription.customer_aws_id #=> String
1904
+ # resp.event_subscription.cust_subscription_id #=> String
1905
+ # resp.event_subscription.sns_topic_arn #=> String
1906
+ # resp.event_subscription.status #=> String
1907
+ # resp.event_subscription.subscription_creation_time #=> String
1908
+ # resp.event_subscription.source_type #=> String
1909
+ # resp.event_subscription.source_ids_list #=> Array
1910
+ # resp.event_subscription.source_ids_list[0] #=> String
1911
+ # resp.event_subscription.event_categories_list #=> Array
1912
+ # resp.event_subscription.event_categories_list[0] #=> String
1913
+ # resp.event_subscription.enabled #=> Boolean
1914
+ # resp.event_subscription.event_subscription_arn #=> String
1915
+ #
1916
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DeleteEventSubscription AWS API Documentation
1917
+ #
1918
+ # @overload delete_event_subscription(params = {})
1919
+ # @param [Hash] params ({})
1920
+ def delete_event_subscription(params = {}, options = {})
1921
+ req = build_request(:delete_event_subscription, params)
1922
+ req.send_request(options)
1923
+ end
1924
+
1925
+ # Deletes a global cluster. The primary and secondary clusters must
1926
+ # already be detached or deleted before attempting to delete a global
1927
+ # cluster.
1928
+ #
1929
+ # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
1930
+ #
1931
+ # </note>
1932
+ #
1933
+ # @option params [required, String] :global_cluster_identifier
1934
+ # The cluster identifier of the global cluster being deleted.
1935
+ #
1936
+ # @return [Types::DeleteGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1937
+ #
1938
+ # * {Types::DeleteGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
1939
+ #
1940
+ # @example Request syntax with placeholder values
1941
+ #
1942
+ # resp = client.delete_global_cluster({
1943
+ # global_cluster_identifier: "GlobalClusterIdentifier", # required
1944
+ # })
1945
+ #
1946
+ # @example Response structure
1947
+ #
1948
+ # resp.global_cluster.global_cluster_identifier #=> String
1949
+ # resp.global_cluster.global_cluster_resource_id #=> String
1950
+ # resp.global_cluster.global_cluster_arn #=> String
1951
+ # resp.global_cluster.status #=> String
1952
+ # resp.global_cluster.engine #=> String
1953
+ # resp.global_cluster.engine_version #=> String
1954
+ # resp.global_cluster.database_name #=> String
1955
+ # resp.global_cluster.storage_encrypted #=> Boolean
1956
+ # resp.global_cluster.deletion_protection #=> Boolean
1957
+ # resp.global_cluster.global_cluster_members #=> Array
1958
+ # resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
1959
+ # resp.global_cluster.global_cluster_members[0].readers #=> Array
1960
+ # resp.global_cluster.global_cluster_members[0].readers[0] #=> String
1961
+ # resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
1962
+ #
1963
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DeleteGlobalCluster AWS API Documentation
1964
+ #
1965
+ # @overload delete_global_cluster(params = {})
1966
+ # @param [Hash] params ({})
1967
+ def delete_global_cluster(params = {}, options = {})
1968
+ req = build_request(:delete_global_cluster, params)
1969
+ req.send_request(options)
1970
+ end
1971
+
1598
1972
  # Returns a list of certificate authority (CA) certificates provided by
1599
1973
  # Amazon DocumentDB for this AWS account.
1600
1974
  #
@@ -1916,7 +2290,7 @@ module Aws::DocDB
1916
2290
  # manual cluster snapshots are returned. You can include shared cluster
1917
2291
  # snapshots with these results by setting the `IncludeShared` parameter
1918
2292
  # to `true`. You can include public cluster snapshots with these results
1919
- # by setting the `IncludePublic` parameter to `true`.
2293
+ # by setting the`IncludePublic` parameter to `true`.
1920
2294
  #
1921
2295
  # The `IncludeShared` and `IncludePublic` parameters don't apply for
1922
2296
  # `SnapshotType` values of `manual` or `automated`. The `IncludePublic`
@@ -2097,6 +2471,9 @@ module Aws::DocDB
2097
2471
  # resp.db_clusters[0].master_username #=> String
2098
2472
  # resp.db_clusters[0].preferred_backup_window #=> String
2099
2473
  # resp.db_clusters[0].preferred_maintenance_window #=> String
2474
+ # resp.db_clusters[0].replication_source_identifier #=> String
2475
+ # resp.db_clusters[0].read_replica_identifiers #=> Array
2476
+ # resp.db_clusters[0].read_replica_identifiers[0] #=> String
2100
2477
  # resp.db_clusters[0].db_cluster_members #=> Array
2101
2478
  # resp.db_clusters[0].db_cluster_members[0].db_instance_identifier #=> String
2102
2479
  # resp.db_clusters[0].db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -2556,6 +2933,83 @@ module Aws::DocDB
2556
2933
  req.send_request(options)
2557
2934
  end
2558
2935
 
2936
+ # Lists all the subscription descriptions for a customer account. The
2937
+ # description for a subscription includes `SubscriptionName`,
2938
+ # `SNSTopicARN`, `CustomerID`, `SourceType`, `SourceID`, `CreationTime`,
2939
+ # and `Status`.
2940
+ #
2941
+ # If you specify a `SubscriptionName`, lists the description for that
2942
+ # subscription.
2943
+ #
2944
+ # @option params [String] :subscription_name
2945
+ # The name of the Amazon DocumentDB event notification subscription that
2946
+ # you want to describe.
2947
+ #
2948
+ # @option params [Array<Types::Filter>] :filters
2949
+ # This parameter is not currently supported.
2950
+ #
2951
+ # @option params [Integer] :max_records
2952
+ # The maximum number of records to include in the response. If more
2953
+ # records exist than the specified `MaxRecords` value, a pagination
2954
+ # token (marker) is included in the response so that the remaining
2955
+ # results can be retrieved.
2956
+ #
2957
+ # Default: 100
2958
+ #
2959
+ # Constraints: Minimum 20, maximum 100.
2960
+ #
2961
+ # @option params [String] :marker
2962
+ # An optional pagination token provided by a previous request. If this
2963
+ # parameter is specified, the response includes only records beyond the
2964
+ # marker, up to the value specified by `MaxRecords`.
2965
+ #
2966
+ # @return [Types::EventSubscriptionsMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2967
+ #
2968
+ # * {Types::EventSubscriptionsMessage#marker #marker} => String
2969
+ # * {Types::EventSubscriptionsMessage#event_subscriptions_list #event_subscriptions_list} => Array&lt;Types::EventSubscription&gt;
2970
+ #
2971
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2972
+ #
2973
+ # @example Request syntax with placeholder values
2974
+ #
2975
+ # resp = client.describe_event_subscriptions({
2976
+ # subscription_name: "String",
2977
+ # filters: [
2978
+ # {
2979
+ # name: "String", # required
2980
+ # values: ["String"], # required
2981
+ # },
2982
+ # ],
2983
+ # max_records: 1,
2984
+ # marker: "String",
2985
+ # })
2986
+ #
2987
+ # @example Response structure
2988
+ #
2989
+ # resp.marker #=> String
2990
+ # resp.event_subscriptions_list #=> Array
2991
+ # resp.event_subscriptions_list[0].customer_aws_id #=> String
2992
+ # resp.event_subscriptions_list[0].cust_subscription_id #=> String
2993
+ # resp.event_subscriptions_list[0].sns_topic_arn #=> String
2994
+ # resp.event_subscriptions_list[0].status #=> String
2995
+ # resp.event_subscriptions_list[0].subscription_creation_time #=> String
2996
+ # resp.event_subscriptions_list[0].source_type #=> String
2997
+ # resp.event_subscriptions_list[0].source_ids_list #=> Array
2998
+ # resp.event_subscriptions_list[0].source_ids_list[0] #=> String
2999
+ # resp.event_subscriptions_list[0].event_categories_list #=> Array
3000
+ # resp.event_subscriptions_list[0].event_categories_list[0] #=> String
3001
+ # resp.event_subscriptions_list[0].enabled #=> Boolean
3002
+ # resp.event_subscriptions_list[0].event_subscription_arn #=> String
3003
+ #
3004
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DescribeEventSubscriptions AWS API Documentation
3005
+ #
3006
+ # @overload describe_event_subscriptions(params = {})
3007
+ # @param [Hash] params ({})
3008
+ def describe_event_subscriptions(params = {}, options = {})
3009
+ req = build_request(:describe_event_subscriptions, params)
3010
+ req.send_request(options)
3011
+ end
3012
+
2559
3013
  # Returns events related to instances, security groups, snapshots, and
2560
3014
  # DB parameter groups for the past 14 days. You can obtain events
2561
3015
  # specific to a particular DB instance, security group, snapshot, or
@@ -2675,6 +3129,86 @@ module Aws::DocDB
2675
3129
  req.send_request(options)
2676
3130
  end
2677
3131
 
3132
+ # Returns information about Amazon DocumentDB global clusters. This API
3133
+ # supports pagination.
3134
+ #
3135
+ # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
3136
+ #
3137
+ # </note>
3138
+ #
3139
+ # @option params [String] :global_cluster_identifier
3140
+ # The user-supplied cluster identifier. If this parameter is specified,
3141
+ # information from only the specific cluster is returned. This parameter
3142
+ # isn't case-sensitive.
3143
+ #
3144
+ # @option params [Array<Types::Filter>] :filters
3145
+ # A filter that specifies one or more global DB clusters to describe.
3146
+ #
3147
+ # Supported filters: `db-cluster-id` accepts cluster identifiers and
3148
+ # cluster Amazon Resource Names (ARNs). The results list will only
3149
+ # include information about the clusters identified by these ARNs.
3150
+ #
3151
+ # @option params [Integer] :max_records
3152
+ # The maximum number of records to include in the response. If more
3153
+ # records exist than the specified `MaxRecords` value, a pagination
3154
+ # token called a marker is included in the response so that you can
3155
+ # retrieve the remaining results.
3156
+ #
3157
+ # @option params [String] :marker
3158
+ # An optional pagination token provided by a previous
3159
+ # `DescribeGlobalClusters` request. If this parameter is specified, the
3160
+ # response includes only records beyond the marker, up to the value
3161
+ # specified by `MaxRecords`.
3162
+ #
3163
+ # @return [Types::GlobalClustersMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3164
+ #
3165
+ # * {Types::GlobalClustersMessage#marker #marker} => String
3166
+ # * {Types::GlobalClustersMessage#global_clusters #global_clusters} => Array&lt;Types::GlobalCluster&gt;
3167
+ #
3168
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3169
+ #
3170
+ # @example Request syntax with placeholder values
3171
+ #
3172
+ # resp = client.describe_global_clusters({
3173
+ # global_cluster_identifier: "GlobalClusterIdentifier",
3174
+ # filters: [
3175
+ # {
3176
+ # name: "String", # required
3177
+ # values: ["String"], # required
3178
+ # },
3179
+ # ],
3180
+ # max_records: 1,
3181
+ # marker: "String",
3182
+ # })
3183
+ #
3184
+ # @example Response structure
3185
+ #
3186
+ # resp.marker #=> String
3187
+ # resp.global_clusters #=> Array
3188
+ # resp.global_clusters[0].global_cluster_identifier #=> String
3189
+ # resp.global_clusters[0].global_cluster_resource_id #=> String
3190
+ # resp.global_clusters[0].global_cluster_arn #=> String
3191
+ # resp.global_clusters[0].status #=> String
3192
+ # resp.global_clusters[0].engine #=> String
3193
+ # resp.global_clusters[0].engine_version #=> String
3194
+ # resp.global_clusters[0].database_name #=> String
3195
+ # resp.global_clusters[0].storage_encrypted #=> Boolean
3196
+ # resp.global_clusters[0].deletion_protection #=> Boolean
3197
+ # resp.global_clusters[0].global_cluster_members #=> Array
3198
+ # resp.global_clusters[0].global_cluster_members[0].db_cluster_arn #=> String
3199
+ # resp.global_clusters[0].global_cluster_members[0].readers #=> Array
3200
+ # resp.global_clusters[0].global_cluster_members[0].readers[0] #=> String
3201
+ # resp.global_clusters[0].global_cluster_members[0].is_writer #=> Boolean
3202
+ #
3203
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DescribeGlobalClusters AWS API Documentation
3204
+ #
3205
+ # @overload describe_global_clusters(params = {})
3206
+ # @param [Hash] params ({})
3207
+ def describe_global_clusters(params = {}, options = {})
3208
+ req = build_request(:describe_global_clusters, params)
3209
+ req.send_request(options)
3210
+ end
3211
+
2678
3212
  # Returns a list of orderable instance options for the specified engine.
2679
3213
  #
2680
3214
  # @option params [required, String] :engine
@@ -2897,6 +3431,9 @@ module Aws::DocDB
2897
3431
  # resp.db_cluster.master_username #=> String
2898
3432
  # resp.db_cluster.preferred_backup_window #=> String
2899
3433
  # resp.db_cluster.preferred_maintenance_window #=> String
3434
+ # resp.db_cluster.replication_source_identifier #=> String
3435
+ # resp.db_cluster.read_replica_identifiers #=> Array
3436
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
2900
3437
  # resp.db_cluster.db_cluster_members #=> Array
2901
3438
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
2902
3439
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -3085,9 +3622,8 @@ module Aws::DocDB
3085
3622
  #
3086
3623
  # @option params [String] :engine_version
3087
3624
  # The version number of the database engine to which you want to
3088
- # upgrade. Changing this parameter results in an outage. The change is
3089
- # applied during the next maintenance window unless the
3090
- # `ApplyImmediately` parameter is set to `true`.
3625
+ # upgrade. Modifying engine version is not supported on Amazon
3626
+ # DocumentDB.
3091
3627
  #
3092
3628
  # @option params [Boolean] :deletion_protection
3093
3629
  # Specifies whether this cluster can be deleted. If `DeletionProtection`
@@ -3141,6 +3677,9 @@ module Aws::DocDB
3141
3677
  # resp.db_cluster.master_username #=> String
3142
3678
  # resp.db_cluster.preferred_backup_window #=> String
3143
3679
  # resp.db_cluster.preferred_maintenance_window #=> String
3680
+ # resp.db_cluster.replication_source_identifier #=> String
3681
+ # resp.db_cluster.read_replica_identifiers #=> Array
3682
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
3144
3683
  # resp.db_cluster.db_cluster_members #=> Array
3145
3684
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
3146
3685
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -3544,6 +4083,144 @@ module Aws::DocDB
3544
4083
  req.send_request(options)
3545
4084
  end
3546
4085
 
4086
+ # Modifies an existing Amazon DocumentDB event notification
4087
+ # subscription.
4088
+ #
4089
+ # @option params [required, String] :subscription_name
4090
+ # The name of the Amazon DocumentDB event notification subscription.
4091
+ #
4092
+ # @option params [String] :sns_topic_arn
4093
+ # The Amazon Resource Name (ARN) of the SNS topic created for event
4094
+ # notification. The ARN is created by Amazon SNS when you create a topic
4095
+ # and subscribe to it.
4096
+ #
4097
+ # @option params [String] :source_type
4098
+ # The type of source that is generating the events. For example, if you
4099
+ # want to be notified of events generated by an instance, set this
4100
+ # parameter to `db-instance`. If this value is not specified, all events
4101
+ # are returned.
4102
+ #
4103
+ # Valid values: `db-instance`, `db-parameter-group`,
4104
+ # `db-security-group`, `db-snapshot`
4105
+ #
4106
+ # @option params [Array<String>] :event_categories
4107
+ # A list of event categories for a `SourceType` that you want to
4108
+ # subscribe to.
4109
+ #
4110
+ # @option params [Boolean] :enabled
4111
+ # A Boolean value; set to `true` to activate the subscription.
4112
+ #
4113
+ # @return [Types::ModifyEventSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4114
+ #
4115
+ # * {Types::ModifyEventSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
4116
+ #
4117
+ # @example Request syntax with placeholder values
4118
+ #
4119
+ # resp = client.modify_event_subscription({
4120
+ # subscription_name: "String", # required
4121
+ # sns_topic_arn: "String",
4122
+ # source_type: "String",
4123
+ # event_categories: ["String"],
4124
+ # enabled: false,
4125
+ # })
4126
+ #
4127
+ # @example Response structure
4128
+ #
4129
+ # resp.event_subscription.customer_aws_id #=> String
4130
+ # resp.event_subscription.cust_subscription_id #=> String
4131
+ # resp.event_subscription.sns_topic_arn #=> String
4132
+ # resp.event_subscription.status #=> String
4133
+ # resp.event_subscription.subscription_creation_time #=> String
4134
+ # resp.event_subscription.source_type #=> String
4135
+ # resp.event_subscription.source_ids_list #=> Array
4136
+ # resp.event_subscription.source_ids_list[0] #=> String
4137
+ # resp.event_subscription.event_categories_list #=> Array
4138
+ # resp.event_subscription.event_categories_list[0] #=> String
4139
+ # resp.event_subscription.enabled #=> Boolean
4140
+ # resp.event_subscription.event_subscription_arn #=> String
4141
+ #
4142
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/ModifyEventSubscription AWS API Documentation
4143
+ #
4144
+ # @overload modify_event_subscription(params = {})
4145
+ # @param [Hash] params ({})
4146
+ def modify_event_subscription(params = {}, options = {})
4147
+ req = build_request(:modify_event_subscription, params)
4148
+ req.send_request(options)
4149
+ end
4150
+
4151
+ # Modify a setting for an Amazon DocumentDB global cluster. You can
4152
+ # change one or more configuration parameters (for example: deletion
4153
+ # protection), or the global cluster identifier by specifying these
4154
+ # parameters and the new values in the request.
4155
+ #
4156
+ # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
4157
+ #
4158
+ # </note>
4159
+ #
4160
+ # @option params [required, String] :global_cluster_identifier
4161
+ # The identifier for the global cluster being modified. This parameter
4162
+ # isn't case-sensitive.
4163
+ #
4164
+ # Constraints:
4165
+ #
4166
+ # * Must match the identifier of an existing global cluster.
4167
+ #
4168
+ # ^
4169
+ #
4170
+ # @option params [String] :new_global_cluster_identifier
4171
+ # The new identifier for a global cluster when you modify a global
4172
+ # cluster. This value is stored as a lowercase string.
4173
+ #
4174
+ # * Must contain from 1 to 63 letters, numbers, or hyphens
4175
+ #
4176
+ # The first character must be a letter
4177
+ #
4178
+ # Can't end with a hyphen or contain two consecutive hyphens
4179
+ #
4180
+ # Example: `my-cluster2`
4181
+ #
4182
+ # @option params [Boolean] :deletion_protection
4183
+ # Indicates if the global cluster has deletion protection enabled. The
4184
+ # global cluster can't be deleted when deletion protection is enabled.
4185
+ #
4186
+ # @return [Types::ModifyGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4187
+ #
4188
+ # * {Types::ModifyGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
4189
+ #
4190
+ # @example Request syntax with placeholder values
4191
+ #
4192
+ # resp = client.modify_global_cluster({
4193
+ # global_cluster_identifier: "GlobalClusterIdentifier", # required
4194
+ # new_global_cluster_identifier: "GlobalClusterIdentifier",
4195
+ # deletion_protection: false,
4196
+ # })
4197
+ #
4198
+ # @example Response structure
4199
+ #
4200
+ # resp.global_cluster.global_cluster_identifier #=> String
4201
+ # resp.global_cluster.global_cluster_resource_id #=> String
4202
+ # resp.global_cluster.global_cluster_arn #=> String
4203
+ # resp.global_cluster.status #=> String
4204
+ # resp.global_cluster.engine #=> String
4205
+ # resp.global_cluster.engine_version #=> String
4206
+ # resp.global_cluster.database_name #=> String
4207
+ # resp.global_cluster.storage_encrypted #=> Boolean
4208
+ # resp.global_cluster.deletion_protection #=> Boolean
4209
+ # resp.global_cluster.global_cluster_members #=> Array
4210
+ # resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
4211
+ # resp.global_cluster.global_cluster_members[0].readers #=> Array
4212
+ # resp.global_cluster.global_cluster_members[0].readers[0] #=> String
4213
+ # resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
4214
+ #
4215
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/ModifyGlobalCluster AWS API Documentation
4216
+ #
4217
+ # @overload modify_global_cluster(params = {})
4218
+ # @param [Hash] params ({})
4219
+ def modify_global_cluster(params = {}, options = {})
4220
+ req = build_request(:modify_global_cluster, params)
4221
+ req.send_request(options)
4222
+ end
4223
+
3547
4224
  # You might need to reboot your instance, usually for maintenance
3548
4225
  # reasons. For example, if you make certain changes, or if you change
3549
4226
  # the cluster parameter group that is associated with the instance, you
@@ -3651,6 +4328,106 @@ module Aws::DocDB
3651
4328
  req.send_request(options)
3652
4329
  end
3653
4330
 
4331
+ # Detaches an Amazon DocumentDB secondary cluster from a global cluster.
4332
+ # The cluster becomes a standalone cluster with read-write capability
4333
+ # instead of being read-only and receiving data from a primary in a
4334
+ # different region.
4335
+ #
4336
+ # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
4337
+ #
4338
+ # </note>
4339
+ #
4340
+ # @option params [required, String] :global_cluster_identifier
4341
+ # The cluster identifier to detach from the Amazon DocumentDB global
4342
+ # cluster.
4343
+ #
4344
+ # @option params [required, String] :db_cluster_identifier
4345
+ # The Amazon Resource Name (ARN) identifying the cluster that was
4346
+ # detached from the Amazon DocumentDB global cluster.
4347
+ #
4348
+ # @return [Types::RemoveFromGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4349
+ #
4350
+ # * {Types::RemoveFromGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
4351
+ #
4352
+ # @example Request syntax with placeholder values
4353
+ #
4354
+ # resp = client.remove_from_global_cluster({
4355
+ # global_cluster_identifier: "GlobalClusterIdentifier", # required
4356
+ # db_cluster_identifier: "String", # required
4357
+ # })
4358
+ #
4359
+ # @example Response structure
4360
+ #
4361
+ # resp.global_cluster.global_cluster_identifier #=> String
4362
+ # resp.global_cluster.global_cluster_resource_id #=> String
4363
+ # resp.global_cluster.global_cluster_arn #=> String
4364
+ # resp.global_cluster.status #=> String
4365
+ # resp.global_cluster.engine #=> String
4366
+ # resp.global_cluster.engine_version #=> String
4367
+ # resp.global_cluster.database_name #=> String
4368
+ # resp.global_cluster.storage_encrypted #=> Boolean
4369
+ # resp.global_cluster.deletion_protection #=> Boolean
4370
+ # resp.global_cluster.global_cluster_members #=> Array
4371
+ # resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
4372
+ # resp.global_cluster.global_cluster_members[0].readers #=> Array
4373
+ # resp.global_cluster.global_cluster_members[0].readers[0] #=> String
4374
+ # resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
4375
+ #
4376
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/RemoveFromGlobalCluster AWS API Documentation
4377
+ #
4378
+ # @overload remove_from_global_cluster(params = {})
4379
+ # @param [Hash] params ({})
4380
+ def remove_from_global_cluster(params = {}, options = {})
4381
+ req = build_request(:remove_from_global_cluster, params)
4382
+ req.send_request(options)
4383
+ end
4384
+
4385
+ # Removes a source identifier from an existing Amazon DocumentDB event
4386
+ # notification subscription.
4387
+ #
4388
+ # @option params [required, String] :subscription_name
4389
+ # The name of the Amazon DocumentDB event notification subscription that
4390
+ # you want to remove a source identifier from.
4391
+ #
4392
+ # @option params [required, String] :source_identifier
4393
+ # The source identifier to be removed from the subscription, such as the
4394
+ # instance identifier for an instance, or the name of a security group.
4395
+ #
4396
+ # @return [Types::RemoveSourceIdentifierFromSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4397
+ #
4398
+ # * {Types::RemoveSourceIdentifierFromSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
4399
+ #
4400
+ # @example Request syntax with placeholder values
4401
+ #
4402
+ # resp = client.remove_source_identifier_from_subscription({
4403
+ # subscription_name: "String", # required
4404
+ # source_identifier: "String", # required
4405
+ # })
4406
+ #
4407
+ # @example Response structure
4408
+ #
4409
+ # resp.event_subscription.customer_aws_id #=> String
4410
+ # resp.event_subscription.cust_subscription_id #=> String
4411
+ # resp.event_subscription.sns_topic_arn #=> String
4412
+ # resp.event_subscription.status #=> String
4413
+ # resp.event_subscription.subscription_creation_time #=> String
4414
+ # resp.event_subscription.source_type #=> String
4415
+ # resp.event_subscription.source_ids_list #=> Array
4416
+ # resp.event_subscription.source_ids_list[0] #=> String
4417
+ # resp.event_subscription.event_categories_list #=> Array
4418
+ # resp.event_subscription.event_categories_list[0] #=> String
4419
+ # resp.event_subscription.enabled #=> Boolean
4420
+ # resp.event_subscription.event_subscription_arn #=> String
4421
+ #
4422
+ # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription AWS API Documentation
4423
+ #
4424
+ # @overload remove_source_identifier_from_subscription(params = {})
4425
+ # @param [Hash] params ({})
4426
+ def remove_source_identifier_from_subscription(params = {}, options = {})
4427
+ req = build_request(:remove_source_identifier_from_subscription, params)
4428
+ req.send_request(options)
4429
+ end
4430
+
3654
4431
  # Removes metadata tags from an Amazon DocumentDB resource.
3655
4432
  #
3656
4433
  # @option params [required, String] :resource_name
@@ -3891,6 +4668,9 @@ module Aws::DocDB
3891
4668
  # resp.db_cluster.master_username #=> String
3892
4669
  # resp.db_cluster.preferred_backup_window #=> String
3893
4670
  # resp.db_cluster.preferred_maintenance_window #=> String
4671
+ # resp.db_cluster.replication_source_identifier #=> String
4672
+ # resp.db_cluster.read_replica_identifiers #=> Array
4673
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
3894
4674
  # resp.db_cluster.db_cluster_members #=> Array
3895
4675
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
3896
4676
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4081,6 +4861,9 @@ module Aws::DocDB
4081
4861
  # resp.db_cluster.master_username #=> String
4082
4862
  # resp.db_cluster.preferred_backup_window #=> String
4083
4863
  # resp.db_cluster.preferred_maintenance_window #=> String
4864
+ # resp.db_cluster.replication_source_identifier #=> String
4865
+ # resp.db_cluster.read_replica_identifiers #=> Array
4866
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
4084
4867
  # resp.db_cluster.db_cluster_members #=> Array
4085
4868
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
4086
4869
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4154,6 +4937,9 @@ module Aws::DocDB
4154
4937
  # resp.db_cluster.master_username #=> String
4155
4938
  # resp.db_cluster.preferred_backup_window #=> String
4156
4939
  # resp.db_cluster.preferred_maintenance_window #=> String
4940
+ # resp.db_cluster.replication_source_identifier #=> String
4941
+ # resp.db_cluster.read_replica_identifiers #=> Array
4942
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
4157
4943
  # resp.db_cluster.db_cluster_members #=> Array
4158
4944
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
4159
4945
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4227,6 +5013,9 @@ module Aws::DocDB
4227
5013
  # resp.db_cluster.master_username #=> String
4228
5014
  # resp.db_cluster.preferred_backup_window #=> String
4229
5015
  # resp.db_cluster.preferred_maintenance_window #=> String
5016
+ # resp.db_cluster.replication_source_identifier #=> String
5017
+ # resp.db_cluster.read_replica_identifiers #=> Array
5018
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
4230
5019
  # resp.db_cluster.db_cluster_members #=> Array
4231
5020
  # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
4232
5021
  # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4270,7 +5059,7 @@ module Aws::DocDB
4270
5059
  params: params,
4271
5060
  config: config)
4272
5061
  context[:gem_name] = 'aws-sdk-docdb'
4273
- context[:gem_version] = '1.26.0'
5062
+ context[:gem_version] = '1.31.0'
4274
5063
  Seahorse::Client::Request.new(handlers, context)
4275
5064
  end
4276
5065