lib/aws-sdk-s3control/client.rb in aws-sdk-s3control-1.39.0 vs lib/aws-sdk-s3control/client.rb in aws-sdk-s3control-1.40.0
- old
+ new
@@ -383,12 +383,12 @@
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessPoints.html
#
# @option params [required, String] :account_id
- # The account ID for the owner of the bucket for which you want to
- # create an access point.
+ # The Amazon Web Services account ID for the owner of the bucket for
+ # which you want to create an access point.
#
# @option params [required, String] :name
# The name you want to assign to this access point.
#
# @option params [required, String] :bucket
@@ -476,11 +476,12 @@
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointForObjectLambda.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointForObjectLambda.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessPointsForObjectLambda.html
#
# @option params [required, String] :account_id
- # The account ID for owner of the specified Object Lambda Access Point.
+ # The Amazon Web Services account ID for owner of the specified Object
+ # Lambda Access Point.
#
# @option params [required, String] :name
# The name you want to assign to this Object Lambda Access Point.
#
# @option params [required, Types::ObjectLambdaConfiguration] :configuration
@@ -713,11 +714,11 @@
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobPriority.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_JobOperation.html
#
# @option params [required, String] :account_id
- # The account ID that creates the job.
+ # The Amazon Web Services account ID that creates the job.
#
# @option params [Boolean] :confirmation_required
# Indicates whether confirmation is required before Amazon S3 runs the
# job. Confirmation is only required for jobs created through the Amazon
# S3 console.
@@ -911,10 +912,98 @@
def create_job(params = {}, options = {})
req = build_request(:create_job, params)
req.send_request(options)
end
+ # Creates a Multi-Region Access Point and associates it with the
+ # specified buckets. For more information about creating Multi-Region
+ # Access Points, see [Creating Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ # This action will always be routed to the US West (Oregon) Region. For
+ # more information about the restrictions around managing Multi-Region
+ # Access Points, see [Managing Multi-Region Access Points][2] in the
+ # *Amazon S3 User Guide*.
+ #
+ # This request is asynchronous, meaning that you might receive a
+ # response before the command has completed. When this request provides
+ # a response, it provides a token that you can use to monitor the status
+ # of the request with `DescribeMultiRegionAccessPointOperation`.
+ #
+ # The following actions are related to `CreateMultiRegionAccessPoint`\:
+ #
+ # * [DeleteMultiRegionAccessPoint][3]
+ #
+ # * [DescribeMultiRegionAccessPointOperation][4]
+ #
+ # * [GetMultiRegionAccessPoint][5]
+ #
+ # * [ListMultiRegionAccessPoints][6]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteMultiRegionAccessPoint.html
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeMultiRegionAccessPointOperation.html
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPoint.html
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListMultiRegionAccessPoints.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point. The owner of the Multi-Region Access Point also must own
+ # the underlying buckets.
+ #
+ # @option params [required, String] :client_token
+ # An idempotency token used to identify the request and guarantee that
+ # requests are unique.
+ #
+ # **A suitable default value is auto-generated.** You should normally
+ # not need to pass this option.**
+ #
+ # @option params [required, Types::CreateMultiRegionAccessPointInput] :details
+ # A container element containing details about the Multi-Region Access
+ # Point.
+ #
+ # @return [Types::CreateMultiRegionAccessPointResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::CreateMultiRegionAccessPointResult#request_token_arn #request_token_arn} => String
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.create_multi_region_access_point({
+ # account_id: "AccountId", # required
+ # client_token: "MultiRegionAccessPointClientToken", # required
+ # details: { # required
+ # name: "MultiRegionAccessPointName", # required
+ # public_access_block: {
+ # block_public_acls: false,
+ # ignore_public_acls: false,
+ # block_public_policy: false,
+ # restrict_public_buckets: false,
+ # },
+ # regions: [ # required
+ # {
+ # bucket: "BucketName", # required
+ # },
+ # ],
+ # },
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.request_token_arn #=> String
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/CreateMultiRegionAccessPoint AWS API Documentation
+ #
+ # @overload create_multi_region_access_point(params = {})
+ # @param [Hash] params ({})
+ def create_multi_region_access_point(params = {}, options = {})
+ req = build_request(:create_multi_region_access_point, params)
+ req.send_request(options)
+ end
+
# Deletes the specified access point.
#
# All Amazon S3 on Outposts REST API requests for this action require an
# additional parameter of `x-amz-outpost-id` to be passed with the
# request and an S3 on Outposts endpoint hostname prefix instead of
@@ -1278,25 +1367,26 @@
#
# </note>
#
# This implementation of the DELETE action uses the policy subresource
# to delete the policy of a specified Amazon S3 on Outposts bucket. If
- # you are using an identity other than the root user of the account that
- # owns the bucket, the calling identity must have the
- # `s3-outposts:DeleteBucketPolicy` permissions on the specified Outposts
- # bucket and belong to the bucket owner's account to use this action.
- # For more information, see [Using Amazon S3 on Outposts][2] in *Amazon
- # S3 User Guide*.
+ # you are using an identity other than the root user of the Amazon Web
+ # Services account that owns the bucket, the calling identity must have
+ # the `s3-outposts:DeleteBucketPolicy` permissions on the specified
+ # Outposts bucket and belong to the bucket owner's account to use this
+ # action. For more information, see [Using Amazon S3 on Outposts][2] in
+ # *Amazon S3 User Guide*.
#
# If you don't have `DeleteBucketPolicy` permissions, Amazon S3 returns
# a `403 Access Denied` error. If you have the correct permissions, but
# you're not using an identity that belongs to the bucket owner's
# account, Amazon S3 returns a `405 Method Not Allowed` error.
#
- # As a security precaution, the root user of the account that owns a
- # bucket can always use this action, even if the policy explicitly
- # denies the root user the ability to perform this action.
+ # As a security precaution, the root user of the Amazon Web Services
+ # account that owns a bucket can always use this action, even if the
+ # policy explicitly denies the root user the ability to perform this
+ # action.
#
# For more information about bucket policies, see [Using Bucket Policies
# and User Policies][3].
#
# All Amazon S3 on Outposts REST API requests for this action require an
@@ -1393,11 +1483,12 @@
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketTagging.html#API_control_DeleteBucketTagging_Examples
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketTagging.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketTagging.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket tag set to be removed.
+ # The Amazon Web Services account ID of the Outposts bucket tag set to
+ # be removed.
#
# @option params [required, String] :bucket
# The bucket ARN that has the tag set to be removed.
#
# For using this parameter with Amazon S3 on Outposts with the REST API,
@@ -1452,11 +1543,12 @@
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateJob.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetJobTagging.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutJobTagging.html
#
# @option params [required, String] :account_id
- # The account ID associated with the S3 Batch Operations job.
+ # The Amazon Web Services account ID associated with the S3 Batch
+ # Operations job.
#
# @option params [required, String] :job_id
# The ID for the S3 Batch Operations job whose tags you want to delete.
#
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -1475,13 +1567,88 @@
def delete_job_tagging(params = {}, options = {})
req = build_request(:delete_job_tagging, params)
req.send_request(options)
end
- # Removes the `PublicAccessBlock` configuration for an account. For more
- # information, see [ Using Amazon S3 block public access][1].
+ # Deletes a Multi-Region Access Point. This action does not delete the
+ # buckets associated with the Multi-Region Access Point, only the
+ # Multi-Region Access Point itself.
#
+ # This action will always be routed to the US West (Oregon) Region. For
+ # more information about the restrictions around managing Multi-Region
+ # Access Points, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ # This request is asynchronous, meaning that you might receive a
+ # response before the command has completed. When this request provides
+ # a response, it provides a token that you can use to monitor the status
+ # of the request with `DescribeMultiRegionAccessPointOperation`.
+ #
+ # The following actions are related to `DeleteMultiRegionAccessPoint`\:
+ #
+ # * [CreateMultiRegionAccessPoint][2]
+ #
+ # * [DescribeMultiRegionAccessPointOperation][3]
+ #
+ # * [GetMultiRegionAccessPoint][4]
+ #
+ # * [ListMultiRegionAccessPoints][5]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateMultiRegionAccessPoint.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeMultiRegionAccessPointOperation.html
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPoint.html
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListMultiRegionAccessPoints.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point.
+ #
+ # @option params [required, String] :client_token
+ # An idempotency token used to identify the request and guarantee that
+ # requests are unique.
+ #
+ # **A suitable default value is auto-generated.** You should normally
+ # not need to pass this option.**
+ #
+ # @option params [required, Types::DeleteMultiRegionAccessPointInput] :details
+ # A container element containing details about the Multi-Region Access
+ # Point.
+ #
+ # @return [Types::DeleteMultiRegionAccessPointResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::DeleteMultiRegionAccessPointResult#request_token_arn #request_token_arn} => String
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.delete_multi_region_access_point({
+ # account_id: "AccountId", # required
+ # client_token: "MultiRegionAccessPointClientToken", # required
+ # details: { # required
+ # name: "MultiRegionAccessPointName", # required
+ # },
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.request_token_arn #=> String
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DeleteMultiRegionAccessPoint AWS API Documentation
+ #
+ # @overload delete_multi_region_access_point(params = {})
+ # @param [Hash] params ({})
+ def delete_multi_region_access_point(params = {}, options = {})
+ req = build_request(:delete_multi_region_access_point, params)
+ req.send_request(options)
+ end
+
+ # Removes the `PublicAccessBlock` configuration for an Amazon Web
+ # Services account. For more information, see [ Using Amazon S3 block
+ # public access][1].
+ #
# Related actions include:
#
# * [GetPublicAccessBlock][2]
#
# * [PutPublicAccessBlock][3]
@@ -1491,12 +1658,12 @@
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetPublicAccessBlock.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutPublicAccessBlock.html
#
# @option params [required, String] :account_id
- # The account ID for the account whose `PublicAccessBlock` configuration
- # you want to remove.
+ # The account ID for the Amazon Web Services account whose
+ # `PublicAccessBlock` configuration you want to remove.
#
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
#
# @example Request syntax with placeholder values
#
@@ -1617,11 +1784,12 @@
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListJobs.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobPriority.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
#
# @option params [required, String] :account_id
- # The account ID associated with the S3 Batch Operations job.
+ # The Amazon Web Services account ID associated with the S3 Batch
+ # Operations job.
#
# @option params [required, String] :job_id
# The ID for the job whose information you want to retrieve.
#
# @return [Types::DescribeJobResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1726,10 +1894,88 @@
def describe_job(params = {}, options = {})
req = build_request(:describe_job, params)
req.send_request(options)
end
+ # Retrieves the status of an asynchronous request to manage a
+ # Multi-Region Access Point. For more information about managing
+ # Multi-Region Access Points and how asynchronous requests work, see
+ # [Managing Multi-Region Access Points][1] in the *Amazon S3 User
+ # Guide*.
+ #
+ # The following actions are related to `GetMultiRegionAccessPoint`\:
+ #
+ # * [CreateMultiRegionAccessPoint][2]
+ #
+ # * [DeleteMultiRegionAccessPoint][3]
+ #
+ # * [GetMultiRegionAccessPoint][4]
+ #
+ # * [ListMultiRegionAccessPoints][5]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateMultiRegionAccessPoint.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteMultiRegionAccessPoint.html
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPoint.html
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListMultiRegionAccessPoints.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point.
+ #
+ # @option params [required, String] :request_token_arn
+ # The request token associated with the request you want to know about.
+ # This request token is returned as part of the response when you make
+ # an asynchronous request. You provide this token to query about the
+ # status of the asynchronous action.
+ #
+ # @return [Types::DescribeMultiRegionAccessPointOperationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::DescribeMultiRegionAccessPointOperationResult#async_operation #async_operation} => Types::AsyncOperation
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.describe_multi_region_access_point_operation({
+ # account_id: "AccountId", # required
+ # request_token_arn: "AsyncRequestTokenARN", # required
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.async_operation.creation_time #=> Time
+ # resp.async_operation.operation #=> String, one of "CreateMultiRegionAccessPoint", "DeleteMultiRegionAccessPoint", "PutMultiRegionAccessPointPolicy"
+ # resp.async_operation.request_token_arn #=> String
+ # resp.async_operation.request_parameters.create_multi_region_access_point_request.name #=> String
+ # resp.async_operation.request_parameters.create_multi_region_access_point_request.public_access_block.block_public_acls #=> Boolean
+ # resp.async_operation.request_parameters.create_multi_region_access_point_request.public_access_block.ignore_public_acls #=> Boolean
+ # resp.async_operation.request_parameters.create_multi_region_access_point_request.public_access_block.block_public_policy #=> Boolean
+ # resp.async_operation.request_parameters.create_multi_region_access_point_request.public_access_block.restrict_public_buckets #=> Boolean
+ # resp.async_operation.request_parameters.create_multi_region_access_point_request.regions #=> Array
+ # resp.async_operation.request_parameters.create_multi_region_access_point_request.regions[0].bucket #=> String
+ # resp.async_operation.request_parameters.delete_multi_region_access_point_request.name #=> String
+ # resp.async_operation.request_parameters.put_multi_region_access_point_policy_request.name #=> String
+ # resp.async_operation.request_parameters.put_multi_region_access_point_policy_request.policy #=> String
+ # resp.async_operation.request_status #=> String
+ # resp.async_operation.response_details.multi_region_access_point_details.regions #=> Array
+ # resp.async_operation.response_details.multi_region_access_point_details.regions[0].name #=> String
+ # resp.async_operation.response_details.multi_region_access_point_details.regions[0].request_status #=> String
+ # resp.async_operation.response_details.error_details.code #=> String
+ # resp.async_operation.response_details.error_details.message #=> String
+ # resp.async_operation.response_details.error_details.resource #=> String
+ # resp.async_operation.response_details.error_details.request_id #=> String
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/DescribeMultiRegionAccessPointOperation AWS API Documentation
+ #
+ # @overload describe_multi_region_access_point_operation(params = {})
+ # @param [Hash] params ({})
+ def describe_multi_region_access_point_operation(params = {}, options = {})
+ req = build_request(:describe_multi_region_access_point_operation, params)
+ req.send_request(options)
+ end
+
# Returns configuration information about the specified access point.
#
#
#
# All Amazon S3 on Outposts REST API requests for this action require an
@@ -2103,16 +2349,17 @@
end
# Gets an Amazon S3 on Outposts bucket. For more information, see [
# Using Amazon S3 on Outposts][1] in the *Amazon S3 User Guide*.
#
- # If you are using an identity other than the root user of the account
- # that owns the Outposts bucket, the calling identity must have the
- # `s3-outposts:GetBucket` permissions on the specified Outposts bucket
- # and belong to the Outposts bucket owner's account in order to use
- # this action. Only users from Outposts bucket owner account with the
- # right permissions can perform actions on an Outposts bucket.
+ # If you are using an identity other than the root user of the Amazon
+ # Web Services account that owns the Outposts bucket, the calling
+ # identity must have the `s3-outposts:GetBucket` permissions on the
+ # specified Outposts bucket and belong to the Outposts bucket owner's
+ # account in order to use this action. Only users from Outposts bucket
+ # owner account with the right permissions can perform actions on an
+ # Outposts bucket.
#
# If you don't have `s3-outposts:GetBucket` permissions or you're not
# using an identity that belongs to the bucket owner's account, Amazon
# S3 returns a `403 Access Denied` error.
#
@@ -2140,11 +2387,11 @@
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucket.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [required, String] :bucket
# Specifies the bucket.
#
# For using this parameter with Amazon S3 on Outposts with the REST API,
@@ -2241,11 +2488,11 @@
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html#API_control_GetBucketLifecycleConfiguration_Examples
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketLifecycleConfiguration.html
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketLifecycleConfiguration.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [required, String] :bucket
# The Amazon Resource Name (ARN) of the bucket.
#
# For using this parameter with Amazon S3 on Outposts with the REST API,
@@ -2314,24 +2561,25 @@
#
# Returns the policy of a specified Outposts bucket. For more
# information, see [Using Amazon S3 on Outposts][2] in the *Amazon S3
# User Guide*.
#
- # If you are using an identity other than the root user of the account
- # that owns the bucket, the calling identity must have the
- # `GetBucketPolicy` permissions on the specified bucket and belong to
- # the bucket owner's account in order to use this action.
+ # If you are using an identity other than the root user of the Amazon
+ # Web Services account that owns the bucket, the calling identity must
+ # have the `GetBucketPolicy` permissions on the specified bucket and
+ # belong to the bucket owner's account in order to use this action.
#
# Only users from Outposts bucket owner account with the right
# permissions can perform actions on an Outposts bucket. If you don't
# have `s3-outposts:GetBucketPolicy` permissions or you're not using an
# identity that belongs to the bucket owner's account, Amazon S3
# returns a `403 Access Denied` error.
#
- # As a security precaution, the root user of the account that owns a
- # bucket can always use this action, even if the policy explicitly
- # denies the root user the ability to perform this action.
+ # As a security precaution, the root user of the Amazon Web Services
+ # account that owns a bucket can always use this action, even if the
+ # policy explicitly denies the root user the ability to perform this
+ # action.
#
# For more information about bucket policies, see [Using Bucket Policies
# and User Policies][3].
#
# All Amazon S3 on Outposts REST API requests for this action require an
@@ -2359,11 +2607,11 @@
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketPolicy.html
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketPolicy.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [required, String] :bucket
# Specifies the bucket.
#
# For using this parameter with Amazon S3 on Outposts with the REST API,
@@ -2446,11 +2694,11 @@
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketTagging.html#API_control_GetBucketTagging_Examples
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketTagging.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketTagging.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [required, String] :bucket
# Specifies the bucket.
#
# For using this parameter with Amazon S3 on Outposts with the REST API,
@@ -2513,11 +2761,12 @@
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateJob.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutJobTagging.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteJobTagging.html
#
# @option params [required, String] :account_id
- # The account ID associated with the S3 Batch Operations job.
+ # The Amazon Web Services account ID associated with the S3 Batch
+ # Operations job.
#
# @option params [required, String] :job_id
# The ID for the S3 Batch Operations job whose tags you want to
# retrieve.
#
@@ -2545,13 +2794,211 @@
def get_job_tagging(params = {}, options = {})
req = build_request(:get_job_tagging, params)
req.send_request(options)
end
- # Retrieves the `PublicAccessBlock` configuration for an account. For
- # more information, see [ Using Amazon S3 block public access][1].
+ # Returns configuration information about the specified Multi-Region
+ # Access Point.
#
+ # This action will always be routed to the US West (Oregon) Region. For
+ # more information about the restrictions around managing Multi-Region
+ # Access Points, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ # The following actions are related to `GetMultiRegionAccessPoint`\:
+ #
+ # * [CreateMultiRegionAccessPoint][2]
+ #
+ # * [DeleteMultiRegionAccessPoint][3]
+ #
+ # * [DescribeMultiRegionAccessPointOperation][4]
+ #
+ # * [ListMultiRegionAccessPoints][5]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateMultiRegionAccessPoint.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteMultiRegionAccessPoint.html
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeMultiRegionAccessPointOperation.html
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListMultiRegionAccessPoints.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point.
+ #
+ # @option params [required, String] :name
+ # The name of the Multi-Region Access Point whose configuration
+ # information you want to receive. The name of the Multi-Region Access
+ # Point is different from the alias. For more information about the
+ # distinction between the name and the alias of an Multi-Region Access
+ # Point, see [Managing Multi-Region Access Points][1] in the *Amazon S3
+ # User Guide*.
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html#multi-region-access-point-naming
+ #
+ # @return [Types::GetMultiRegionAccessPointResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::GetMultiRegionAccessPointResult#access_point #access_point} => Types::MultiRegionAccessPointReport
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.get_multi_region_access_point({
+ # account_id: "AccountId", # required
+ # name: "MultiRegionAccessPointName", # required
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.access_point.name #=> String
+ # resp.access_point.alias #=> String
+ # resp.access_point.created_at #=> Time
+ # resp.access_point.public_access_block.block_public_acls #=> Boolean
+ # resp.access_point.public_access_block.ignore_public_acls #=> Boolean
+ # resp.access_point.public_access_block.block_public_policy #=> Boolean
+ # resp.access_point.public_access_block.restrict_public_buckets #=> Boolean
+ # resp.access_point.status #=> String, one of "READY", "INCONSISTENT_ACROSS_REGIONS", "CREATING", "PARTIALLY_CREATED", "PARTIALLY_DELETED", "DELETING"
+ # resp.access_point.regions #=> Array
+ # resp.access_point.regions[0].bucket #=> String
+ # resp.access_point.regions[0].region #=> String
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetMultiRegionAccessPoint AWS API Documentation
+ #
+ # @overload get_multi_region_access_point(params = {})
+ # @param [Hash] params ({})
+ def get_multi_region_access_point(params = {}, options = {})
+ req = build_request(:get_multi_region_access_point, params)
+ req.send_request(options)
+ end
+
+ # Returns the access control policy of the specified Multi-Region Access
+ # Point.
+ #
+ # This action will always be routed to the US West (Oregon) Region. For
+ # more information about the restrictions around managing Multi-Region
+ # Access Points, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ # The following actions are related to
+ # `GetMultiRegionAccessPointPolicy`\:
+ #
+ # * [GetMultiRegionAccessPointPolicyStatus][2]
+ #
+ # * [PutMultiRegionAccessPointPolicy][3]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPointPolicyStatus.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutMultiRegionAccessPointPolicy.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point.
+ #
+ # @option params [required, String] :name
+ # Specifies the Multi-Region Access Point. The name of the Multi-Region
+ # Access Point is different from the alias. For more information about
+ # the distinction between the name and the alias of an Multi-Region
+ # Access Point, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html#multi-region-access-point-naming
+ #
+ # @return [Types::GetMultiRegionAccessPointPolicyResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::GetMultiRegionAccessPointPolicyResult#policy #policy} => Types::MultiRegionAccessPointPolicyDocument
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.get_multi_region_access_point_policy({
+ # account_id: "AccountId", # required
+ # name: "MultiRegionAccessPointName", # required
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.policy.established.policy #=> String
+ # resp.policy.proposed.policy #=> String
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetMultiRegionAccessPointPolicy AWS API Documentation
+ #
+ # @overload get_multi_region_access_point_policy(params = {})
+ # @param [Hash] params ({})
+ def get_multi_region_access_point_policy(params = {}, options = {})
+ req = build_request(:get_multi_region_access_point_policy, params)
+ req.send_request(options)
+ end
+
+ # Indicates whether the specified Multi-Region Access Point has an
+ # access control policy that allows public access.
+ #
+ # This action will always be routed to the US West (Oregon) Region. For
+ # more information about the restrictions around managing Multi-Region
+ # Access Points, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ # The following actions are related to
+ # `GetMultiRegionAccessPointPolicyStatus`\:
+ #
+ # * [GetMultiRegionAccessPointPolicy][2]
+ #
+ # * [PutMultiRegionAccessPointPolicy][3]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPointPolicy.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutMultiRegionAccessPointPolicy.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point.
+ #
+ # @option params [required, String] :name
+ # Specifies the Multi-Region Access Point. The name of the Multi-Region
+ # Access Point is different from the alias. For more information about
+ # the distinction between the name and the alias of an Multi-Region
+ # Access Point, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html#multi-region-access-point-naming
+ #
+ # @return [Types::GetMultiRegionAccessPointPolicyStatusResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::GetMultiRegionAccessPointPolicyStatusResult#established #established} => Types::PolicyStatus
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.get_multi_region_access_point_policy_status({
+ # account_id: "AccountId", # required
+ # name: "MultiRegionAccessPointName", # required
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.established.is_public #=> Boolean
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetMultiRegionAccessPointPolicyStatus AWS API Documentation
+ #
+ # @overload get_multi_region_access_point_policy_status(params = {})
+ # @param [Hash] params ({})
+ def get_multi_region_access_point_policy_status(params = {}, options = {})
+ req = build_request(:get_multi_region_access_point_policy_status, params)
+ req.send_request(options)
+ end
+
+ # Retrieves the `PublicAccessBlock` configuration for an Amazon Web
+ # Services account. For more information, see [ Using Amazon S3 block
+ # public access][1].
+ #
# Related actions include:
#
# * [DeletePublicAccessBlock][2]
#
# * [PutPublicAccessBlock][3]
@@ -2561,12 +3008,12 @@
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeletePublicAccessBlock.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutPublicAccessBlock.html
#
# @option params [required, String] :account_id
- # The account ID for the account whose `PublicAccessBlock` configuration
- # you want to retrieve.
+ # The account ID for the Amazon Web Services account whose
+ # `PublicAccessBlock` configuration you want to retrieve.
#
# @return [Types::GetPublicAccessBlockOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
#
# * {Types::GetPublicAccessBlockOutput#public_access_block_configuration #public_access_block_configuration} => Types::PublicAccessBlockConfiguration
#
@@ -2741,12 +3188,12 @@
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html
#
# @option params [required, String] :account_id
- # The account ID for owner of the bucket whose access points you want to
- # list.
+ # The Amazon Web Services account ID for owner of the bucket whose
+ # access points you want to list.
#
# @option params [String] :bucket
# The name of the bucket whose associated access points you want to
# list.
#
@@ -2879,13 +3326,13 @@
req = build_request(:list_access_points_for_object_lambda, params)
req.send_request(options)
end
# Lists current S3 Batch Operations jobs and jobs that have ended within
- # the last 30 days for the account making the request. For more
- # information, see [S3 Batch Operations][1] in the *Amazon S3 User
- # Guide*.
+ # the last 30 days for the Amazon Web Services account making the
+ # request. For more information, see [S3 Batch Operations][1] in the
+ # *Amazon S3 User Guide*.
#
# Related actions include:
#
#
#
@@ -2904,11 +3351,12 @@
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeJob.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobPriority.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
#
# @option params [required, String] :account_id
- # The account ID associated with the S3 Batch Operations job.
+ # The Amazon Web Services account ID associated with the S3 Batch
+ # Operations job.
#
# @option params [Array<String>] :job_statuses
# The `List Jobs` request returns jobs that match the statuses listed in
# this element.
#
@@ -2961,10 +3409,89 @@
def list_jobs(params = {}, options = {})
req = build_request(:list_jobs, params)
req.send_request(options)
end
+ # Returns a list of the Multi-Region Access Points currently associated
+ # with the specified Amazon Web Services account. Each call can return
+ # up to 100 Multi-Region Access Points, the maximum number of
+ # Multi-Region Access Points that can be associated with a single
+ # account.
+ #
+ # This action will always be routed to the US West (Oregon) Region. For
+ # more information about the restrictions around managing Multi-Region
+ # Access Points, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ # The following actions are related to `ListMultiRegionAccessPoint`\:
+ #
+ # * [CreateMultiRegionAccessPoint][2]
+ #
+ # * [DeleteMultiRegionAccessPoint][3]
+ #
+ # * [DescribeMultiRegionAccessPointOperation][4]
+ #
+ # * [GetMultiRegionAccessPoint][5]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateMultiRegionAccessPoint.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteMultiRegionAccessPoint.html
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeMultiRegionAccessPointOperation.html
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPoint.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point.
+ #
+ # @option params [String] :next_token
+ # Not currently used. Do not use this parameter.
+ #
+ # @option params [Integer] :max_results
+ # Not currently used. Do not use this parameter.
+ #
+ # @return [Types::ListMultiRegionAccessPointsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::ListMultiRegionAccessPointsResult#access_points #access_points} => Array<Types::MultiRegionAccessPointReport>
+ # * {Types::ListMultiRegionAccessPointsResult#next_token #next_token} => String
+ #
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.list_multi_region_access_points({
+ # account_id: "AccountId", # required
+ # next_token: "NonEmptyMaxLength1024String",
+ # max_results: 1,
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.access_points #=> Array
+ # resp.access_points[0].name #=> String
+ # resp.access_points[0].alias #=> String
+ # resp.access_points[0].created_at #=> Time
+ # resp.access_points[0].public_access_block.block_public_acls #=> Boolean
+ # resp.access_points[0].public_access_block.ignore_public_acls #=> Boolean
+ # resp.access_points[0].public_access_block.block_public_policy #=> Boolean
+ # resp.access_points[0].public_access_block.restrict_public_buckets #=> Boolean
+ # resp.access_points[0].status #=> String, one of "READY", "INCONSISTENT_ACROSS_REGIONS", "CREATING", "PARTIALLY_CREATED", "PARTIALLY_DELETED", "DELETING"
+ # resp.access_points[0].regions #=> Array
+ # resp.access_points[0].regions[0].bucket #=> String
+ # resp.access_points[0].regions[0].region #=> String
+ # resp.next_token #=> String
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/ListMultiRegionAccessPoints AWS API Documentation
+ #
+ # @overload list_multi_region_access_points(params = {})
+ # @param [Hash] params ({})
+ def list_multi_region_access_points(params = {}, options = {})
+ req = build_request(:list_multi_region_access_points, params)
+ req.send_request(options)
+ end
+
# Returns a list of all Outposts buckets in an Outpost that are owned by
# the authenticated sender of the request. For more information, see
# [Using Amazon S3 on Outposts][1] in the *Amazon S3 User Guide*.
#
# For an example of the request syntax for Amazon S3 on Outposts that
@@ -2975,11 +3502,11 @@
#
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListRegionalBuckets.html#API_control_ListRegionalBuckets_Examples
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [String] :next_token
#
# @option params [Integer] :max_results
#
@@ -3163,12 +3690,12 @@
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointPolicy.html#API_control_PutAccessPointPolicy_Examples
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointPolicy.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointPolicy.html
#
# @option params [required, String] :account_id
- # The account ID for owner of the bucket associated with the specified
- # access point.
+ # The Amazon Web Services account ID for owner of the bucket associated
+ # with the specified access point.
#
# @option params [required, String] :name
# The name of the access point that you want to associate with the
# specified policy.
#
@@ -3293,11 +3820,11 @@
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketLifecycleConfiguration.html#API_control_PutBucketLifecycleConfiguration_Examples
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketLifecycleConfiguration.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [required, String] :bucket
# The name of the bucket for which to set the configuration.
#
# @option params [Types::LifecycleConfiguration] :lifecycle_configuration
@@ -3377,23 +3904,25 @@
#
# Applies an Amazon S3 bucket policy to an Outposts bucket. For more
# information, see [Using Amazon S3 on Outposts][2] in the *Amazon S3
# User Guide*.
#
- # If you are using an identity other than the root user of the account
- # that owns the Outposts bucket, the calling identity must have the
- # `PutBucketPolicy` permissions on the specified Outposts bucket and
- # belong to the bucket owner's account in order to use this action.
+ # If you are using an identity other than the root user of the Amazon
+ # Web Services account that owns the Outposts bucket, the calling
+ # identity must have the `PutBucketPolicy` permissions on the specified
+ # Outposts bucket and belong to the bucket owner's account in order to
+ # use this action.
#
# If you don't have `PutBucketPolicy` permissions, Amazon S3 returns a
# `403 Access Denied` error. If you have the correct permissions, but
# you're not using an identity that belongs to the bucket owner's
# account, Amazon S3 returns a `405 Method Not Allowed` error.
#
- # As a security precaution, the root user of the account that owns a
- # bucket can always use this action, even if the policy explicitly
- # denies the root user the ability to perform this action.
+ # As a security precaution, the root user of the Amazon Web Services
+ # account that owns a bucket can always use this action, even if the
+ # policy explicitly denies the root user the ability to perform this
+ # action.
#
# For more information about bucket policies, see [Using Bucket Policies
# and User Policies][3].
#
# All Amazon S3 on Outposts REST API requests for this action require an
@@ -3418,11 +3947,11 @@
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketPolicy.html#API_control_PutBucketPolicy_Examples
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketPolicy.html
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketPolicy.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [required, String] :bucket
# Specifies the bucket.
#
# For using this parameter with Amazon S3 on Outposts with the REST API,
@@ -3477,17 +4006,18 @@
#
# Sets the tags for an S3 on Outposts bucket. For more information, see
# [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
#
# Use tags to organize your Amazon Web Services bill to reflect your own
- # cost structure. To do this, sign up to get your account bill with tag
- # key values included. Then, to see the cost of combined resources,
- # organize your billing information according to resources with the same
- # tag key values. For example, you can tag several resources with a
- # specific application name, and then organize your billing information
- # to see the total cost of that application across several services. For
- # more information, see [Cost allocation and tagging][3].
+ # cost structure. To do this, sign up to get your Amazon Web Services
+ # account bill with tag key values included. Then, to see the cost of
+ # combined resources, organize your billing information according to
+ # resources with the same tag key values. For example, you can tag
+ # several resources with a specific application name, and then organize
+ # your billing information to see the total cost of that application
+ # across several services. For more information, see [Cost allocation
+ # and tagging][3].
#
# <note markdown="1"> Within a bucket, if you add a tag that has the same key as an existing
# tag, the new value overwrites the old value. For more information, see
# [ Using cost allocation in Amazon S3 bucket tags][4].
#
@@ -3559,11 +4089,11 @@
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketTagging.html#API_control_PutBucketTagging_Examples
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketTagging.html
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteBucketTagging.html
#
# @option params [required, String] :account_id
- # The account ID of the Outposts bucket.
+ # The Amazon Web Services account ID of the Outposts bucket.
#
# @option params [required, String] :bucket
# The Amazon Resource Name (ARN) of the bucket.
#
# For using this parameter with Amazon S3 on Outposts with the REST API,
@@ -3669,11 +4199,12 @@
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteJobTagging.html
# [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateJob.html
#
# @option params [required, String] :account_id
- # The account ID associated with the S3 Batch Operations job.
+ # The Amazon Web Services account ID associated with the S3 Batch
+ # Operations job.
#
# @option params [required, String] :job_id
# The ID for the S3 Batch Operations job whose tags you want to replace.
#
# @option params [required, Array<Types::S3Tag>] :tags
@@ -3701,13 +4232,79 @@
def put_job_tagging(params = {}, options = {})
req = build_request(:put_job_tagging, params)
req.send_request(options)
end
+ # Associates an access control policy with the specified Multi-Region
+ # Access Point. Each Multi-Region Access Point can have only one policy,
+ # so a request made to this action replaces any existing policy that is
+ # associated with the specified Multi-Region Access Point.
+ #
+ # This action will always be routed to the US West (Oregon) Region. For
+ # more information about the restrictions around managing Multi-Region
+ # Access Points, see [Managing Multi-Region Access Points][1] in the
+ # *Amazon S3 User Guide*.
+ #
+ # The following actions are related to
+ # `PutMultiRegionAccessPointPolicy`\:
+ #
+ # * [GetMultiRegionAccessPointPolicy][2]
+ #
+ # * [GetMultiRegionAccessPointPolicyStatus][3]
+ #
+ #
+ #
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPointPolicy.html
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPointPolicyStatus.html
+ #
+ # @option params [required, String] :account_id
+ # The Amazon Web Services account ID for the owner of the Multi-Region
+ # Access Point.
+ #
+ # @option params [required, String] :client_token
+ # An idempotency token used to identify the request and guarantee that
+ # requests are unique.
+ #
+ # **A suitable default value is auto-generated.** You should normally
+ # not need to pass this option.**
+ #
+ # @option params [required, Types::PutMultiRegionAccessPointPolicyInput] :details
+ # A container element containing the details of the policy for the
+ # Multi-Region Access Point.
+ #
+ # @return [Types::PutMultiRegionAccessPointPolicyResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+ #
+ # * {Types::PutMultiRegionAccessPointPolicyResult#request_token_arn #request_token_arn} => String
+ #
+ # @example Request syntax with placeholder values
+ #
+ # resp = client.put_multi_region_access_point_policy({
+ # account_id: "AccountId", # required
+ # client_token: "MultiRegionAccessPointClientToken", # required
+ # details: { # required
+ # name: "MultiRegionAccessPointName", # required
+ # policy: "Policy", # required
+ # },
+ # })
+ #
+ # @example Response structure
+ #
+ # resp.request_token_arn #=> String
+ #
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutMultiRegionAccessPointPolicy AWS API Documentation
+ #
+ # @overload put_multi_region_access_point_policy(params = {})
+ # @param [Hash] params ({})
+ def put_multi_region_access_point_policy(params = {}, options = {})
+ req = build_request(:put_multi_region_access_point_policy, params)
+ req.send_request(options)
+ end
+
# Creates or modifies the `PublicAccessBlock` configuration for an
- # account. For more information, see [ Using Amazon S3 block public
- # access][1].
+ # Amazon Web Services account. For more information, see [ Using Amazon
+ # S3 block public access][1].
#
# Related actions include:
#
# * [GetPublicAccessBlock][2]
#
@@ -3719,15 +4316,15 @@
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetPublicAccessBlock.html
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeletePublicAccessBlock.html
#
# @option params [required, Types::PublicAccessBlockConfiguration] :public_access_block_configuration
# The `PublicAccessBlock` configuration that you want to apply to the
- # specified account.
+ # specified Amazon Web Services account.
#
# @option params [required, String] :account_id
- # The account ID for the account whose `PublicAccessBlock` configuration
- # you want to set.
+ # The account ID for the Amazon Web Services account whose
+ # `PublicAccessBlock` configuration you want to set.
#
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
#
# @example Request syntax with placeholder values
#
@@ -3935,11 +4532,12 @@
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListJobs.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeJob.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
#
# @option params [required, String] :account_id
- # The account ID associated with the S3 Batch Operations job.
+ # The Amazon Web Services account ID associated with the S3 Batch
+ # Operations job.
#
# @option params [required, String] :job_id
# The ID for the job whose priority you want to update.
#
# @option params [required, Integer] :priority
@@ -3996,11 +4594,12 @@
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListJobs.html
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeJob.html
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateJobStatus.html
#
# @option params [required, String] :account_id
- # The account ID associated with the S3 Batch Operations job.
+ # The Amazon Web Services account ID associated with the S3 Batch
+ # Operations job.
#
# @option params [required, String] :job_id
# The ID of the job whose status you want to update.
#
# @option params [required, String] :requested_job_status
@@ -4051,10 +4650,10 @@
operation: config.api.operation(operation_name),
client: self,
params: params,
config: config)
context[:gem_name] = 'aws-sdk-s3control'
- context[:gem_version] = '1.39.0'
+ context[:gem_version] = '1.40.0'
Seahorse::Client::Request.new(handlers, context)
end
# @api private
# @deprecated