aws-sdk-s3control 1.59.0 → 1.61.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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.59.0'
5541
+ context[:gem_version] = '1.61.0'
5108
5542
  Seahorse::Client::Request.new(handlers, context)
5109
5543
  end
5110
5544