aws-sdk-s3control 1.24.0 → 1.29.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +167 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-s3control.rb +1 -1
- data/lib/aws-sdk-s3control/arn/outpost_access_point_arn.rb +6 -2
- data/lib/aws-sdk-s3control/arn/outpost_bucket_arn.rb +6 -2
- data/lib/aws-sdk-s3control/client.rb +796 -287
- data/lib/aws-sdk-s3control/client_api.rb +266 -1
- data/lib/aws-sdk-s3control/plugins/arn.rb +28 -16
- data/lib/aws-sdk-s3control/plugins/dualstack.rb +11 -10
- data/lib/aws-sdk-s3control/plugins/s3_control_signer.rb +6 -2
- data/lib/aws-sdk-s3control/types.rb +1163 -105
- metadata +8 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 37fa8a338007af61764ea82bbd14fae8a4efafe7b464c4185471db71d38e6fe5
|
4
|
+
data.tar.gz: 0d1804d2c2d3c6d32ed3141073a01d2f7ebc57c8fcd4299d824aa19416fe431c
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 0a4c9b73f1e05376865bf3944ae8069992c3cc3aa26792e06cb41eff4d724b3c1edb3daf86ee085c9d3f71469abb8e4fced1b56356d12108696b76ce7b3f1885
|
7
|
+
data.tar.gz: c421e3a27cbec40940e9203cc3a3cdd853b148c24e36e11c80d34f1f1b566f1157803b899c470ff9a57674c681a06e6d393a015417364759b56c6a9257d932e4
|
data/CHANGELOG.md
ADDED
@@ -0,0 +1,167 @@
|
|
1
|
+
Unreleased Changes
|
2
|
+
------------------
|
3
|
+
|
4
|
+
1.29.0 (2021-03-08)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Documentation updates for Amazon S3
|
8
|
+
|
9
|
+
1.28.0 (2021-02-23)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Documentation updates for s3-control
|
13
|
+
|
14
|
+
1.27.0 (2021-02-02)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Amazon S3 Batch Operations now supports Delete Object Tagging
|
18
|
+
|
19
|
+
* Feature - Support PrivateLink using the client `:endpoint` option. This patch has several minor behavioral changes. 1) Any operation using the `outpost_id` parameter with a client configured with `:use_dualstack_endpoint` will now raise an `ArgumentError` as dualstack is not supported by S3 Outposts. 2) Fix a bug where clients configured with `:use_dualstack_endpoint` resolved to the wrong endpoint by not prefixing the account id to the host. 3) A client constructed using both `:use_dualstack_endpoint` and `:endpoint` will now raise an `ArgumentError`.
|
20
|
+
|
21
|
+
1.26.0 (2021-01-14)
|
22
|
+
------------------
|
23
|
+
|
24
|
+
* Feature - Amazon S3 Batch Operations now supports restoring objects from the S3 Intelligent-Tiering Archive Access and Deep Archive Access tiers.
|
25
|
+
|
26
|
+
1.25.0 (2020-11-18)
|
27
|
+
------------------
|
28
|
+
|
29
|
+
* Feature - AWS S3 Storage Lens provides visibility into your storage usage and activity trends at the organization or account level, with aggregations by Region, storage class, bucket, and prefix.
|
30
|
+
|
31
|
+
1.24.0 (2020-09-30)
|
32
|
+
------------------
|
33
|
+
|
34
|
+
* Feature - Amazon S3 on Outposts expands object storage to on-premises AWS Outposts environments, enabling you to store and retrieve objects using S3 APIs and features.
|
35
|
+
|
36
|
+
* Feature - Support Outpost Access Point and Outpost Bucket ARNs.
|
37
|
+
|
38
|
+
1.23.0 (2020-09-15)
|
39
|
+
------------------
|
40
|
+
|
41
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
42
|
+
|
43
|
+
1.22.0 (2020-08-25)
|
44
|
+
------------------
|
45
|
+
|
46
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
47
|
+
|
48
|
+
1.21.0 (2020-06-23)
|
49
|
+
------------------
|
50
|
+
|
51
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
52
|
+
|
53
|
+
1.20.1 (2020-06-11)
|
54
|
+
------------------
|
55
|
+
|
56
|
+
* Issue - Republish previous version with correct dependency on `aws-sdk-core`.
|
57
|
+
|
58
|
+
1.20.0 (2020-06-10)
|
59
|
+
------------------
|
60
|
+
|
61
|
+
* Issue - This version has been yanked. (#2327).
|
62
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
63
|
+
|
64
|
+
1.19.0 (2020-05-28)
|
65
|
+
------------------
|
66
|
+
|
67
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
68
|
+
|
69
|
+
1.18.0 (2020-05-07)
|
70
|
+
------------------
|
71
|
+
|
72
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
73
|
+
|
74
|
+
1.17.0 (2020-05-04)
|
75
|
+
------------------
|
76
|
+
|
77
|
+
* Feature - Amazon S3 Batch Operations now supports Object Lock.
|
78
|
+
|
79
|
+
1.16.0 (2020-03-16)
|
80
|
+
------------------
|
81
|
+
|
82
|
+
* Feature - Amazon S3 now supports Batch Operations job tagging.
|
83
|
+
|
84
|
+
1.15.0 (2020-03-09)
|
85
|
+
------------------
|
86
|
+
|
87
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
88
|
+
|
89
|
+
1.14.0 (2019-12-03)
|
90
|
+
------------------
|
91
|
+
|
92
|
+
* Feature - Amazon S3 Access Points is a new S3 feature that simplifies managing data access at scale for shared data sets on Amazon S3. Access Points provide a customizable way to access the objects in a bucket, with a unique hostname and access policy that enforces the specific permissions and network controls for any request made through the access point. This represents a new way of provisioning access to shared data sets.
|
93
|
+
|
94
|
+
1.13.0 (2019-10-23)
|
95
|
+
------------------
|
96
|
+
|
97
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
98
|
+
|
99
|
+
1.12.0 (2019-07-25)
|
100
|
+
------------------
|
101
|
+
|
102
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
103
|
+
|
104
|
+
1.11.0 (2019-07-01)
|
105
|
+
------------------
|
106
|
+
|
107
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
108
|
+
|
109
|
+
1.10.0 (2019-06-17)
|
110
|
+
------------------
|
111
|
+
|
112
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
113
|
+
|
114
|
+
1.9.0 (2019-05-29)
|
115
|
+
------------------
|
116
|
+
|
117
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
118
|
+
|
119
|
+
1.8.0 (2019-05-21)
|
120
|
+
------------------
|
121
|
+
|
122
|
+
* Feature - API update.
|
123
|
+
|
124
|
+
1.7.0 (2019-05-15)
|
125
|
+
------------------
|
126
|
+
|
127
|
+
* Feature - API update.
|
128
|
+
|
129
|
+
1.6.0 (2019-05-14)
|
130
|
+
------------------
|
131
|
+
|
132
|
+
* Feature - API update.
|
133
|
+
|
134
|
+
1.5.0 (2019-04-30)
|
135
|
+
------------------
|
136
|
+
|
137
|
+
* Feature - API update.
|
138
|
+
|
139
|
+
1.4.0 (2019-03-21)
|
140
|
+
------------------
|
141
|
+
|
142
|
+
* Feature - API update.
|
143
|
+
|
144
|
+
1.3.0 (2019-03-18)
|
145
|
+
------------------
|
146
|
+
|
147
|
+
* Feature - API update.
|
148
|
+
|
149
|
+
1.2.0 (2019-03-14)
|
150
|
+
------------------
|
151
|
+
|
152
|
+
* Feature - API update.
|
153
|
+
|
154
|
+
1.1.0 (2018-11-20)
|
155
|
+
------------------
|
156
|
+
|
157
|
+
* Feature - Support S3 Control plugin working with endpoint trait.
|
158
|
+
|
159
|
+
1.0.1 (2018-11-16)
|
160
|
+
------------------
|
161
|
+
|
162
|
+
* Issue - Update version dependency on `aws-sdk-core` to support endpoint discovery.
|
163
|
+
|
164
|
+
1.0.0 (2018-11-15)
|
165
|
+
------------------
|
166
|
+
|
167
|
+
* Feature - Initial release of `aws-sdk-s3control`.
|
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.29.0
|
data/lib/aws-sdk-s3control.rb
CHANGED
@@ -68,8 +68,12 @@ module Aws
|
|
68
68
|
end
|
69
69
|
|
70
70
|
# Outpost Access Point ARNs currently do not support dualstack
|
71
|
-
def host_url(region, _dualstack = false)
|
72
|
-
|
71
|
+
def host_url(region, _dualstack = false, custom_endpoint = nil)
|
72
|
+
if custom_endpoint
|
73
|
+
custom_endpoint
|
74
|
+
else
|
75
|
+
"s3-outposts.#{region}.amazonaws.com"
|
76
|
+
end
|
73
77
|
end
|
74
78
|
end
|
75
79
|
end
|
@@ -64,8 +64,12 @@ module Aws
|
|
64
64
|
end
|
65
65
|
|
66
66
|
# Outpost Bucket ARNs currently do not support dualstack
|
67
|
-
def host_url(region, _dualstack = false)
|
68
|
-
|
67
|
+
def host_url(region, _dualstack = false, custom_endpoint = nil)
|
68
|
+
if custom_endpoint
|
69
|
+
custom_endpoint
|
70
|
+
else
|
71
|
+
"s3-outposts.#{region}.amazonaws.com"
|
72
|
+
end
|
69
73
|
end
|
70
74
|
end
|
71
75
|
end
|
@@ -345,7 +345,7 @@ module Aws::S3Control
|
|
345
345
|
|
346
346
|
# Creates an access point and associates it with the specified bucket.
|
347
347
|
# For more information, see [Managing Data Access with Amazon S3 Access
|
348
|
-
# Points][1] in the *Amazon Simple Storage Service
|
348
|
+
# Points][1] in the *Amazon Simple Storage Service User Guide*.
|
349
349
|
#
|
350
350
|
#
|
351
351
|
#
|
@@ -362,34 +362,35 @@ module Aws::S3Control
|
|
362
362
|
#
|
363
363
|
# * Does not support object lock for S3 on Outposts buckets.
|
364
364
|
#
|
365
|
-
# For more information, see [Using Amazon S3 on
|
366
|
-
#
|
367
|
-
# Simple Storage Service Developer Guide </i>.
|
365
|
+
# For more information, see [Using Amazon S3 on Outposts][2] in the
|
366
|
+
# <i>Amazon Simple Storage Service User Guide </i>.
|
368
367
|
#
|
369
368
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
370
|
-
# additional parameter of outpost-id to be passed with the
|
371
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
372
|
-
# an example of the request syntax for Amazon S3 on
|
373
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
374
|
-
# using the access point ARN, see the
|
369
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
370
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
371
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
372
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
373
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
374
|
+
# [Examples][3] section.
|
375
375
|
#
|
376
376
|
#
|
377
377
|
#
|
378
378
|
# The following actions are related to `CreateAccessPoint`\:
|
379
379
|
#
|
380
|
-
# * [GetAccessPoint][
|
380
|
+
# * [GetAccessPoint][4]
|
381
381
|
#
|
382
|
-
# * [DeleteAccessPoint][
|
382
|
+
# * [DeleteAccessPoint][5]
|
383
383
|
#
|
384
|
-
# * [ListAccessPoints][
|
384
|
+
# * [ListAccessPoints][6]
|
385
385
|
#
|
386
386
|
#
|
387
387
|
#
|
388
388
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
|
389
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
390
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
391
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
392
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
389
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
390
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html#API_control_CreateAccessPoint_Examples
|
391
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html
|
392
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html
|
393
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessPoints.html
|
393
394
|
#
|
394
395
|
# @option params [required, String] :account_id
|
395
396
|
# The AWS account ID for the owner of the bucket for which you want to
|
@@ -402,8 +403,11 @@ module Aws::S3Control
|
|
402
403
|
# The name of the bucket that you want to associate this access point
|
403
404
|
# with.
|
404
405
|
#
|
405
|
-
# For Amazon S3 on Outposts
|
406
|
-
# the
|
406
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
407
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
408
|
+
#
|
409
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
410
|
+
# you must specify the ARN of the bucket accessed in the format
|
407
411
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
408
412
|
# For example, to access the bucket `reports` through outpost
|
409
413
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -422,7 +426,7 @@ module Aws::S3Control
|
|
422
426
|
#
|
423
427
|
# @option params [Types::PublicAccessBlockConfiguration] :public_access_block_configuration
|
424
428
|
# The `PublicAccessBlock` configuration that you want to apply to this
|
425
|
-
# Amazon S3
|
429
|
+
# Amazon S3 account. You can enable the configuration options in any
|
426
430
|
# combination. For more information about when Amazon S3 considers a
|
427
431
|
# bucket or object public, see [The Meaning of "Public"][1] in the
|
428
432
|
# *Amazon Simple Storage Service Developer Guide*.
|
@@ -467,59 +471,58 @@ module Aws::S3Control
|
|
467
471
|
req.send_request(options)
|
468
472
|
end
|
469
473
|
|
470
|
-
# <note markdown="1"> This
|
471
|
-
#
|
472
|
-
#
|
474
|
+
# <note markdown="1"> This action creates an Amazon S3 on Outposts bucket. To create an S3
|
475
|
+
# bucket, see [Create Bucket][1] in the *Amazon Simple Storage Service
|
476
|
+
# API*.
|
473
477
|
#
|
474
478
|
# </note>
|
475
479
|
#
|
476
480
|
# Creates a new Outposts bucket. By creating the bucket, you become the
|
477
481
|
# bucket owner. To create an Outposts bucket, you must have S3 on
|
478
482
|
# Outposts. For more information, see [Using Amazon S3 on Outposts][2]
|
479
|
-
# in *Amazon Simple Storage Service
|
483
|
+
# in *Amazon Simple Storage Service User Guide*.
|
480
484
|
#
|
481
485
|
# Not every string is an acceptable bucket name. For information on
|
482
486
|
# bucket naming restrictions, see [Working with Amazon S3 Buckets][3].
|
483
487
|
#
|
484
|
-
# S3 on Outposts buckets
|
485
|
-
#
|
486
|
-
# * ACLs. Instead, configure access point policies to manage access to
|
487
|
-
# buckets.
|
488
|
+
# S3 on Outposts buckets support:
|
488
489
|
#
|
489
|
-
# *
|
490
|
+
# * Tags
|
490
491
|
#
|
491
|
-
# *
|
492
|
+
# * LifecycleConfigurations for deleting expired objects
|
492
493
|
#
|
493
|
-
#
|
494
|
+
# For a list of Amazon S3 features not supported by Amazon S3 on
|
495
|
+
# Outposts, see [Unsupported Amazon S3 features][4].
|
494
496
|
#
|
495
497
|
# For an example of the request syntax for Amazon S3 on Outposts that
|
496
|
-
# uses the S3 on Outposts endpoint hostname prefix and
|
497
|
-
# your API request, see the [
|
498
|
+
# uses the S3 on Outposts endpoint hostname prefix and
|
499
|
+
# `x-amz-outpost-id` in your API request, see the [Examples][5] section.
|
498
500
|
#
|
499
501
|
# The following actions are related to `CreateBucket` for Amazon S3 on
|
500
502
|
# Outposts:
|
501
503
|
#
|
502
|
-
# * [PutObject][
|
504
|
+
# * [PutObject][6]
|
503
505
|
#
|
504
|
-
# * [GetBucket][
|
506
|
+
# * [GetBucket][7]
|
505
507
|
#
|
506
|
-
# * [DeleteBucket][
|
508
|
+
# * [DeleteBucket][8]
|
507
509
|
#
|
508
|
-
# * [CreateAccessPoint][
|
510
|
+
# * [CreateAccessPoint][9]
|
509
511
|
#
|
510
|
-
# * [PutAccessPointPolicy][
|
512
|
+
# * [PutAccessPointPolicy][10]
|
511
513
|
#
|
512
514
|
#
|
513
515
|
#
|
514
516
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
515
517
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
516
518
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html#bucketnamingrules
|
517
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
518
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
519
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
520
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
521
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
522
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
519
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OnOutpostsRestrictionsLimitations.html#S3OnOutpostsFeatureLimitations
|
520
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html#API_control_CreateBucket_Examples
|
521
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
522
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucket.html
|
523
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucket.html
|
524
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html
|
525
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointPolicy.html
|
523
526
|
#
|
524
527
|
# @option params [String] :acl
|
525
528
|
# The canned ACL to apply to the bucket.
|
@@ -626,13 +629,13 @@ module Aws::S3Control
|
|
626
629
|
req.send_request(options)
|
627
630
|
end
|
628
631
|
|
629
|
-
# S3 Batch Operations
|
630
|
-
# objects. Batch Operations can run a single
|
632
|
+
# You can use S3 Batch Operations to perform large-scale batch actions
|
633
|
+
# on Amazon S3 objects. Batch Operations can run a single action on
|
631
634
|
# lists of Amazon S3 objects that you specify. For more information, see
|
632
|
-
# [S3 Batch Operations][1] in the *Amazon Simple Storage Service
|
633
|
-
#
|
635
|
+
# [S3 Batch Operations][1] in the *Amazon Simple Storage Service User
|
636
|
+
# Guide*.
|
634
637
|
#
|
635
|
-
# This
|
638
|
+
# This action creates a S3 Batch Operations job.
|
636
639
|
#
|
637
640
|
#
|
638
641
|
#
|
@@ -646,6 +649,8 @@ module Aws::S3Control
|
|
646
649
|
#
|
647
650
|
# * [UpdateJobStatus][5]
|
648
651
|
#
|
652
|
+
# * [JobOperation][6]
|
653
|
+
#
|
649
654
|
#
|
650
655
|
#
|
651
656
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/batch-ops-basics.html
|
@@ -653,6 +658,7 @@ module Aws::S3Control
|
|
653
658
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListJobs.html
|
654
659
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobPriority.html
|
655
660
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
|
661
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_JobOperation.html
|
656
662
|
#
|
657
663
|
# @option params [required, String] :account_id
|
658
664
|
# The AWS account ID that creates the job.
|
@@ -663,14 +669,13 @@ module Aws::S3Control
|
|
663
669
|
# S3 console.
|
664
670
|
#
|
665
671
|
# @option params [required, Types::JobOperation] :operation
|
666
|
-
# The
|
667
|
-
#
|
668
|
-
#
|
669
|
-
# Guide*.
|
672
|
+
# The action that you want this job to perform on every object listed in
|
673
|
+
# the manifest. For more information about the available actions, see
|
674
|
+
# [Operations][1] in the *Amazon Simple Storage Service User Guide*.
|
670
675
|
#
|
671
676
|
#
|
672
677
|
#
|
673
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/batch-ops-
|
678
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/batch-ops-actions.html
|
674
679
|
#
|
675
680
|
# @option params [required, Types::JobReport] :report
|
676
681
|
# Configuration parameters for the optional job-completion report.
|
@@ -697,7 +702,7 @@ module Aws::S3Control
|
|
697
702
|
# @option params [required, String] :role_arn
|
698
703
|
# The Amazon Resource Name (ARN) for the AWS Identity and Access
|
699
704
|
# Management (IAM) role that Batch Operations will use to run this
|
700
|
-
# job's
|
705
|
+
# job's action on every object in the manifest.
|
701
706
|
#
|
702
707
|
# @option params [Array<Types::S3Tag>] :tags
|
703
708
|
# A set of tags to associate with the S3 Batch Operations job. This is
|
@@ -791,6 +796,8 @@ module Aws::S3Control
|
|
791
796
|
# },
|
792
797
|
# ],
|
793
798
|
# },
|
799
|
+
# s3_delete_object_tagging: {
|
800
|
+
# },
|
794
801
|
# s3_initiate_restore_object: {
|
795
802
|
# expiration_in_days: 1,
|
796
803
|
# glacier_job_tier: "BULK", # accepts BULK, STANDARD
|
@@ -854,12 +861,12 @@ module Aws::S3Control
|
|
854
861
|
# Deletes the specified access point.
|
855
862
|
#
|
856
863
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
857
|
-
# additional parameter of outpost-id to be passed with the
|
858
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
859
|
-
# an example of the request syntax for Amazon S3 on
|
860
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
861
|
-
# using the access point ARN, see the
|
862
|
-
#
|
864
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
865
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
866
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
867
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
868
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
869
|
+
# [Examples][1] section.
|
863
870
|
#
|
864
871
|
# The following actions are related to `DeleteAccessPoint`\:
|
865
872
|
#
|
@@ -871,7 +878,7 @@ module Aws::S3Control
|
|
871
878
|
#
|
872
879
|
#
|
873
880
|
#
|
874
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
881
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html#API_control_DeleteAccessPoint_Examples
|
875
882
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html
|
876
883
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html
|
877
884
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessPoints.html
|
@@ -882,8 +889,11 @@ module Aws::S3Control
|
|
882
889
|
# @option params [required, String] :name
|
883
890
|
# The name of the access point you want to delete.
|
884
891
|
#
|
885
|
-
# For Amazon S3 on Outposts
|
886
|
-
#
|
892
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
893
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
894
|
+
#
|
895
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
896
|
+
# you must specify the ARN of the access point accessed in the format
|
887
897
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
888
898
|
# For example, to access the access point `reports-ap` through outpost
|
889
899
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -914,11 +924,12 @@ module Aws::S3Control
|
|
914
924
|
#
|
915
925
|
#
|
916
926
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
917
|
-
# additional parameter of outpost-id to be passed with the
|
918
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
919
|
-
# an example of the request syntax for Amazon S3 on
|
920
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
921
|
-
# using the access point ARN, see the
|
927
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
928
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
929
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
930
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
931
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
932
|
+
# [Examples][1] section.
|
922
933
|
#
|
923
934
|
# The following actions are related to `DeleteAccessPointPolicy`\:
|
924
935
|
#
|
@@ -928,7 +939,7 @@ module Aws::S3Control
|
|
928
939
|
#
|
929
940
|
#
|
930
941
|
#
|
931
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
942
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointPolicy.html#API_control_DeleteAccessPointPolicy_Examples
|
932
943
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointPolicy.html
|
933
944
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointPolicy.html
|
934
945
|
#
|
@@ -938,8 +949,11 @@ module Aws::S3Control
|
|
938
949
|
# @option params [required, String] :name
|
939
950
|
# The name of the access point whose policy you want to delete.
|
940
951
|
#
|
941
|
-
# For Amazon S3 on Outposts
|
942
|
-
#
|
952
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
953
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
954
|
+
#
|
955
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
956
|
+
# you must specify the ARN of the access point accessed in the format
|
943
957
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
944
958
|
# For example, to access the access point `reports-ap` through outpost
|
945
959
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -965,9 +979,9 @@ module Aws::S3Control
|
|
965
979
|
req.send_request(options)
|
966
980
|
end
|
967
981
|
|
968
|
-
# <note markdown="1"> This
|
969
|
-
#
|
970
|
-
#
|
982
|
+
# <note markdown="1"> This action deletes an Amazon S3 on Outposts bucket. To delete an S3
|
983
|
+
# bucket, see [DeleteBucket][1] in the *Amazon Simple Storage Service
|
984
|
+
# API*.
|
971
985
|
#
|
972
986
|
# </note>
|
973
987
|
#
|
@@ -975,14 +989,15 @@ module Aws::S3Control
|
|
975
989
|
# object versions and delete markers) in the bucket must be deleted
|
976
990
|
# before the bucket itself can be deleted. For more information, see
|
977
991
|
# [Using Amazon S3 on Outposts][2] in *Amazon Simple Storage Service
|
978
|
-
#
|
992
|
+
# User Guide*.
|
979
993
|
#
|
980
994
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
981
|
-
# additional parameter of outpost-id to be passed with the
|
982
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
983
|
-
# an example of the request syntax for Amazon S3 on
|
984
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
985
|
-
# using the access point ARN, see the
|
995
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
996
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
997
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
998
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
999
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
1000
|
+
# [Examples][3] section.
|
986
1001
|
#
|
987
1002
|
# **Related Resources**
|
988
1003
|
#
|
@@ -996,9 +1011,9 @@ module Aws::S3Control
|
|
996
1011
|
#
|
997
1012
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
998
1013
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
999
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1014
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucket.html#API_control_DeleteBucket_Examples
|
1000
1015
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
|
1001
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1016
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucket.html
|
1002
1017
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
1003
1018
|
#
|
1004
1019
|
# @option params [required, String] :account_id
|
@@ -1007,8 +1022,11 @@ module Aws::S3Control
|
|
1007
1022
|
# @option params [required, String] :bucket
|
1008
1023
|
# Specifies the bucket being deleted.
|
1009
1024
|
#
|
1010
|
-
# For Amazon S3 on Outposts
|
1011
|
-
# the
|
1025
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1026
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1027
|
+
#
|
1028
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1029
|
+
# you must specify the ARN of the bucket accessed in the format
|
1012
1030
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1013
1031
|
# For example, to access the bucket `reports` through outpost
|
1014
1032
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1034,7 +1052,7 @@ module Aws::S3Control
|
|
1034
1052
|
req.send_request(options)
|
1035
1053
|
end
|
1036
1054
|
|
1037
|
-
# <note markdown="1"> This
|
1055
|
+
# <note markdown="1"> This action deletes an Amazon S3 on Outposts bucket's lifecycle
|
1038
1056
|
# configuration. To delete an S3 bucket's lifecycle configuration, see
|
1039
1057
|
# [DeleteBucketLifecycle][1] in the *Amazon Simple Storage Service API*.
|
1040
1058
|
#
|
@@ -1046,22 +1064,23 @@ module Aws::S3Control
|
|
1046
1064
|
# objects never expire, and Amazon S3 on Outposts no longer
|
1047
1065
|
# automatically deletes any objects on the basis of rules contained in
|
1048
1066
|
# the deleted lifecycle configuration. For more information, see [Using
|
1049
|
-
# Amazon S3 on Outposts][2] in *Amazon Simple Storage Service
|
1067
|
+
# Amazon S3 on Outposts][2] in *Amazon Simple Storage Service User
|
1050
1068
|
# Guide*.
|
1051
1069
|
#
|
1052
|
-
# To use this
|
1053
|
-
# `
|
1070
|
+
# To use this action, you must have permission to perform the
|
1071
|
+
# `s3-outposts:DeleteLifecycleConfiguration` action. By default, the
|
1054
1072
|
# bucket owner has this permission and the Outposts bucket owner can
|
1055
1073
|
# grant this permission to others.
|
1056
1074
|
#
|
1057
1075
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
1058
|
-
# additional parameter of outpost-id to be passed with the
|
1059
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
1060
|
-
# an example of the request syntax for Amazon S3 on
|
1061
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
1062
|
-
# using the access point ARN, see the
|
1063
|
-
#
|
1064
|
-
#
|
1076
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
1077
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
1078
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
1079
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
1080
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
1081
|
+
# [Examples][3] section.
|
1082
|
+
#
|
1083
|
+
# For more information about object expiration, see [Elements to
|
1065
1084
|
# Describe Lifecycle Actions][4].
|
1066
1085
|
#
|
1067
1086
|
# Related actions include:
|
@@ -1074,7 +1093,7 @@ module Aws::S3Control
|
|
1074
1093
|
#
|
1075
1094
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
1076
1095
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
1077
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1096
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketLifecycleConfiguration.html#API_control_DeleteBucketLifecycleConfiguration_Examples
|
1078
1097
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
|
1079
1098
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketLifecycleConfiguration.html
|
1080
1099
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html
|
@@ -1083,10 +1102,13 @@ module Aws::S3Control
|
|
1083
1102
|
# The account ID of the lifecycle configuration to delete.
|
1084
1103
|
#
|
1085
1104
|
# @option params [required, String] :bucket
|
1086
|
-
#
|
1105
|
+
# Specifies the bucket.
|
1106
|
+
#
|
1107
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1108
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1087
1109
|
#
|
1088
|
-
# For
|
1089
|
-
# the format
|
1110
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1111
|
+
# you must specify the ARN of the bucket accessed in the format
|
1090
1112
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1091
1113
|
# For example, to access the bucket `reports` through outpost
|
1092
1114
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1112,20 +1134,20 @@ module Aws::S3Control
|
|
1112
1134
|
req.send_request(options)
|
1113
1135
|
end
|
1114
1136
|
|
1115
|
-
# <note markdown="1"> This
|
1116
|
-
#
|
1117
|
-
#
|
1137
|
+
# <note markdown="1"> This action deletes an Amazon S3 on Outposts bucket policy. To delete
|
1138
|
+
# an S3 bucket policy, see [DeleteBucketPolicy][1] in the *Amazon Simple
|
1139
|
+
# Storage Service API*.
|
1118
1140
|
#
|
1119
1141
|
# </note>
|
1120
1142
|
#
|
1121
|
-
# This implementation of the DELETE
|
1122
|
-
#
|
1123
|
-
#
|
1124
|
-
#
|
1125
|
-
# `
|
1126
|
-
# bucket and belong to the bucket owner's account to use this
|
1127
|
-
#
|
1128
|
-
#
|
1143
|
+
# This implementation of the DELETE action uses the policy subresource
|
1144
|
+
# to delete the policy of a specified Amazon S3 on Outposts bucket. If
|
1145
|
+
# you are using an identity other than the root user of the AWS account
|
1146
|
+
# that owns the bucket, the calling identity must have the
|
1147
|
+
# `s3-outposts:DeleteBucketPolicy` permissions on the specified Outposts
|
1148
|
+
# bucket and belong to the bucket owner's account to use this action.
|
1149
|
+
# For more information, see [Using Amazon S3 on Outposts][2] in *Amazon
|
1150
|
+
# Simple Storage Service User Guide*.
|
1129
1151
|
#
|
1130
1152
|
# If you don't have `DeleteBucketPolicy` permissions, Amazon S3 returns
|
1131
1153
|
# a `403 Access Denied` error. If you have the correct permissions, but
|
@@ -1133,42 +1155,46 @@ module Aws::S3Control
|
|
1133
1155
|
# account, Amazon S3 returns a `405 Method Not Allowed` error.
|
1134
1156
|
#
|
1135
1157
|
# As a security precaution, the root user of the AWS account that owns a
|
1136
|
-
# bucket can always use this
|
1158
|
+
# bucket can always use this action, even if the policy explicitly
|
1137
1159
|
# denies the root user the ability to perform this action.
|
1138
1160
|
#
|
1139
1161
|
# For more information about bucket policies, see [Using Bucket Policies
|
1140
|
-
# and User Policies]
|
1141
|
-
# https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html).
|
1162
|
+
# and User Policies][3].
|
1142
1163
|
#
|
1143
1164
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
1144
|
-
# additional parameter of outpost-id to be passed with the
|
1145
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
1146
|
-
# an example of the request syntax for Amazon S3 on
|
1147
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
1148
|
-
# using the access point ARN, see the
|
1165
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
1166
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
1167
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
1168
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
1169
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
1170
|
+
# [Examples][4] section.
|
1149
1171
|
#
|
1150
1172
|
# The following actions are related to `DeleteBucketPolicy`\:
|
1151
1173
|
#
|
1152
|
-
# * [GetBucketPolicy][
|
1174
|
+
# * [GetBucketPolicy][5]
|
1153
1175
|
#
|
1154
|
-
# * [PutBucketPolicy][
|
1176
|
+
# * [PutBucketPolicy][6]
|
1155
1177
|
#
|
1156
1178
|
#
|
1157
1179
|
#
|
1158
1180
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketPolicy.html
|
1159
1181
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
1160
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1161
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1162
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1182
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
1183
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketPolicy.html#API_control_DeleteBucketPolicy_Examples
|
1184
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketPolicy.html
|
1185
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketPolicy.html
|
1163
1186
|
#
|
1164
1187
|
# @option params [required, String] :account_id
|
1165
1188
|
# The account ID of the Outposts bucket.
|
1166
1189
|
#
|
1167
1190
|
# @option params [required, String] :bucket
|
1168
|
-
#
|
1191
|
+
# Specifies the bucket.
|
1192
|
+
#
|
1193
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1194
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1169
1195
|
#
|
1170
|
-
# For
|
1171
|
-
# the format
|
1196
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1197
|
+
# you must specify the ARN of the bucket accessed in the format
|
1172
1198
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1173
1199
|
# For example, to access the bucket `reports` through outpost
|
1174
1200
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1194,26 +1220,27 @@ module Aws::S3Control
|
|
1194
1220
|
req.send_request(options)
|
1195
1221
|
end
|
1196
1222
|
|
1197
|
-
# <note markdown="1"> This
|
1198
|
-
#
|
1199
|
-
#
|
1223
|
+
# <note markdown="1"> This action deletes an Amazon S3 on Outposts bucket's tags. To delete
|
1224
|
+
# an S3 bucket tags, see [DeleteBucketTagging][1] in the *Amazon Simple
|
1225
|
+
# Storage Service API*.
|
1200
1226
|
#
|
1201
1227
|
# </note>
|
1202
1228
|
#
|
1203
1229
|
# Deletes the tags from the Outposts bucket. For more information, see
|
1204
1230
|
# [Using Amazon S3 on Outposts][2] in *Amazon Simple Storage Service
|
1205
|
-
#
|
1231
|
+
# User Guide*.
|
1206
1232
|
#
|
1207
|
-
# To use this
|
1233
|
+
# To use this action, you must have permission to perform the
|
1208
1234
|
# `PutBucketTagging` action. By default, the bucket owner has this
|
1209
1235
|
# permission and can grant this permission to others.
|
1210
1236
|
#
|
1211
1237
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
1212
|
-
# additional parameter of outpost-id to be passed with the
|
1213
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
1214
|
-
# an example of the request syntax for Amazon S3 on
|
1215
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
1216
|
-
# using the access point ARN, see the
|
1238
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
1239
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
1240
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
1241
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
1242
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
1243
|
+
# [Examples][3] section.
|
1217
1244
|
#
|
1218
1245
|
# The following actions are related to `DeleteBucketTagging`\:
|
1219
1246
|
#
|
@@ -1225,7 +1252,7 @@ module Aws::S3Control
|
|
1225
1252
|
#
|
1226
1253
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
1227
1254
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
1228
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1255
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketTagging.html#API_control_DeleteBucketTagging_Examples
|
1229
1256
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketTagging.html
|
1230
1257
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketTagging.html
|
1231
1258
|
#
|
@@ -1235,8 +1262,11 @@ module Aws::S3Control
|
|
1235
1262
|
# @option params [required, String] :bucket
|
1236
1263
|
# The bucket ARN that has the tag set to be removed.
|
1237
1264
|
#
|
1238
|
-
# For Amazon S3 on Outposts
|
1239
|
-
# the
|
1265
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1266
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1267
|
+
#
|
1268
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1269
|
+
# you must specify the ARN of the bucket accessed in the format
|
1240
1270
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1241
1271
|
# For example, to access the bucket `reports` through outpost
|
1242
1272
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1266,7 +1296,7 @@ module Aws::S3Control
|
|
1266
1296
|
# To use this operation, you must have permission to perform the
|
1267
1297
|
# `s3:DeleteJobTagging` action. For more information, see [Controlling
|
1268
1298
|
# access and labeling jobs using tags][1] in the *Amazon Simple Storage
|
1269
|
-
# Service
|
1299
|
+
# Service User Guide*.
|
1270
1300
|
#
|
1271
1301
|
#
|
1272
1302
|
#
|
@@ -1345,9 +1375,91 @@ module Aws::S3Control
|
|
1345
1375
|
req.send_request(options)
|
1346
1376
|
end
|
1347
1377
|
|
1378
|
+
# Deletes the Amazon S3 Storage Lens configuration. For more information
|
1379
|
+
# about S3 Storage Lens, see [Assessing your storage activity and usage
|
1380
|
+
# with Amazon S3 Storage Lens ][1] in the *Amazon Simple Storage Service
|
1381
|
+
# User Guide*.
|
1382
|
+
#
|
1383
|
+
# <note markdown="1"> To use this action, you must have permission to perform the
|
1384
|
+
# `s3:DeleteStorageLensConfiguration` action. For more information, see
|
1385
|
+
# [Setting permissions to use Amazon S3 Storage Lens][2] in the *Amazon
|
1386
|
+
# Simple Storage Service User Guide*.
|
1387
|
+
#
|
1388
|
+
# </note>
|
1389
|
+
#
|
1390
|
+
#
|
1391
|
+
#
|
1392
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html
|
1393
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html
|
1394
|
+
#
|
1395
|
+
# @option params [required, String] :config_id
|
1396
|
+
# The ID of the S3 Storage Lens configuration.
|
1397
|
+
#
|
1398
|
+
# @option params [required, String] :account_id
|
1399
|
+
# The account ID of the requester.
|
1400
|
+
#
|
1401
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1402
|
+
#
|
1403
|
+
# @example Request syntax with placeholder values
|
1404
|
+
#
|
1405
|
+
# resp = client.delete_storage_lens_configuration({
|
1406
|
+
# config_id: "ConfigId", # required
|
1407
|
+
# account_id: "AccountId", # required
|
1408
|
+
# })
|
1409
|
+
#
|
1410
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DeleteStorageLensConfiguration AWS API Documentation
|
1411
|
+
#
|
1412
|
+
# @overload delete_storage_lens_configuration(params = {})
|
1413
|
+
# @param [Hash] params ({})
|
1414
|
+
def delete_storage_lens_configuration(params = {}, options = {})
|
1415
|
+
req = build_request(:delete_storage_lens_configuration, params)
|
1416
|
+
req.send_request(options)
|
1417
|
+
end
|
1418
|
+
|
1419
|
+
# Deletes the Amazon S3 Storage Lens configuration tags. For more
|
1420
|
+
# information about S3 Storage Lens, see [Assessing your storage
|
1421
|
+
# activity and usage with Amazon S3 Storage Lens ][1] in the *Amazon
|
1422
|
+
# Simple Storage Service User Guide*.
|
1423
|
+
#
|
1424
|
+
# <note markdown="1"> To use this action, you must have permission to perform the
|
1425
|
+
# `s3:DeleteStorageLensConfigurationTagging` action. For more
|
1426
|
+
# information, see [Setting permissions to use Amazon S3 Storage
|
1427
|
+
# Lens][2] in the *Amazon Simple Storage Service User Guide*.
|
1428
|
+
#
|
1429
|
+
# </note>
|
1430
|
+
#
|
1431
|
+
#
|
1432
|
+
#
|
1433
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html
|
1434
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html
|
1435
|
+
#
|
1436
|
+
# @option params [required, String] :config_id
|
1437
|
+
# The ID of the S3 Storage Lens configuration.
|
1438
|
+
#
|
1439
|
+
# @option params [required, String] :account_id
|
1440
|
+
# The account ID of the requester.
|
1441
|
+
#
|
1442
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1443
|
+
#
|
1444
|
+
# @example Request syntax with placeholder values
|
1445
|
+
#
|
1446
|
+
# resp = client.delete_storage_lens_configuration_tagging({
|
1447
|
+
# config_id: "ConfigId", # required
|
1448
|
+
# account_id: "AccountId", # required
|
1449
|
+
# })
|
1450
|
+
#
|
1451
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DeleteStorageLensConfigurationTagging AWS API Documentation
|
1452
|
+
#
|
1453
|
+
# @overload delete_storage_lens_configuration_tagging(params = {})
|
1454
|
+
# @param [Hash] params ({})
|
1455
|
+
def delete_storage_lens_configuration_tagging(params = {}, options = {})
|
1456
|
+
req = build_request(:delete_storage_lens_configuration_tagging, params)
|
1457
|
+
req.send_request(options)
|
1458
|
+
end
|
1459
|
+
|
1348
1460
|
# Retrieves the configuration parameters and status for a Batch
|
1349
1461
|
# Operations job. For more information, see [S3 Batch Operations][1] in
|
1350
|
-
# the *Amazon Simple Storage Service
|
1462
|
+
# the *Amazon Simple Storage Service User Guide*.
|
1351
1463
|
#
|
1352
1464
|
#
|
1353
1465
|
#
|
@@ -1370,6 +1482,7 @@ module Aws::S3Control
|
|
1370
1482
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
|
1371
1483
|
#
|
1372
1484
|
# @option params [required, String] :account_id
|
1485
|
+
# The AWS account ID associated with the S3 Batch Operations job.
|
1373
1486
|
#
|
1374
1487
|
# @option params [required, String] :job_id
|
1375
1488
|
# The ID for the job whose information you want to retrieve.
|
@@ -1482,11 +1595,12 @@ module Aws::S3Control
|
|
1482
1595
|
#
|
1483
1596
|
#
|
1484
1597
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
1485
|
-
# additional parameter of outpost-id to be passed with the
|
1486
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
1487
|
-
# an example of the request syntax for Amazon S3 on
|
1488
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
1489
|
-
# using the access point ARN, see the
|
1598
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
1599
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
1600
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
1601
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
1602
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
1603
|
+
# [Examples][1] section.
|
1490
1604
|
#
|
1491
1605
|
# The following actions are related to `GetAccessPoint`\:
|
1492
1606
|
#
|
@@ -1498,7 +1612,7 @@ module Aws::S3Control
|
|
1498
1612
|
#
|
1499
1613
|
#
|
1500
1614
|
#
|
1501
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1615
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html#API_control_GetAccessPoint_Examples
|
1502
1616
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html
|
1503
1617
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html
|
1504
1618
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessPoints.html
|
@@ -1510,8 +1624,11 @@ module Aws::S3Control
|
|
1510
1624
|
# The name of the access point whose configuration information you want
|
1511
1625
|
# to retrieve.
|
1512
1626
|
#
|
1513
|
-
# For Amazon S3 on Outposts
|
1514
|
-
#
|
1627
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1628
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1629
|
+
#
|
1630
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1631
|
+
# you must specify the ARN of the access point accessed in the format
|
1515
1632
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
1516
1633
|
# For example, to access the access point `reports-ap` through outpost
|
1517
1634
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1576,8 +1693,11 @@ module Aws::S3Control
|
|
1576
1693
|
# @option params [required, String] :name
|
1577
1694
|
# The name of the access point whose policy you want to retrieve.
|
1578
1695
|
#
|
1579
|
-
# For Amazon S3 on Outposts
|
1580
|
-
#
|
1696
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1697
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1698
|
+
#
|
1699
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1700
|
+
# you must specify the ARN of the access point accessed in the format
|
1581
1701
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
1582
1702
|
# For example, to access the access point `reports-ap` through outpost
|
1583
1703
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1650,32 +1770,55 @@ module Aws::S3Control
|
|
1650
1770
|
|
1651
1771
|
# Gets an Amazon S3 on Outposts bucket. For more information, see [
|
1652
1772
|
# Using Amazon S3 on Outposts][1] in the *Amazon Simple Storage Service
|
1653
|
-
#
|
1773
|
+
# User Guide*.
|
1774
|
+
#
|
1775
|
+
# If you are using an identity other than the root user of the AWS
|
1776
|
+
# account that owns the bucket, the calling identity must have the
|
1777
|
+
# `s3-outposts:GetBucket` permissions on the specified bucket and belong
|
1778
|
+
# to the bucket owner's account in order to use this action. Only users
|
1779
|
+
# from Outposts bucket owner account with the right permissions can
|
1780
|
+
# perform actions on an Outposts bucket.
|
1781
|
+
#
|
1782
|
+
# If you don't have `s3-outposts:GetBucket` permissions or you're not
|
1783
|
+
# using an identity that belongs to the bucket owner's account, Amazon
|
1784
|
+
# S3 returns a `403 Access Denied` error.
|
1654
1785
|
#
|
1655
1786
|
# The following actions are related to `GetBucket` for Amazon S3 on
|
1656
1787
|
# Outposts:
|
1657
1788
|
#
|
1658
|
-
#
|
1789
|
+
# All Amazon S3 on Outposts REST API requests for this action require an
|
1790
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
1791
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
1792
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
1793
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
1794
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
1795
|
+
# [Examples][2] section.
|
1659
1796
|
#
|
1660
|
-
# * [
|
1797
|
+
# * [PutObject][3]
|
1661
1798
|
#
|
1662
|
-
# * [
|
1799
|
+
# * [CreateBucket][4]
|
1800
|
+
#
|
1801
|
+
# * [DeleteBucket][5]
|
1663
1802
|
#
|
1664
1803
|
#
|
1665
1804
|
#
|
1666
1805
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
1667
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1668
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1669
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1806
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucket.html#API_control_GetBucket_Examples
|
1807
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
1808
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
|
1809
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucket.html
|
1670
1810
|
#
|
1671
1811
|
# @option params [required, String] :account_id
|
1672
1812
|
# The AWS account ID of the Outposts bucket.
|
1673
1813
|
#
|
1674
1814
|
# @option params [required, String] :bucket
|
1675
|
-
#
|
1815
|
+
# Specifies the bucket.
|
1676
1816
|
#
|
1677
|
-
# For Amazon S3 on Outposts
|
1678
|
-
# the
|
1817
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1818
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1819
|
+
#
|
1820
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1821
|
+
# you must specify the ARN of the bucket accessed in the format
|
1679
1822
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1680
1823
|
# For example, to access the bucket `reports` through outpost
|
1681
1824
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1711,7 +1854,7 @@ module Aws::S3Control
|
|
1711
1854
|
req.send_request(options)
|
1712
1855
|
end
|
1713
1856
|
|
1714
|
-
# <note markdown="1"> This
|
1857
|
+
# <note markdown="1"> This action gets an Amazon S3 on Outposts bucket's lifecycle
|
1715
1858
|
# configuration. To get an S3 bucket's lifecycle configuration, see
|
1716
1859
|
# [GetBucketLifecycleConfiguration][1] in the *Amazon Simple Storage
|
1717
1860
|
# Service API*.
|
@@ -1721,21 +1864,22 @@ module Aws::S3Control
|
|
1721
1864
|
# Returns the lifecycle configuration information set on the Outposts
|
1722
1865
|
# bucket. For more information, see [Using Amazon S3 on Outposts][2] and
|
1723
1866
|
# for information about lifecycle configuration, see [ Object Lifecycle
|
1724
|
-
# Management][3] in *Amazon Simple Storage Service
|
1867
|
+
# Management][3] in *Amazon Simple Storage Service User Guide*.
|
1725
1868
|
#
|
1726
|
-
# To use this
|
1727
|
-
# `
|
1869
|
+
# To use this action, you must have permission to perform the
|
1870
|
+
# `s3-outposts:GetLifecycleConfiguration` action. The Outposts bucket
|
1728
1871
|
# owner has this permission, by default. The bucket owner can grant this
|
1729
1872
|
# permission to others. For more information about permissions, see
|
1730
1873
|
# [Permissions Related to Bucket Subresource Operations][4] and
|
1731
1874
|
# [Managing Access Permissions to Your Amazon S3 Resources][5].
|
1732
1875
|
#
|
1733
1876
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
1734
|
-
# additional parameter of outpost-id to be passed with the
|
1735
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
1736
|
-
# an example of the request syntax for Amazon S3 on
|
1737
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
1738
|
-
# using the access point ARN, see the
|
1877
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
1878
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
1879
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
1880
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
1881
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
1882
|
+
# [Examples][6] section.
|
1739
1883
|
#
|
1740
1884
|
# `GetBucketLifecycleConfiguration` has the following special error:
|
1741
1885
|
#
|
@@ -1761,7 +1905,7 @@ module Aws::S3Control
|
|
1761
1905
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
1762
1906
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
1763
1907
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
1764
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1908
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html#API_control_GetBucketLifecycleConfiguration_Examples
|
1765
1909
|
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketLifecycleConfiguration.html
|
1766
1910
|
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketLifecycleConfiguration.html
|
1767
1911
|
#
|
@@ -1771,8 +1915,11 @@ module Aws::S3Control
|
|
1771
1915
|
# @option params [required, String] :bucket
|
1772
1916
|
# The Amazon Resource Name (ARN) of the bucket.
|
1773
1917
|
#
|
1774
|
-
# For Amazon S3 on Outposts
|
1775
|
-
# the
|
1918
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1919
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1920
|
+
#
|
1921
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
1922
|
+
# you must specify the ARN of the bucket accessed in the format
|
1776
1923
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1777
1924
|
# For example, to access the bucket `reports` through outpost
|
1778
1925
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1825,40 +1972,41 @@ module Aws::S3Control
|
|
1825
1972
|
req.send_request(options)
|
1826
1973
|
end
|
1827
1974
|
|
1828
|
-
# <note markdown="1"> This
|
1829
|
-
#
|
1830
|
-
#
|
1975
|
+
# <note markdown="1"> This action gets a bucket policy for an Amazon S3 on Outposts bucket.
|
1976
|
+
# To get a policy for an S3 bucket, see [GetBucketPolicy][1] in the
|
1977
|
+
# *Amazon Simple Storage Service API*.
|
1831
1978
|
#
|
1832
1979
|
# </note>
|
1833
1980
|
#
|
1834
1981
|
# Returns the policy of a specified Outposts bucket. For more
|
1835
1982
|
# information, see [Using Amazon S3 on Outposts][2] in the *Amazon
|
1836
|
-
# Simple Storage Service
|
1983
|
+
# Simple Storage Service User Guide*.
|
1837
1984
|
#
|
1838
1985
|
# If you are using an identity other than the root user of the AWS
|
1839
1986
|
# account that owns the bucket, the calling identity must have the
|
1840
1987
|
# `GetBucketPolicy` permissions on the specified bucket and belong to
|
1841
|
-
# the bucket owner's account in order to use this
|
1988
|
+
# the bucket owner's account in order to use this action.
|
1842
1989
|
#
|
1843
|
-
#
|
1844
|
-
#
|
1845
|
-
# permissions
|
1846
|
-
# bucket owner's account, Amazon S3
|
1847
|
-
# error.
|
1990
|
+
# Only users from Outposts bucket owner account with the right
|
1991
|
+
# permissions can perform actions on an Outposts bucket. If you don't
|
1992
|
+
# have `s3-outposts:GetBucketPolicy` permissions or you're not using an
|
1993
|
+
# identity that belongs to the bucket owner's account, Amazon S3
|
1994
|
+
# returns a `403 Access Denied` error.
|
1848
1995
|
#
|
1849
1996
|
# As a security precaution, the root user of the AWS account that owns a
|
1850
|
-
# bucket can always use this
|
1997
|
+
# bucket can always use this action, even if the policy explicitly
|
1851
1998
|
# denies the root user the ability to perform this action.
|
1852
1999
|
#
|
1853
2000
|
# For more information about bucket policies, see [Using Bucket Policies
|
1854
2001
|
# and User Policies][3].
|
1855
2002
|
#
|
1856
2003
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
1857
|
-
# additional parameter of outpost-id to be passed with the
|
1858
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
1859
|
-
# an example of the request syntax for Amazon S3 on
|
1860
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
1861
|
-
# using the access point ARN, see the
|
2004
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
2005
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
2006
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
2007
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
2008
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
2009
|
+
# [Examples][4] section.
|
1862
2010
|
#
|
1863
2011
|
# The following actions are related to `GetBucketPolicy`\:
|
1864
2012
|
#
|
@@ -1873,7 +2021,7 @@ module Aws::S3Control
|
|
1873
2021
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html
|
1874
2022
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
1875
2023
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
1876
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2024
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketPolicy.html#API_control_GetBucketPolicy_Examples
|
1877
2025
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
1878
2026
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketPolicy.html
|
1879
2027
|
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketPolicy.html
|
@@ -1882,10 +2030,13 @@ module Aws::S3Control
|
|
1882
2030
|
# The AWS account ID of the Outposts bucket.
|
1883
2031
|
#
|
1884
2032
|
# @option params [required, String] :bucket
|
1885
|
-
#
|
2033
|
+
# Specifies the bucket.
|
2034
|
+
#
|
2035
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
2036
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1886
2037
|
#
|
1887
|
-
# For
|
1888
|
-
# the format
|
2038
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
2039
|
+
# you must specify the ARN of the bucket accessed in the format
|
1889
2040
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1890
2041
|
# For example, to access the bucket `reports` through outpost
|
1891
2042
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -1917,17 +2068,17 @@ module Aws::S3Control
|
|
1917
2068
|
req.send_request(options)
|
1918
2069
|
end
|
1919
2070
|
|
1920
|
-
# <note markdown="1"> This
|
1921
|
-
#
|
1922
|
-
#
|
2071
|
+
# <note markdown="1"> This action gets an Amazon S3 on Outposts bucket's tags. To get an S3
|
2072
|
+
# bucket tags, see [GetBucketTagging][1] in the *Amazon Simple Storage
|
2073
|
+
# Service API*.
|
1923
2074
|
#
|
1924
2075
|
# </note>
|
1925
2076
|
#
|
1926
2077
|
# Returns the tag set associated with the Outposts bucket. For more
|
1927
2078
|
# information, see [Using Amazon S3 on Outposts][2] in the *Amazon
|
1928
|
-
# Simple Storage Service
|
2079
|
+
# Simple Storage Service User Guide*.
|
1929
2080
|
#
|
1930
|
-
# To use this
|
2081
|
+
# To use this action, you must have permission to perform the
|
1931
2082
|
# `GetBucketTagging` action. By default, the bucket owner has this
|
1932
2083
|
# permission and can grant this permission to others.
|
1933
2084
|
#
|
@@ -1940,11 +2091,12 @@ module Aws::S3Control
|
|
1940
2091
|
# ^
|
1941
2092
|
#
|
1942
2093
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
1943
|
-
# additional parameter of outpost-id to be passed with the
|
1944
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
1945
|
-
# an example of the request syntax for Amazon S3 on
|
1946
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
1947
|
-
# using the access point ARN, see the
|
2094
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
2095
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
2096
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
2097
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
2098
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
2099
|
+
# [Examples][3] section.
|
1948
2100
|
#
|
1949
2101
|
# The following actions are related to `GetBucketTagging`\:
|
1950
2102
|
#
|
@@ -1956,7 +2108,7 @@ module Aws::S3Control
|
|
1956
2108
|
#
|
1957
2109
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
1958
2110
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
1959
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2111
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketTagging.html#API_control_GetBucketTagging_Examples
|
1960
2112
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketTagging.html
|
1961
2113
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketTagging.html
|
1962
2114
|
#
|
@@ -1964,10 +2116,13 @@ module Aws::S3Control
|
|
1964
2116
|
# The AWS account ID of the Outposts bucket.
|
1965
2117
|
#
|
1966
2118
|
# @option params [required, String] :bucket
|
1967
|
-
#
|
2119
|
+
# Specifies the bucket.
|
2120
|
+
#
|
2121
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
2122
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1968
2123
|
#
|
1969
|
-
# For
|
1970
|
-
# the format
|
2124
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
2125
|
+
# you must specify the ARN of the bucket accessed in the format
|
1971
2126
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1972
2127
|
# For example, to access the bucket `reports` through outpost
|
1973
2128
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -2004,7 +2159,7 @@ module Aws::S3Control
|
|
2004
2159
|
# Returns the tags on an S3 Batch Operations job. To use this operation,
|
2005
2160
|
# you must have permission to perform the `s3:GetJobTagging` action. For
|
2006
2161
|
# more information, see [Controlling access and labeling jobs using
|
2007
|
-
# tags][1] in the *Amazon Simple Storage Service
|
2162
|
+
# tags][1] in the *Amazon Simple Storage Service User Guide*.
|
2008
2163
|
#
|
2009
2164
|
#
|
2010
2165
|
#
|
@@ -2101,6 +2256,124 @@ module Aws::S3Control
|
|
2101
2256
|
req.send_request(options)
|
2102
2257
|
end
|
2103
2258
|
|
2259
|
+
# Gets the Amazon S3 Storage Lens configuration. For more information,
|
2260
|
+
# see [Assessing your storage activity and usage with Amazon S3 Storage
|
2261
|
+
# Lens ][1] in the *Amazon Simple Storage Service User Guide*.
|
2262
|
+
#
|
2263
|
+
# <note markdown="1"> To use this action, you must have permission to perform the
|
2264
|
+
# `s3:GetStorageLensConfiguration` action. For more information, see
|
2265
|
+
# [Setting permissions to use Amazon S3 Storage Lens][2] in the *Amazon
|
2266
|
+
# Simple Storage Service User Guide*.
|
2267
|
+
#
|
2268
|
+
# </note>
|
2269
|
+
#
|
2270
|
+
#
|
2271
|
+
#
|
2272
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html
|
2273
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html
|
2274
|
+
#
|
2275
|
+
# @option params [required, String] :config_id
|
2276
|
+
# The ID of the Amazon S3 Storage Lens configuration.
|
2277
|
+
#
|
2278
|
+
# @option params [required, String] :account_id
|
2279
|
+
# The account ID of the requester.
|
2280
|
+
#
|
2281
|
+
# @return [Types::GetStorageLensConfigurationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2282
|
+
#
|
2283
|
+
# * {Types::GetStorageLensConfigurationResult#storage_lens_configuration #storage_lens_configuration} => Types::StorageLensConfiguration
|
2284
|
+
#
|
2285
|
+
# @example Request syntax with placeholder values
|
2286
|
+
#
|
2287
|
+
# resp = client.get_storage_lens_configuration({
|
2288
|
+
# config_id: "ConfigId", # required
|
2289
|
+
# account_id: "AccountId", # required
|
2290
|
+
# })
|
2291
|
+
#
|
2292
|
+
# @example Response structure
|
2293
|
+
#
|
2294
|
+
# resp.storage_lens_configuration.id #=> String
|
2295
|
+
# resp.storage_lens_configuration.account_level.activity_metrics.is_enabled #=> Boolean
|
2296
|
+
# resp.storage_lens_configuration.account_level.bucket_level.activity_metrics.is_enabled #=> Boolean
|
2297
|
+
# resp.storage_lens_configuration.account_level.bucket_level.prefix_level.storage_metrics.is_enabled #=> Boolean
|
2298
|
+
# resp.storage_lens_configuration.account_level.bucket_level.prefix_level.storage_metrics.selection_criteria.delimiter #=> String
|
2299
|
+
# resp.storage_lens_configuration.account_level.bucket_level.prefix_level.storage_metrics.selection_criteria.max_depth #=> Integer
|
2300
|
+
# resp.storage_lens_configuration.account_level.bucket_level.prefix_level.storage_metrics.selection_criteria.min_storage_bytes_percentage #=> Float
|
2301
|
+
# resp.storage_lens_configuration.include.buckets #=> Array
|
2302
|
+
# resp.storage_lens_configuration.include.buckets[0] #=> String
|
2303
|
+
# resp.storage_lens_configuration.include.regions #=> Array
|
2304
|
+
# resp.storage_lens_configuration.include.regions[0] #=> String
|
2305
|
+
# resp.storage_lens_configuration.exclude.buckets #=> Array
|
2306
|
+
# resp.storage_lens_configuration.exclude.buckets[0] #=> String
|
2307
|
+
# resp.storage_lens_configuration.exclude.regions #=> Array
|
2308
|
+
# resp.storage_lens_configuration.exclude.regions[0] #=> String
|
2309
|
+
# resp.storage_lens_configuration.data_export.s3_bucket_destination.format #=> String, one of "CSV", "Parquet"
|
2310
|
+
# resp.storage_lens_configuration.data_export.s3_bucket_destination.output_schema_version #=> String, one of "V_1"
|
2311
|
+
# resp.storage_lens_configuration.data_export.s3_bucket_destination.account_id #=> String
|
2312
|
+
# resp.storage_lens_configuration.data_export.s3_bucket_destination.arn #=> String
|
2313
|
+
# resp.storage_lens_configuration.data_export.s3_bucket_destination.prefix #=> String
|
2314
|
+
# resp.storage_lens_configuration.data_export.s3_bucket_destination.encryption.ssekms.key_id #=> String
|
2315
|
+
# resp.storage_lens_configuration.is_enabled #=> Boolean
|
2316
|
+
# resp.storage_lens_configuration.aws_org.arn #=> String
|
2317
|
+
# resp.storage_lens_configuration.storage_lens_arn #=> String
|
2318
|
+
#
|
2319
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetStorageLensConfiguration AWS API Documentation
|
2320
|
+
#
|
2321
|
+
# @overload get_storage_lens_configuration(params = {})
|
2322
|
+
# @param [Hash] params ({})
|
2323
|
+
def get_storage_lens_configuration(params = {}, options = {})
|
2324
|
+
req = build_request(:get_storage_lens_configuration, params)
|
2325
|
+
req.send_request(options)
|
2326
|
+
end
|
2327
|
+
|
2328
|
+
# Gets the tags of Amazon S3 Storage Lens configuration. For more
|
2329
|
+
# information about S3 Storage Lens, see [Assessing your storage
|
2330
|
+
# activity and usage with Amazon S3 Storage Lens ][1] in the *Amazon
|
2331
|
+
# Simple Storage Service User Guide*.
|
2332
|
+
#
|
2333
|
+
# <note markdown="1"> To use this action, you must have permission to perform the
|
2334
|
+
# `s3:GetStorageLensConfigurationTagging` action. For more information,
|
2335
|
+
# see [Setting permissions to use Amazon S3 Storage Lens][2] in the
|
2336
|
+
# *Amazon Simple Storage Service User Guide*.
|
2337
|
+
#
|
2338
|
+
# </note>
|
2339
|
+
#
|
2340
|
+
#
|
2341
|
+
#
|
2342
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html
|
2343
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html
|
2344
|
+
#
|
2345
|
+
# @option params [required, String] :config_id
|
2346
|
+
# The ID of the Amazon S3 Storage Lens configuration.
|
2347
|
+
#
|
2348
|
+
# @option params [required, String] :account_id
|
2349
|
+
# The account ID of the requester.
|
2350
|
+
#
|
2351
|
+
# @return [Types::GetStorageLensConfigurationTaggingResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2352
|
+
#
|
2353
|
+
# * {Types::GetStorageLensConfigurationTaggingResult#tags #tags} => Array<Types::StorageLensTag>
|
2354
|
+
#
|
2355
|
+
# @example Request syntax with placeholder values
|
2356
|
+
#
|
2357
|
+
# resp = client.get_storage_lens_configuration_tagging({
|
2358
|
+
# config_id: "ConfigId", # required
|
2359
|
+
# account_id: "AccountId", # required
|
2360
|
+
# })
|
2361
|
+
#
|
2362
|
+
# @example Response structure
|
2363
|
+
#
|
2364
|
+
# resp.tags #=> Array
|
2365
|
+
# resp.tags[0].key #=> String
|
2366
|
+
# resp.tags[0].value #=> String
|
2367
|
+
#
|
2368
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetStorageLensConfigurationTagging AWS API Documentation
|
2369
|
+
#
|
2370
|
+
# @overload get_storage_lens_configuration_tagging(params = {})
|
2371
|
+
# @param [Hash] params ({})
|
2372
|
+
def get_storage_lens_configuration_tagging(params = {}, options = {})
|
2373
|
+
req = build_request(:get_storage_lens_configuration_tagging, params)
|
2374
|
+
req.send_request(options)
|
2375
|
+
end
|
2376
|
+
|
2104
2377
|
# Returns a list of the access points currently associated with the
|
2105
2378
|
# specified bucket. You can retrieve up to 1000 access points per call.
|
2106
2379
|
# If the specified bucket has more than 1,000 access points (or the
|
@@ -2111,11 +2384,12 @@ module Aws::S3Control
|
|
2111
2384
|
#
|
2112
2385
|
#
|
2113
2386
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
2114
|
-
# additional parameter of outpost-id to be passed with the
|
2115
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
2116
|
-
# an example of the request syntax for Amazon S3 on
|
2117
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
2118
|
-
# using the access point ARN, see the
|
2387
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
2388
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
2389
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
2390
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
2391
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
2392
|
+
# [Examples][1] section.
|
2119
2393
|
#
|
2120
2394
|
# The following actions are related to `ListAccessPoints`\:
|
2121
2395
|
#
|
@@ -2127,7 +2401,7 @@ module Aws::S3Control
|
|
2127
2401
|
#
|
2128
2402
|
#
|
2129
2403
|
#
|
2130
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2404
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html#API_control_GetAccessPoint_Examples
|
2131
2405
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html
|
2132
2406
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html
|
2133
2407
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html
|
@@ -2140,8 +2414,11 @@ module Aws::S3Control
|
|
2140
2414
|
# The name of the bucket whose associated access points you want to
|
2141
2415
|
# list.
|
2142
2416
|
#
|
2143
|
-
# For Amazon S3 on Outposts
|
2144
|
-
# the
|
2417
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
2418
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
2419
|
+
#
|
2420
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
2421
|
+
# you must specify the ARN of the bucket accessed in the format
|
2145
2422
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2146
2423
|
# For example, to access the bucket `reports` through outpost
|
2147
2424
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -2199,7 +2476,7 @@ module Aws::S3Control
|
|
2199
2476
|
# Lists current S3 Batch Operations jobs and jobs that have ended within
|
2200
2477
|
# the last 30 days for the AWS account making the request. For more
|
2201
2478
|
# information, see [S3 Batch Operations][1] in the *Amazon Simple
|
2202
|
-
# Storage Service
|
2479
|
+
# Storage Service User Guide*.
|
2203
2480
|
#
|
2204
2481
|
# Related actions include:
|
2205
2482
|
#
|
@@ -2222,6 +2499,7 @@ module Aws::S3Control
|
|
2222
2499
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
|
2223
2500
|
#
|
2224
2501
|
# @option params [required, String] :account_id
|
2502
|
+
# The AWS account ID associated with the S3 Batch Operations job.
|
2225
2503
|
#
|
2226
2504
|
# @option params [Array<String>] :job_statuses
|
2227
2505
|
# The `List Jobs` request returns jobs that match the statuses listed in
|
@@ -2260,7 +2538,7 @@ module Aws::S3Control
|
|
2260
2538
|
# resp.jobs #=> Array
|
2261
2539
|
# resp.jobs[0].job_id #=> String
|
2262
2540
|
# resp.jobs[0].description #=> String
|
2263
|
-
# resp.jobs[0].operation #=> String, one of "LambdaInvoke", "S3PutObjectCopy", "S3PutObjectAcl", "S3PutObjectTagging", "S3InitiateRestoreObject", "S3PutObjectLegalHold", "S3PutObjectRetention"
|
2541
|
+
# resp.jobs[0].operation #=> String, one of "LambdaInvoke", "S3PutObjectCopy", "S3PutObjectAcl", "S3PutObjectTagging", "S3DeleteObjectTagging", "S3InitiateRestoreObject", "S3PutObjectLegalHold", "S3PutObjectRetention"
|
2264
2542
|
# resp.jobs[0].priority #=> Integer
|
2265
2543
|
# resp.jobs[0].status #=> String, one of "Active", "Cancelled", "Cancelling", "Complete", "Completing", "Failed", "Failing", "New", "Paused", "Pausing", "Preparing", "Ready", "Suspended"
|
2266
2544
|
# resp.jobs[0].creation_time #=> Time
|
@@ -2278,19 +2556,19 @@ module Aws::S3Control
|
|
2278
2556
|
req.send_request(options)
|
2279
2557
|
end
|
2280
2558
|
|
2281
|
-
# Returns a list of all Outposts buckets in an
|
2282
|
-
#
|
2559
|
+
# Returns a list of all Outposts buckets in an Outpost that are owned by
|
2560
|
+
# the authenticated sender of the request. For more information, see
|
2283
2561
|
# [Using Amazon S3 on Outposts][1] in the *Amazon Simple Storage Service
|
2284
|
-
#
|
2562
|
+
# User Guide*.
|
2285
2563
|
#
|
2286
2564
|
# For an example of the request syntax for Amazon S3 on Outposts that
|
2287
|
-
# uses the S3 on Outposts endpoint hostname prefix and
|
2288
|
-
# your
|
2565
|
+
# uses the S3 on Outposts endpoint hostname prefix and
|
2566
|
+
# `x-amz-outpost-id` in your request, see the [Examples][2] section.
|
2289
2567
|
#
|
2290
2568
|
#
|
2291
2569
|
#
|
2292
2570
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
2293
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2571
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListRegionalBuckets.html#API_control_ListRegionalBuckets_Examples
|
2294
2572
|
#
|
2295
2573
|
# @option params [required, String] :account_id
|
2296
2574
|
# The AWS account ID of the Outposts bucket.
|
@@ -2341,6 +2619,59 @@ module Aws::S3Control
|
|
2341
2619
|
req.send_request(options)
|
2342
2620
|
end
|
2343
2621
|
|
2622
|
+
# Gets a list of Amazon S3 Storage Lens configurations. For more
|
2623
|
+
# information about S3 Storage Lens, see [Assessing your storage
|
2624
|
+
# activity and usage with Amazon S3 Storage Lens ][1] in the *Amazon
|
2625
|
+
# Simple Storage Service User Guide*.
|
2626
|
+
#
|
2627
|
+
# <note markdown="1"> To use this action, you must have permission to perform the
|
2628
|
+
# `s3:ListStorageLensConfigurations` action. For more information, see
|
2629
|
+
# [Setting permissions to use Amazon S3 Storage Lens][2] in the *Amazon
|
2630
|
+
# Simple Storage Service User Guide*.
|
2631
|
+
#
|
2632
|
+
# </note>
|
2633
|
+
#
|
2634
|
+
#
|
2635
|
+
#
|
2636
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html
|
2637
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html
|
2638
|
+
#
|
2639
|
+
# @option params [required, String] :account_id
|
2640
|
+
# The account ID of the requester.
|
2641
|
+
#
|
2642
|
+
# @option params [String] :next_token
|
2643
|
+
# A pagination token to request the next page of results.
|
2644
|
+
#
|
2645
|
+
# @return [Types::ListStorageLensConfigurationsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2646
|
+
#
|
2647
|
+
# * {Types::ListStorageLensConfigurationsResult#next_token #next_token} => String
|
2648
|
+
# * {Types::ListStorageLensConfigurationsResult#storage_lens_configuration_list #storage_lens_configuration_list} => Array<Types::ListStorageLensConfigurationEntry>
|
2649
|
+
#
|
2650
|
+
# @example Request syntax with placeholder values
|
2651
|
+
#
|
2652
|
+
# resp = client.list_storage_lens_configurations({
|
2653
|
+
# account_id: "AccountId", # required
|
2654
|
+
# next_token: "ContinuationToken",
|
2655
|
+
# })
|
2656
|
+
#
|
2657
|
+
# @example Response structure
|
2658
|
+
#
|
2659
|
+
# resp.next_token #=> String
|
2660
|
+
# resp.storage_lens_configuration_list #=> Array
|
2661
|
+
# resp.storage_lens_configuration_list[0].id #=> String
|
2662
|
+
# resp.storage_lens_configuration_list[0].storage_lens_arn #=> String
|
2663
|
+
# resp.storage_lens_configuration_list[0].home_region #=> String
|
2664
|
+
# resp.storage_lens_configuration_list[0].is_enabled #=> Boolean
|
2665
|
+
#
|
2666
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/ListStorageLensConfigurations AWS API Documentation
|
2667
|
+
#
|
2668
|
+
# @overload list_storage_lens_configurations(params = {})
|
2669
|
+
# @param [Hash] params ({})
|
2670
|
+
def list_storage_lens_configurations(params = {}, options = {})
|
2671
|
+
req = build_request(:list_storage_lens_configurations, params)
|
2672
|
+
req.send_request(options)
|
2673
|
+
end
|
2674
|
+
|
2344
2675
|
# Associates an access policy with the specified access point. Each
|
2345
2676
|
# access point can have only one policy, so a request made to this API
|
2346
2677
|
# replaces any existing policy associated with the specified access
|
@@ -2349,11 +2680,12 @@ module Aws::S3Control
|
|
2349
2680
|
#
|
2350
2681
|
#
|
2351
2682
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
2352
|
-
# additional parameter of outpost-id to be passed with the
|
2353
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
2354
|
-
# an example of the request syntax for Amazon S3 on
|
2355
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
2356
|
-
# using the access point ARN, see the
|
2683
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
2684
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
2685
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
2686
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
2687
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
2688
|
+
# [Examples][1] section.
|
2357
2689
|
#
|
2358
2690
|
# The following actions are related to `PutAccessPointPolicy`\:
|
2359
2691
|
#
|
@@ -2363,7 +2695,7 @@ module Aws::S3Control
|
|
2363
2695
|
#
|
2364
2696
|
#
|
2365
2697
|
#
|
2366
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2698
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointPolicy.html#API_control_PutAccessPointPolicy_Examples
|
2367
2699
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointPolicy.html
|
2368
2700
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointPolicy.html
|
2369
2701
|
#
|
@@ -2375,8 +2707,11 @@ module Aws::S3Control
|
|
2375
2707
|
# The name of the access point that you want to associate with the
|
2376
2708
|
# specified policy.
|
2377
2709
|
#
|
2378
|
-
# For Amazon S3 on Outposts
|
2379
|
-
#
|
2710
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
2711
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
2712
|
+
#
|
2713
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
2714
|
+
# you must specify the ARN of the access point accessed in the format
|
2380
2715
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
2381
2716
|
# For example, to access the access point `reports-ap` through outpost
|
2382
2717
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -2386,9 +2721,9 @@ module Aws::S3Control
|
|
2386
2721
|
#
|
2387
2722
|
# @option params [required, String] :policy
|
2388
2723
|
# The policy that you want to apply to the specified access point. For
|
2389
|
-
# more information about access point policies, see [Managing
|
2390
|
-
#
|
2391
|
-
# Service
|
2724
|
+
# more information about access point policies, see [Managing data
|
2725
|
+
# access with Amazon S3 Access Points][1] in the *Amazon Simple Storage
|
2726
|
+
# Service User Guide*.
|
2392
2727
|
#
|
2393
2728
|
#
|
2394
2729
|
#
|
@@ -2413,27 +2748,29 @@ module Aws::S3Control
|
|
2413
2748
|
req.send_request(options)
|
2414
2749
|
end
|
2415
2750
|
|
2416
|
-
# <note markdown="1"> This
|
2417
|
-
#
|
2751
|
+
# <note markdown="1"> This action puts a lifecycle configuration to an Amazon S3 on Outposts
|
2752
|
+
# bucket. To put a lifecycle configuration to an S3 bucket, see
|
2418
2753
|
# [PutBucketLifecycleConfiguration][1] in the *Amazon Simple Storage
|
2419
2754
|
# Service API*.
|
2420
2755
|
#
|
2421
2756
|
# </note>
|
2422
2757
|
#
|
2423
2758
|
# Creates a new lifecycle configuration for the Outposts bucket or
|
2424
|
-
# replaces an existing lifecycle configuration. Outposts buckets
|
2425
|
-
#
|
2426
|
-
# of time
|
2427
|
-
# Amazon S3 on
|
2759
|
+
# replaces an existing lifecycle configuration. Outposts buckets only
|
2760
|
+
# support lifecycle configurations that delete/expire objects after a
|
2761
|
+
# certain period of time and abort incomplete multipart uploads. For
|
2762
|
+
# more information, see [Managing Lifecycle Permissions for Amazon S3 on
|
2763
|
+
# Outposts][2].
|
2428
2764
|
#
|
2429
2765
|
#
|
2430
2766
|
#
|
2431
2767
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
2432
|
-
# additional parameter of outpost-id to be passed with the
|
2433
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
2434
|
-
# an example of the request syntax for Amazon S3 on
|
2435
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
2436
|
-
# using the access point ARN, see the
|
2768
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
2769
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
2770
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
2771
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
2772
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
2773
|
+
# [Examples][3] section.
|
2437
2774
|
#
|
2438
2775
|
# The following actions are related to
|
2439
2776
|
# `PutBucketLifecycleConfiguration`\:
|
@@ -2446,7 +2783,7 @@ module Aws::S3Control
|
|
2446
2783
|
#
|
2447
2784
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
2448
2785
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
2449
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2786
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketLifecycleConfiguration.html#API_control_PutBucketLifecycleConfiguration_Examples
|
2450
2787
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html
|
2451
2788
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketLifecycleConfiguration.html
|
2452
2789
|
#
|
@@ -2525,20 +2862,20 @@ module Aws::S3Control
|
|
2525
2862
|
req.send_request(options)
|
2526
2863
|
end
|
2527
2864
|
|
2528
|
-
# <note markdown="1"> This
|
2529
|
-
#
|
2530
|
-
#
|
2865
|
+
# <note markdown="1"> This action puts a bucket policy to an Amazon S3 on Outposts bucket.
|
2866
|
+
# To put a policy on an S3 bucket, see [PutBucketPolicy][1] in the
|
2867
|
+
# *Amazon Simple Storage Service API*.
|
2531
2868
|
#
|
2532
2869
|
# </note>
|
2533
2870
|
#
|
2534
2871
|
# Applies an Amazon S3 bucket policy to an Outposts bucket. For more
|
2535
2872
|
# information, see [Using Amazon S3 on Outposts][2] in the *Amazon
|
2536
|
-
# Simple Storage Service
|
2873
|
+
# Simple Storage Service User Guide*.
|
2537
2874
|
#
|
2538
2875
|
# If you are using an identity other than the root user of the AWS
|
2539
2876
|
# account that owns the Outposts bucket, the calling identity must have
|
2540
2877
|
# the `PutBucketPolicy` permissions on the specified Outposts bucket and
|
2541
|
-
# belong to the bucket owner's account in order to use this
|
2878
|
+
# belong to the bucket owner's account in order to use this action.
|
2542
2879
|
#
|
2543
2880
|
# If you don't have `PutBucketPolicy` permissions, Amazon S3 returns a
|
2544
2881
|
# `403 Access Denied` error. If you have the correct permissions, but
|
@@ -2546,18 +2883,19 @@ module Aws::S3Control
|
|
2546
2883
|
# account, Amazon S3 returns a `405 Method Not Allowed` error.
|
2547
2884
|
#
|
2548
2885
|
# As a security precaution, the root user of the AWS account that owns a
|
2549
|
-
# bucket can always use this
|
2886
|
+
# bucket can always use this action, even if the policy explicitly
|
2550
2887
|
# denies the root user the ability to perform this action.
|
2551
2888
|
#
|
2552
2889
|
# For more information about bucket policies, see [Using Bucket Policies
|
2553
2890
|
# and User Policies][3].
|
2554
2891
|
#
|
2555
2892
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
2556
|
-
# additional parameter of outpost-id to be passed with the
|
2557
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
2558
|
-
# an example of the request syntax for Amazon S3 on
|
2559
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
2560
|
-
# using the access point ARN, see the
|
2893
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
2894
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
2895
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
2896
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
2897
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
2898
|
+
# [Examples][4] section.
|
2561
2899
|
#
|
2562
2900
|
# The following actions are related to `PutBucketPolicy`\:
|
2563
2901
|
#
|
@@ -2570,7 +2908,7 @@ module Aws::S3Control
|
|
2570
2908
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketPolicy.html
|
2571
2909
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
2572
2910
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
2573
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2911
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketPolicy.html#API_control_PutBucketPolicy_Examples
|
2574
2912
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketPolicy.html
|
2575
2913
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketPolicy.html
|
2576
2914
|
#
|
@@ -2578,10 +2916,13 @@ module Aws::S3Control
|
|
2578
2916
|
# The AWS account ID of the Outposts bucket.
|
2579
2917
|
#
|
2580
2918
|
# @option params [required, String] :bucket
|
2581
|
-
#
|
2919
|
+
# Specifies the bucket.
|
2920
|
+
#
|
2921
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
2922
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
2582
2923
|
#
|
2583
|
-
# For
|
2584
|
-
# the format
|
2924
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
2925
|
+
# you must specify the ARN of the bucket accessed in the format
|
2585
2926
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2586
2927
|
# For example, to access the bucket `reports` through outpost
|
2587
2928
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -2620,15 +2961,15 @@ module Aws::S3Control
|
|
2620
2961
|
req.send_request(options)
|
2621
2962
|
end
|
2622
2963
|
|
2623
|
-
# <note markdown="1"> This
|
2624
|
-
#
|
2964
|
+
# <note markdown="1"> This action puts tags on an Amazon S3 on Outposts bucket. To put tags
|
2965
|
+
# on an S3 bucket, see [PutBucketTagging][1] in the *Amazon Simple
|
2625
2966
|
# Storage Service API*.
|
2626
2967
|
#
|
2627
2968
|
# </note>
|
2628
2969
|
#
|
2629
2970
|
# Sets the tags for an Outposts bucket. For more information, see [Using
|
2630
|
-
# Amazon S3 on Outposts][2] in the *Amazon Simple Storage Service
|
2631
|
-
#
|
2971
|
+
# Amazon S3 on Outposts][2] in the *Amazon Simple Storage Service User
|
2972
|
+
# Guide*.
|
2632
2973
|
#
|
2633
2974
|
# Use tags to organize your AWS bill to reflect your own cost structure.
|
2634
2975
|
# To do this, sign up to get your AWS account bill with tag key values
|
@@ -2641,12 +2982,12 @@ module Aws::S3Control
|
|
2641
2982
|
#
|
2642
2983
|
# <note markdown="1"> Within a bucket, if you add a tag that has the same key as an existing
|
2643
2984
|
# tag, the new value overwrites the old value. For more information, see
|
2644
|
-
# [Using Cost Allocation in Amazon S3 Bucket Tags][4].
|
2985
|
+
# [ Using Cost Allocation in Amazon S3 Bucket Tags][4].
|
2645
2986
|
#
|
2646
2987
|
# </note>
|
2647
2988
|
#
|
2648
|
-
# To use this
|
2649
|
-
# `
|
2989
|
+
# To use this action, you must have permissions to perform the
|
2990
|
+
# `s3-outposts:PutBucketTagging` action. The Outposts bucket owner has
|
2650
2991
|
# this permission by default and can grant this permission to others.
|
2651
2992
|
# For more information about permissions, see [ Permissions Related to
|
2652
2993
|
# Bucket Subresource Operations][5] and [Managing Access Permissions to
|
@@ -2671,7 +3012,7 @@ module Aws::S3Control
|
|
2671
3012
|
#
|
2672
3013
|
# * Error code: `OperationAbortedError `
|
2673
3014
|
#
|
2674
|
-
# * Description: A conflicting conditional
|
3015
|
+
# * Description: A conflicting conditional action is currently in
|
2675
3016
|
# progress against this resource. Try again.
|
2676
3017
|
#
|
2677
3018
|
# ^
|
@@ -2684,11 +3025,12 @@ module Aws::S3Control
|
|
2684
3025
|
# ^
|
2685
3026
|
#
|
2686
3027
|
# All Amazon S3 on Outposts REST API requests for this action require an
|
2687
|
-
# additional parameter of outpost-id to be passed with the
|
2688
|
-
# an S3 on Outposts endpoint hostname prefix instead of
|
2689
|
-
# an example of the request syntax for Amazon S3 on
|
2690
|
-
# the S3 on Outposts endpoint hostname prefix and the
|
2691
|
-
# using the access point ARN, see the
|
3028
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
3029
|
+
# request and an S3 on Outposts endpoint hostname prefix instead of
|
3030
|
+
# `s3-control`. For an example of the request syntax for Amazon S3 on
|
3031
|
+
# Outposts that uses the S3 on Outposts endpoint hostname prefix and the
|
3032
|
+
# `x-amz-outpost-id` derived using the access point ARN, see the
|
3033
|
+
# [Examples][9] section.
|
2692
3034
|
#
|
2693
3035
|
# The following actions are related to `PutBucketTagging`\:
|
2694
3036
|
#
|
@@ -2706,7 +3048,7 @@ module Aws::S3Control
|
|
2706
3048
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2707
3049
|
# [7]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
|
2708
3050
|
# [8]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tag-restrictions.html
|
2709
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
3051
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketTagging.html#API_control_PutBucketTagging_Examples
|
2710
3052
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketTagging.html
|
2711
3053
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketTagging.html
|
2712
3054
|
#
|
@@ -2716,8 +3058,11 @@ module Aws::S3Control
|
|
2716
3058
|
# @option params [required, String] :bucket
|
2717
3059
|
# The Amazon Resource Name (ARN) of the bucket.
|
2718
3060
|
#
|
2719
|
-
# For Amazon S3 on Outposts
|
2720
|
-
# the
|
3061
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
3062
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
3063
|
+
#
|
3064
|
+
# For using this parameter with S3 on Outposts with the AWS SDK and CLI,
|
3065
|
+
# you must specify the ARN of the bucket accessed in the format
|
2721
3066
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2722
3067
|
# For example, to access the bucket `reports` through outpost
|
2723
3068
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
@@ -2760,10 +3105,10 @@ module Aws::S3Control
|
|
2760
3105
|
# that is associated with the job. To modify the existing tag set, you
|
2761
3106
|
# can either replace the existing tag set entirely, or make changes
|
2762
3107
|
# within the existing tag set by retrieving the existing tag set using
|
2763
|
-
# [GetJobTagging][1], modify that tag set, and use this
|
3108
|
+
# [GetJobTagging][1], modify that tag set, and use this action to
|
2764
3109
|
# replace the tag set with the one you modified. For more information,
|
2765
3110
|
# see [Controlling access and labeling jobs using tags][2] in the
|
2766
|
-
# *Amazon Simple Storage Service
|
3111
|
+
# *Amazon Simple Storage Service User Guide*.
|
2767
3112
|
#
|
2768
3113
|
#
|
2769
3114
|
#
|
@@ -2796,7 +3141,7 @@ module Aws::S3Control
|
|
2796
3141
|
#
|
2797
3142
|
#
|
2798
3143
|
#
|
2799
|
-
# To use this
|
3144
|
+
# To use this action, you must have permission to perform the
|
2800
3145
|
# `s3:PutJobTagging` action.
|
2801
3146
|
#
|
2802
3147
|
# Related actions include:
|
@@ -2896,9 +3241,171 @@ module Aws::S3Control
|
|
2896
3241
|
req.send_request(options)
|
2897
3242
|
end
|
2898
3243
|
|
3244
|
+
# Puts an Amazon S3 Storage Lens configuration. For more information
|
3245
|
+
# about S3 Storage Lens, see [Working with Amazon S3 Storage Lens][1] in
|
3246
|
+
# the *Amazon Simple Storage Service User Guide*.
|
3247
|
+
#
|
3248
|
+
# <note markdown="1"> To use this action, you must have permission to perform the
|
3249
|
+
# `s3:PutStorageLensConfiguration` action. For more information, see
|
3250
|
+
# [Setting permissions to use Amazon S3 Storage Lens][2] in the *Amazon
|
3251
|
+
# Simple Storage Service User Guide*.
|
3252
|
+
#
|
3253
|
+
# </note>
|
3254
|
+
#
|
3255
|
+
#
|
3256
|
+
#
|
3257
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html
|
3258
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html
|
3259
|
+
#
|
3260
|
+
# @option params [required, String] :config_id
|
3261
|
+
# The ID of the S3 Storage Lens configuration.
|
3262
|
+
#
|
3263
|
+
# @option params [required, String] :account_id
|
3264
|
+
# The account ID of the requester.
|
3265
|
+
#
|
3266
|
+
# @option params [required, Types::StorageLensConfiguration] :storage_lens_configuration
|
3267
|
+
# The S3 Storage Lens configuration.
|
3268
|
+
#
|
3269
|
+
# @option params [Array<Types::StorageLensTag>] :tags
|
3270
|
+
# The tag set of the S3 Storage Lens configuration.
|
3271
|
+
#
|
3272
|
+
# <note markdown="1"> You can set up to a maximum of 50 tags.
|
3273
|
+
#
|
3274
|
+
# </note>
|
3275
|
+
#
|
3276
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3277
|
+
#
|
3278
|
+
# @example Request syntax with placeholder values
|
3279
|
+
#
|
3280
|
+
# resp = client.put_storage_lens_configuration({
|
3281
|
+
# config_id: "ConfigId", # required
|
3282
|
+
# account_id: "AccountId", # required
|
3283
|
+
# storage_lens_configuration: { # required
|
3284
|
+
# id: "ConfigId", # required
|
3285
|
+
# account_level: { # required
|
3286
|
+
# activity_metrics: {
|
3287
|
+
# is_enabled: false,
|
3288
|
+
# },
|
3289
|
+
# bucket_level: { # required
|
3290
|
+
# activity_metrics: {
|
3291
|
+
# is_enabled: false,
|
3292
|
+
# },
|
3293
|
+
# prefix_level: {
|
3294
|
+
# storage_metrics: { # required
|
3295
|
+
# is_enabled: false,
|
3296
|
+
# selection_criteria: {
|
3297
|
+
# delimiter: "StorageLensPrefixLevelDelimiter",
|
3298
|
+
# max_depth: 1,
|
3299
|
+
# min_storage_bytes_percentage: 1.0,
|
3300
|
+
# },
|
3301
|
+
# },
|
3302
|
+
# },
|
3303
|
+
# },
|
3304
|
+
# },
|
3305
|
+
# include: {
|
3306
|
+
# buckets: ["S3BucketArnString"],
|
3307
|
+
# regions: ["S3AWSRegion"],
|
3308
|
+
# },
|
3309
|
+
# exclude: {
|
3310
|
+
# buckets: ["S3BucketArnString"],
|
3311
|
+
# regions: ["S3AWSRegion"],
|
3312
|
+
# },
|
3313
|
+
# data_export: {
|
3314
|
+
# s3_bucket_destination: { # required
|
3315
|
+
# format: "CSV", # required, accepts CSV, Parquet
|
3316
|
+
# output_schema_version: "V_1", # required, accepts V_1
|
3317
|
+
# account_id: "AccountId", # required
|
3318
|
+
# arn: "S3BucketArnString", # required
|
3319
|
+
# prefix: "Prefix",
|
3320
|
+
# encryption: {
|
3321
|
+
# sses3: {
|
3322
|
+
# },
|
3323
|
+
# ssekms: {
|
3324
|
+
# key_id: "SSEKMSKeyId", # required
|
3325
|
+
# },
|
3326
|
+
# },
|
3327
|
+
# },
|
3328
|
+
# },
|
3329
|
+
# is_enabled: false, # required
|
3330
|
+
# aws_org: {
|
3331
|
+
# arn: "AwsOrgArn", # required
|
3332
|
+
# },
|
3333
|
+
# storage_lens_arn: "StorageLensArn",
|
3334
|
+
# },
|
3335
|
+
# tags: [
|
3336
|
+
# {
|
3337
|
+
# key: "TagKeyString", # required
|
3338
|
+
# value: "TagValueString", # required
|
3339
|
+
# },
|
3340
|
+
# ],
|
3341
|
+
# })
|
3342
|
+
#
|
3343
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutStorageLensConfiguration AWS API Documentation
|
3344
|
+
#
|
3345
|
+
# @overload put_storage_lens_configuration(params = {})
|
3346
|
+
# @param [Hash] params ({})
|
3347
|
+
def put_storage_lens_configuration(params = {}, options = {})
|
3348
|
+
req = build_request(:put_storage_lens_configuration, params)
|
3349
|
+
req.send_request(options)
|
3350
|
+
end
|
3351
|
+
|
3352
|
+
# Put or replace tags on an existing Amazon S3 Storage Lens
|
3353
|
+
# configuration. For more information about S3 Storage Lens, see
|
3354
|
+
# [Assessing your storage activity and usage with Amazon S3 Storage Lens
|
3355
|
+
# ][1] in the *Amazon Simple Storage Service User Guide*.
|
3356
|
+
#
|
3357
|
+
# <note markdown="1"> To use this action, you must have permission to perform the
|
3358
|
+
# `s3:PutStorageLensConfigurationTagging` action. For more information,
|
3359
|
+
# see [Setting permissions to use Amazon S3 Storage Lens][2] in the
|
3360
|
+
# *Amazon Simple Storage Service User Guide*.
|
3361
|
+
#
|
3362
|
+
# </note>
|
3363
|
+
#
|
3364
|
+
#
|
3365
|
+
#
|
3366
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html
|
3367
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html
|
3368
|
+
#
|
3369
|
+
# @option params [required, String] :config_id
|
3370
|
+
# The ID of the S3 Storage Lens configuration.
|
3371
|
+
#
|
3372
|
+
# @option params [required, String] :account_id
|
3373
|
+
# The account ID of the requester.
|
3374
|
+
#
|
3375
|
+
# @option params [required, Array<Types::StorageLensTag>] :tags
|
3376
|
+
# The tag set of the S3 Storage Lens configuration.
|
3377
|
+
#
|
3378
|
+
# <note markdown="1"> You can set up to a maximum of 50 tags.
|
3379
|
+
#
|
3380
|
+
# </note>
|
3381
|
+
#
|
3382
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3383
|
+
#
|
3384
|
+
# @example Request syntax with placeholder values
|
3385
|
+
#
|
3386
|
+
# resp = client.put_storage_lens_configuration_tagging({
|
3387
|
+
# config_id: "ConfigId", # required
|
3388
|
+
# account_id: "AccountId", # required
|
3389
|
+
# tags: [ # required
|
3390
|
+
# {
|
3391
|
+
# key: "TagKeyString", # required
|
3392
|
+
# value: "TagValueString", # required
|
3393
|
+
# },
|
3394
|
+
# ],
|
3395
|
+
# })
|
3396
|
+
#
|
3397
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutStorageLensConfigurationTagging AWS API Documentation
|
3398
|
+
#
|
3399
|
+
# @overload put_storage_lens_configuration_tagging(params = {})
|
3400
|
+
# @param [Hash] params ({})
|
3401
|
+
def put_storage_lens_configuration_tagging(params = {}, options = {})
|
3402
|
+
req = build_request(:put_storage_lens_configuration_tagging, params)
|
3403
|
+
req.send_request(options)
|
3404
|
+
end
|
3405
|
+
|
2899
3406
|
# Updates an existing S3 Batch Operations job's priority. For more
|
2900
3407
|
# information, see [S3 Batch Operations][1] in the *Amazon Simple
|
2901
|
-
# Storage Service
|
3408
|
+
# Storage Service User Guide*.
|
2902
3409
|
#
|
2903
3410
|
#
|
2904
3411
|
#
|
@@ -2921,6 +3428,7 @@ module Aws::S3Control
|
|
2921
3428
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
|
2922
3429
|
#
|
2923
3430
|
# @option params [required, String] :account_id
|
3431
|
+
# The AWS account ID associated with the S3 Batch Operations job.
|
2924
3432
|
#
|
2925
3433
|
# @option params [required, String] :job_id
|
2926
3434
|
# The ID for the job whose priority you want to update.
|
@@ -2955,10 +3463,10 @@ module Aws::S3Control
|
|
2955
3463
|
req.send_request(options)
|
2956
3464
|
end
|
2957
3465
|
|
2958
|
-
# Updates the status for the specified job. Use this
|
2959
|
-
#
|
2960
|
-
#
|
2961
|
-
# Storage Service
|
3466
|
+
# Updates the status for the specified job. Use this action to confirm
|
3467
|
+
# that you want to run a job or to cancel an existing job. For more
|
3468
|
+
# information, see [S3 Batch Operations][1] in the *Amazon Simple
|
3469
|
+
# Storage Service User Guide*.
|
2962
3470
|
#
|
2963
3471
|
#
|
2964
3472
|
#
|
@@ -2981,6 +3489,7 @@ module Aws::S3Control
|
|
2981
3489
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
|
2982
3490
|
#
|
2983
3491
|
# @option params [required, String] :account_id
|
3492
|
+
# The AWS account ID associated with the S3 Batch Operations job.
|
2984
3493
|
#
|
2985
3494
|
# @option params [required, String] :job_id
|
2986
3495
|
# The ID of the job whose status you want to update.
|
@@ -3035,7 +3544,7 @@ module Aws::S3Control
|
|
3035
3544
|
params: params,
|
3036
3545
|
config: config)
|
3037
3546
|
context[:gem_name] = 'aws-sdk-s3control'
|
3038
|
-
context[:gem_version] = '1.
|
3547
|
+
context[:gem_version] = '1.29.0'
|
3039
3548
|
Seahorse::Client::Request.new(handlers, context)
|
3040
3549
|
end
|
3041
3550
|
|