aws-sdk-s3control 1.60.0 → 1.61.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.
@@ -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 outpost
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 outpost
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 outpost
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 outpost
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 outpost
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 outpost
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 outpost
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 this operation, you must have permission to perform the
1604
- # `s3:DeleteJobTagging` action. For more information, see [Controlling
1605
- # access and labeling jobs using tags][1] in the *Amazon S3 User Guide*.
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 outpost
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 outpost
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 outpost
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 outpost
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 outpost
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 outpost
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 only for S3 on Outposts
2848
- # buckets. To return the versioning state for an S3 bucket, see
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
- # versioning, you can save multiple distinct copies of your data and
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 this operation,
2923
- # you must have permission to perform the `s3:GetJobTagging` action. For
2924
- # more information, see [Controlling access and labeling jobs using
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 account
3407
- # associated with the specified bucket. You can retrieve up to 1000
3408
- # access points per call. If the specified bucket has more than 1,000
3409
- # access points (or the number specified in `maxResults`, whichever is
3410
- # less), the response will include a continuation token that you can use
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 outpost
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 outpost
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 outpost
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 outpost
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 only for S3 on Outposts
4394
- # buckets. To set the versioning state for an S3 bucket, see
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
- # versioning, you can save multiple distinct copies of your data and
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 deletes of the noncurrent object versions in 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 this action, you must have permission to perform the
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.60.0'
5541
+ context[:gem_version] = '1.61.0'
5108
5542
  Seahorse::Client::Request.new(handlers, context)
5109
5543
  end
5110
5544