/* * Copyright 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. */ /* * Do not modify this file. This file is generated from the s3control-2018-08-20.normal.json service model. */ using System; using System.Threading; using System.Threading.Tasks; using System.Collections.Generic; using Amazon.Runtime; using Amazon.S3Control.Model; namespace Amazon.S3Control { /// /// Interface for accessing S3Control /// /// Amazon Web Services S3 Control provides access to Amazon S3 control plane actions. /// public partial interface IAmazonS3Control : IAmazonService, IDisposable { /// /// Paginators for the service /// IS3ControlPaginatorFactory Paginators { get; } #region CreateAccessPoint /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateAccessPoint service method. /// /// The response from the CreateAccessPoint service method, as returned by S3Control. /// REST API Reference for CreateAccessPoint Operation CreateAccessPointResponse CreateAccessPoint(CreateAccessPointRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateAccessPoint service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateAccessPoint service method, as returned by S3Control. /// REST API Reference for CreateAccessPoint Operation Task CreateAccessPointAsync(CreateAccessPointRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CreateAccessPointForObjectLambda /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateAccessPointForObjectLambda service method. /// /// The response from the CreateAccessPointForObjectLambda service method, as returned by S3Control. /// REST API Reference for CreateAccessPointForObjectLambda Operation CreateAccessPointForObjectLambdaResponse CreateAccessPointForObjectLambda(CreateAccessPointForObjectLambdaRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateAccessPointForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateAccessPointForObjectLambda service method, as returned by S3Control. /// REST API Reference for CreateAccessPointForObjectLambda Operation Task CreateAccessPointForObjectLambdaAsync(CreateAccessPointForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CreateBucket /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the CreateBucket service method. /// /// The response from the CreateBucket service method, as returned by S3Control. /// /// The requested Outposts bucket name is not available. The bucket namespace is shared /// by all users of the Outposts in this Region. Select a different name and try again. /// /// /// The Outposts bucket you tried to create already exists, and you own it. /// /// REST API Reference for CreateBucket Operation CreateBucketResponse CreateBucket(CreateBucketRequest request); /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the CreateBucket service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateBucket service method, as returned by S3Control. /// /// The requested Outposts bucket name is not available. The bucket namespace is shared /// by all users of the Outposts in this Region. Select a different name and try again. /// /// /// The Outposts bucket you tried to create already exists, and you own it. /// /// REST API Reference for CreateBucket Operation Task CreateBucketAsync(CreateBucketRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CreateJob /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateJob service method. /// /// The response from the CreateJob service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for CreateJob Operation CreateJobResponse CreateJob(CreateJobRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateJob service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateJob service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for CreateJob Operation Task CreateJobAsync(CreateJobRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CreateMultiRegionAccessPoint /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateMultiRegionAccessPoint service method. /// /// The response from the CreateMultiRegionAccessPoint service method, as returned by S3Control. /// REST API Reference for CreateMultiRegionAccessPoint Operation CreateMultiRegionAccessPointResponse CreateMultiRegionAccessPoint(CreateMultiRegionAccessPointRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the CreateMultiRegionAccessPoint service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateMultiRegionAccessPoint service method, as returned by S3Control. /// REST API Reference for CreateMultiRegionAccessPoint Operation Task CreateMultiRegionAccessPointAsync(CreateMultiRegionAccessPointRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteAccessPoint /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPoint service method. /// /// The response from the DeleteAccessPoint service method, as returned by S3Control. /// REST API Reference for DeleteAccessPoint Operation DeleteAccessPointResponse DeleteAccessPoint(DeleteAccessPointRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPoint service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteAccessPoint service method, as returned by S3Control. /// REST API Reference for DeleteAccessPoint Operation Task DeleteAccessPointAsync(DeleteAccessPointRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteAccessPointForObjectLambda /// /// Deletes the specified Object Lambda Access Point. /// /// /// /// The following actions are related to DeleteAccessPointForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPointForObjectLambda service method. /// /// The response from the DeleteAccessPointForObjectLambda service method, as returned by S3Control. /// REST API Reference for DeleteAccessPointForObjectLambda Operation DeleteAccessPointForObjectLambdaResponse DeleteAccessPointForObjectLambda(DeleteAccessPointForObjectLambdaRequest request); /// /// Deletes the specified Object Lambda Access Point. /// /// /// /// The following actions are related to DeleteAccessPointForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPointForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteAccessPointForObjectLambda service method, as returned by S3Control. /// REST API Reference for DeleteAccessPointForObjectLambda Operation Task DeleteAccessPointForObjectLambdaAsync(DeleteAccessPointForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteAccessPointPolicy /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPointPolicy service method. /// /// The response from the DeleteAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for DeleteAccessPointPolicy Operation DeleteAccessPointPolicyResponse DeleteAccessPointPolicy(DeleteAccessPointPolicyRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPointPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for DeleteAccessPointPolicy Operation Task DeleteAccessPointPolicyAsync(DeleteAccessPointPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteAccessPointPolicyForObjectLambda /// /// Removes the resource policy for an Object Lambda Access Point. /// /// /// /// The following actions are related to DeleteAccessPointPolicyForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPointPolicyForObjectLambda service method. /// /// The response from the DeleteAccessPointPolicyForObjectLambda service method, as returned by S3Control. /// REST API Reference for DeleteAccessPointPolicyForObjectLambda Operation DeleteAccessPointPolicyForObjectLambdaResponse DeleteAccessPointPolicyForObjectLambda(DeleteAccessPointPolicyForObjectLambdaRequest request); /// /// Removes the resource policy for an Object Lambda Access Point. /// /// /// /// The following actions are related to DeleteAccessPointPolicyForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the DeleteAccessPointPolicyForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteAccessPointPolicyForObjectLambda service method, as returned by S3Control. /// REST API Reference for DeleteAccessPointPolicyForObjectLambda Operation Task DeleteAccessPointPolicyForObjectLambdaAsync(DeleteAccessPointPolicyForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteBucket /// /// /// /// 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 /// ///

///
/// Container for the necessary parameters to execute the DeleteBucket service method. /// /// The response from the DeleteBucket service method, as returned by S3Control. /// REST API Reference for DeleteBucket Operation DeleteBucketResponse DeleteBucket(DeleteBucketRequest request); /// /// /// /// 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 /// ///

///
/// Container for the necessary parameters to execute the DeleteBucket service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteBucket service method, as returned by S3Control. /// REST API Reference for DeleteBucket Operation Task DeleteBucketAsync(DeleteBucketRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteBucketLifecycleConfiguration /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketLifecycleConfiguration service method. /// /// The response from the DeleteBucketLifecycleConfiguration service method, as returned by S3Control. /// REST API Reference for DeleteBucketLifecycleConfiguration Operation DeleteBucketLifecycleConfigurationResponse DeleteBucketLifecycleConfiguration(DeleteBucketLifecycleConfigurationRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketLifecycleConfiguration service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteBucketLifecycleConfiguration service method, as returned by S3Control. /// REST API Reference for DeleteBucketLifecycleConfiguration Operation Task DeleteBucketLifecycleConfigurationAsync(DeleteBucketLifecycleConfigurationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteBucketPolicy /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketPolicy service method. /// /// The response from the DeleteBucketPolicy service method, as returned by S3Control. /// REST API Reference for DeleteBucketPolicy Operation DeleteBucketPolicyResponse DeleteBucketPolicy(DeleteBucketPolicyRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteBucketPolicy service method, as returned by S3Control. /// REST API Reference for DeleteBucketPolicy Operation Task DeleteBucketPolicyAsync(DeleteBucketPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteBucketReplication /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketReplication service method. /// /// The response from the DeleteBucketReplication service method, as returned by S3Control. /// REST API Reference for DeleteBucketReplication Operation DeleteBucketReplicationResponse DeleteBucketReplication(DeleteBucketReplicationRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketReplication service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteBucketReplication service method, as returned by S3Control. /// REST API Reference for DeleteBucketReplication Operation Task DeleteBucketReplicationAsync(DeleteBucketReplicationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteBucketTagging /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketTagging service method. /// /// The response from the DeleteBucketTagging service method, as returned by S3Control. /// REST API Reference for DeleteBucketTagging Operation DeleteBucketTaggingResponse DeleteBucketTagging(DeleteBucketTaggingRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteBucketTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteBucketTagging service method, as returned by S3Control. /// REST API Reference for DeleteBucketTagging Operation Task DeleteBucketTaggingAsync(DeleteBucketTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteJobTagging /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteJobTagging service method. /// /// The response from the DeleteJobTagging service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// REST API Reference for DeleteJobTagging Operation DeleteJobTaggingResponse DeleteJobTagging(DeleteJobTaggingRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteJobTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteJobTagging service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// REST API Reference for DeleteJobTagging Operation Task DeleteJobTaggingAsync(DeleteJobTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteMultiRegionAccessPoint /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteMultiRegionAccessPoint service method. /// /// The response from the DeleteMultiRegionAccessPoint service method, as returned by S3Control. /// REST API Reference for DeleteMultiRegionAccessPoint Operation DeleteMultiRegionAccessPointResponse DeleteMultiRegionAccessPoint(DeleteMultiRegionAccessPointRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DeleteMultiRegionAccessPoint service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteMultiRegionAccessPoint service method, as returned by S3Control. /// REST API Reference for DeleteMultiRegionAccessPoint Operation Task DeleteMultiRegionAccessPointAsync(DeleteMultiRegionAccessPointRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeletePublicAccessBlock /// /// Removes the PublicAccessBlock configuration for an Amazon Web Services /// account. For more information, see /// Using Amazon S3 block public access. /// /// /// /// Related actions include: /// /// /// /// Container for the necessary parameters to execute the DeletePublicAccessBlock service method. /// /// The response from the DeletePublicAccessBlock service method, as returned by S3Control. /// REST API Reference for DeletePublicAccessBlock Operation DeletePublicAccessBlockResponse DeletePublicAccessBlock(DeletePublicAccessBlockRequest request); /// /// Removes the PublicAccessBlock configuration for an Amazon Web Services /// account. For more information, see /// Using Amazon S3 block public access. /// /// /// /// Related actions include: /// /// /// /// Container for the necessary parameters to execute the DeletePublicAccessBlock service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeletePublicAccessBlock service method, as returned by S3Control. /// REST API Reference for DeletePublicAccessBlock Operation Task DeletePublicAccessBlockAsync(DeletePublicAccessBlockRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteStorageLensConfiguration /// /// 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. /// /// /// /// Container for the necessary parameters to execute the DeleteStorageLensConfiguration service method. /// /// The response from the DeleteStorageLensConfiguration service method, as returned by S3Control. /// REST API Reference for DeleteStorageLensConfiguration Operation DeleteStorageLensConfigurationResponse DeleteStorageLensConfiguration(DeleteStorageLensConfigurationRequest request); /// /// 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. /// /// /// /// Container for the necessary parameters to execute the DeleteStorageLensConfiguration service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteStorageLensConfiguration service method, as returned by S3Control. /// REST API Reference for DeleteStorageLensConfiguration Operation Task DeleteStorageLensConfigurationAsync(DeleteStorageLensConfigurationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteStorageLensConfigurationTagging /// /// 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. /// /// /// /// Container for the necessary parameters to execute the DeleteStorageLensConfigurationTagging service method. /// /// The response from the DeleteStorageLensConfigurationTagging service method, as returned by S3Control. /// REST API Reference for DeleteStorageLensConfigurationTagging Operation DeleteStorageLensConfigurationTaggingResponse DeleteStorageLensConfigurationTagging(DeleteStorageLensConfigurationTaggingRequest request); /// /// 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. /// /// /// /// Container for the necessary parameters to execute the DeleteStorageLensConfigurationTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteStorageLensConfigurationTagging service method, as returned by S3Control. /// REST API Reference for DeleteStorageLensConfigurationTagging Operation Task DeleteStorageLensConfigurationTaggingAsync(DeleteStorageLensConfigurationTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeJob /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DescribeJob service method. /// /// The response from the DescribeJob service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for DescribeJob Operation DescribeJobResponse DescribeJob(DescribeJobRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DescribeJob service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeJob service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for DescribeJob Operation Task DescribeJobAsync(DescribeJobRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeMultiRegionAccessPointOperation /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DescribeMultiRegionAccessPointOperation service method. /// /// The response from the DescribeMultiRegionAccessPointOperation service method, as returned by S3Control. /// REST API Reference for DescribeMultiRegionAccessPointOperation Operation DescribeMultiRegionAccessPointOperationResponse DescribeMultiRegionAccessPointOperation(DescribeMultiRegionAccessPointOperationRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the DescribeMultiRegionAccessPointOperation service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeMultiRegionAccessPointOperation service method, as returned by S3Control. /// REST API Reference for DescribeMultiRegionAccessPointOperation Operation Task DescribeMultiRegionAccessPointOperationAsync(DescribeMultiRegionAccessPointOperationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetAccessPoint /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetAccessPoint service method. /// /// The response from the GetAccessPoint service method, as returned by S3Control. /// REST API Reference for GetAccessPoint Operation GetAccessPointResponse GetAccessPoint(GetAccessPointRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetAccessPoint service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetAccessPoint service method, as returned by S3Control. /// REST API Reference for GetAccessPoint Operation Task GetAccessPointAsync(GetAccessPointRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetAccessPointConfigurationForObjectLambda /// /// Returns configuration for an Object Lambda Access Point. /// /// /// /// The following actions are related to GetAccessPointConfigurationForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointConfigurationForObjectLambda service method. /// /// The response from the GetAccessPointConfigurationForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointConfigurationForObjectLambda Operation GetAccessPointConfigurationForObjectLambdaResponse GetAccessPointConfigurationForObjectLambda(GetAccessPointConfigurationForObjectLambdaRequest request); /// /// Returns configuration for an Object Lambda Access Point. /// /// /// /// The following actions are related to GetAccessPointConfigurationForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointConfigurationForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetAccessPointConfigurationForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointConfigurationForObjectLambda Operation Task GetAccessPointConfigurationForObjectLambdaAsync(GetAccessPointConfigurationForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetAccessPointForObjectLambda /// /// Returns configuration information about the specified Object Lambda Access Point /// /// /// /// The following actions are related to GetAccessPointForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointForObjectLambda service method. /// /// The response from the GetAccessPointForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointForObjectLambda Operation GetAccessPointForObjectLambdaResponse GetAccessPointForObjectLambda(GetAccessPointForObjectLambdaRequest request); /// /// Returns configuration information about the specified Object Lambda Access Point /// /// /// /// The following actions are related to GetAccessPointForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetAccessPointForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointForObjectLambda Operation Task GetAccessPointForObjectLambdaAsync(GetAccessPointForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetAccessPointPolicy /// /// Returns the access point policy associated with the specified access point. /// /// /// /// The following actions are related to GetAccessPointPolicy: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointPolicy service method. /// /// The response from the GetAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicy Operation GetAccessPointPolicyResponse GetAccessPointPolicy(GetAccessPointPolicyRequest request); /// /// Returns the access point policy associated with the specified access point. /// /// /// /// The following actions are related to GetAccessPointPolicy: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicy Operation Task GetAccessPointPolicyAsync(GetAccessPointPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetAccessPointPolicyForObjectLambda /// /// Returns the resource policy for an Object Lambda Access Point. /// /// /// /// The following actions are related to GetAccessPointPolicyForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointPolicyForObjectLambda service method. /// /// The response from the GetAccessPointPolicyForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicyForObjectLambda Operation GetAccessPointPolicyForObjectLambdaResponse GetAccessPointPolicyForObjectLambda(GetAccessPointPolicyForObjectLambdaRequest request); /// /// Returns the resource policy for an Object Lambda Access Point. /// /// /// /// The following actions are related to GetAccessPointPolicyForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the GetAccessPointPolicyForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetAccessPointPolicyForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicyForObjectLambda Operation Task GetAccessPointPolicyForObjectLambdaAsync(GetAccessPointPolicyForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetAccessPointPolicyStatus /// /// 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. /// /// Container for the necessary parameters to execute the GetAccessPointPolicyStatus service method. /// /// The response from the GetAccessPointPolicyStatus service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicyStatus Operation GetAccessPointPolicyStatusResponse GetAccessPointPolicyStatus(GetAccessPointPolicyStatusRequest request); /// /// 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. /// /// Container for the necessary parameters to execute the GetAccessPointPolicyStatus service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetAccessPointPolicyStatus service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicyStatus Operation Task GetAccessPointPolicyStatusAsync(GetAccessPointPolicyStatusRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetAccessPointPolicyStatusForObjectLambda /// /// Returns the status of the resource policy associated with an Object Lambda Access /// Point. /// /// Container for the necessary parameters to execute the GetAccessPointPolicyStatusForObjectLambda service method. /// /// The response from the GetAccessPointPolicyStatusForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicyStatusForObjectLambda Operation GetAccessPointPolicyStatusForObjectLambdaResponse GetAccessPointPolicyStatusForObjectLambda(GetAccessPointPolicyStatusForObjectLambdaRequest request); /// /// Returns the status of the resource policy associated with an Object Lambda Access /// Point. /// /// Container for the necessary parameters to execute the GetAccessPointPolicyStatusForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetAccessPointPolicyStatusForObjectLambda service method, as returned by S3Control. /// REST API Reference for GetAccessPointPolicyStatusForObjectLambda Operation Task GetAccessPointPolicyStatusForObjectLambdaAsync(GetAccessPointPolicyStatusForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetBucket /// /// 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. /// /// /// /// Container for the necessary parameters to execute the GetBucket service method. /// /// The response from the GetBucket service method, as returned by S3Control. /// REST API Reference for GetBucket Operation GetBucketResponse GetBucket(GetBucketRequest 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. /// /// /// /// Container for the necessary parameters to execute the GetBucket service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetBucket service method, as returned by S3Control. /// REST API Reference for GetBucket Operation Task GetBucketAsync(GetBucketRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetBucketLifecycleConfiguration /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the GetBucketLifecycleConfiguration service method. /// /// The response from the GetBucketLifecycleConfiguration service method, as returned by S3Control. /// REST API Reference for GetBucketLifecycleConfiguration Operation GetBucketLifecycleConfigurationResponse GetBucketLifecycleConfiguration(GetBucketLifecycleConfigurationRequest request); /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the GetBucketLifecycleConfiguration service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetBucketLifecycleConfiguration service method, as returned by S3Control. /// REST API Reference for GetBucketLifecycleConfiguration Operation Task GetBucketLifecycleConfigurationAsync(GetBucketLifecycleConfigurationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetBucketPolicy /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetBucketPolicy service method. /// /// The response from the GetBucketPolicy service method, as returned by S3Control. /// REST API Reference for GetBucketPolicy Operation GetBucketPolicyResponse GetBucketPolicy(GetBucketPolicyRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetBucketPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetBucketPolicy service method, as returned by S3Control. /// REST API Reference for GetBucketPolicy Operation Task GetBucketPolicyAsync(GetBucketPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetBucketReplication /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetBucketReplication service method. /// /// The response from the GetBucketReplication service method, as returned by S3Control. /// REST API Reference for GetBucketReplication Operation GetBucketReplicationResponse GetBucketReplication(GetBucketReplicationRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetBucketReplication service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetBucketReplication service method, as returned by S3Control. /// REST API Reference for GetBucketReplication Operation Task GetBucketReplicationAsync(GetBucketReplicationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetBucketTagging /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the GetBucketTagging service method. /// /// The response from the GetBucketTagging service method, as returned by S3Control. /// REST API Reference for GetBucketTagging Operation GetBucketTaggingResponse GetBucketTagging(GetBucketTaggingRequest request); /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the GetBucketTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetBucketTagging service method, as returned by S3Control. /// REST API Reference for GetBucketTagging Operation Task GetBucketTaggingAsync(GetBucketTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetBucketVersioning /// /// /// /// 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. /// /// /// /// Container for the necessary parameters to execute the GetBucketVersioning service method. /// /// The response from the GetBucketVersioning service method, as returned by S3Control. /// REST API Reference for GetBucketVersioning Operation GetBucketVersioningResponse GetBucketVersioning(GetBucketVersioningRequest request); /// /// /// /// 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. /// /// /// /// Container for the necessary parameters to execute the GetBucketVersioning service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetBucketVersioning service method, as returned by S3Control. /// REST API Reference for GetBucketVersioning Operation Task GetBucketVersioningAsync(GetBucketVersioningRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetJobTagging /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetJobTagging service method. /// /// The response from the GetJobTagging service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// REST API Reference for GetJobTagging Operation GetJobTaggingResponse GetJobTagging(GetJobTaggingRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetJobTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetJobTagging service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// REST API Reference for GetJobTagging Operation Task GetJobTaggingAsync(GetJobTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetMultiRegionAccessPoint /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetMultiRegionAccessPoint service method. /// /// The response from the GetMultiRegionAccessPoint service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPoint Operation GetMultiRegionAccessPointResponse GetMultiRegionAccessPoint(GetMultiRegionAccessPointRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetMultiRegionAccessPoint service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetMultiRegionAccessPoint service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPoint Operation Task GetMultiRegionAccessPointAsync(GetMultiRegionAccessPointRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetMultiRegionAccessPointPolicy /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetMultiRegionAccessPointPolicy service method. /// /// The response from the GetMultiRegionAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPointPolicy Operation GetMultiRegionAccessPointPolicyResponse GetMultiRegionAccessPointPolicy(GetMultiRegionAccessPointPolicyRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetMultiRegionAccessPointPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetMultiRegionAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPointPolicy Operation Task GetMultiRegionAccessPointPolicyAsync(GetMultiRegionAccessPointPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetMultiRegionAccessPointPolicyStatus /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetMultiRegionAccessPointPolicyStatus service method. /// /// The response from the GetMultiRegionAccessPointPolicyStatus service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPointPolicyStatus Operation GetMultiRegionAccessPointPolicyStatusResponse GetMultiRegionAccessPointPolicyStatus(GetMultiRegionAccessPointPolicyStatusRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the GetMultiRegionAccessPointPolicyStatus service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetMultiRegionAccessPointPolicyStatus service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPointPolicyStatus Operation Task GetMultiRegionAccessPointPolicyStatusAsync(GetMultiRegionAccessPointPolicyStatusRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetMultiRegionAccessPointRoutes /// /// 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. /// /// ///
/// Container for the necessary parameters to execute the GetMultiRegionAccessPointRoutes service method. /// /// The response from the GetMultiRegionAccessPointRoutes service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPointRoutes Operation GetMultiRegionAccessPointRoutesResponse GetMultiRegionAccessPointRoutes(GetMultiRegionAccessPointRoutesRequest request); /// /// 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. /// /// ///
/// Container for the necessary parameters to execute the GetMultiRegionAccessPointRoutes service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetMultiRegionAccessPointRoutes service method, as returned by S3Control. /// REST API Reference for GetMultiRegionAccessPointRoutes Operation Task GetMultiRegionAccessPointRoutesAsync(GetMultiRegionAccessPointRoutesRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetPublicAccessBlock /// /// Retrieves the PublicAccessBlock configuration for an Amazon Web Services /// account. For more information, see /// Using Amazon S3 block public access. /// /// /// /// Related actions include: /// /// /// /// Container for the necessary parameters to execute the GetPublicAccessBlock service method. /// /// The response from the GetPublicAccessBlock service method, as returned by S3Control. /// /// Amazon S3 throws this exception if you make a GetPublicAccessBlock request /// against an account that doesn't have a PublicAccessBlockConfiguration /// set. /// /// REST API Reference for GetPublicAccessBlock Operation GetPublicAccessBlockResponse GetPublicAccessBlock(GetPublicAccessBlockRequest request); /// /// Retrieves the PublicAccessBlock configuration for an Amazon Web Services /// account. For more information, see /// Using Amazon S3 block public access. /// /// /// /// Related actions include: /// /// /// /// Container for the necessary parameters to execute the GetPublicAccessBlock service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetPublicAccessBlock service method, as returned by S3Control. /// /// Amazon S3 throws this exception if you make a GetPublicAccessBlock request /// against an account that doesn't have a PublicAccessBlockConfiguration /// set. /// /// REST API Reference for GetPublicAccessBlock Operation Task GetPublicAccessBlockAsync(GetPublicAccessBlockRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetStorageLensConfiguration /// /// 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. /// /// /// /// Container for the necessary parameters to execute the GetStorageLensConfiguration service method. /// /// The response from the GetStorageLensConfiguration service method, as returned by S3Control. /// REST API Reference for GetStorageLensConfiguration Operation GetStorageLensConfigurationResponse GetStorageLensConfiguration(GetStorageLensConfigurationRequest 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. /// /// /// /// Container for the necessary parameters to execute the GetStorageLensConfiguration service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetStorageLensConfiguration service method, as returned by S3Control. /// REST API Reference for GetStorageLensConfiguration Operation Task GetStorageLensConfigurationAsync(GetStorageLensConfigurationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetStorageLensConfigurationTagging /// /// 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. /// /// /// /// Container for the necessary parameters to execute the GetStorageLensConfigurationTagging service method. /// /// The response from the GetStorageLensConfigurationTagging service method, as returned by S3Control. /// REST API Reference for GetStorageLensConfigurationTagging Operation GetStorageLensConfigurationTaggingResponse GetStorageLensConfigurationTagging(GetStorageLensConfigurationTaggingRequest request); /// /// 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. /// /// /// /// Container for the necessary parameters to execute the GetStorageLensConfigurationTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetStorageLensConfigurationTagging service method, as returned by S3Control. /// REST API Reference for GetStorageLensConfigurationTagging Operation Task GetStorageLensConfigurationTaggingAsync(GetStorageLensConfigurationTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListAccessPoints /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListAccessPoints service method. /// /// The response from the ListAccessPoints service method, as returned by S3Control. /// REST API Reference for ListAccessPoints Operation ListAccessPointsResponse ListAccessPoints(ListAccessPointsRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListAccessPoints service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListAccessPoints service method, as returned by S3Control. /// REST API Reference for ListAccessPoints Operation Task ListAccessPointsAsync(ListAccessPointsRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListAccessPointsForObjectLambda /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListAccessPointsForObjectLambda service method. /// /// The response from the ListAccessPointsForObjectLambda service method, as returned by S3Control. /// REST API Reference for ListAccessPointsForObjectLambda Operation ListAccessPointsForObjectLambdaResponse ListAccessPointsForObjectLambda(ListAccessPointsForObjectLambdaRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListAccessPointsForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListAccessPointsForObjectLambda service method, as returned by S3Control. /// REST API Reference for ListAccessPointsForObjectLambda Operation Task ListAccessPointsForObjectLambdaAsync(ListAccessPointsForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListJobs /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListJobs service method. /// /// The response from the ListJobs service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// REST API Reference for ListJobs Operation ListJobsResponse ListJobs(ListJobsRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListJobs service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListJobs service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// REST API Reference for ListJobs Operation Task ListJobsAsync(ListJobsRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListMultiRegionAccessPoints /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListMultiRegionAccessPoints service method. /// /// The response from the ListMultiRegionAccessPoints service method, as returned by S3Control. /// REST API Reference for ListMultiRegionAccessPoints Operation ListMultiRegionAccessPointsResponse ListMultiRegionAccessPoints(ListMultiRegionAccessPointsRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the ListMultiRegionAccessPoints service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListMultiRegionAccessPoints service method, as returned by S3Control. /// REST API Reference for ListMultiRegionAccessPoints Operation Task ListMultiRegionAccessPointsAsync(ListMultiRegionAccessPointsRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListRegionalBuckets /// /// 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. /// /// /// Container for the necessary parameters to execute the ListRegionalBuckets service method. /// /// The response from the ListRegionalBuckets service method, as returned by S3Control. /// REST API Reference for ListRegionalBuckets Operation ListRegionalBucketsResponse ListRegionalBuckets(ListRegionalBucketsRequest request); /// /// 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. /// /// /// Container for the necessary parameters to execute the ListRegionalBuckets service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListRegionalBuckets service method, as returned by S3Control. /// REST API Reference for ListRegionalBuckets Operation Task ListRegionalBucketsAsync(ListRegionalBucketsRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListStorageLensConfigurations /// /// 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. /// /// /// /// Container for the necessary parameters to execute the ListStorageLensConfigurations service method. /// /// The response from the ListStorageLensConfigurations service method, as returned by S3Control. /// REST API Reference for ListStorageLensConfigurations Operation ListStorageLensConfigurationsResponse ListStorageLensConfigurations(ListStorageLensConfigurationsRequest request); /// /// 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. /// /// /// /// Container for the necessary parameters to execute the ListStorageLensConfigurations service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListStorageLensConfigurations service method, as returned by S3Control. /// REST API Reference for ListStorageLensConfigurations Operation Task ListStorageLensConfigurationsAsync(ListStorageLensConfigurationsRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutAccessPointConfigurationForObjectLambda /// /// Replaces configuration for an Object Lambda Access Point. /// /// /// /// The following actions are related to PutAccessPointConfigurationForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the PutAccessPointConfigurationForObjectLambda service method. /// /// The response from the PutAccessPointConfigurationForObjectLambda service method, as returned by S3Control. /// REST API Reference for PutAccessPointConfigurationForObjectLambda Operation PutAccessPointConfigurationForObjectLambdaResponse PutAccessPointConfigurationForObjectLambda(PutAccessPointConfigurationForObjectLambdaRequest request); /// /// Replaces configuration for an Object Lambda Access Point. /// /// /// /// The following actions are related to PutAccessPointConfigurationForObjectLambda: /// /// /// /// Container for the necessary parameters to execute the PutAccessPointConfigurationForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutAccessPointConfigurationForObjectLambda service method, as returned by S3Control. /// REST API Reference for PutAccessPointConfigurationForObjectLambda Operation Task PutAccessPointConfigurationForObjectLambdaAsync(PutAccessPointConfigurationForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutAccessPointPolicy /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutAccessPointPolicy service method. /// /// The response from the PutAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for PutAccessPointPolicy Operation PutAccessPointPolicyResponse PutAccessPointPolicy(PutAccessPointPolicyRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutAccessPointPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for PutAccessPointPolicy Operation Task PutAccessPointPolicyAsync(PutAccessPointPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutAccessPointPolicyForObjectLambda /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutAccessPointPolicyForObjectLambda service method. /// /// The response from the PutAccessPointPolicyForObjectLambda service method, as returned by S3Control. /// REST API Reference for PutAccessPointPolicyForObjectLambda Operation PutAccessPointPolicyForObjectLambdaResponse PutAccessPointPolicyForObjectLambda(PutAccessPointPolicyForObjectLambdaRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutAccessPointPolicyForObjectLambda service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutAccessPointPolicyForObjectLambda service method, as returned by S3Control. /// REST API Reference for PutAccessPointPolicyForObjectLambda Operation Task PutAccessPointPolicyForObjectLambdaAsync(PutAccessPointPolicyForObjectLambdaRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutBucketLifecycleConfiguration /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutBucketLifecycleConfiguration service method. /// /// The response from the PutBucketLifecycleConfiguration service method, as returned by S3Control. /// REST API Reference for PutBucketLifecycleConfiguration Operation PutBucketLifecycleConfigurationResponse PutBucketLifecycleConfiguration(PutBucketLifecycleConfigurationRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutBucketLifecycleConfiguration service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutBucketLifecycleConfiguration service method, as returned by S3Control. /// REST API Reference for PutBucketLifecycleConfiguration Operation Task PutBucketLifecycleConfigurationAsync(PutBucketLifecycleConfigurationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutBucketPolicy /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutBucketPolicy service method. /// /// The response from the PutBucketPolicy service method, as returned by S3Control. /// REST API Reference for PutBucketPolicy Operation PutBucketPolicyResponse PutBucketPolicy(PutBucketPolicyRequest request); /// /// /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutBucketPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutBucketPolicy service method, as returned by S3Control. /// REST API Reference for PutBucketPolicy Operation Task PutBucketPolicyAsync(PutBucketPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutBucketReplication /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the PutBucketReplication service method. /// /// The response from the PutBucketReplication service method, as returned by S3Control. /// REST API Reference for PutBucketReplication Operation PutBucketReplicationResponse PutBucketReplication(PutBucketReplicationRequest request); /// /// /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the PutBucketReplication service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutBucketReplication service method, as returned by S3Control. /// REST API Reference for PutBucketReplication Operation Task PutBucketReplicationAsync(PutBucketReplicationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutBucketTagging /// /// /// /// 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 /// ///
  • /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the PutBucketTagging service method. /// /// The response from the PutBucketTagging service method, as returned by S3Control. /// REST API Reference for PutBucketTagging Operation PutBucketTaggingResponse PutBucketTagging(PutBucketTaggingRequest request); /// /// /// /// 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 /// ///
  • /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the PutBucketTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutBucketTagging service method, as returned by S3Control. /// REST API Reference for PutBucketTagging Operation Task PutBucketTaggingAsync(PutBucketTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutBucketVersioning /// /// /// /// 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. /// /// ///
/// Container for the necessary parameters to execute the PutBucketVersioning service method. /// /// The response from the PutBucketVersioning service method, as returned by S3Control. /// REST API Reference for PutBucketVersioning Operation PutBucketVersioningResponse PutBucketVersioning(PutBucketVersioningRequest request); /// /// /// /// 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. /// /// ///
/// Container for the necessary parameters to execute the PutBucketVersioning service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutBucketVersioning service method, as returned by S3Control. /// REST API Reference for PutBucketVersioning Operation Task PutBucketVersioningAsync(PutBucketVersioningRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutJobTagging /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the PutJobTagging service method. /// /// The response from the PutJobTagging service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// Amazon S3 throws this exception if you have too many tags in your tag set. /// /// REST API Reference for PutJobTagging Operation PutJobTaggingResponse PutJobTagging(PutJobTaggingRequest request); /// /// 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: /// /// ///
/// Container for the necessary parameters to execute the PutJobTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutJobTagging service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// Amazon S3 throws this exception if you have too many tags in your tag set. /// /// REST API Reference for PutJobTagging Operation Task PutJobTaggingAsync(PutJobTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutMultiRegionAccessPointPolicy /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutMultiRegionAccessPointPolicy service method. /// /// The response from the PutMultiRegionAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for PutMultiRegionAccessPointPolicy Operation PutMultiRegionAccessPointPolicyResponse PutMultiRegionAccessPointPolicy(PutMultiRegionAccessPointPolicyRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutMultiRegionAccessPointPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutMultiRegionAccessPointPolicy service method, as returned by S3Control. /// REST API Reference for PutMultiRegionAccessPointPolicy Operation Task PutMultiRegionAccessPointPolicyAsync(PutMultiRegionAccessPointPolicyRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutPublicAccessBlock /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutPublicAccessBlock service method. /// /// The response from the PutPublicAccessBlock service method, as returned by S3Control. /// REST API Reference for PutPublicAccessBlock Operation PutPublicAccessBlockResponse PutPublicAccessBlock(PutPublicAccessBlockRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the PutPublicAccessBlock service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutPublicAccessBlock service method, as returned by S3Control. /// REST API Reference for PutPublicAccessBlock Operation Task PutPublicAccessBlockAsync(PutPublicAccessBlockRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutStorageLensConfiguration /// /// 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. /// /// /// /// Container for the necessary parameters to execute the PutStorageLensConfiguration service method. /// /// The response from the PutStorageLensConfiguration service method, as returned by S3Control. /// REST API Reference for PutStorageLensConfiguration Operation PutStorageLensConfigurationResponse PutStorageLensConfiguration(PutStorageLensConfigurationRequest request); /// /// 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. /// /// /// /// Container for the necessary parameters to execute the PutStorageLensConfiguration service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutStorageLensConfiguration service method, as returned by S3Control. /// REST API Reference for PutStorageLensConfiguration Operation Task PutStorageLensConfigurationAsync(PutStorageLensConfigurationRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutStorageLensConfigurationTagging /// /// 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. /// /// /// /// Container for the necessary parameters to execute the PutStorageLensConfigurationTagging service method. /// /// The response from the PutStorageLensConfigurationTagging service method, as returned by S3Control. /// REST API Reference for PutStorageLensConfigurationTagging Operation PutStorageLensConfigurationTaggingResponse PutStorageLensConfigurationTagging(PutStorageLensConfigurationTaggingRequest request); /// /// 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. /// /// /// /// Container for the necessary parameters to execute the PutStorageLensConfigurationTagging service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutStorageLensConfigurationTagging service method, as returned by S3Control. /// REST API Reference for PutStorageLensConfigurationTagging Operation Task PutStorageLensConfigurationTaggingAsync(PutStorageLensConfigurationTaggingRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region SubmitMultiRegionAccessPointRoutes /// /// 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. /// /// ///
/// Container for the necessary parameters to execute the SubmitMultiRegionAccessPointRoutes service method. /// /// The response from the SubmitMultiRegionAccessPointRoutes service method, as returned by S3Control. /// REST API Reference for SubmitMultiRegionAccessPointRoutes Operation SubmitMultiRegionAccessPointRoutesResponse SubmitMultiRegionAccessPointRoutes(SubmitMultiRegionAccessPointRoutesRequest request); /// /// 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. /// /// ///
/// Container for the necessary parameters to execute the SubmitMultiRegionAccessPointRoutes service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the SubmitMultiRegionAccessPointRoutes service method, as returned by S3Control. /// REST API Reference for SubmitMultiRegionAccessPointRoutes Operation Task SubmitMultiRegionAccessPointRoutesAsync(SubmitMultiRegionAccessPointRoutesRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region UpdateJobPriority /// /// 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: /// /// /// /// Container for the necessary parameters to execute the UpdateJobPriority service method. /// /// The response from the UpdateJobPriority service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for UpdateJobPriority Operation UpdateJobPriorityResponse UpdateJobPriority(UpdateJobPriorityRequest request); /// /// 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: /// /// /// /// Container for the necessary parameters to execute the UpdateJobPriority service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the UpdateJobPriority service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for UpdateJobPriority Operation Task UpdateJobPriorityAsync(UpdateJobPriorityRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion #region UpdateJobStatus /// /// Updates the status for the specified job. Use this action to confirm that you want /// to run a job or to cancel an existing job. For more information, see S3 /// Batch Operations in the Amazon S3 User Guide. /// /// /// /// Related actions include: /// /// /// /// Container for the necessary parameters to execute the UpdateJobStatus service method. /// /// The response from the UpdateJobStatus service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for UpdateJobStatus Operation UpdateJobStatusResponse UpdateJobStatus(UpdateJobStatusRequest request); /// /// Updates the status for the specified job. Use this action to confirm that you want /// to run a job or to cancel an existing job. For more information, see S3 /// Batch Operations in the Amazon S3 User Guide. /// /// /// /// Related actions include: /// /// /// /// Container for the necessary parameters to execute the UpdateJobStatus service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the UpdateJobStatus service method, as returned by S3Control. /// /// /// /// /// /// /// /// /// /// /// /// /// /// /// /// REST API Reference for UpdateJobStatus Operation Task UpdateJobStatusAsync(UpdateJobStatusRequest request, CancellationToken cancellationToken = default(CancellationToken)); #endregion } }