/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.s3control; import org.w3c.dom.*; import java.net.*; import java.util.*; import javax.annotation.Generated; import org.apache.commons.logging.*; import com.amazonaws.*; import com.amazonaws.annotation.SdkInternalApi; import com.amazonaws.auth.*; import com.amazonaws.handlers.*; import com.amazonaws.http.*; import com.amazonaws.internal.*; import com.amazonaws.internal.auth.*; import com.amazonaws.metrics.*; import com.amazonaws.regions.*; import com.amazonaws.transform.*; import com.amazonaws.util.*; import com.amazonaws.protocol.json.*; import com.amazonaws.util.AWSRequestMetrics.Field; import com.amazonaws.annotation.ThreadSafe; import com.amazonaws.client.AwsSyncClientParams; import com.amazonaws.client.builder.AdvancedConfig; import com.amazonaws.services.s3control.AWSS3ControlClientBuilder; import com.amazonaws.AmazonServiceException; import com.amazonaws.services.s3control.model.*; import com.amazonaws.services.s3control.model.transform.*; import com.amazonaws.arn.Arn; import com.amazonaws.arn.AwsResource; import static com.amazonaws.services.s3control.S3ControlHandlerContextKey.S3_ARNABLE_FIELD; /** * Client for accessing AWS S3 Control. All service calls made using this client are blocking, and will not return until * the service call completes. *
*
* Amazon Web Services S3 Control provides access to Amazon S3 control plane actions. *
*/ @ThreadSafe @Generated("com.amazonaws:aws-java-sdk-code-generator") public class AWSS3ControlClient extends AmazonWebServiceClient implements AWSS3Control { /** Provider for AWS credentials. */ private final AWSCredentialsProvider awsCredentialsProvider; private static final Log log = LogFactory.getLog(AWSS3Control.class); /** Default signing name for the service. */ private static final String DEFAULT_SIGNING_NAME = "s3"; /** Client configuration factory providing ClientConfigurations tailored to this client */ protected static final ClientConfigurationFactory configFactory = new ClientConfigurationFactory(); private final AdvancedConfig advancedConfig; /** * Map of exception unmarshallers for all modeled exceptions */ private final Map* All service calls made using this new client object are blocking, and will not return until the service call * completes. * * @param clientParams * Object providing client parameters. */ AWSS3ControlClient(AwsSyncClientParams clientParams) { this(clientParams, false); } /** * Constructs a new client to invoke service methods on AWS S3 Control using the specified parameters. * *
* All service calls made using this new client object are blocking, and will not return until the service call * completes. * * @param clientParams * Object providing client parameters. */ AWSS3ControlClient(AwsSyncClientParams clientParams, boolean endpointDiscoveryEnabled) { super(clientParams); this.awsCredentialsProvider = clientParams.getCredentialsProvider(); this.advancedConfig = clientParams.getAdvancedConfig(); init(); } private void init() { if (exceptionUnmarshallersMap.get("InvalidRequestException") == null) { exceptionUnmarshallersMap.put("InvalidRequestException", new InvalidRequestExceptionUnmarshaller()); } exceptionUnmarshallers.add(new InvalidRequestExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("InvalidNextTokenException") == null) { exceptionUnmarshallersMap.put("InvalidNextTokenException", new InvalidNextTokenExceptionUnmarshaller()); } exceptionUnmarshallers.add(new InvalidNextTokenExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("JobStatusException") == null) { exceptionUnmarshallersMap.put("JobStatusException", new JobStatusExceptionUnmarshaller()); } exceptionUnmarshallers.add(new JobStatusExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("NoSuchPublicAccessBlockConfiguration") == null) { exceptionUnmarshallersMap.put("NoSuchPublicAccessBlockConfiguration", new NoSuchPublicAccessBlockConfigurationExceptionUnmarshaller()); } exceptionUnmarshallers.add(new NoSuchPublicAccessBlockConfigurationExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("InternalServiceException") == null) { exceptionUnmarshallersMap.put("InternalServiceException", new InternalServiceExceptionUnmarshaller()); } exceptionUnmarshallers.add(new InternalServiceExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("BucketAlreadyExists") == null) { exceptionUnmarshallersMap.put("BucketAlreadyExists", new BucketAlreadyExistsExceptionUnmarshaller()); } exceptionUnmarshallers.add(new BucketAlreadyExistsExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("NotFoundException") == null) { exceptionUnmarshallersMap.put("NotFoundException", new NotFoundExceptionUnmarshaller()); } exceptionUnmarshallers.add(new NotFoundExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("TooManyTagsException") == null) { exceptionUnmarshallersMap.put("TooManyTagsException", new TooManyTagsExceptionUnmarshaller()); } exceptionUnmarshallers.add(new TooManyTagsExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("IdempotencyException") == null) { exceptionUnmarshallersMap.put("IdempotencyException", new IdempotencyExceptionUnmarshaller()); } exceptionUnmarshallers.add(new IdempotencyExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("BucketAlreadyOwnedByYou") == null) { exceptionUnmarshallersMap.put("BucketAlreadyOwnedByYou", new BucketAlreadyOwnedByYouExceptionUnmarshaller()); } exceptionUnmarshallers.add(new BucketAlreadyOwnedByYouExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("TooManyRequestsException") == null) { exceptionUnmarshallersMap.put("TooManyRequestsException", new TooManyRequestsExceptionUnmarshaller()); } exceptionUnmarshallers.add(new TooManyRequestsExceptionUnmarshaller()); if (exceptionUnmarshallersMap.get("BadRequestException") == null) { exceptionUnmarshallersMap.put("BadRequestException", new BadRequestExceptionUnmarshaller()); } exceptionUnmarshallers.add(new BadRequestExceptionUnmarshaller()); defaultUnmarshaller = new StandardErrorUnmarshaller(com.amazonaws.services.s3control.model.AWSS3ControlException.class); exceptionUnmarshallers.add(new StandardErrorUnmarshaller(com.amazonaws.services.s3control.model.AWSS3ControlException.class)); setServiceNameIntern(DEFAULT_SIGNING_NAME); setEndpointPrefix(ENDPOINT_PREFIX); // calling this.setEndPoint(...) will also modify the signer accordingly this.setEndpoint("s3-control.us-east-1.amazonaws.com"); HandlerChainFactory chainFactory = new HandlerChainFactory(); requestHandler2s.addAll(chainFactory.newRequestHandlerChain("/com/amazonaws/services/s3control/request.handlers")); requestHandler2s.addAll(chainFactory.newRequestHandler2Chain("/com/amazonaws/services/s3control/request.handler2s")); requestHandler2s.addAll(chainFactory.getGlobalHandlers()); } /** *
* Creates an access point and associates it with the specified bucket. For more information, see Managing Data Access with Amazon * S3 Access Points in the Amazon S3 User Guide. *
* ** S3 on Outposts only supports VPC-style access points. *
** For more information, see * Accessing Amazon S3 on Outposts using virtual private cloud (VPC) only access points in the Amazon S3 User * Guide. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to CreateAccessPoint
:
*
* GetAccessPoint *
** ListAccessPoints *
** Creates an Object Lambda Access Point. For more information, see Transforming objects with * Object Lambda Access Points in the Amazon S3 User Guide. *
*
* The following actions are related to CreateAccessPointForObjectLambda
:
*
* This action creates an Amazon S3 on Outposts bucket. To create an S3 bucket, see Create Bucket in the Amazon * S3 API Reference. *
** Creates a new Outposts bucket. By creating the bucket, you become the bucket owner. To create an Outposts bucket, * you must have S3 on Outposts. For more information, see Using Amazon S3 on Outposts in * Amazon S3 User Guide. *
** Not every string is an acceptable bucket name. For information on bucket naming restrictions, see Working * with Amazon S3 Buckets. *
** S3 on Outposts buckets support: *
** Tags *
** LifecycleConfigurations for deleting expired objects *
** For a complete list of restrictions and Amazon S3 feature limitations on S3 on Outposts, see Amazon S3 * on Outposts Restrictions and Limitations. *
*
* For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname
* prefix and x-amz-outpost-id
in your API request, see the Examples section.
*
* The following actions are related to CreateBucket
for Amazon S3 on Outposts:
*
* PutObject *
** GetBucket *
** DeleteBucket *
** You can use S3 Batch Operations to perform large-scale batch actions on Amazon S3 objects. Batch Operations can * run a single action on lists of Amazon S3 objects that you specify. For more information, see S3 Batch Operations in the * Amazon S3 User Guide. *
** This action creates a S3 Batch Operations job. *
* ** Related actions include: *
** DescribeJob *
** ListJobs *
** UpdateJobStatus *
** JobOperation *
** 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 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 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
:
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to DeleteAccessPoint
:
*
* GetAccessPoint *
** ListAccessPoints *
** Deletes the specified Object Lambda Access Point. *
*
* The following actions are related to DeleteAccessPointForObjectLambda
:
*
* Deletes the access point policy for 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to DeleteAccessPointPolicy
:
*
* Removes the resource policy for an Object Lambda Access Point. *
*
* The following actions are related to DeleteAccessPointPolicyForObjectLambda
:
*
* This action deletes an Amazon S3 on Outposts bucket. To delete an S3 bucket, see DeleteBucket in the Amazon S3 * API Reference. *
** Deletes the Amazon S3 on Outposts bucket. All objects (including all object versions and delete markers) in the * bucket must be deleted before the bucket itself can be deleted. For more information, see Using Amazon S3 on Outposts in * Amazon S3 User Guide. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* Related Resources *
** CreateBucket *
** GetBucket *
** DeleteObject *
** This action deletes an Amazon S3 on Outposts bucket's lifecycle configuration. To delete an S3 bucket's lifecycle * configuration, see DeleteBucketLifecycle * in the Amazon S3 API Reference. *
** Deletes the lifecycle configuration from the specified Outposts bucket. Amazon S3 on Outposts removes all the * lifecycle configuration rules in the lifecycle subresource associated with the bucket. Your objects never expire, * and Amazon S3 on Outposts no longer automatically deletes any objects on the basis of rules contained in the * deleted lifecycle configuration. For more information, see Using Amazon S3 on Outposts in * Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3-outposts:DeleteLifecycleConfiguration
* action. By default, the bucket owner has this permission and the Outposts bucket owner can grant this permission
* to others.
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* For more information about object expiration, see Elements to Describe Lifecycle Actions. *
** Related actions include: *
** This action deletes an Amazon S3 on Outposts bucket policy. To delete an S3 bucket policy, see DeleteBucketPolicy in the * Amazon S3 API Reference. *
*
* 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 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 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 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. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to DeleteBucketPolicy
:
*
* GetBucketPolicy *
** PutBucketPolicy *
** This operation deletes an Amazon S3 on Outposts bucket's replication configuration. To delete an S3 bucket's * replication configuration, see DeleteBucketReplication in the Amazon S3 API Reference. *
** Deletes the replication configuration from the specified S3 on Outposts bucket. *
*
* To use this operation, you must have permissions to perform the
* s3-outposts:PutReplicationConfiguration
action. The Outposts bucket owner has this permission by
* default and can grant it to others. For more information about permissions, see Setting up IAM with S3 on
* Outposts and Managing access to S3 on
* Outposts buckets in the Amazon S3 User Guide.
*
* It can take a while to propagate PUT
or DELETE
requests for a replication configuration
* to all S3 on Outposts systems. Therefore, the replication configuration that's returned by a GET
* request soon after a PUT
or DELETE
request might return a more recent result than
* what's on the Outpost. If an Outpost is offline, the delay in updating the replication configuration on that
* Outpost can be significant.
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* For information about S3 replication on Outposts configuration, see Replicating objects for * S3 on Outposts in the Amazon S3 User Guide. *
*
* The following operations are related to DeleteBucketReplication
:
*
* This action deletes an Amazon S3 on Outposts bucket's tags. To delete an S3 bucket tags, see DeleteBucketTagging in * the Amazon S3 API Reference. *
** Deletes the tags from the Outposts bucket. For more information, see Using Amazon S3 on Outposts in * Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the PutBucketTagging
action. By default, the
* bucket owner has this permission and can grant this permission to others.
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to DeleteBucketTagging
:
*
* GetBucketTagging *
** PutBucketTagging *
*
* Removes the entire tag set from the specified S3 Batch Operations job. To use the DeleteJobTagging
* operation, you must have permission to perform the s3:DeleteJobTagging
action. For more information,
* see
* Controlling access and labeling jobs using tags in the Amazon S3 User Guide.
*
* Related actions include: *
** CreateJob *
** GetJobTagging *
** PutJobTagging *
** 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 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
:
*
* Removes the PublicAccessBlock
configuration for an Amazon Web Services account. For more
* information, see Using Amazon S3
* block public access.
*
* Related actions include: *
** Deletes the Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see Assessing your storage activity and * usage with Amazon S3 Storage Lens in the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3:DeleteStorageLensConfiguration
* action. For more information, see Setting permissions to
* use Amazon S3 Storage Lens in the Amazon S3 User Guide.
*
* Deletes the Amazon S3 Storage Lens configuration tags. For more information about S3 Storage Lens, see Assessing your storage activity and * usage with Amazon S3 Storage Lens in the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3:DeleteStorageLensConfigurationTagging
* action. For more information, see Setting permissions to
* use Amazon S3 Storage Lens in the Amazon S3 User Guide.
*
* Retrieves the configuration parameters and status for a Batch Operations job. For more information, see S3 Batch Operations in the * Amazon S3 User Guide. *
* ** Related actions include: *
** CreateJob *
** ListJobs *
** UpdateJobStatus *
** 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 in the Amazon S3 User Guide. *
*
* The following actions are related to GetMultiRegionAccessPoint
:
*
* Returns configuration information about 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to GetAccessPoint
:
*
* ListAccessPoints *
** Returns configuration for an Object Lambda Access Point. *
*
* The following actions are related to GetAccessPointConfigurationForObjectLambda
:
*
* Returns configuration information about the specified Object Lambda Access Point *
*
* The following actions are related to GetAccessPointForObjectLambda
:
*
* Returns the access point policy associated with the specified access point. *
*
* The following actions are related to GetAccessPointPolicy
:
*
* Returns the resource policy for an Object Lambda Access Point. *
*
* The following actions are related to GetAccessPointPolicyForObjectLambda
:
*
* Indicates whether the specified access point currently has a policy that allows public access. For more * information about public access through access points, see Managing Data Access with Amazon * S3 access points in the Amazon S3 User Guide. *
* * @param getAccessPointPolicyStatusRequest * @return Result of the GetAccessPointPolicyStatus operation returned by the service. * @sample AWSS3Control.GetAccessPointPolicyStatus * @see AWS API Documentation */ @Override public GetAccessPointPolicyStatusResult getAccessPointPolicyStatus(GetAccessPointPolicyStatusRequest request) { request = beforeClientExecution(request); return executeGetAccessPointPolicyStatus(request); } @SdkInternalApi final GetAccessPointPolicyStatusResult executeGetAccessPointPolicyStatus(GetAccessPointPolicyStatusRequest getAccessPointPolicyStatusRequest) { ExecutionContext executionContext = createExecutionContext(getAccessPointPolicyStatusRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns the status of the resource policy associated with an Object Lambda Access Point. *
* * @param getAccessPointPolicyStatusForObjectLambdaRequest * @return Result of the GetAccessPointPolicyStatusForObjectLambda operation returned by the service. * @sample AWSS3Control.GetAccessPointPolicyStatusForObjectLambda * @see AWS API Documentation */ @Override public GetAccessPointPolicyStatusForObjectLambdaResult getAccessPointPolicyStatusForObjectLambda(GetAccessPointPolicyStatusForObjectLambdaRequest request) { request = beforeClientExecution(request); return executeGetAccessPointPolicyStatusForObjectLambda(request); } @SdkInternalApi final GetAccessPointPolicyStatusForObjectLambdaResult executeGetAccessPointPolicyStatusForObjectLambda( GetAccessPointPolicyStatusForObjectLambdaRequest getAccessPointPolicyStatusForObjectLambdaRequest) { ExecutionContext executionContext = createExecutionContext(getAccessPointPolicyStatusForObjectLambdaRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Gets an Amazon S3 on Outposts bucket. For more information, see Using Amazon S3 on Outposts * in the Amazon S3 User Guide. *
*
* 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.
*
* The following actions are related to GetBucket
for Amazon S3 on Outposts:
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* PutObject *
** CreateBucket *
** DeleteBucket *
** This action gets an Amazon S3 on Outposts bucket's lifecycle configuration. To get an S3 bucket's lifecycle * configuration, see GetBucketLifecycleConfiguration in the Amazon S3 API Reference. *
** Returns the lifecycle configuration information set on the Outposts bucket. For more information, see Using Amazon S3 on Outposts * and for information about lifecycle configuration, see Object Lifecycle * Management in Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3-outposts:GetLifecycleConfiguration
* action. The Outposts bucket owner has this permission, by default. The bucket owner can grant this permission to
* others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions
* to Your Amazon S3 Resources.
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* GetBucketLifecycleConfiguration
has the following special error:
*
* Error code: NoSuchLifecycleConfiguration
*
* Description: The lifecycle configuration does not exist. *
** HTTP Status Code: 404 Not Found *
** SOAP Fault Code Prefix: Client *
*
* The following actions are related to GetBucketLifecycleConfiguration
:
*
* This action gets a bucket policy for an Amazon S3 on Outposts bucket. To get a policy for an S3 bucket, see GetBucketPolicy in the * Amazon S3 API Reference. *
** Returns the policy of a specified Outposts bucket. For more information, see Using Amazon S3 on Outposts in * the Amazon S3 User Guide. *
*
* 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 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. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to GetBucketPolicy
:
*
* GetObject *
** PutBucketPolicy *
** This operation gets an Amazon S3 on Outposts bucket's replication configuration. To get an S3 bucket's * replication configuration, see GetBucketReplication in * the Amazon S3 API Reference. *
** Returns the replication configuration of an S3 on Outposts bucket. For more information about S3 on Outposts, see * Using Amazon S3 on Outposts * in the Amazon S3 User Guide. For information about S3 replication on Outposts configuration, see Replicating objects for * S3 on Outposts in the Amazon S3 User Guide. *
*
* It can take a while to propagate PUT
or DELETE
requests for a replication configuration
* to all S3 on Outposts systems. Therefore, the replication configuration that's returned by a GET
* request soon after a PUT
or DELETE
request might return a more recent result than
* what's on the Outpost. If an Outpost is offline, the delay in updating the replication configuration on that
* Outpost can be significant.
*
* This action requires permissions for the s3-outposts:GetReplicationConfiguration
action. The
* Outposts bucket owner has this permission by default and can grant it to others. For more information about
* permissions, see Setting up
* IAM with S3 on Outposts and Managing access to S3 on
* Outposts bucket in the Amazon S3 User Guide.
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* If you include the Filter
element in a replication configuration, you must also include the
* DeleteMarkerReplication
, Status
, and Priority
elements. The response also
* returns those elements.
*
* For information about S3 on Outposts replication failure reasons, see Replication failure reasons in the Amazon S3 User Guide. *
*
* The following operations are related to GetBucketReplication
:
*
* This action gets an Amazon S3 on Outposts bucket's tags. To get an S3 bucket tags, see GetBucketTagging in the * Amazon S3 API Reference. *
** Returns the tag set associated with the Outposts bucket. For more information, see Using Amazon S3 on Outposts in * the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the GetBucketTagging
action. By default, the
* bucket owner has this permission and can grant this permission to others.
*
* GetBucketTagging
has the following special error:
*
* Error code: NoSuchTagSetError
*
* Description: There is no tag set associated with the bucket. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to GetBucketTagging
:
*
* PutBucketTagging *
** This operation returns the versioning state for S3 on Outposts buckets only. To return the versioning state for * an S3 bucket, see GetBucketVersioning in * the Amazon S3 API Reference. *
** Returns the versioning state for an S3 on Outposts bucket. With S3 Versioning, you can save multiple distinct * copies of your objects and recover from unintended user actions and application failures. *
*
* If you've never set versioning on your bucket, it has no versioning state. In that case, the
* GetBucketVersioning
request does not return a versioning state value.
*
* For more information about versioning, see Versioning in the Amazon S3 * User Guide. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following operations are related to GetBucketVersioning
for S3 on Outposts.
*
* Returns the tags on an S3 Batch Operations job. To use the GetJobTagging
operation, you must have
* permission to perform the s3:GetJobTagging
action. For more information, see Controlling access and labeling jobs using tags in the Amazon S3 User Guide.
*
* Related actions include: *
** CreateJob *
** PutJobTagging *
** DeleteJobTagging *
** 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 in the Amazon S3 User Guide. *
*
* The following actions are related to GetMultiRegionAccessPoint
:
*
* 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 in the Amazon S3 User Guide. *
*
* The following actions are related to GetMultiRegionAccessPointPolicy
:
*
* 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 in the Amazon S3 User Guide. *
*
* The following actions are related to GetMultiRegionAccessPointPolicyStatus
:
*
* Returns the routing configuration for a Multi-Region Access Point, indicating which Regions are active or * passive. *
** To obtain routing control changes and failover requests, use the Amazon S3 failover control infrastructure * endpoints in these five Amazon Web Services Regions: *
*
* us-east-1
*
* us-west-2
*
* ap-southeast-2
*
* ap-northeast-1
*
* eu-west-1
*
* Your Amazon S3 bucket does not need to be in these five Regions. *
*
* Retrieves the PublicAccessBlock
configuration for an Amazon Web Services account. For more
* information, see Using Amazon S3
* block public access.
*
* Related actions include: *
*GetPublicAccessBlock
request against an
* account that doesn't have a PublicAccessBlockConfiguration
set.
* @sample AWSS3Control.GetPublicAccessBlock
* @see AWS
* API Documentation
*/
@Override
public GetPublicAccessBlockResult getPublicAccessBlock(GetPublicAccessBlockRequest request) {
request = beforeClientExecution(request);
return executeGetPublicAccessBlock(request);
}
@SdkInternalApi
final GetPublicAccessBlockResult executeGetPublicAccessBlock(GetPublicAccessBlockRequest getPublicAccessBlockRequest) {
ExecutionContext executionContext = createExecutionContext(getPublicAccessBlockRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request* Gets the Amazon S3 Storage Lens configuration. For more information, see Assessing your storage activity and * usage with Amazon S3 Storage Lens in the Amazon S3 User Guide. For a complete list of S3 Storage Lens * metrics, see S3 Storage Lens * metrics glossary in the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3:GetStorageLensConfiguration
action.
* For more information, see Setting permissions to
* use Amazon S3 Storage Lens in the Amazon S3 User Guide.
*
* Gets the tags of Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see Assessing your storage activity and * usage with Amazon S3 Storage Lens in the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3:GetStorageLensConfigurationTagging
* action. For more information, see Setting permissions to
* use Amazon S3 Storage Lens in the Amazon S3 User Guide.
*
* Returns a list of the access points that are owned by the current account that's associated with the specified
* bucket. You can retrieve up to 1000 access points per call. If the specified bucket has more than 1,000 access
* points (or the number specified in maxResults
, whichever is less), the response will include a
* continuation token that you can use to list the additional access points.
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to ListAccessPoints
:
*
* GetAccessPoint *
** Returns some or all (up to 1,000) access points associated with the Object Lambda Access Point per call. If there * are more access points than what can be returned in one call, the response will include a continuation token that * you can use to list the additional access points. *
*
* The following actions are related to ListAccessPointsForObjectLambda
:
*
* Lists current S3 Batch Operations jobs and jobs that have ended within the last 30 days for the Amazon Web * Services account making the request. For more information, see S3 Batch Operations in the * Amazon S3 User Guide. *
** Related actions include: *
* ** CreateJob *
** DescribeJob *
** UpdateJobStatus *
** 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 in the Amazon S3 User Guide. *
*
* The following actions are related to ListMultiRegionAccessPoint
:
*
* 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 in the Amazon S3 User Guide. *
*
* For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname
* prefix and x-amz-outpost-id
in your request, see the Examples section.
*
* Gets a list of Amazon S3 Storage Lens configurations. For more information about S3 Storage Lens, see Assessing your storage activity and * usage with Amazon S3 Storage Lens in the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3:ListStorageLensConfigurations
action.
* For more information, see Setting permissions to
* use Amazon S3 Storage Lens in the Amazon S3 User Guide.
*
* Replaces configuration for an Object Lambda Access Point. *
*
* The following actions are related to PutAccessPointConfigurationForObjectLambda
:
*
* Associates an access policy with the specified access point. Each access point can have only one policy, so a * request made to this API replaces any existing policy associated with 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to PutAccessPointPolicy
:
*
* Creates or replaces resource policy for an Object Lambda Access Point. For an example policy, see Creating Object * Lambda Access Points in the Amazon S3 User Guide. *
*
* The following actions are related to PutAccessPointPolicyForObjectLambda
:
*
* This action puts a lifecycle configuration to an Amazon S3 on Outposts bucket. To put a lifecycle configuration * to an S3 bucket, see PutBucketLifecycleConfiguration in the Amazon S3 API Reference. *
** Creates a new lifecycle configuration for the S3 on Outposts bucket or replaces an existing lifecycle * configuration. Outposts buckets only support lifecycle configurations that delete/expire objects after a certain * period of time and abort incomplete multipart uploads. *
* *
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to PutBucketLifecycleConfiguration
:
*
* This action puts a bucket policy to an Amazon S3 on Outposts bucket. To put a policy on an S3 bucket, see PutBucketPolicy in the * Amazon S3 API Reference. *
** Applies an Amazon S3 bucket policy to an Outposts bucket. For more information, see Using Amazon S3 on Outposts in * the Amazon S3 User Guide. *
*
* 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 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. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to PutBucketPolicy
:
*
* GetBucketPolicy *
** This action creates an Amazon S3 on Outposts bucket's replication configuration. To create an S3 bucket's * replication configuration, see PutBucketReplication in * the Amazon S3 API Reference. *
** Creates a replication configuration or replaces an existing one. For information about S3 replication on Outposts * configuration, see Replicating objects for * S3 on Outposts in the Amazon S3 User Guide. *
*
* It can take a while to propagate PUT
or DELETE
requests for a replication configuration
* to all S3 on Outposts systems. Therefore, the replication configuration that's returned by a GET
* request soon after a PUT
or DELETE
request might return a more recent result than
* what's on the Outpost. If an Outpost is offline, the delay in updating the replication configuration on that
* Outpost can be significant.
*
* Specify the replication configuration in the request body. In the replication configuration, you provide the * following information: *
** The name of the destination bucket or buckets where you want S3 on Outposts to replicate objects *
** The Identity and Access Management (IAM) role that S3 on Outposts can assume to replicate objects on your behalf *
** Other relevant information, such as replication rules *
** A replication configuration must include at least one rule and can contain a maximum of 100. Each rule identifies * a subset of objects to replicate by filtering the objects in the source Outposts bucket. To choose additional * subsets of objects to replicate, add a rule for each subset. *
*
* To specify a subset of the objects in the source Outposts bucket to apply a replication rule to, add the
* Filter
element as a child of the Rule
element. You can filter objects based on an
* object key prefix, one or more object tags, or both. When you add the Filter
element in the
* configuration, you must also add the following elements: DeleteMarkerReplication
,
* Status
, and Priority
.
*
* Using PutBucketReplication
on Outposts requires that both the source and destination buckets must
* have versioning enabled. For information about enabling versioning on a bucket, see Managing S3
* Versioning for your S3 on Outposts bucket.
*
* For information about S3 on Outposts replication failure reasons, see Replication failure reasons in the Amazon S3 User Guide. *
** Handling Replication of Encrypted Objects *
** Outposts buckets are encrypted at all times. All the objects in the source Outposts bucket are encrypted and can * be replicated. Also, all the replicas in the destination Outposts bucket are encrypted with the same encryption * key as the objects in the source Outposts bucket. *
** Permissions *
*
* To create a PutBucketReplication
request, you must have
* s3-outposts:PutReplicationConfiguration
permissions for the bucket. The Outposts bucket owner has
* this permission by default and can grant it to others. For more information about permissions, see Setting up IAM with S3 on
* Outposts and Managing access to S3 on
* Outposts buckets.
*
* To perform this operation, the user or role must also have the iam:CreateRole
and
* iam:PassRole
permissions. For more information, see Granting a user permissions to
* pass a role to an Amazon Web Services service.
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following operations are related to PutBucketReplication
:
*
* This action puts tags on an Amazon S3 on Outposts bucket. To put tags on an S3 bucket, see PutBucketTagging in the * Amazon S3 API Reference. *
** Sets the tags for an S3 on Outposts bucket. For more information, see Using Amazon S3 on Outposts 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 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. *
** 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. *
*
* To use this action, you must have permissions to perform the s3-outposts:PutBucketTagging
action.
* The Outposts bucket owner has this permission by default and can grant this permission to others. For more
* information about permissions, see Permissions Related to Bucket Subresource Operations and Managing access permissions
* to your Amazon S3 resources.
*
* PutBucketTagging
has the following special errors:
*
* Error code: InvalidTagError
*
* Description: The tag provided was not a valid tag. This error can occur if the tag did not pass input validation. * For information about tag restrictions, see * User-Defined Tag Restrictions and Amazon Web * Services-Generated Cost Allocation Tag Restrictions. *
*
* Error code: MalformedXMLError
*
* Description: The XML provided does not match the schema. *
*
* Error code: OperationAbortedError
*
* Description: A conflicting conditional action is currently in progress against this resource. Try again. *
*
* Error code: InternalError
*
* Description: The service was unable to apply the provided tag to the bucket. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following actions are related to PutBucketTagging
:
*
* GetBucketTagging *
** This operation sets the versioning state for S3 on Outposts buckets only. To set the versioning state for an S3 * bucket, see PutBucketVersioning in * the Amazon S3 API Reference. *
** Sets the versioning state for an S3 on Outposts bucket. With S3 Versioning, you can save multiple distinct copies * of your objects and recover from unintended user actions and application failures. *
** You can set the versioning state to one of the following: *
** Enabled - Enables versioning for the objects in the bucket. All objects added to the bucket receive a * unique version ID. *
*
* Suspended - Suspends versioning for the objects in the bucket. All objects added to the bucket receive the
* version ID null
.
*
* If you've never set versioning on your bucket, it has no versioning state. In that case, a * GetBucketVersioning request does not return a versioning state value. *
** When you enable S3 Versioning, for each object in your bucket, you have a current version and zero or more * noncurrent versions. You can configure your bucket S3 Lifecycle rules to expire noncurrent versions after a * specified time period. For more information, see Creating and * managing a lifecycle configuration for your S3 on Outposts bucket in the Amazon S3 User Guide. *
** If you have an object expiration lifecycle configuration in your non-versioned bucket and you want to maintain * the same permanent delete behavior when you enable versioning, you must add a noncurrent expiration policy. The * noncurrent expiration lifecycle configuration will manage the deletes of the noncurrent object versions in the * version-enabled bucket. For more information, see Versioning in the Amazon S3 * User Guide. *
*
* 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. In addition, you must use an S3 on Outposts endpoint
* hostname prefix instead of s3-control
. For an example of the request syntax for Amazon S3 on
* Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived by
* using the access point ARN, see the Examples section.
*
* The following operations are related to PutBucketVersioning
for S3 on Outposts.
*
* Sets the supplied tag-set on an S3 Batch Operations job. *
** A tag is a key-value pair. You can associate S3 Batch Operations tags with any job by sending a PUT request * against the tagging subresource that is associated with the job. To modify the existing tag set, you can either * replace the existing tag set entirely, or make changes within the existing tag set by retrieving the existing tag * set using GetJobTagging, modify * that tag set, and use this action to replace the tag set with the one you modified. For more information, see Controlling * access and labeling jobs using tags in the Amazon S3 User Guide. *
* ** If you send this request with an empty tag set, Amazon S3 deletes the existing tag set on the Batch Operations * job. If you use this method, you are charged for a Tier 1 Request (PUT). For more information, see Amazon S3 pricing. *
** For deleting existing tags for your Batch Operations job, a DeleteJobTagging * request is preferred because it achieves the same result without incurring charges. *
** A few things to consider about using tags: *
** Amazon S3 limits the maximum number of tags to 50 tags per job. *
** You can associate up to 50 tags with a job as long as they have unique tag keys. *
** A tag key can be up to 128 Unicode characters in length, and tag values can be up to 256 Unicode characters in * length. *
** The key and values are case sensitive. *
** For tagging-related restrictions related to characters and encodings, see User-Defined * Tag Restrictions in the Billing and Cost Management User Guide. *
*
* To use the PutJobTagging
operation, you must have permission to perform the
* s3:PutJobTagging
action.
*
* Related actions include: *
** CreateJob *
** GetJobTagging *
** DeleteJobTagging *
** 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 in the Amazon S3 User Guide. *
*
* The following actions are related to PutMultiRegionAccessPointPolicy
:
*
* Creates or modifies the PublicAccessBlock
configuration for an Amazon Web Services account. For this
* operation, users must have the s3:PutAccountPublicAccessBlock
permission. For more information, see
* Using Amazon
* S3 block public access.
*
* Related actions include: *
** Puts an Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see Working with Amazon S3 Storage Lens * in the Amazon S3 User Guide. For a complete list of S3 Storage Lens metrics, see S3 Storage Lens * metrics glossary in the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3:PutStorageLensConfiguration
action.
* For more information, see Setting permissions to
* use Amazon S3 Storage Lens in the Amazon S3 User Guide.
*
* Put or replace tags on an existing Amazon S3 Storage Lens configuration. For more information about S3 Storage * Lens, see Assessing your storage * activity and usage with Amazon S3 Storage Lens in the Amazon S3 User Guide. *
*
* To use this action, you must have permission to perform the s3:PutStorageLensConfigurationTagging
* action. For more information, see Setting permissions to
* use Amazon S3 Storage Lens in the Amazon S3 User Guide.
*
* Submits an updated route configuration for a Multi-Region Access Point. This API operation updates the routing
* status for the specified Regions from active to passive, or from passive to active. A value of 0
* indicates a passive status, which means that traffic won't be routed to the specified Region. A value of
* 100
indicates an active status, which means that traffic will be routed to the specified Region. At
* least one Region must be active at all times.
*
* When the routing configuration is changed, any in-progress operations (uploads, copies, deletes, and so on) to * formerly active Regions will continue to run to their final completion state (success or failure). The routing * configurations of any Regions that aren’t specified remain unchanged. *
** Updated routing configurations might not be immediately applied. It can take up to 2 minutes for your changes to * take effect. *
** To submit routing control changes and failover requests, use the Amazon S3 failover control infrastructure * endpoints in these five Amazon Web Services Regions: *
*
* us-east-1
*
* us-west-2
*
* ap-southeast-2
*
* ap-northeast-1
*
* eu-west-1
*
* Your Amazon S3 bucket does not need to be in these five Regions. *
** Updates an existing S3 Batch Operations job's priority. For more information, see S3 Batch Operations in the * Amazon S3 User Guide. *
* ** Related actions include: *
*