aws-sdk-s3control 1.60.0 → 1.61.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3control/client.rb +508 -74
- data/lib/aws-sdk-s3control/client_api.rb +154 -0
- data/lib/aws-sdk-s3control/endpoint_provider.rb +19 -19
- data/lib/aws-sdk-s3control/endpoints.rb +60 -0
- data/lib/aws-sdk-s3control/plugins/endpoints.rb +6 -0
- data/lib/aws-sdk-s3control/types.rb +739 -60
- data/lib/aws-sdk-s3control.rb +1 -1
- metadata +2 -2
@@ -404,7 +404,7 @@ module Aws::S3Control
|
|
404
404
|
#
|
405
405
|
#
|
406
406
|
#
|
407
|
-
# The following actions are related to `CreateAccessPoint
|
407
|
+
# The following actions are related to `CreateAccessPoint`:
|
408
408
|
#
|
409
409
|
# * [GetAccessPoint][4]
|
410
410
|
#
|
@@ -439,7 +439,7 @@ module Aws::S3Control
|
|
439
439
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
440
440
|
# in the format
|
441
441
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
442
|
-
# For example, to access the bucket `reports` through
|
442
|
+
# For example, to access the bucket `reports` through Outpost
|
443
443
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
444
444
|
# use the URL encoding of
|
445
445
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -504,7 +504,7 @@ module Aws::S3Control
|
|
504
504
|
# *Amazon S3 User Guide*.
|
505
505
|
#
|
506
506
|
# The following actions are related to
|
507
|
-
# `CreateAccessPointForObjectLambda
|
507
|
+
# `CreateAccessPointForObjectLambda`:
|
508
508
|
#
|
509
509
|
# * [DeleteAccessPointForObjectLambda][2]
|
510
510
|
#
|
@@ -1005,7 +1005,7 @@ module Aws::S3Control
|
|
1005
1005
|
# a response, it provides a token that you can use to monitor the status
|
1006
1006
|
# of the request with `DescribeMultiRegionAccessPointOperation`.
|
1007
1007
|
#
|
1008
|
-
# The following actions are related to `CreateMultiRegionAccessPoint
|
1008
|
+
# The following actions are related to `CreateMultiRegionAccessPoint`:
|
1009
1009
|
#
|
1010
1010
|
# * [DeleteMultiRegionAccessPoint][3]
|
1011
1011
|
#
|
@@ -1060,6 +1060,7 @@ module Aws::S3Control
|
|
1060
1060
|
# regions: [ # required
|
1061
1061
|
# {
|
1062
1062
|
# bucket: "BucketName", # required
|
1063
|
+
# bucket_account_id: "AccountId",
|
1063
1064
|
# },
|
1064
1065
|
# ],
|
1065
1066
|
# },
|
@@ -1088,7 +1089,7 @@ module Aws::S3Control
|
|
1088
1089
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
1089
1090
|
# point ARN, see the [Examples][1] section.
|
1090
1091
|
#
|
1091
|
-
# The following actions are related to `DeleteAccessPoint
|
1092
|
+
# The following actions are related to `DeleteAccessPoint`:
|
1092
1093
|
#
|
1093
1094
|
# * [CreateAccessPoint][2]
|
1094
1095
|
#
|
@@ -1117,7 +1118,7 @@ module Aws::S3Control
|
|
1117
1118
|
# Services SDK and CLI, you must specify the ARN of the access point
|
1118
1119
|
# accessed in the format
|
1119
1120
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
1120
|
-
# For example, to access the access point `reports-ap` through
|
1121
|
+
# For example, to access the access point `reports-ap` through Outpost
|
1121
1122
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
1122
1123
|
# use the URL encoding of
|
1123
1124
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/accesspoint/reports-ap`.
|
@@ -1144,7 +1145,7 @@ module Aws::S3Control
|
|
1144
1145
|
# Deletes the specified Object Lambda Access Point.
|
1145
1146
|
#
|
1146
1147
|
# The following actions are related to
|
1147
|
-
# `DeleteAccessPointForObjectLambda
|
1148
|
+
# `DeleteAccessPointForObjectLambda`:
|
1148
1149
|
#
|
1149
1150
|
# * [CreateAccessPointForObjectLambda][1]
|
1150
1151
|
#
|
@@ -1195,7 +1196,7 @@ module Aws::S3Control
|
|
1195
1196
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
1196
1197
|
# point ARN, see the [Examples][1] section.
|
1197
1198
|
#
|
1198
|
-
# The following actions are related to `DeleteAccessPointPolicy
|
1199
|
+
# The following actions are related to `DeleteAccessPointPolicy`:
|
1199
1200
|
#
|
1200
1201
|
# * [PutAccessPointPolicy][2]
|
1201
1202
|
#
|
@@ -1220,7 +1221,7 @@ module Aws::S3Control
|
|
1220
1221
|
# Services SDK and CLI, you must specify the ARN of the access point
|
1221
1222
|
# accessed in the format
|
1222
1223
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
1223
|
-
# For example, to access the access point `reports-ap` through
|
1224
|
+
# For example, to access the access point `reports-ap` through Outpost
|
1224
1225
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
1225
1226
|
# use the URL encoding of
|
1226
1227
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/accesspoint/reports-ap`.
|
@@ -1247,7 +1248,7 @@ module Aws::S3Control
|
|
1247
1248
|
# Removes the resource policy for an Object Lambda Access Point.
|
1248
1249
|
#
|
1249
1250
|
# The following actions are related to
|
1250
|
-
# `DeleteAccessPointPolicyForObjectLambda
|
1251
|
+
# `DeleteAccessPointPolicyForObjectLambda`:
|
1251
1252
|
#
|
1252
1253
|
# * [GetAccessPointPolicyForObjectLambda][1]
|
1253
1254
|
#
|
@@ -1332,7 +1333,7 @@ module Aws::S3Control
|
|
1332
1333
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
1333
1334
|
# in the format
|
1334
1335
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1335
|
-
# For example, to access the bucket `reports` through
|
1336
|
+
# For example, to access the bucket `reports` through Outpost
|
1336
1337
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
1337
1338
|
# use the URL encoding of
|
1338
1339
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -1414,7 +1415,7 @@ module Aws::S3Control
|
|
1414
1415
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
1415
1416
|
# in the format
|
1416
1417
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1417
|
-
# For example, to access the bucket `reports` through
|
1418
|
+
# For example, to access the bucket `reports` through Outpost
|
1418
1419
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
1419
1420
|
# use the URL encoding of
|
1420
1421
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -1474,7 +1475,7 @@ module Aws::S3Control
|
|
1474
1475
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
1475
1476
|
# point ARN, see the [Examples][4] section.
|
1476
1477
|
#
|
1477
|
-
# The following actions are related to `DeleteBucketPolicy
|
1478
|
+
# The following actions are related to `DeleteBucketPolicy`:
|
1478
1479
|
#
|
1479
1480
|
# * [GetBucketPolicy][5]
|
1480
1481
|
#
|
@@ -1502,7 +1503,7 @@ module Aws::S3Control
|
|
1502
1503
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
1503
1504
|
# in the format
|
1504
1505
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1505
|
-
# For example, to access the bucket `reports` through
|
1506
|
+
# For example, to access the bucket `reports` through Outpost
|
1506
1507
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
1507
1508
|
# use the URL encoding of
|
1508
1509
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -1526,6 +1527,99 @@ module Aws::S3Control
|
|
1526
1527
|
req.send_request(options)
|
1527
1528
|
end
|
1528
1529
|
|
1530
|
+
# <note markdown="1"> This operation deletes an Amazon S3 on Outposts bucket's replication
|
1531
|
+
# configuration. To delete an S3 bucket's replication configuration,
|
1532
|
+
# see [DeleteBucketReplication][1] in the *Amazon S3 API Reference*.
|
1533
|
+
#
|
1534
|
+
# </note>
|
1535
|
+
#
|
1536
|
+
# Deletes the replication configuration from the specified S3 on
|
1537
|
+
# Outposts bucket.
|
1538
|
+
#
|
1539
|
+
# To use this operation, you must have permissions to perform the
|
1540
|
+
# `s3-outposts:PutReplicationConfiguration` action. The Outposts bucket
|
1541
|
+
# owner has this permission by default and can grant it to others. For
|
1542
|
+
# more information about permissions, see [Setting up IAM with S3 on
|
1543
|
+
# Outposts][2] and [Managing access to S3 on Outposts buckets][3] in the
|
1544
|
+
# *Amazon S3 User Guide*.
|
1545
|
+
#
|
1546
|
+
# <note markdown="1"> It can take a while to propagate `PUT` or `DELETE` requests for a
|
1547
|
+
# replication configuration to all S3 on Outposts systems. Therefore,
|
1548
|
+
# the replication configuration that's returned by a `GET` request soon
|
1549
|
+
# after a `PUT` or `DELETE` request might return a more recent result
|
1550
|
+
# than what's on the Outpost. If an Outpost is offline, the delay in
|
1551
|
+
# updating the replication configuration on that Outpost can be
|
1552
|
+
# significant.
|
1553
|
+
#
|
1554
|
+
# </note>
|
1555
|
+
#
|
1556
|
+
# All Amazon S3 on Outposts REST API requests for this action require an
|
1557
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
1558
|
+
# request. In addition, you must use an S3 on Outposts endpoint hostname
|
1559
|
+
# prefix instead of `s3-control`. For an example of the request syntax
|
1560
|
+
# for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
|
1561
|
+
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
1562
|
+
# point ARN, see the [Examples][4] section.
|
1563
|
+
#
|
1564
|
+
# For information about S3 replication on Outposts configuration, see
|
1565
|
+
# [Replicating objects for Amazon Web Services Outposts][5] in the
|
1566
|
+
# *Amazon S3 User Guide*.
|
1567
|
+
#
|
1568
|
+
# The following operations are related to `DeleteBucketReplication`:
|
1569
|
+
#
|
1570
|
+
# * [PutBucketReplication][6]
|
1571
|
+
#
|
1572
|
+
# * [GetBucketReplication][7]
|
1573
|
+
#
|
1574
|
+
#
|
1575
|
+
#
|
1576
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html
|
1577
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsIAM.html
|
1578
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsBucketPolicy.html
|
1579
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketReplication.html#API_control_DeleteBucketReplication_Examples
|
1580
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsReplication.html
|
1581
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketReplication.html
|
1582
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketReplication.html
|
1583
|
+
#
|
1584
|
+
# @option params [String] :account_id
|
1585
|
+
# The Amazon Web Services account ID of the Outposts bucket to delete
|
1586
|
+
# the replication configuration for.
|
1587
|
+
#
|
1588
|
+
# @option params [required, String] :bucket
|
1589
|
+
# Specifies the S3 on Outposts bucket to delete the replication
|
1590
|
+
# configuration for.
|
1591
|
+
#
|
1592
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
1593
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
1594
|
+
#
|
1595
|
+
# For using this parameter with S3 on Outposts with the Amazon Web
|
1596
|
+
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
1597
|
+
# in the format
|
1598
|
+
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1599
|
+
# For example, to access the bucket `reports` through Outpost
|
1600
|
+
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
1601
|
+
# use the URL encoding of
|
1602
|
+
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
1603
|
+
# The value must be URL encoded.
|
1604
|
+
#
|
1605
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1606
|
+
#
|
1607
|
+
# @example Request syntax with placeholder values
|
1608
|
+
#
|
1609
|
+
# resp = client.delete_bucket_replication({
|
1610
|
+
# account_id: "AccountId",
|
1611
|
+
# bucket: "BucketName", # required
|
1612
|
+
# })
|
1613
|
+
#
|
1614
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DeleteBucketReplication AWS API Documentation
|
1615
|
+
#
|
1616
|
+
# @overload delete_bucket_replication(params = {})
|
1617
|
+
# @param [Hash] params ({})
|
1618
|
+
def delete_bucket_replication(params = {}, options = {})
|
1619
|
+
req = build_request(:delete_bucket_replication, params)
|
1620
|
+
req.send_request(options)
|
1621
|
+
end
|
1622
|
+
|
1529
1623
|
# <note markdown="1"> This action deletes an Amazon S3 on Outposts bucket's tags. To delete
|
1530
1624
|
# an S3 bucket tags, see [DeleteBucketTagging][1] in the *Amazon S3 API
|
1531
1625
|
# Reference*.
|
@@ -1547,7 +1641,7 @@ module Aws::S3Control
|
|
1547
1641
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
1548
1642
|
# point ARN, see the [Examples][3] section.
|
1549
1643
|
#
|
1550
|
-
# The following actions are related to `DeleteBucketTagging
|
1644
|
+
# The following actions are related to `DeleteBucketTagging`:
|
1551
1645
|
#
|
1552
1646
|
# * [GetBucketTagging][4]
|
1553
1647
|
#
|
@@ -1575,7 +1669,7 @@ module Aws::S3Control
|
|
1575
1669
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
1576
1670
|
# in the format
|
1577
1671
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
1578
|
-
# For example, to access the bucket `reports` through
|
1672
|
+
# For example, to access the bucket `reports` through Outpost
|
1579
1673
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
1580
1674
|
# use the URL encoding of
|
1581
1675
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -1600,9 +1694,10 @@ module Aws::S3Control
|
|
1600
1694
|
end
|
1601
1695
|
|
1602
1696
|
# Removes the entire tag set from the specified S3 Batch Operations job.
|
1603
|
-
# To use
|
1604
|
-
# `s3:DeleteJobTagging` action. For more information, see
|
1605
|
-
# access and labeling jobs using tags][1] in the *Amazon S3
|
1697
|
+
# To use the `DeleteJobTagging` operation, you must have permission to
|
1698
|
+
# perform the `s3:DeleteJobTagging` action. For more information, see
|
1699
|
+
# [Controlling access and labeling jobs using tags][1] in the *Amazon S3
|
1700
|
+
# User Guide*.
|
1606
1701
|
#
|
1607
1702
|
#
|
1608
1703
|
#
|
@@ -1660,7 +1755,7 @@ module Aws::S3Control
|
|
1660
1755
|
# a response, it provides a token that you can use to monitor the status
|
1661
1756
|
# of the request with `DescribeMultiRegionAccessPointOperation`.
|
1662
1757
|
#
|
1663
|
-
# The following actions are related to `DeleteMultiRegionAccessPoint
|
1758
|
+
# The following actions are related to `DeleteMultiRegionAccessPoint`:
|
1664
1759
|
#
|
1665
1760
|
# * [CreateMultiRegionAccessPoint][2]
|
1666
1761
|
#
|
@@ -1998,7 +2093,7 @@ module Aws::S3Control
|
|
1998
2093
|
# [Managing Multi-Region Access Points][1] in the *Amazon S3 User
|
1999
2094
|
# Guide*.
|
2000
2095
|
#
|
2001
|
-
# The following actions are related to `GetMultiRegionAccessPoint
|
2096
|
+
# The following actions are related to `GetMultiRegionAccessPoint`:
|
2002
2097
|
#
|
2003
2098
|
# * [CreateMultiRegionAccessPoint][2]
|
2004
2099
|
#
|
@@ -2049,6 +2144,7 @@ module Aws::S3Control
|
|
2049
2144
|
# resp.async_operation.request_parameters.create_multi_region_access_point_request.public_access_block.restrict_public_buckets #=> Boolean
|
2050
2145
|
# resp.async_operation.request_parameters.create_multi_region_access_point_request.regions #=> Array
|
2051
2146
|
# resp.async_operation.request_parameters.create_multi_region_access_point_request.regions[0].bucket #=> String
|
2147
|
+
# resp.async_operation.request_parameters.create_multi_region_access_point_request.regions[0].bucket_account_id #=> String
|
2052
2148
|
# resp.async_operation.request_parameters.delete_multi_region_access_point_request.name #=> String
|
2053
2149
|
# resp.async_operation.request_parameters.put_multi_region_access_point_policy_request.name #=> String
|
2054
2150
|
# resp.async_operation.request_parameters.put_multi_region_access_point_policy_request.policy #=> String
|
@@ -2082,7 +2178,7 @@ module Aws::S3Control
|
|
2082
2178
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
2083
2179
|
# point ARN, see the [Examples][1] section.
|
2084
2180
|
#
|
2085
|
-
# The following actions are related to `GetAccessPoint
|
2181
|
+
# The following actions are related to `GetAccessPoint`:
|
2086
2182
|
#
|
2087
2183
|
# * [CreateAccessPoint][2]
|
2088
2184
|
#
|
@@ -2112,7 +2208,7 @@ module Aws::S3Control
|
|
2112
2208
|
# Services SDK and CLI, you must specify the ARN of the access point
|
2113
2209
|
# accessed in the format
|
2114
2210
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
2115
|
-
# For example, to access the access point `reports-ap` through
|
2211
|
+
# For example, to access the access point `reports-ap` through Outpost
|
2116
2212
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
2117
2213
|
# use the URL encoding of
|
2118
2214
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/accesspoint/reports-ap`.
|
@@ -2167,7 +2263,7 @@ module Aws::S3Control
|
|
2167
2263
|
# Returns configuration for an Object Lambda Access Point.
|
2168
2264
|
#
|
2169
2265
|
# The following actions are related to
|
2170
|
-
# `GetAccessPointConfigurationForObjectLambda
|
2266
|
+
# `GetAccessPointConfigurationForObjectLambda`:
|
2171
2267
|
#
|
2172
2268
|
# * [PutAccessPointConfigurationForObjectLambda][1]
|
2173
2269
|
#
|
@@ -2220,7 +2316,7 @@ module Aws::S3Control
|
|
2220
2316
|
# Returns configuration information about the specified Object Lambda
|
2221
2317
|
# Access Point
|
2222
2318
|
#
|
2223
|
-
# The following actions are related to `GetAccessPointForObjectLambda
|
2319
|
+
# The following actions are related to `GetAccessPointForObjectLambda`:
|
2224
2320
|
#
|
2225
2321
|
# * [CreateAccessPointForObjectLambda][1]
|
2226
2322
|
#
|
@@ -2275,7 +2371,7 @@ module Aws::S3Control
|
|
2275
2371
|
# Returns the access point policy associated with the specified access
|
2276
2372
|
# point.
|
2277
2373
|
#
|
2278
|
-
# The following actions are related to `GetAccessPointPolicy
|
2374
|
+
# The following actions are related to `GetAccessPointPolicy`:
|
2279
2375
|
#
|
2280
2376
|
# * [PutAccessPointPolicy][1]
|
2281
2377
|
#
|
@@ -2299,7 +2395,7 @@ module Aws::S3Control
|
|
2299
2395
|
# Services SDK and CLI, you must specify the ARN of the access point
|
2300
2396
|
# accessed in the format
|
2301
2397
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
2302
|
-
# For example, to access the access point `reports-ap` through
|
2398
|
+
# For example, to access the access point `reports-ap` through Outpost
|
2303
2399
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
2304
2400
|
# use the URL encoding of
|
2305
2401
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/accesspoint/reports-ap`.
|
@@ -2332,7 +2428,7 @@ module Aws::S3Control
|
|
2332
2428
|
# Returns the resource policy for an Object Lambda Access Point.
|
2333
2429
|
#
|
2334
2430
|
# The following actions are related to
|
2335
|
-
# `GetAccessPointPolicyForObjectLambda
|
2431
|
+
# `GetAccessPointPolicyForObjectLambda`:
|
2336
2432
|
#
|
2337
2433
|
# * [DeleteAccessPointPolicyForObjectLambda][1]
|
2338
2434
|
#
|
@@ -2500,7 +2596,7 @@ module Aws::S3Control
|
|
2500
2596
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
2501
2597
|
# in the format
|
2502
2598
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2503
|
-
# For example, to access the bucket `reports` through
|
2599
|
+
# For example, to access the bucket `reports` through Outpost
|
2504
2600
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
2505
2601
|
# use the URL encoding of
|
2506
2602
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -2571,7 +2667,7 @@ module Aws::S3Control
|
|
2571
2667
|
# * SOAP Fault Code Prefix: Client
|
2572
2668
|
#
|
2573
2669
|
# The following actions are related to
|
2574
|
-
# `GetBucketLifecycleConfiguration
|
2670
|
+
# `GetBucketLifecycleConfiguration`:
|
2575
2671
|
#
|
2576
2672
|
# * [PutBucketLifecycleConfiguration][7]
|
2577
2673
|
#
|
@@ -2601,7 +2697,7 @@ module Aws::S3Control
|
|
2601
2697
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
2602
2698
|
# in the format
|
2603
2699
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2604
|
-
# For example, to access the bucket `reports` through
|
2700
|
+
# For example, to access the bucket `reports` through Outpost
|
2605
2701
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
2606
2702
|
# use the URL encoding of
|
2607
2703
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -2694,7 +2790,7 @@ module Aws::S3Control
|
|
2694
2790
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
2695
2791
|
# point ARN, see the [Examples][4] section.
|
2696
2792
|
#
|
2697
|
-
# The following actions are related to `GetBucketPolicy
|
2793
|
+
# The following actions are related to `GetBucketPolicy`:
|
2698
2794
|
#
|
2699
2795
|
# * [GetObject][5]
|
2700
2796
|
#
|
@@ -2725,7 +2821,7 @@ module Aws::S3Control
|
|
2725
2821
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
2726
2822
|
# in the format
|
2727
2823
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2728
|
-
# For example, to access the bucket `reports` through
|
2824
|
+
# For example, to access the bucket `reports` through Outpost
|
2729
2825
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
2730
2826
|
# use the URL encoding of
|
2731
2827
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -2755,6 +2851,137 @@ module Aws::S3Control
|
|
2755
2851
|
req.send_request(options)
|
2756
2852
|
end
|
2757
2853
|
|
2854
|
+
# <note markdown="1"> This operation gets an Amazon S3 on Outposts bucket's replication
|
2855
|
+
# configuration. To get an S3 bucket's replication configuration, see
|
2856
|
+
# [GetBucketReplication][1] in the *Amazon S3 API Reference*.
|
2857
|
+
#
|
2858
|
+
# </note>
|
2859
|
+
#
|
2860
|
+
# Returns the replication configuration of an S3 on Outposts bucket. For
|
2861
|
+
# more information about S3 on Outposts, see [Using Amazon S3 on
|
2862
|
+
# Outposts][2] in the *Amazon S3 User Guide*. For information about S3
|
2863
|
+
# replication on Outposts configuration, see [Replicating objects for
|
2864
|
+
# Amazon Web Services Outposts][3] in the *Amazon S3 User Guide*.
|
2865
|
+
#
|
2866
|
+
# <note markdown="1"> It can take a while to propagate `PUT` or `DELETE` requests for a
|
2867
|
+
# replication configuration to all S3 on Outposts systems. Therefore,
|
2868
|
+
# the replication configuration that's returned by a `GET` request soon
|
2869
|
+
# after a `PUT` or `DELETE` request might return a more recent result
|
2870
|
+
# than what's on the Outpost. If an Outpost is offline, the delay in
|
2871
|
+
# updating the replication configuration on that Outpost can be
|
2872
|
+
# significant.
|
2873
|
+
#
|
2874
|
+
# </note>
|
2875
|
+
#
|
2876
|
+
# This action requires permissions for the
|
2877
|
+
# `s3-outposts:GetReplicationConfiguration` action. The Outposts bucket
|
2878
|
+
# owner has this permission by default and can grant it to others. For
|
2879
|
+
# more information about permissions, see [Setting up IAM with S3 on
|
2880
|
+
# Outposts][4] and [Managing access to S3 on Outposts bucket][5] in the
|
2881
|
+
# *Amazon S3 User Guide*.
|
2882
|
+
#
|
2883
|
+
# All Amazon S3 on Outposts REST API requests for this action require an
|
2884
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
2885
|
+
# request. In addition, you must use an S3 on Outposts endpoint hostname
|
2886
|
+
# prefix instead of `s3-control`. For an example of the request syntax
|
2887
|
+
# for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
|
2888
|
+
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
2889
|
+
# point ARN, see the [Examples][6] section.
|
2890
|
+
#
|
2891
|
+
# If you include the `Filter` element in a replication configuration,
|
2892
|
+
# you must also include the `DeleteMarkerReplication`, `Status`, and
|
2893
|
+
# `Priority` elements. The response also returns those elements.
|
2894
|
+
#
|
2895
|
+
# For information about S3 on Outposts replication failure reasons, see
|
2896
|
+
# [Replication failure reasons][7] in the *Amazon S3 User Guide*.
|
2897
|
+
#
|
2898
|
+
# The following operations are related to `GetBucketReplication`:
|
2899
|
+
#
|
2900
|
+
# * [PutBucketReplication][8]
|
2901
|
+
#
|
2902
|
+
# * [DeleteBucketReplication][9]
|
2903
|
+
#
|
2904
|
+
#
|
2905
|
+
#
|
2906
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
|
2907
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
|
2908
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsReplication.html
|
2909
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsIAM.html
|
2910
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsBucketPolicy.html
|
2911
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketReplication.html#API_control_GetBucketReplication_Examples
|
2912
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/outposts-replication-eventbridge.html#outposts-replication-failure-codes
|
2913
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketReplication.html
|
2914
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketReplication.html
|
2915
|
+
#
|
2916
|
+
# @option params [String] :account_id
|
2917
|
+
# The Amazon Web Services account ID of the Outposts bucket.
|
2918
|
+
#
|
2919
|
+
# @option params [required, String] :bucket
|
2920
|
+
# Specifies the bucket to get the replication information for.
|
2921
|
+
#
|
2922
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
2923
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
2924
|
+
#
|
2925
|
+
# For using this parameter with S3 on Outposts with the Amazon Web
|
2926
|
+
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
2927
|
+
# in the format
|
2928
|
+
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2929
|
+
# For example, to access the bucket `reports` through Outpost
|
2930
|
+
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
2931
|
+
# use the URL encoding of
|
2932
|
+
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
2933
|
+
# The value must be URL encoded.
|
2934
|
+
#
|
2935
|
+
# @return [Types::GetBucketReplicationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2936
|
+
#
|
2937
|
+
# * {Types::GetBucketReplicationResult#replication_configuration #replication_configuration} => Types::ReplicationConfiguration
|
2938
|
+
#
|
2939
|
+
# @example Request syntax with placeholder values
|
2940
|
+
#
|
2941
|
+
# resp = client.get_bucket_replication({
|
2942
|
+
# account_id: "AccountId",
|
2943
|
+
# bucket: "BucketName", # required
|
2944
|
+
# })
|
2945
|
+
#
|
2946
|
+
# @example Response structure
|
2947
|
+
#
|
2948
|
+
# resp.replication_configuration.role #=> String
|
2949
|
+
# resp.replication_configuration.rules #=> Array
|
2950
|
+
# resp.replication_configuration.rules[0].id #=> String
|
2951
|
+
# resp.replication_configuration.rules[0].priority #=> Integer
|
2952
|
+
# resp.replication_configuration.rules[0].prefix #=> String
|
2953
|
+
# resp.replication_configuration.rules[0].filter.prefix #=> String
|
2954
|
+
# resp.replication_configuration.rules[0].filter.tag.key #=> String
|
2955
|
+
# resp.replication_configuration.rules[0].filter.tag.value #=> String
|
2956
|
+
# resp.replication_configuration.rules[0].filter.and.prefix #=> String
|
2957
|
+
# resp.replication_configuration.rules[0].filter.and.tags #=> Array
|
2958
|
+
# resp.replication_configuration.rules[0].filter.and.tags[0].key #=> String
|
2959
|
+
# resp.replication_configuration.rules[0].filter.and.tags[0].value #=> String
|
2960
|
+
# resp.replication_configuration.rules[0].status #=> String, one of "Enabled", "Disabled"
|
2961
|
+
# resp.replication_configuration.rules[0].source_selection_criteria.sse_kms_encrypted_objects.status #=> String, one of "Enabled", "Disabled"
|
2962
|
+
# resp.replication_configuration.rules[0].source_selection_criteria.replica_modifications.status #=> String, one of "Enabled", "Disabled"
|
2963
|
+
# resp.replication_configuration.rules[0].existing_object_replication.status #=> String, one of "Enabled", "Disabled"
|
2964
|
+
# resp.replication_configuration.rules[0].destination.account #=> String
|
2965
|
+
# resp.replication_configuration.rules[0].destination.bucket #=> String
|
2966
|
+
# resp.replication_configuration.rules[0].destination.replication_time.status #=> String, one of "Enabled", "Disabled"
|
2967
|
+
# resp.replication_configuration.rules[0].destination.replication_time.time.minutes #=> Integer
|
2968
|
+
# resp.replication_configuration.rules[0].destination.access_control_translation.owner #=> String, one of "Destination"
|
2969
|
+
# resp.replication_configuration.rules[0].destination.encryption_configuration.replica_kms_key_id #=> String
|
2970
|
+
# resp.replication_configuration.rules[0].destination.metrics.status #=> String, one of "Enabled", "Disabled"
|
2971
|
+
# resp.replication_configuration.rules[0].destination.metrics.event_threshold.minutes #=> Integer
|
2972
|
+
# resp.replication_configuration.rules[0].destination.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
2973
|
+
# resp.replication_configuration.rules[0].delete_marker_replication.status #=> String, one of "Enabled", "Disabled"
|
2974
|
+
# resp.replication_configuration.rules[0].bucket #=> String
|
2975
|
+
#
|
2976
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetBucketReplication AWS API Documentation
|
2977
|
+
#
|
2978
|
+
# @overload get_bucket_replication(params = {})
|
2979
|
+
# @param [Hash] params ({})
|
2980
|
+
def get_bucket_replication(params = {}, options = {})
|
2981
|
+
req = build_request(:get_bucket_replication, params)
|
2982
|
+
req.send_request(options)
|
2983
|
+
end
|
2984
|
+
|
2758
2985
|
# <note markdown="1"> This action gets an Amazon S3 on Outposts bucket's tags. To get an S3
|
2759
2986
|
# bucket tags, see [GetBucketTagging][1] in the *Amazon S3 API
|
2760
2987
|
# Reference*.
|
@@ -2785,7 +3012,7 @@ module Aws::S3Control
|
|
2785
3012
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
2786
3013
|
# point ARN, see the [Examples][3] section.
|
2787
3014
|
#
|
2788
|
-
# The following actions are related to `GetBucketTagging
|
3015
|
+
# The following actions are related to `GetBucketTagging`:
|
2789
3016
|
#
|
2790
3017
|
# * [PutBucketTagging][4]
|
2791
3018
|
#
|
@@ -2812,7 +3039,7 @@ module Aws::S3Control
|
|
2812
3039
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
2813
3040
|
# in the format
|
2814
3041
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
2815
|
-
# For example, to access the bucket `reports` through
|
3042
|
+
# For example, to access the bucket `reports` through Outpost
|
2816
3043
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
2817
3044
|
# use the URL encoding of
|
2818
3045
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -2844,14 +3071,14 @@ module Aws::S3Control
|
|
2844
3071
|
req.send_request(options)
|
2845
3072
|
end
|
2846
3073
|
|
2847
|
-
# <note markdown="1"> This operation returns the versioning state
|
2848
|
-
#
|
3074
|
+
# <note markdown="1"> This operation returns the versioning state for S3 on Outposts buckets
|
3075
|
+
# only. To return the versioning state for an S3 bucket, see
|
2849
3076
|
# [GetBucketVersioning][1] in the *Amazon S3 API Reference*.
|
2850
3077
|
#
|
2851
3078
|
# </note>
|
2852
3079
|
#
|
2853
|
-
# Returns the versioning state for an S3 on Outposts bucket. With
|
2854
|
-
#
|
3080
|
+
# Returns the versioning state for an S3 on Outposts bucket. With S3
|
3081
|
+
# Versioning, you can save multiple distinct copies of your objects and
|
2855
3082
|
# recover from unintended user actions and application failures.
|
2856
3083
|
#
|
2857
3084
|
# If you've never set versioning on your bucket, it has no versioning
|
@@ -2919,10 +3146,10 @@ module Aws::S3Control
|
|
2919
3146
|
req.send_request(options)
|
2920
3147
|
end
|
2921
3148
|
|
2922
|
-
# Returns the tags on an S3 Batch Operations job. To use
|
2923
|
-
# you must have permission to perform the
|
2924
|
-
# more information, see [Controlling
|
2925
|
-
# tags][1] in the *Amazon S3 User Guide*.
|
3149
|
+
# Returns the tags on an S3 Batch Operations job. To use the
|
3150
|
+
# `GetJobTagging` operation, you must have permission to perform the
|
3151
|
+
# `s3:GetJobTagging` action. For more information, see [Controlling
|
3152
|
+
# access and labeling jobs using tags][1] in the *Amazon S3 User Guide*.
|
2926
3153
|
#
|
2927
3154
|
#
|
2928
3155
|
#
|
@@ -2983,7 +3210,7 @@ module Aws::S3Control
|
|
2983
3210
|
# Access Points, see [Managing Multi-Region Access Points][1] in the
|
2984
3211
|
# *Amazon S3 User Guide*.
|
2985
3212
|
#
|
2986
|
-
# The following actions are related to `GetMultiRegionAccessPoint
|
3213
|
+
# The following actions are related to `GetMultiRegionAccessPoint`:
|
2987
3214
|
#
|
2988
3215
|
# * [CreateMultiRegionAccessPoint][2]
|
2989
3216
|
#
|
@@ -3041,6 +3268,7 @@ module Aws::S3Control
|
|
3041
3268
|
# resp.access_point.regions #=> Array
|
3042
3269
|
# resp.access_point.regions[0].bucket #=> String
|
3043
3270
|
# resp.access_point.regions[0].region #=> String
|
3271
|
+
# resp.access_point.regions[0].bucket_account_id #=> String
|
3044
3272
|
#
|
3045
3273
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetMultiRegionAccessPoint AWS API Documentation
|
3046
3274
|
#
|
@@ -3060,7 +3288,7 @@ module Aws::S3Control
|
|
3060
3288
|
# *Amazon S3 User Guide*.
|
3061
3289
|
#
|
3062
3290
|
# The following actions are related to
|
3063
|
-
# `GetMultiRegionAccessPointPolicy
|
3291
|
+
# `GetMultiRegionAccessPointPolicy`:
|
3064
3292
|
#
|
3065
3293
|
# * [GetMultiRegionAccessPointPolicyStatus][2]
|
3066
3294
|
#
|
@@ -3121,7 +3349,7 @@ module Aws::S3Control
|
|
3121
3349
|
# *Amazon S3 User Guide*.
|
3122
3350
|
#
|
3123
3351
|
# The following actions are related to
|
3124
|
-
# `GetMultiRegionAccessPointPolicyStatus
|
3352
|
+
# `GetMultiRegionAccessPointPolicyStatus`:
|
3125
3353
|
#
|
3126
3354
|
# * [GetMultiRegionAccessPointPolicy][2]
|
3127
3355
|
#
|
@@ -3403,12 +3631,12 @@ module Aws::S3Control
|
|
3403
3631
|
req.send_request(options)
|
3404
3632
|
end
|
3405
3633
|
|
3406
|
-
# Returns a list of the access points owned by the current
|
3407
|
-
# associated with the specified bucket. You can retrieve
|
3408
|
-
# access points per call. If the specified bucket has more
|
3409
|
-
# access points (or the number specified in `maxResults`,
|
3410
|
-
# less), the response will include a continuation token
|
3411
|
-
# to list the additional access points.
|
3634
|
+
# Returns a list of the access points that are owned by the current
|
3635
|
+
# account that's associated with the specified bucket. You can retrieve
|
3636
|
+
# up to 1000 access points per call. If the specified bucket has more
|
3637
|
+
# than 1,000 access points (or the number specified in `maxResults`,
|
3638
|
+
# whichever is less), the response will include a continuation token
|
3639
|
+
# that you can use to list the additional access points.
|
3412
3640
|
#
|
3413
3641
|
#
|
3414
3642
|
#
|
@@ -3420,7 +3648,7 @@ module Aws::S3Control
|
|
3420
3648
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
3421
3649
|
# point ARN, see the [Examples][1] section.
|
3422
3650
|
#
|
3423
|
-
# The following actions are related to `ListAccessPoints
|
3651
|
+
# The following actions are related to `ListAccessPoints`:
|
3424
3652
|
#
|
3425
3653
|
# * [CreateAccessPoint][2]
|
3426
3654
|
#
|
@@ -3450,7 +3678,7 @@ module Aws::S3Control
|
|
3450
3678
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
3451
3679
|
# in the format
|
3452
3680
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
3453
|
-
# For example, to access the bucket `reports` through
|
3681
|
+
# For example, to access the bucket `reports` through Outpost
|
3454
3682
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
3455
3683
|
# use the URL encoding of
|
3456
3684
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -3512,7 +3740,7 @@ module Aws::S3Control
|
|
3512
3740
|
# points.
|
3513
3741
|
#
|
3514
3742
|
# The following actions are related to
|
3515
|
-
# `ListAccessPointsForObjectLambda
|
3743
|
+
# `ListAccessPointsForObjectLambda`:
|
3516
3744
|
#
|
3517
3745
|
# * [CreateAccessPointForObjectLambda][1]
|
3518
3746
|
#
|
@@ -3670,7 +3898,7 @@ module Aws::S3Control
|
|
3670
3898
|
# Access Points, see [Managing Multi-Region Access Points][1] in the
|
3671
3899
|
# *Amazon S3 User Guide*.
|
3672
3900
|
#
|
3673
|
-
# The following actions are related to `ListMultiRegionAccessPoint
|
3901
|
+
# The following actions are related to `ListMultiRegionAccessPoint`:
|
3674
3902
|
#
|
3675
3903
|
# * [CreateMultiRegionAccessPoint][2]
|
3676
3904
|
#
|
@@ -3727,6 +3955,7 @@ module Aws::S3Control
|
|
3727
3955
|
# resp.access_points[0].regions #=> Array
|
3728
3956
|
# resp.access_points[0].regions[0].bucket #=> String
|
3729
3957
|
# resp.access_points[0].regions[0].region #=> String
|
3958
|
+
# resp.access_points[0].regions[0].bucket_account_id #=> String
|
3730
3959
|
# resp.next_token #=> String
|
3731
3960
|
#
|
3732
3961
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/ListMultiRegionAccessPoints AWS API Documentation
|
@@ -3858,7 +4087,7 @@ module Aws::S3Control
|
|
3858
4087
|
# Replaces configuration for an Object Lambda Access Point.
|
3859
4088
|
#
|
3860
4089
|
# The following actions are related to
|
3861
|
-
# `PutAccessPointConfigurationForObjectLambda
|
4090
|
+
# `PutAccessPointConfigurationForObjectLambda`:
|
3862
4091
|
#
|
3863
4092
|
# * [GetAccessPointConfigurationForObjectLambda][1]
|
3864
4093
|
#
|
@@ -3927,7 +4156,7 @@ module Aws::S3Control
|
|
3927
4156
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
3928
4157
|
# point ARN, see the [Examples][1] section.
|
3929
4158
|
#
|
3930
|
-
# The following actions are related to `PutAccessPointPolicy
|
4159
|
+
# The following actions are related to `PutAccessPointPolicy`:
|
3931
4160
|
#
|
3932
4161
|
# * [GetAccessPointPolicy][2]
|
3933
4162
|
#
|
@@ -3954,7 +4183,7 @@ module Aws::S3Control
|
|
3954
4183
|
# Services SDK and CLI, you must specify the ARN of the access point
|
3955
4184
|
# accessed in the format
|
3956
4185
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>`.
|
3957
|
-
# For example, to access the access point `reports-ap` through
|
4186
|
+
# For example, to access the access point `reports-ap` through Outpost
|
3958
4187
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
3959
4188
|
# use the URL encoding of
|
3960
4189
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/accesspoint/reports-ap`.
|
@@ -3993,7 +4222,7 @@ module Aws::S3Control
|
|
3993
4222
|
# in the *Amazon S3 User Guide*.
|
3994
4223
|
#
|
3995
4224
|
# The following actions are related to
|
3996
|
-
# `PutAccessPointPolicyForObjectLambda
|
4225
|
+
# `PutAccessPointPolicyForObjectLambda`:
|
3997
4226
|
#
|
3998
4227
|
# * [DeleteAccessPointPolicyForObjectLambda][2]
|
3999
4228
|
#
|
@@ -4056,7 +4285,7 @@ module Aws::S3Control
|
|
4056
4285
|
# point ARN, see the [Examples][2] section.
|
4057
4286
|
#
|
4058
4287
|
# The following actions are related to
|
4059
|
-
# `PutBucketLifecycleConfiguration
|
4288
|
+
# `PutBucketLifecycleConfiguration`:
|
4060
4289
|
#
|
4061
4290
|
# * [GetBucketLifecycleConfiguration][3]
|
4062
4291
|
#
|
@@ -4186,7 +4415,7 @@ module Aws::S3Control
|
|
4186
4415
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
4187
4416
|
# point ARN, see the [Examples][4] section.
|
4188
4417
|
#
|
4189
|
-
# The following actions are related to `PutBucketPolicy
|
4418
|
+
# The following actions are related to `PutBucketPolicy`:
|
4190
4419
|
#
|
4191
4420
|
# * [GetBucketPolicy][5]
|
4192
4421
|
#
|
@@ -4214,7 +4443,7 @@ module Aws::S3Control
|
|
4214
4443
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
4215
4444
|
# in the format
|
4216
4445
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
4217
|
-
# For example, to access the bucket `reports` through
|
4446
|
+
# For example, to access the bucket `reports` through Outpost
|
4218
4447
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
4219
4448
|
# use the URL encoding of
|
4220
4449
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -4251,6 +4480,211 @@ module Aws::S3Control
|
|
4251
4480
|
req.send_request(options)
|
4252
4481
|
end
|
4253
4482
|
|
4483
|
+
# <note markdown="1"> This action creates an Amazon S3 on Outposts bucket's replication
|
4484
|
+
# configuration. To create an S3 bucket's replication configuration,
|
4485
|
+
# see [PutBucketReplication][1] in the *Amazon S3 API Reference*.
|
4486
|
+
#
|
4487
|
+
# </note>
|
4488
|
+
#
|
4489
|
+
# Creates a replication configuration or replaces an existing one. For
|
4490
|
+
# information about S3 replication on Outposts configuration, see
|
4491
|
+
# [Replicating objects for Amazon Web Services Outposts][2] in the
|
4492
|
+
# *Amazon S3 User Guide*.
|
4493
|
+
#
|
4494
|
+
# <note markdown="1"> It can take a while to propagate `PUT` or `DELETE` requests for a
|
4495
|
+
# replication configuration to all S3 on Outposts systems. Therefore,
|
4496
|
+
# the replication configuration that's returned by a `GET` request soon
|
4497
|
+
# after a `PUT` or `DELETE` request might return a more recent result
|
4498
|
+
# than what's on the Outpost. If an Outpost is offline, the delay in
|
4499
|
+
# updating the replication configuration on that Outpost can be
|
4500
|
+
# significant.
|
4501
|
+
#
|
4502
|
+
# </note>
|
4503
|
+
#
|
4504
|
+
# Specify the replication configuration in the request body. In the
|
4505
|
+
# replication configuration, you provide the following information:
|
4506
|
+
#
|
4507
|
+
# * The name of the destination bucket or buckets where you want S3 on
|
4508
|
+
# Outposts to replicate objects
|
4509
|
+
#
|
4510
|
+
# * The Identity and Access Management (IAM) role that S3 on Outposts
|
4511
|
+
# can assume to replicate objects on your behalf
|
4512
|
+
#
|
4513
|
+
# * Other relevant information, such as replication rules
|
4514
|
+
#
|
4515
|
+
# A replication configuration must include at least one rule and can
|
4516
|
+
# contain a maximum of 100. Each rule identifies a subset of objects to
|
4517
|
+
# replicate by filtering the objects in the source Outposts bucket. To
|
4518
|
+
# choose additional subsets of objects to replicate, add a rule for each
|
4519
|
+
# subset.
|
4520
|
+
#
|
4521
|
+
# To specify a subset of the objects in the source Outposts bucket to
|
4522
|
+
# apply a replication rule to, add the `Filter` element as a child of
|
4523
|
+
# the `Rule` element. You can filter objects based on an object key
|
4524
|
+
# prefix, one or more object tags, or both. When you add the `Filter`
|
4525
|
+
# element in the configuration, you must also add the following
|
4526
|
+
# elements: `DeleteMarkerReplication`, `Status`, and `Priority`.
|
4527
|
+
#
|
4528
|
+
# Using `PutBucketReplication` on Outposts requires that both the source
|
4529
|
+
# and destination buckets must have versioning enabled. For information
|
4530
|
+
# about enabling versioning on a bucket, see [Managing S3 Versioning for
|
4531
|
+
# your S3 on Outposts bucket][3].
|
4532
|
+
#
|
4533
|
+
# For information about S3 on Outposts replication failure reasons, see
|
4534
|
+
# [Replication failure reasons][4] in the *Amazon S3 User Guide*.
|
4535
|
+
#
|
4536
|
+
# **Handling Replication of Encrypted Objects**
|
4537
|
+
#
|
4538
|
+
# Outposts buckets are encrypted at all times. All the objects in the
|
4539
|
+
# source Outposts bucket are encrypted and can be replicated. Also, all
|
4540
|
+
# the replicas in the destination Outposts bucket are encrypted with the
|
4541
|
+
# same encryption key as the objects in the source Outposts bucket.
|
4542
|
+
#
|
4543
|
+
# **Permissions**
|
4544
|
+
#
|
4545
|
+
# To create a `PutBucketReplication` request, you must have
|
4546
|
+
# `s3-outposts:PutReplicationConfiguration` permissions for the bucket.
|
4547
|
+
# The Outposts bucket owner has this permission by default and can grant
|
4548
|
+
# it to others. For more information about permissions, see [Setting up
|
4549
|
+
# IAM with S3 on Outposts][5] and [Managing access to S3 on Outposts
|
4550
|
+
# buckets][6].
|
4551
|
+
#
|
4552
|
+
# <note markdown="1"> To perform this operation, the user or role must also have the
|
4553
|
+
# [iam:PassRole][7] permission.
|
4554
|
+
#
|
4555
|
+
# </note>
|
4556
|
+
#
|
4557
|
+
# All Amazon S3 on Outposts REST API requests for this action require an
|
4558
|
+
# additional parameter of `x-amz-outpost-id` to be passed with the
|
4559
|
+
# request. In addition, you must use an S3 on Outposts endpoint hostname
|
4560
|
+
# prefix instead of `s3-control`. For an example of the request syntax
|
4561
|
+
# for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
|
4562
|
+
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
4563
|
+
# point ARN, see the [Examples][8] section.
|
4564
|
+
#
|
4565
|
+
# The following operations are related to `PutBucketReplication`:
|
4566
|
+
#
|
4567
|
+
# * [GetBucketReplication][9]
|
4568
|
+
#
|
4569
|
+
# * [DeleteBucketReplication][10]
|
4570
|
+
#
|
4571
|
+
#
|
4572
|
+
#
|
4573
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
|
4574
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/AmazonS3/latest/userguide/S3OutpostsReplication.html
|
4575
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsManagingVersioning.html
|
4576
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/outposts-replication-eventbridge.html#outposts-replication-failure-codes
|
4577
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsIAM.html
|
4578
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsBucketPolicy.html
|
4579
|
+
# [7]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html
|
4580
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html#API_control_GetBucketLifecycleConfiguration_Examples
|
4581
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketReplication.html
|
4582
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketReplication.html
|
4583
|
+
#
|
4584
|
+
# @option params [String] :account_id
|
4585
|
+
# The Amazon Web Services account ID of the Outposts bucket.
|
4586
|
+
#
|
4587
|
+
# @option params [required, String] :bucket
|
4588
|
+
# Specifies the S3 on Outposts bucket to set the configuration for.
|
4589
|
+
#
|
4590
|
+
# For using this parameter with Amazon S3 on Outposts with the REST API,
|
4591
|
+
# you must specify the name and the x-amz-outpost-id as well.
|
4592
|
+
#
|
4593
|
+
# For using this parameter with S3 on Outposts with the Amazon Web
|
4594
|
+
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
4595
|
+
# in the format
|
4596
|
+
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
4597
|
+
# For example, to access the bucket `reports` through Outpost
|
4598
|
+
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
4599
|
+
# use the URL encoding of
|
4600
|
+
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
4601
|
+
# The value must be URL encoded.
|
4602
|
+
#
|
4603
|
+
# @option params [required, Types::ReplicationConfiguration] :replication_configuration
|
4604
|
+
#
|
4605
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4606
|
+
#
|
4607
|
+
# @example Request syntax with placeholder values
|
4608
|
+
#
|
4609
|
+
# resp = client.put_bucket_replication({
|
4610
|
+
# account_id: "AccountId",
|
4611
|
+
# bucket: "BucketName", # required
|
4612
|
+
# replication_configuration: { # required
|
4613
|
+
# role: "Role", # required
|
4614
|
+
# rules: [ # required
|
4615
|
+
# {
|
4616
|
+
# id: "ID",
|
4617
|
+
# priority: 1,
|
4618
|
+
# prefix: "Prefix",
|
4619
|
+
# filter: {
|
4620
|
+
# prefix: "Prefix",
|
4621
|
+
# tag: {
|
4622
|
+
# key: "TagKeyString", # required
|
4623
|
+
# value: "TagValueString", # required
|
4624
|
+
# },
|
4625
|
+
# and: {
|
4626
|
+
# prefix: "Prefix",
|
4627
|
+
# tags: [
|
4628
|
+
# {
|
4629
|
+
# key: "TagKeyString", # required
|
4630
|
+
# value: "TagValueString", # required
|
4631
|
+
# },
|
4632
|
+
# ],
|
4633
|
+
# },
|
4634
|
+
# },
|
4635
|
+
# status: "Enabled", # required, accepts Enabled, Disabled
|
4636
|
+
# source_selection_criteria: {
|
4637
|
+
# sse_kms_encrypted_objects: {
|
4638
|
+
# status: "Enabled", # required, accepts Enabled, Disabled
|
4639
|
+
# },
|
4640
|
+
# replica_modifications: {
|
4641
|
+
# status: "Enabled", # required, accepts Enabled, Disabled
|
4642
|
+
# },
|
4643
|
+
# },
|
4644
|
+
# existing_object_replication: {
|
4645
|
+
# status: "Enabled", # required, accepts Enabled, Disabled
|
4646
|
+
# },
|
4647
|
+
# destination: { # required
|
4648
|
+
# account: "AccountId",
|
4649
|
+
# bucket: "BucketIdentifierString", # required
|
4650
|
+
# replication_time: {
|
4651
|
+
# status: "Enabled", # required, accepts Enabled, Disabled
|
4652
|
+
# time: { # required
|
4653
|
+
# minutes: 1,
|
4654
|
+
# },
|
4655
|
+
# },
|
4656
|
+
# access_control_translation: {
|
4657
|
+
# owner: "Destination", # required, accepts Destination
|
4658
|
+
# },
|
4659
|
+
# encryption_configuration: {
|
4660
|
+
# replica_kms_key_id: "ReplicaKmsKeyID",
|
4661
|
+
# },
|
4662
|
+
# metrics: {
|
4663
|
+
# status: "Enabled", # required, accepts Enabled, Disabled
|
4664
|
+
# event_threshold: {
|
4665
|
+
# minutes: 1,
|
4666
|
+
# },
|
4667
|
+
# },
|
4668
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
4669
|
+
# },
|
4670
|
+
# delete_marker_replication: {
|
4671
|
+
# status: "Enabled", # required, accepts Enabled, Disabled
|
4672
|
+
# },
|
4673
|
+
# bucket: "BucketIdentifierString", # required
|
4674
|
+
# },
|
4675
|
+
# ],
|
4676
|
+
# },
|
4677
|
+
# })
|
4678
|
+
#
|
4679
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutBucketReplication AWS API Documentation
|
4680
|
+
#
|
4681
|
+
# @overload put_bucket_replication(params = {})
|
4682
|
+
# @param [Hash] params ({})
|
4683
|
+
def put_bucket_replication(params = {}, options = {})
|
4684
|
+
req = build_request(:put_bucket_replication, params)
|
4685
|
+
req.send_request(options)
|
4686
|
+
end
|
4687
|
+
|
4254
4688
|
# <note markdown="1"> This action puts tags on an Amazon S3 on Outposts bucket. To put tags
|
4255
4689
|
# on an S3 bucket, see [PutBucketTagging][1] in the *Amazon S3 API
|
4256
4690
|
# Reference*.
|
@@ -4323,7 +4757,7 @@ module Aws::S3Control
|
|
4323
4757
|
# hostname prefix and the `x-amz-outpost-id` derived by using the access
|
4324
4758
|
# point ARN, see the [Examples][9] section.
|
4325
4759
|
#
|
4326
|
-
# The following actions are related to `PutBucketTagging
|
4760
|
+
# The following actions are related to `PutBucketTagging`:
|
4327
4761
|
#
|
4328
4762
|
# * [GetBucketTagging][10]
|
4329
4763
|
#
|
@@ -4356,7 +4790,7 @@ module Aws::S3Control
|
|
4356
4790
|
# Services SDK and CLI, you must specify the ARN of the bucket accessed
|
4357
4791
|
# in the format
|
4358
4792
|
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>`.
|
4359
|
-
# For example, to access the bucket `reports` through
|
4793
|
+
# For example, to access the bucket `reports` through Outpost
|
4360
4794
|
# `my-outpost` owned by account `123456789012` in Region `us-west-2`,
|
4361
4795
|
# use the URL encoding of
|
4362
4796
|
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports`.
|
@@ -4390,14 +4824,14 @@ module Aws::S3Control
|
|
4390
4824
|
req.send_request(options)
|
4391
4825
|
end
|
4392
4826
|
|
4393
|
-
# <note markdown="1"> This operation sets the versioning state
|
4394
|
-
#
|
4827
|
+
# <note markdown="1"> This operation sets the versioning state for S3 on Outposts buckets
|
4828
|
+
# only. To set the versioning state for an S3 bucket, see
|
4395
4829
|
# [PutBucketVersioning][1] in the *Amazon S3 API Reference*.
|
4396
4830
|
#
|
4397
4831
|
# </note>
|
4398
4832
|
#
|
4399
|
-
# Sets the versioning state for an S3 on Outposts bucket. With
|
4400
|
-
#
|
4833
|
+
# Sets the versioning state for an S3 on Outposts bucket. With S3
|
4834
|
+
# Versioning, you can save multiple distinct copies of your objects and
|
4401
4835
|
# recover from unintended user actions and application failures.
|
4402
4836
|
#
|
4403
4837
|
# You can set the versioning state to one of the following:
|
@@ -4423,7 +4857,7 @@ module Aws::S3Control
|
|
4423
4857
|
# non-versioned bucket and you want to maintain the same permanent
|
4424
4858
|
# delete behavior when you enable versioning, you must add a noncurrent
|
4425
4859
|
# expiration policy. The noncurrent expiration lifecycle policy will
|
4426
|
-
# manage the
|
4860
|
+
# manage the deletions of the noncurrent object versions in the
|
4427
4861
|
# version-enabled bucket. For more information, see [Versioning][4] in
|
4428
4862
|
# the *Amazon S3 User Guide*.
|
4429
4863
|
#
|
@@ -4533,8 +4967,8 @@ module Aws::S3Control
|
|
4533
4967
|
#
|
4534
4968
|
#
|
4535
4969
|
#
|
4536
|
-
# To use
|
4537
|
-
# `s3:PutJobTagging` action.
|
4970
|
+
# To use the `PutJobTagging` operation, you must have permission to
|
4971
|
+
# perform the `s3:PutJobTagging` action.
|
4538
4972
|
#
|
4539
4973
|
# Related actions include:
|
4540
4974
|
#
|
@@ -4598,7 +5032,7 @@ module Aws::S3Control
|
|
4598
5032
|
# *Amazon S3 User Guide*.
|
4599
5033
|
#
|
4600
5034
|
# The following actions are related to
|
4601
|
-
# `PutMultiRegionAccessPointPolicy
|
5035
|
+
# `PutMultiRegionAccessPointPolicy`:
|
4602
5036
|
#
|
4603
5037
|
# * [GetMultiRegionAccessPointPolicy][2]
|
4604
5038
|
#
|
@@ -5104,7 +5538,7 @@ module Aws::S3Control
|
|
5104
5538
|
params: params,
|
5105
5539
|
config: config)
|
5106
5540
|
context[:gem_name] = 'aws-sdk-s3control'
|
5107
|
-
context[:gem_version] = '1.
|
5541
|
+
context[:gem_version] = '1.61.0'
|
5108
5542
|
Seahorse::Client::Request.new(handlers, context)
|
5109
5543
|
end
|
5110
5544
|
|