aws-sdk-qldb 1.12.0 → 1.16.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +93 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-qldb.rb +2 -2
- data/lib/aws-sdk-qldb/client.rb +276 -50
- data/lib/aws-sdk-qldb/client_api.rb +37 -1
- data/lib/aws-sdk-qldb/errors.rb +1 -1
- data/lib/aws-sdk-qldb/resource.rb +1 -1
- data/lib/aws-sdk-qldb/types.rb +381 -82
- metadata +9 -7
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 8316983414fbf201041f490ff20114768b7f53f9ad64ee7d9a8e1736d2f71927
|
4
|
+
data.tar.gz: 9b7944b5bf7edae1eabd9d1115d61ff195498564a9caf3c709f7d838c558404e
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 115c6a9ea018004b6334b0b9b29acd23c43e6de015cd36cfe308e5382a3f0bf607368f17444d193194b9875daf5729457f6c33ed29ba8ee327a4dd11de850857
|
7
|
+
data.tar.gz: e61c32fe5db38feec76e7ad55d0c78c8e50c7010662556644f5173ebc7c40b77b455796a1778852f13e6a36b48b42c1378956f9a9684c00dc935f0e8887979bb
|
data/CHANGELOG.md
ADDED
@@ -0,0 +1,93 @@
|
|
1
|
+
Unreleased Changes
|
2
|
+
------------------
|
3
|
+
|
4
|
+
1.16.0 (2021-07-22)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Amazon QLDB now supports ledgers encrypted with customer managed KMS keys. Changes in CreateLedger, UpdateLedger and DescribeLedger APIs to support the changes.
|
8
|
+
|
9
|
+
1.15.0 (2021-06-04)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Documentation updates for Amazon QLDB
|
13
|
+
|
14
|
+
1.14.0 (2021-05-26)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Support STANDARD permissions mode in CreateLedger and DescribeLedger. Add UpdateLedgerPermissionsMode to update permissions mode on existing ledgers.
|
18
|
+
|
19
|
+
1.13.0 (2021-03-10)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
23
|
+
|
24
|
+
1.12.0 (2021-02-02)
|
25
|
+
------------------
|
26
|
+
|
27
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
28
|
+
|
29
|
+
1.11.0 (2020-09-30)
|
30
|
+
------------------
|
31
|
+
|
32
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
33
|
+
|
34
|
+
1.10.0 (2020-09-15)
|
35
|
+
------------------
|
36
|
+
|
37
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
38
|
+
|
39
|
+
1.9.0 (2020-08-25)
|
40
|
+
------------------
|
41
|
+
|
42
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
43
|
+
|
44
|
+
1.8.0 (2020-06-23)
|
45
|
+
------------------
|
46
|
+
|
47
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
48
|
+
|
49
|
+
1.7.0 (2020-06-16)
|
50
|
+
------------------
|
51
|
+
|
52
|
+
* Feature - Documentation updates for Amazon QLDB
|
53
|
+
|
54
|
+
1.6.1 (2020-06-11)
|
55
|
+
------------------
|
56
|
+
|
57
|
+
* Issue - Republish previous version with correct dependency on `aws-sdk-core`.
|
58
|
+
|
59
|
+
1.6.0 (2020-06-10)
|
60
|
+
------------------
|
61
|
+
|
62
|
+
* Issue - This version has been yanked. (#2327).
|
63
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
64
|
+
|
65
|
+
1.5.0 (2020-05-28)
|
66
|
+
------------------
|
67
|
+
|
68
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
69
|
+
|
70
|
+
1.4.0 (2020-05-18)
|
71
|
+
------------------
|
72
|
+
|
73
|
+
* Feature - Amazon QLDB now supports Amazon Kinesis data streams. You can now emit QLDB journal data, via the new QLDB Streams feature, directly to Amazon Kinesis supporting event processing and analytics among related use cases.
|
74
|
+
|
75
|
+
1.3.0 (2020-05-07)
|
76
|
+
------------------
|
77
|
+
|
78
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
79
|
+
|
80
|
+
1.2.0 (2020-03-09)
|
81
|
+
------------------
|
82
|
+
|
83
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
84
|
+
|
85
|
+
1.1.0 (2019-10-23)
|
86
|
+
------------------
|
87
|
+
|
88
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
89
|
+
|
90
|
+
1.0.0 (2019-09-09)
|
91
|
+
------------------
|
92
|
+
|
93
|
+
* Feature - Initial release of `aws-sdk-qldb`.
|
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.16.0
|
data/lib/aws-sdk-qldb.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/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-qldb/customizations'
|
|
48
48
|
# @!group service
|
49
49
|
module Aws::QLDB
|
50
50
|
|
51
|
-
GEM_VERSION = '1.
|
51
|
+
GEM_VERSION = '1.16.0'
|
52
52
|
|
53
53
|
end
|
data/lib/aws-sdk-qldb/client.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/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -338,7 +338,8 @@ module Aws::QLDB
|
|
338
338
|
# The name of the ledger.
|
339
339
|
#
|
340
340
|
# @option params [required, String] :stream_id
|
341
|
-
# The
|
341
|
+
# The UUID (represented in Base62-encoded text) of the QLDB journal
|
342
|
+
# stream to be canceled.
|
342
343
|
#
|
343
344
|
# @return [Types::CancelJournalKinesisStreamResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
344
345
|
#
|
@@ -364,11 +365,11 @@ module Aws::QLDB
|
|
364
365
|
req.send_request(options)
|
365
366
|
end
|
366
367
|
|
367
|
-
# Creates a new ledger in your
|
368
|
+
# Creates a new ledger in your account in the current Region.
|
368
369
|
#
|
369
370
|
# @option params [required, String] :name
|
370
371
|
# The name of the ledger that you want to create. The name must be
|
371
|
-
# unique among all of
|
372
|
+
# unique among all of the ledgers in your account in the current Region.
|
372
373
|
#
|
373
374
|
# Naming constraints for ledger names are defined in [Quotas in Amazon
|
374
375
|
# QLDB][1] in the *Amazon QLDB Developer Guide*.
|
@@ -384,6 +385,37 @@ module Aws::QLDB
|
|
384
385
|
#
|
385
386
|
# @option params [required, String] :permissions_mode
|
386
387
|
# The permissions mode to assign to the ledger that you want to create.
|
388
|
+
# This parameter can have one of the following values:
|
389
|
+
#
|
390
|
+
# * `ALLOW_ALL`\: A legacy permissions mode that enables access control
|
391
|
+
# with API-level granularity for ledgers.
|
392
|
+
#
|
393
|
+
# This mode allows users who have the `SendCommand` API permission for
|
394
|
+
# this ledger to run all PartiQL commands (hence, `ALLOW_ALL`) on any
|
395
|
+
# tables in the specified ledger. This mode disregards any table-level
|
396
|
+
# or command-level IAM permissions policies that you create for the
|
397
|
+
# ledger.
|
398
|
+
#
|
399
|
+
# * `STANDARD`\: (*Recommended*) A permissions mode that enables access
|
400
|
+
# control with finer granularity for ledgers, tables, and PartiQL
|
401
|
+
# commands.
|
402
|
+
#
|
403
|
+
# By default, this mode denies all user requests to run any PartiQL
|
404
|
+
# commands on any tables in this ledger. To allow PartiQL commands to
|
405
|
+
# run, you must create IAM permissions policies for specific table
|
406
|
+
# resources and PartiQL actions, in addition to the `SendCommand` API
|
407
|
+
# permission for the ledger. For information, see [Getting started
|
408
|
+
# with the standard permissions mode][1] in the *Amazon QLDB Developer
|
409
|
+
# Guide*.
|
410
|
+
#
|
411
|
+
# <note markdown="1"> We strongly recommend using the `STANDARD` permissions mode to
|
412
|
+
# maximize the security of your ledger data.
|
413
|
+
#
|
414
|
+
# </note>
|
415
|
+
#
|
416
|
+
#
|
417
|
+
#
|
418
|
+
# [1]: https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html
|
387
419
|
#
|
388
420
|
# @option params [Boolean] :deletion_protection
|
389
421
|
# The flag that prevents a ledger from being deleted by any user. If not
|
@@ -391,10 +423,53 @@ module Aws::QLDB
|
|
391
423
|
# default.
|
392
424
|
#
|
393
425
|
# If deletion protection is enabled, you must first disable it before
|
394
|
-
# you can delete the ledger
|
395
|
-
#
|
396
|
-
#
|
397
|
-
#
|
426
|
+
# you can delete the ledger. You can disable it by calling the
|
427
|
+
# `UpdateLedger` operation to set the flag to `false`.
|
428
|
+
#
|
429
|
+
# @option params [String] :kms_key
|
430
|
+
# The key in Key Management Service (KMS) to use for encryption of data
|
431
|
+
# at rest in the ledger. For more information, see [Encryption at
|
432
|
+
# rest][1] in the *Amazon QLDB Developer Guide*.
|
433
|
+
#
|
434
|
+
# Use one of the following options to specify this parameter:
|
435
|
+
#
|
436
|
+
# * `AWS_OWNED_KMS_KEY`\: Use an KMS key that is owned and managed by
|
437
|
+
# Amazon Web Services on your behalf.
|
438
|
+
#
|
439
|
+
# * **Undefined**\: By default, use an Amazon Web Services owned KMS
|
440
|
+
# key.
|
441
|
+
#
|
442
|
+
# * **A valid symmetric customer managed KMS key**\: Use the specified
|
443
|
+
# KMS key in your account that you create, own, and manage.
|
444
|
+
#
|
445
|
+
# Amazon QLDB does not support asymmetric keys. For more information,
|
446
|
+
# see [Using symmetric and asymmetric keys][2] in the *Key Management
|
447
|
+
# Service Developer Guide*.
|
448
|
+
#
|
449
|
+
# To specify a customer managed KMS key, you can use its key ID, Amazon
|
450
|
+
# Resource Name (ARN), alias name, or alias ARN. When using an alias
|
451
|
+
# name, prefix it with `"alias/"`. To specify a key in a different
|
452
|
+
# account, you must use the key ARN or alias ARN.
|
453
|
+
#
|
454
|
+
# For example:
|
455
|
+
#
|
456
|
+
# * Key ID: `1234abcd-12ab-34cd-56ef-1234567890ab`
|
457
|
+
#
|
458
|
+
# * Key ARN:
|
459
|
+
# `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
|
460
|
+
#
|
461
|
+
# * Alias name: `alias/ExampleAlias`
|
462
|
+
#
|
463
|
+
# * Alias ARN: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias`
|
464
|
+
#
|
465
|
+
# For more information, see [Key identifiers (KeyId)][3] in the *Key
|
466
|
+
# Management Service Developer Guide*.
|
467
|
+
#
|
468
|
+
#
|
469
|
+
#
|
470
|
+
# [1]: https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html
|
471
|
+
# [2]: https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html
|
472
|
+
# [3]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id
|
398
473
|
#
|
399
474
|
# @return [Types::CreateLedgerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
400
475
|
#
|
@@ -402,7 +477,9 @@ module Aws::QLDB
|
|
402
477
|
# * {Types::CreateLedgerResponse#arn #arn} => String
|
403
478
|
# * {Types::CreateLedgerResponse#state #state} => String
|
404
479
|
# * {Types::CreateLedgerResponse#creation_date_time #creation_date_time} => Time
|
480
|
+
# * {Types::CreateLedgerResponse#permissions_mode #permissions_mode} => String
|
405
481
|
# * {Types::CreateLedgerResponse#deletion_protection #deletion_protection} => Boolean
|
482
|
+
# * {Types::CreateLedgerResponse#kms_key_arn #kms_key_arn} => String
|
406
483
|
#
|
407
484
|
# @example Request syntax with placeholder values
|
408
485
|
#
|
@@ -411,8 +488,9 @@ module Aws::QLDB
|
|
411
488
|
# tags: {
|
412
489
|
# "TagKey" => "TagValue",
|
413
490
|
# },
|
414
|
-
# permissions_mode: "ALLOW_ALL", # required, accepts ALLOW_ALL
|
491
|
+
# permissions_mode: "ALLOW_ALL", # required, accepts ALLOW_ALL, STANDARD
|
415
492
|
# deletion_protection: false,
|
493
|
+
# kms_key: "KmsKey",
|
416
494
|
# })
|
417
495
|
#
|
418
496
|
# @example Response structure
|
@@ -421,7 +499,9 @@ module Aws::QLDB
|
|
421
499
|
# resp.arn #=> String
|
422
500
|
# resp.state #=> String, one of "CREATING", "ACTIVE", "DELETING", "DELETED"
|
423
501
|
# resp.creation_date_time #=> Time
|
502
|
+
# resp.permissions_mode #=> String, one of "ALLOW_ALL", "STANDARD"
|
424
503
|
# resp.deletion_protection #=> Boolean
|
504
|
+
# resp.kms_key_arn #=> String
|
425
505
|
#
|
426
506
|
# @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/CreateLedger AWS API Documentation
|
427
507
|
#
|
@@ -435,10 +515,8 @@ module Aws::QLDB
|
|
435
515
|
# Deletes a ledger and all of its contents. This action is irreversible.
|
436
516
|
#
|
437
517
|
# If deletion protection is enabled, you must first disable it before
|
438
|
-
# you can delete the ledger
|
439
|
-
#
|
440
|
-
# operation to set the flag to `false`. The QLDB console disables
|
441
|
-
# deletion protection for you when you use it to delete a ledger.
|
518
|
+
# you can delete the ledger. You can disable it by calling the
|
519
|
+
# `UpdateLedger` operation to set the flag to `false`.
|
442
520
|
#
|
443
521
|
# @option params [required, String] :name
|
444
522
|
# The name of the ledger that you want to delete.
|
@@ -462,14 +540,23 @@ module Aws::QLDB
|
|
462
540
|
|
463
541
|
# Returns detailed information about a given Amazon QLDB journal stream.
|
464
542
|
# The output includes the Amazon Resource Name (ARN), stream name,
|
465
|
-
# current status, creation time, and the parameters of
|
543
|
+
# current status, creation time, and the parameters of the original
|
466
544
|
# stream creation request.
|
467
545
|
#
|
546
|
+
# This action does not return any expired journal streams. For more
|
547
|
+
# information, see [Expiration for terminal streams][1] in the *Amazon
|
548
|
+
# QLDB Developer Guide*.
|
549
|
+
#
|
550
|
+
#
|
551
|
+
#
|
552
|
+
# [1]: https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration
|
553
|
+
#
|
468
554
|
# @option params [required, String] :ledger_name
|
469
555
|
# The name of the ledger.
|
470
556
|
#
|
471
557
|
# @option params [required, String] :stream_id
|
472
|
-
# The
|
558
|
+
# The UUID (represented in Base62-encoded text) of the QLDB journal
|
559
|
+
# stream to describe.
|
473
560
|
#
|
474
561
|
# @return [Types::DescribeJournalKinesisStreamResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
475
562
|
#
|
@@ -507,11 +594,11 @@ module Aws::QLDB
|
|
507
594
|
end
|
508
595
|
|
509
596
|
# Returns information about a journal export job, including the ledger
|
510
|
-
# name, export ID,
|
511
|
-
#
|
597
|
+
# name, export ID, creation time, current status, and the parameters of
|
598
|
+
# the original export creation request.
|
512
599
|
#
|
513
600
|
# This action does not return any expired export jobs. For more
|
514
|
-
# information, see [Export
|
601
|
+
# information, see [Export job expiration][1] in the *Amazon QLDB
|
515
602
|
# Developer Guide*.
|
516
603
|
#
|
517
604
|
# If the export job with the given `ExportId` doesn't exist, then
|
@@ -528,7 +615,8 @@ module Aws::QLDB
|
|
528
615
|
# The name of the ledger.
|
529
616
|
#
|
530
617
|
# @option params [required, String] :export_id
|
531
|
-
# The
|
618
|
+
# The UUID (represented in Base62-encoded text) of the journal export
|
619
|
+
# job to describe.
|
532
620
|
#
|
533
621
|
# @return [Types::DescribeJournalS3ExportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
534
622
|
#
|
@@ -564,8 +652,8 @@ module Aws::QLDB
|
|
564
652
|
req.send_request(options)
|
565
653
|
end
|
566
654
|
|
567
|
-
# Returns information about a ledger, including its state
|
568
|
-
# was created.
|
655
|
+
# Returns information about a ledger, including its state, permissions
|
656
|
+
# mode, encryption at rest settings, and when it was created.
|
569
657
|
#
|
570
658
|
# @option params [required, String] :name
|
571
659
|
# The name of the ledger that you want to describe.
|
@@ -576,7 +664,9 @@ module Aws::QLDB
|
|
576
664
|
# * {Types::DescribeLedgerResponse#arn #arn} => String
|
577
665
|
# * {Types::DescribeLedgerResponse#state #state} => String
|
578
666
|
# * {Types::DescribeLedgerResponse#creation_date_time #creation_date_time} => Time
|
667
|
+
# * {Types::DescribeLedgerResponse#permissions_mode #permissions_mode} => String
|
579
668
|
# * {Types::DescribeLedgerResponse#deletion_protection #deletion_protection} => Boolean
|
669
|
+
# * {Types::DescribeLedgerResponse#encryption_description #encryption_description} => Types::LedgerEncryptionDescription
|
580
670
|
#
|
581
671
|
# @example Request syntax with placeholder values
|
582
672
|
#
|
@@ -590,7 +680,11 @@ module Aws::QLDB
|
|
590
680
|
# resp.arn #=> String
|
591
681
|
# resp.state #=> String, one of "CREATING", "ACTIVE", "DELETING", "DELETED"
|
592
682
|
# resp.creation_date_time #=> Time
|
683
|
+
# resp.permissions_mode #=> String, one of "ALLOW_ALL", "STANDARD"
|
593
684
|
# resp.deletion_protection #=> Boolean
|
685
|
+
# resp.encryption_description.kms_key_arn #=> String
|
686
|
+
# resp.encryption_description.encryption_status #=> String, one of "ENABLED", "UPDATING", "KMS_KEY_INACCESSIBLE"
|
687
|
+
# resp.encryption_description.inaccessible_kms_key_date_time #=> Time
|
594
688
|
#
|
595
689
|
# @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/DescribeLedger AWS API Documentation
|
596
690
|
#
|
@@ -619,12 +713,12 @@ module Aws::QLDB
|
|
619
713
|
# The name of the ledger.
|
620
714
|
#
|
621
715
|
# @option params [required, Time,DateTime,Date,Integer,String] :inclusive_start_time
|
622
|
-
# The inclusive start date and time for the range of journal contents
|
623
|
-
#
|
716
|
+
# The inclusive start date and time for the range of journal contents to
|
717
|
+
# export.
|
624
718
|
#
|
625
719
|
# The `InclusiveStartTime` must be in `ISO 8601` date and time format
|
626
720
|
# and in Universal Coordinated Time (UTC). For example:
|
627
|
-
# `2019-06-13T21:36:34Z
|
721
|
+
# `2019-06-13T21:36:34Z`.
|
628
722
|
#
|
629
723
|
# The `InclusiveStartTime` must be before `ExclusiveEndTime`.
|
630
724
|
#
|
@@ -633,12 +727,12 @@ module Aws::QLDB
|
|
633
727
|
# `CreationDateTime`.
|
634
728
|
#
|
635
729
|
# @option params [required, Time,DateTime,Date,Integer,String] :exclusive_end_time
|
636
|
-
# The exclusive end date and time for the range of journal contents
|
637
|
-
#
|
730
|
+
# The exclusive end date and time for the range of journal contents to
|
731
|
+
# export.
|
638
732
|
#
|
639
733
|
# The `ExclusiveEndTime` must be in `ISO 8601` date and time format and
|
640
734
|
# in Universal Coordinated Time (UTC). For example:
|
641
|
-
# `2019-06-13T21:36:34Z
|
735
|
+
# `2019-06-13T21:36:34Z`.
|
642
736
|
#
|
643
737
|
# The `ExclusiveEndTime` must be less than or equal to the current UTC
|
644
738
|
# date and time.
|
@@ -654,8 +748,8 @@ module Aws::QLDB
|
|
654
748
|
# * Write objects into your Amazon Simple Storage Service (Amazon S3)
|
655
749
|
# bucket.
|
656
750
|
#
|
657
|
-
# * (Optional) Use your customer master key (CMK) in
|
658
|
-
# Service (
|
751
|
+
# * (Optional) Use your customer master key (CMK) in Key Management
|
752
|
+
# Service (KMS) for server-side encryption of your exported data.
|
659
753
|
#
|
660
754
|
# @return [Types::ExportJournalToS3Response] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
661
755
|
#
|
@@ -718,14 +812,14 @@ module Aws::QLDB
|
|
718
812
|
# The location of the block that you want to request. An address is an
|
719
813
|
# Amazon Ion structure that has two fields: `strandId` and `sequenceNo`.
|
720
814
|
#
|
721
|
-
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14\}
|
815
|
+
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14\}`.
|
722
816
|
#
|
723
817
|
# @option params [Types::ValueHolder] :digest_tip_address
|
724
818
|
# The latest block location covered by the digest for which to request a
|
725
819
|
# proof. An address is an Amazon Ion structure that has two fields:
|
726
820
|
# `strandId` and `sequenceNo`.
|
727
821
|
#
|
728
|
-
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49\}
|
822
|
+
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49\}`.
|
729
823
|
#
|
730
824
|
# @return [Types::GetBlockResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
731
825
|
#
|
@@ -802,17 +896,18 @@ module Aws::QLDB
|
|
802
896
|
# is an Amazon Ion structure that has two fields: `strandId` and
|
803
897
|
# `sequenceNo`.
|
804
898
|
#
|
805
|
-
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14\}
|
899
|
+
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14\}`.
|
806
900
|
#
|
807
901
|
# @option params [required, String] :document_id
|
808
|
-
# The
|
902
|
+
# The UUID (represented in Base62-encoded text) of the document to be
|
903
|
+
# verified.
|
809
904
|
#
|
810
905
|
# @option params [Types::ValueHolder] :digest_tip_address
|
811
906
|
# The latest block location covered by the digest for which to request a
|
812
907
|
# proof. An address is an Amazon Ion structure that has two fields:
|
813
908
|
# `strandId` and `sequenceNo`.
|
814
909
|
#
|
815
|
-
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49\}
|
910
|
+
# For example: `\{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49\}`.
|
816
911
|
#
|
817
912
|
# @return [Types::GetRevisionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
818
913
|
#
|
@@ -850,10 +945,18 @@ module Aws::QLDB
|
|
850
945
|
# given ledger. The output of each stream descriptor includes the same
|
851
946
|
# details that are returned by `DescribeJournalKinesisStream`.
|
852
947
|
#
|
948
|
+
# This action does not return any expired journal streams. For more
|
949
|
+
# information, see [Expiration for terminal streams][1] in the *Amazon
|
950
|
+
# QLDB Developer Guide*.
|
951
|
+
#
|
853
952
|
# This action returns a maximum of `MaxResults` items. It is paginated
|
854
953
|
# so that you can retrieve all the items by calling
|
855
954
|
# `ListJournalKinesisStreamsForLedger` multiple times.
|
856
955
|
#
|
956
|
+
#
|
957
|
+
#
|
958
|
+
# [1]: https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration
|
959
|
+
#
|
857
960
|
# @option params [required, String] :ledger_name
|
858
961
|
# The name of the ledger.
|
859
962
|
#
|
@@ -910,14 +1013,14 @@ module Aws::QLDB
|
|
910
1013
|
end
|
911
1014
|
|
912
1015
|
# Returns an array of journal export job descriptions for all ledgers
|
913
|
-
# that are associated with the current
|
1016
|
+
# that are associated with the current account and Region.
|
914
1017
|
#
|
915
1018
|
# This action returns a maximum of `MaxResults` items, and is paginated
|
916
1019
|
# so that you can retrieve all the items by calling
|
917
1020
|
# `ListJournalS3Exports` multiple times.
|
918
1021
|
#
|
919
1022
|
# This action does not return any expired export jobs. For more
|
920
|
-
# information, see [Export
|
1023
|
+
# information, see [Export job expiration][1] in the *Amazon QLDB
|
921
1024
|
# Developer Guide*.
|
922
1025
|
#
|
923
1026
|
#
|
@@ -982,7 +1085,7 @@ module Aws::QLDB
|
|
982
1085
|
# `ListJournalS3ExportsForLedger` multiple times.
|
983
1086
|
#
|
984
1087
|
# This action does not return any expired export jobs. For more
|
985
|
-
# information, see [Export
|
1088
|
+
# information, see [Export job expiration][1] in the *Amazon QLDB
|
986
1089
|
# Developer Guide*.
|
987
1090
|
#
|
988
1091
|
#
|
@@ -1044,7 +1147,7 @@ module Aws::QLDB
|
|
1044
1147
|
end
|
1045
1148
|
|
1046
1149
|
# Returns an array of ledger summaries that are associated with the
|
1047
|
-
# current
|
1150
|
+
# current account and Region.
|
1048
1151
|
#
|
1049
1152
|
# This action returns a maximum of 100 items and is paginated so that
|
1050
1153
|
# you can retrieve all the items by calling `ListLedgers` multiple
|
@@ -1094,8 +1197,8 @@ module Aws::QLDB
|
|
1094
1197
|
# Returns all tags for a specified Amazon QLDB resource.
|
1095
1198
|
#
|
1096
1199
|
# @option params [required, String] :resource_arn
|
1097
|
-
# The Amazon Resource Name (ARN) for which
|
1098
|
-
#
|
1200
|
+
# The Amazon Resource Name (ARN) for which to list the tags. For
|
1201
|
+
# example:
|
1099
1202
|
#
|
1100
1203
|
# `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`
|
1101
1204
|
#
|
@@ -1145,7 +1248,7 @@ module Aws::QLDB
|
|
1145
1248
|
# The inclusive start date and time from which to start streaming
|
1146
1249
|
# journal data. This parameter must be in `ISO 8601` date and time
|
1147
1250
|
# format and in Universal Coordinated Time (UTC). For example:
|
1148
|
-
# `2019-06-13T21:36:34Z
|
1251
|
+
# `2019-06-13T21:36:34Z`.
|
1149
1252
|
#
|
1150
1253
|
# The `InclusiveStartTime` cannot be in the future and must be before
|
1151
1254
|
# `ExclusiveEndTime`.
|
@@ -1161,7 +1264,7 @@ module Aws::QLDB
|
|
1161
1264
|
#
|
1162
1265
|
# The `ExclusiveEndTime` must be in `ISO 8601` date and time format and
|
1163
1266
|
# in Universal Coordinated Time (UTC). For example:
|
1164
|
-
# `2019-06-13T21:36:34Z
|
1267
|
+
# `2019-06-13T21:36:34Z`.
|
1165
1268
|
#
|
1166
1269
|
# @option params [required, Types::KinesisConfiguration] :kinesis_configuration
|
1167
1270
|
# The configuration settings of the Kinesis Data Streams destination for
|
@@ -1256,13 +1359,13 @@ module Aws::QLDB
|
|
1256
1359
|
# can specify up to 50 tag keys to remove.
|
1257
1360
|
#
|
1258
1361
|
# @option params [required, String] :resource_arn
|
1259
|
-
# The Amazon Resource Name (ARN) from which
|
1260
|
-
#
|
1362
|
+
# The Amazon Resource Name (ARN) from which to remove the tags. For
|
1363
|
+
# example:
|
1261
1364
|
#
|
1262
1365
|
# `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`
|
1263
1366
|
#
|
1264
1367
|
# @option params [required, Array<String>] :tag_keys
|
1265
|
-
# The list of tag keys
|
1368
|
+
# The list of tag keys to remove.
|
1266
1369
|
#
|
1267
1370
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1268
1371
|
#
|
@@ -1293,10 +1396,52 @@ module Aws::QLDB
|
|
1293
1396
|
# default.
|
1294
1397
|
#
|
1295
1398
|
# If deletion protection is enabled, you must first disable it before
|
1296
|
-
# you can delete the ledger
|
1297
|
-
#
|
1298
|
-
#
|
1299
|
-
#
|
1399
|
+
# you can delete the ledger. You can disable it by calling the
|
1400
|
+
# `UpdateLedger` operation to set the flag to `false`.
|
1401
|
+
#
|
1402
|
+
# @option params [String] :kms_key
|
1403
|
+
# The key in Key Management Service (KMS) to use for encryption of data
|
1404
|
+
# at rest in the ledger. For more information, see [Encryption at
|
1405
|
+
# rest][1] in the *Amazon QLDB Developer Guide*.
|
1406
|
+
#
|
1407
|
+
# Use one of the following options to specify this parameter:
|
1408
|
+
#
|
1409
|
+
# * `AWS_OWNED_KMS_KEY`\: Use an KMS key that is owned and managed by
|
1410
|
+
# Amazon Web Services on your behalf.
|
1411
|
+
#
|
1412
|
+
# * **Undefined**\: Make no changes to the KMS key of the ledger.
|
1413
|
+
#
|
1414
|
+
# * **A valid symmetric customer managed KMS key**\: Use the specified
|
1415
|
+
# KMS key in your account that you create, own, and manage.
|
1416
|
+
#
|
1417
|
+
# Amazon QLDB does not support asymmetric keys. For more information,
|
1418
|
+
# see [Using symmetric and asymmetric keys][2] in the *Key Management
|
1419
|
+
# Service Developer Guide*.
|
1420
|
+
#
|
1421
|
+
# To specify a customer managed KMS key, you can use its key ID, Amazon
|
1422
|
+
# Resource Name (ARN), alias name, or alias ARN. When using an alias
|
1423
|
+
# name, prefix it with `"alias/"`. To specify a key in a different
|
1424
|
+
# account, you must use the key ARN or alias ARN.
|
1425
|
+
#
|
1426
|
+
# For example:
|
1427
|
+
#
|
1428
|
+
# * Key ID: `1234abcd-12ab-34cd-56ef-1234567890ab`
|
1429
|
+
#
|
1430
|
+
# * Key ARN:
|
1431
|
+
# `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
|
1432
|
+
#
|
1433
|
+
# * Alias name: `alias/ExampleAlias`
|
1434
|
+
#
|
1435
|
+
# * Alias ARN: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias`
|
1436
|
+
#
|
1437
|
+
# For more information, see [Key identifiers (KeyId)][3] in the *Key
|
1438
|
+
# Management Service Developer Guide*.
|
1439
|
+
#
|
1440
|
+
#
|
1441
|
+
#
|
1442
|
+
# [1]: https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html
|
1443
|
+
# [2]: https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html
|
1444
|
+
# [3]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id
|
1300
1445
|
#
|
1301
1446
|
# @return [Types::UpdateLedgerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1302
1447
|
#
|
@@ -1305,12 +1450,14 @@ module Aws::QLDB
|
|
1305
1450
|
# * {Types::UpdateLedgerResponse#state #state} => String
|
1306
1451
|
# * {Types::UpdateLedgerResponse#creation_date_time #creation_date_time} => Time
|
1307
1452
|
# * {Types::UpdateLedgerResponse#deletion_protection #deletion_protection} => Boolean
|
1453
|
+
# * {Types::UpdateLedgerResponse#encryption_description #encryption_description} => Types::LedgerEncryptionDescription
|
1308
1454
|
#
|
1309
1455
|
# @example Request syntax with placeholder values
|
1310
1456
|
#
|
1311
1457
|
# resp = client.update_ledger({
|
1312
1458
|
# name: "LedgerName", # required
|
1313
1459
|
# deletion_protection: false,
|
1460
|
+
# kms_key: "KmsKey",
|
1314
1461
|
# })
|
1315
1462
|
#
|
1316
1463
|
# @example Response structure
|
@@ -1320,6 +1467,9 @@ module Aws::QLDB
|
|
1320
1467
|
# resp.state #=> String, one of "CREATING", "ACTIVE", "DELETING", "DELETED"
|
1321
1468
|
# resp.creation_date_time #=> Time
|
1322
1469
|
# resp.deletion_protection #=> Boolean
|
1470
|
+
# resp.encryption_description.kms_key_arn #=> String
|
1471
|
+
# resp.encryption_description.encryption_status #=> String, one of "ENABLED", "UPDATING", "KMS_KEY_INACCESSIBLE"
|
1472
|
+
# resp.encryption_description.inaccessible_kms_key_date_time #=> Time
|
1323
1473
|
#
|
1324
1474
|
# @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/UpdateLedger AWS API Documentation
|
1325
1475
|
#
|
@@ -1330,6 +1480,82 @@ module Aws::QLDB
|
|
1330
1480
|
req.send_request(options)
|
1331
1481
|
end
|
1332
1482
|
|
1483
|
+
# Updates the permissions mode of a ledger.
|
1484
|
+
#
|
1485
|
+
# Before you switch to the `STANDARD` permissions mode, you must first
|
1486
|
+
# create all required IAM policies and table tags to avoid disruption to
|
1487
|
+
# your users. To learn more, see [Migrating to the standard permissions
|
1488
|
+
# mode][1] in the *Amazon QLDB Developer Guide*.
|
1489
|
+
#
|
1490
|
+
#
|
1491
|
+
#
|
1492
|
+
# [1]: https://docs.aws.amazon.com/qldb/latest/developerguide/ledger-management.basics.html#ledger-mgmt.basics.update-permissions.migrating
|
1493
|
+
#
|
1494
|
+
# @option params [required, String] :name
|
1495
|
+
# The name of the ledger.
|
1496
|
+
#
|
1497
|
+
# @option params [required, String] :permissions_mode
|
1498
|
+
# The permissions mode to assign to the ledger. This parameter can have
|
1499
|
+
# one of the following values:
|
1500
|
+
#
|
1501
|
+
# * `ALLOW_ALL`\: A legacy permissions mode that enables access control
|
1502
|
+
# with API-level granularity for ledgers.
|
1503
|
+
#
|
1504
|
+
# This mode allows users who have the `SendCommand` API permission for
|
1505
|
+
# this ledger to run all PartiQL commands (hence, `ALLOW_ALL`) on any
|
1506
|
+
# tables in the specified ledger. This mode disregards any table-level
|
1507
|
+
# or command-level IAM permissions policies that you create for the
|
1508
|
+
# ledger.
|
1509
|
+
#
|
1510
|
+
# * `STANDARD`\: (*Recommended*) A permissions mode that enables access
|
1511
|
+
# control with finer granularity for ledgers, tables, and PartiQL
|
1512
|
+
# commands.
|
1513
|
+
#
|
1514
|
+
# By default, this mode denies all user requests to run any PartiQL
|
1515
|
+
# commands on any tables in this ledger. To allow PartiQL commands to
|
1516
|
+
# run, you must create IAM permissions policies for specific table
|
1517
|
+
# resources and PartiQL actions, in addition to the `SendCommand` API
|
1518
|
+
# permission for the ledger. For information, see [Getting started
|
1519
|
+
# with the standard permissions mode][1] in the *Amazon QLDB Developer
|
1520
|
+
# Guide*.
|
1521
|
+
#
|
1522
|
+
# <note markdown="1"> We strongly recommend using the `STANDARD` permissions mode to
|
1523
|
+
# maximize the security of your ledger data.
|
1524
|
+
#
|
1525
|
+
# </note>
|
1526
|
+
#
|
1527
|
+
#
|
1528
|
+
#
|
1529
|
+
# [1]: https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html
|
1530
|
+
#
|
1531
|
+
# @return [Types::UpdateLedgerPermissionsModeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1532
|
+
#
|
1533
|
+
# * {Types::UpdateLedgerPermissionsModeResponse#name #name} => String
|
1534
|
+
# * {Types::UpdateLedgerPermissionsModeResponse#arn #arn} => String
|
1535
|
+
# * {Types::UpdateLedgerPermissionsModeResponse#permissions_mode #permissions_mode} => String
|
1536
|
+
#
|
1537
|
+
# @example Request syntax with placeholder values
|
1538
|
+
#
|
1539
|
+
# resp = client.update_ledger_permissions_mode({
|
1540
|
+
# name: "LedgerName", # required
|
1541
|
+
# permissions_mode: "ALLOW_ALL", # required, accepts ALLOW_ALL, STANDARD
|
1542
|
+
# })
|
1543
|
+
#
|
1544
|
+
# @example Response structure
|
1545
|
+
#
|
1546
|
+
# resp.name #=> String
|
1547
|
+
# resp.arn #=> String
|
1548
|
+
# resp.permissions_mode #=> String, one of "ALLOW_ALL", "STANDARD"
|
1549
|
+
#
|
1550
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/UpdateLedgerPermissionsMode AWS API Documentation
|
1551
|
+
#
|
1552
|
+
# @overload update_ledger_permissions_mode(params = {})
|
1553
|
+
# @param [Hash] params ({})
|
1554
|
+
def update_ledger_permissions_mode(params = {}, options = {})
|
1555
|
+
req = build_request(:update_ledger_permissions_mode, params)
|
1556
|
+
req.send_request(options)
|
1557
|
+
end
|
1558
|
+
|
1333
1559
|
# @!endgroup
|
1334
1560
|
|
1335
1561
|
# @param params ({})
|
@@ -1343,7 +1569,7 @@ module Aws::QLDB
|
|
1343
1569
|
params: params,
|
1344
1570
|
config: config)
|
1345
1571
|
context[:gem_name] = 'aws-sdk-qldb'
|
1346
|
-
context[:gem_version] = '1.
|
1572
|
+
context[:gem_version] = '1.16.0'
|
1347
1573
|
Seahorse::Client::Request.new(handlers, context)
|
1348
1574
|
end
|
1349
1575
|
|