AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Implementation for accessing S3

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonServiceClient
    Amazon.S3.AmazonS3Client

Namespace: Amazon.S3
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z

Syntax

C#
public class AmazonS3Client : AmazonServiceClient
         IAmazonS3, IAmazonService, ICoreAmazonS3, IDisposable

The AmazonS3Client type exposes the following members

Constructors

NameDescription
Public Method AmazonS3Client()

Constructs AmazonS3Client with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.



    
        
    

             

Public Method AmazonS3Client(RegionEndpoint)

Constructs AmazonS3Client with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.



    
        
    

             

Public Method AmazonS3Client(AmazonS3Config)

Constructs AmazonS3Client with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.



    
        
    

             

Public Method AmazonS3Client(AWSCredentials)

Constructs AmazonS3Client with AWS Credentials

Public Method AmazonS3Client(AWSCredentials, RegionEndpoint)

Constructs AmazonS3Client with AWS Credentials

Public Method AmazonS3Client(AWSCredentials, AmazonS3Config)

Constructs AmazonS3Client with AWS Credentials and an AmazonS3Client Configuration object.

Public Method AmazonS3Client(string, string)

Constructs AmazonS3Client with AWS Access Key ID and AWS Secret Key

Public Method AmazonS3Client(string, string, RegionEndpoint)

Constructs AmazonS3Client with AWS Access Key ID and AWS Secret Key

Public Method AmazonS3Client(string, string, AmazonS3Config)

Constructs AmazonS3Client with AWS Access Key ID, AWS Secret Key and an AmazonS3Client Configuration object.

Public Method AmazonS3Client(string, string, string)

Constructs AmazonS3Client with AWS Access Key ID and AWS Secret Key

Public Method AmazonS3Client(string, string, string, RegionEndpoint)

Constructs AmazonS3Client with AWS Access Key ID and AWS Secret Key

Public Method AmazonS3Client(string, string, string, AmazonS3Config)

Constructs AmazonS3Client with AWS Access Key ID, AWS Secret Key and an AmazonS3Client Configuration object.

Properties

NameTypeDescription
Public Property Config Amazon.Runtime.IClientConfig Inherited from Amazon.Runtime.AmazonServiceClient.

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.5 or higher. For .NET 3.5 the SDK follows the standard naming convention of BeginMethodName and EndMethodName to indicate asynchronous operations - these method pairs are not shown in the table below.

NameDescription
Public Method AbortMultipartUpload(string, string, string)

Aborts a multipart upload.

To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.

Public Method AbortMultipartUpload(AbortMultipartUploadRequest)

Aborts a multipart upload.

To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.

Public Method AbortMultipartUploadAsync(string, string, string, CancellationToken)

Aborts a multipart upload.

To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.

Public Method AbortMultipartUploadAsync(AbortMultipartUploadRequest, CancellationToken)

Aborts a multipart upload.

To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.

Public Method CompleteMultipartUpload(CompleteMultipartUploadRequest)

Completes a multipart upload by assembling previously uploaded parts.

Public Method CompleteMultipartUploadAsync(CompleteMultipartUploadRequest, CancellationToken)

Completes a multipart upload by assembling previously uploaded parts.

Public Method CopyObject(string, string, string, string)

Creates a copy of an object that is already stored in Amazon S3.

Public Method CopyObject(string, string, string, string, string)

Creates a copy of an object that is already stored in Amazon S3.

Public Method CopyObject(CopyObjectRequest)

Creates a copy of an object that is already stored in Amazon S3.

Public Method CopyObjectAsync(string, string, string, string, CancellationToken)

Creates a copy of an object that is already stored in Amazon S3.

Public Method CopyObjectAsync(string, string, string, string, string, CancellationToken)

Creates a copy of an object that is already stored in Amazon S3.

Public Method CopyObjectAsync(CopyObjectRequest, CancellationToken)

Creates a copy of an object that is already stored in Amazon S3.

Public Method CopyPart(string, string, string, string, string)

Uploads a part by copying data from an existing object as data source.

Public Method CopyPart(string, string, string, string, string, string)

Uploads a part by copying data from an existing object as data source.

Public Method CopyPart(CopyPartRequest)

Uploads a part by copying data from an existing object as data source.

Public Method CopyPartAsync(string, string, string, string, string, CancellationToken)

Uploads a part by copying data from an existing object as data source.

Public Method CopyPartAsync(string, string, string, string, string, string, CancellationToken)

Uploads a part by copying data from an existing object as data source.

Public Method CopyPartAsync(CopyPartRequest, CancellationToken)

Uploads a part by copying data from an existing object as data source.

Public Method DeleteBucket(string)

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.

Public Method DeleteBucket(DeleteBucketRequest)

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.

Public Method DeleteBucketAnalyticsConfiguration(DeleteBucketAnalyticsConfigurationRequest)

Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).

To use this operation, you must have permissions to perform the s3:PutAnalyticsConfiguration action. The bucket owner has this permission by default. The bucket owner can grant this permission to others.

Public Method DeleteBucketAnalyticsConfigurationAsync(DeleteBucketAnalyticsConfigurationRequest, CancellationToken)

Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).

To use this operation, you must have permissions to perform the s3:PutAnalyticsConfiguration action. The bucket owner has this permission by default. The bucket owner can grant this permission to others.

Public Method DeleteBucketAsync(string, CancellationToken)

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.

Public Method DeleteBucketAsync(DeleteBucketRequest, CancellationToken)

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.

Public Method DeleteBucketEncryption(DeleteBucketEncryptionRequest)

Deletes the server-side encryption configuration from the bucket.

Public Method DeleteBucketEncryptionAsync(DeleteBucketEncryptionRequest, CancellationToken)

Deletes the server-side encryption configuration from the bucket.

Public Method DeleteBucketInventoryConfiguration(DeleteBucketInventoryConfigurationRequest)

Deletes an inventory configuration (identified by the inventory ID) from the bucket.

Public Method DeleteBucketInventoryConfigurationAsync(DeleteBucketInventoryConfigurationRequest, CancellationToken)

Deletes an inventory configuration (identified by the inventory ID) from the bucket.

Public Method DeleteBucketMetricsConfiguration(DeleteBucketMetricsConfigurationRequest)

Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.

Public Method DeleteBucketMetricsConfigurationAsync(DeleteBucketMetricsConfigurationRequest, CancellationToken)

Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.

Public Method DeleteBucketPolicy(string)

Deletes the policy from the bucket.

Public Method DeleteBucketPolicy(DeleteBucketPolicyRequest)

Deletes the policy from the bucket.

Public Method DeleteBucketPolicyAsync(string, CancellationToken)

Deletes the policy from the bucket.

Public Method DeleteBucketPolicyAsync(DeleteBucketPolicyRequest, CancellationToken)

Deletes the policy from the bucket.

Public Method DeleteBucketReplication(DeleteBucketReplicationRequest)

Deletes the replication configuration from the bucket. For information about replication configuration, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.

Public Method DeleteBucketReplicationAsync(DeleteBucketReplicationRequest, CancellationToken)

Deletes the replication configuration from the bucket. For information about replication configuration, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.

Public Method DeleteBucketTagging(string)

Deletes the tags from the bucket.

Public Method DeleteBucketTagging(DeleteBucketTaggingRequest)

Deletes the tags from the bucket.

Public Method DeleteBucketTaggingAsync(string, CancellationToken)

Deletes the tags from the bucket.

Public Method DeleteBucketTaggingAsync(DeleteBucketTaggingRequest, CancellationToken)

Deletes the tags from the bucket.

Public Method DeleteBucketWebsite(string)

This operation removes the website configuration from the bucket.

Public Method DeleteBucketWebsite(DeleteBucketWebsiteRequest)

This operation removes the website configuration from the bucket.

Public Method DeleteBucketWebsiteAsync(string, CancellationToken)

This operation removes the website configuration from the bucket.

Public Method DeleteBucketWebsiteAsync(DeleteBucketWebsiteRequest, CancellationToken)

This operation removes the website configuration from the bucket.

Public Method DeleteCORSConfiguration(string)

Deletes the CORS configuration information set for the bucket.

Public Method DeleteCORSConfiguration(DeleteCORSConfigurationRequest)

Deletes the CORS configuration information set for the bucket.

Public Method DeleteCORSConfigurationAsync(string, CancellationToken)

Deletes the CORS configuration information set for the bucket.

Public Method DeleteCORSConfigurationAsync(DeleteCORSConfigurationRequest, CancellationToken)

Deletes the CORS configuration information set for the bucket.

Public Method DeleteLifecycleConfiguration(string)

Deletes the lifecycle configuration from the bucket.

Public Method DeleteLifecycleConfiguration(DeleteLifecycleConfigurationRequest)

Deletes the lifecycle configuration from the bucket.

Public Method DeleteLifecycleConfigurationAsync(string, CancellationToken)

Deletes the lifecycle configuration from the bucket.

Public Method DeleteLifecycleConfigurationAsync(DeleteLifecycleConfigurationRequest, CancellationToken)

Deletes the lifecycle configuration from the bucket.

Public Method DeleteObject(string, string, string)

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Public Method DeleteObject(DeleteObjectRequest)

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Public Method DeleteObject(string, string)

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Public Method DeleteObjectAsync(string, string, CancellationToken)

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Public Method DeleteObjectAsync(string, string, string, CancellationToken)

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Public Method DeleteObjectAsync(DeleteObjectRequest, CancellationToken)

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Public Method DeleteObjects(DeleteObjectsRequest)

This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.

Public Method DeleteObjectsAsync(DeleteObjectsRequest, CancellationToken)

This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.

Public Method DeleteObjectTagging(DeleteObjectTaggingRequest)

Removes the tag-set from an existing object.

Public Method DeleteObjectTaggingAsync(DeleteObjectTaggingRequest, CancellationToken)

Removes the tag-set from an existing object.

Public Method DeletePublicAccessBlock(DeletePublicAccessBlockRequest)

Removes the PublicAccessBlock configuration from an Amazon S3 bucket.

Public Method DeletePublicAccessBlockAsync(DeletePublicAccessBlockRequest, CancellationToken)

Removes the PublicAccessBlock configuration from an Amazon S3 bucket.

Public Method Dispose() Inherited from Amazon.Runtime.AmazonServiceClient.
Public Method GetACL(string)

Gets the access control policy for the bucket.

Public Method GetACL(GetACLRequest)

Gets the access control policy for the bucket.

Public Method GetACLAsync(string, CancellationToken)

Gets the access control policy for the bucket.

Public Method GetACLAsync(GetACLRequest, CancellationToken)

Gets the access control policy for the bucket.

Public Method GetBucketAccelerateConfiguration(string)

Returns the accelerate configuration of a bucket.

Public Method GetBucketAccelerateConfiguration(GetBucketAccelerateConfigurationRequest)

Returns the accelerate configuration of a bucket.

Public Method GetBucketAccelerateConfigurationAsync(string, CancellationToken)

Returns the accelerate configuration of a bucket.

Public Method GetBucketAccelerateConfigurationAsync(GetBucketAccelerateConfigurationRequest, CancellationToken)

Returns the accelerate configuration of a bucket.

Public Method GetBucketAnalyticsConfiguration(GetBucketAnalyticsConfigurationRequest)

Gets an analytics configuration for the bucket (specified by the analytics configuration ID).

Public Method GetBucketAnalyticsConfigurationAsync(GetBucketAnalyticsConfigurationRequest, CancellationToken)

Gets an analytics configuration for the bucket (specified by the analytics configuration ID).

Public Method GetBucketEncryption(GetBucketEncryptionRequest)

Returns the server-side encryption configuration of a bucket.

Public Method GetBucketEncryptionAsync(GetBucketEncryptionRequest, CancellationToken)

Returns the server-side encryption configuration of a bucket.

Public Method GetBucketInventoryConfiguration(GetBucketInventoryConfigurationRequest)

Returns an inventory configuration (identified by the inventory ID) from the bucket.

Public Method GetBucketInventoryConfigurationAsync(GetBucketInventoryConfigurationRequest, CancellationToken)

Returns an inventory configuration (identified by the inventory ID) from the bucket.

Public Method GetBucketLocation(string)

Returns the region the bucket resides in.

Public Method GetBucketLocation(GetBucketLocationRequest)

Returns the region the bucket resides in.

Public Method GetBucketLocationAsync(string, CancellationToken)

Returns the region the bucket resides in.

Public Method GetBucketLocationAsync(GetBucketLocationRequest, CancellationToken)

Returns the region the bucket resides in.

Public Method GetBucketLogging(string)

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

Public Method GetBucketLogging(GetBucketLoggingRequest)

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

Public Method GetBucketLoggingAsync(string, CancellationToken)

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

Public Method GetBucketLoggingAsync(GetBucketLoggingRequest, CancellationToken)

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

Public Method GetBucketMetricsConfiguration(GetBucketMetricsConfigurationRequest)

Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.

Public Method GetBucketMetricsConfigurationAsync(GetBucketMetricsConfigurationRequest, CancellationToken)

Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.

Public Method GetBucketNotification(string)

Returns the notification configuration of a bucket.

Public Method GetBucketNotification(GetBucketNotificationRequest)

Returns the notification configuration of a bucket.

Public Method GetBucketNotificationAsync(string, CancellationToken)

Returns the notification configuration of a bucket.

Public Method GetBucketNotificationAsync(GetBucketNotificationRequest, CancellationToken)

Returns the notification configuration of a bucket.

Public Method GetBucketPolicy(string)

Returns the policy of a specified bucket.

Public Method GetBucketPolicy(GetBucketPolicyRequest)

Returns the policy of a specified bucket.

Public Method GetBucketPolicyAsync(string, CancellationToken)

Returns the policy of a specified bucket.

Public Method GetBucketPolicyAsync(GetBucketPolicyRequest, CancellationToken)

Returns the policy of a specified bucket.

Public Method GetBucketPolicyStatus(GetBucketPolicyStatusRequest)

Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public.

Public Method GetBucketPolicyStatusAsync(GetBucketPolicyStatusRequest, CancellationToken)

Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public.

Public Method GetBucketReplication(GetBucketReplicationRequest)

Retrieves the replication configuration for the given Amazon S3 bucket.

Public Method GetBucketReplicationAsync(GetBucketReplicationRequest, CancellationToken)

Retrieves the replication configuration for the given Amazon S3 bucket.

Public Method GetBucketRequestPayment(string)

Returns the request payment configuration of a bucket.

Public Method GetBucketRequestPayment(GetBucketRequestPaymentRequest)

Returns the request payment configuration of a bucket.

Public Method GetBucketRequestPaymentAsync(string, CancellationToken)

Returns the request payment configuration of a bucket.

Public Method GetBucketRequestPaymentAsync(GetBucketRequestPaymentRequest, CancellationToken)

Returns the request payment configuration of a bucket.

Public Method GetBucketTagging(GetBucketTaggingRequest)

Returns the tag set associated with the bucket.

Public Method GetBucketTaggingAsync(GetBucketTaggingRequest, CancellationToken)

Returns the tag set associated with the bucket.

Public Method GetBucketVersioning(string)

Returns the versioning state of a bucket.

Public Method GetBucketVersioning(GetBucketVersioningRequest)

Returns the versioning state of a bucket.

Public Method GetBucketVersioningAsync(string, CancellationToken)

Returns the versioning state of a bucket.

Public Method GetBucketVersioningAsync(GetBucketVersioningRequest, CancellationToken)

Returns the versioning state of a bucket.

Public Method GetBucketWebsite(string)

Returns the website configuration for a bucket.

Public Method GetBucketWebsite(GetBucketWebsiteRequest)

Returns the website configuration for a bucket.

Public Method GetBucketWebsiteAsync(string, CancellationToken)

Returns the website configuration for a bucket.

Public Method GetBucketWebsiteAsync(GetBucketWebsiteRequest, CancellationToken)

Returns the website configuration for a bucket.

Public Method GetCORSConfiguration(string)

Returns the CORS configuration for the bucket.

Public Method GetCORSConfiguration(GetCORSConfigurationRequest)

Returns the CORS configuration for the bucket.

Public Method GetCORSConfigurationAsync(string, CancellationToken)

Returns the CORS configuration for the bucket.

Public Method GetCORSConfigurationAsync(GetCORSConfigurationRequest, CancellationToken)

Returns the CORS configuration for the bucket.

Public Method GetLifecycleConfiguration(string)

Returns the lifecycle configuration information set on the bucket.

Public Method GetLifecycleConfiguration(GetLifecycleConfigurationRequest)

Returns the lifecycle configuration information set on the bucket.

Public Method GetLifecycleConfigurationAsync(string, CancellationToken)

Returns the lifecycle configuration information set on the bucket.

Public Method GetLifecycleConfigurationAsync(GetLifecycleConfigurationRequest, CancellationToken)

Returns the lifecycle configuration information set on the bucket.

Public Method GetObject(string, string)

Retrieves objects from Amazon S3.

Public Method GetObject(string, string, string)

Retrieves objects from Amazon S3.

Public Method GetObject(GetObjectRequest)

Retrieves objects from Amazon S3.

Public Method GetObjectAsync(string, string, CancellationToken)

Retrieves objects from Amazon S3.

Public Method GetObjectAsync(string, string, string, CancellationToken)

Retrieves objects from Amazon S3.

Public Method GetObjectAsync(GetObjectRequest, CancellationToken)

Retrieves objects from Amazon S3.

Public Method GetObjectLegalHold(GetObjectLegalHoldRequest)

Gets an object's current Legal Hold status.

Public Method GetObjectLegalHoldAsync(GetObjectLegalHoldRequest, CancellationToken)

Gets an object's current Legal Hold status.

Public Method GetObjectLockConfiguration(GetObjectLockConfigurationRequest)

Gets the object lock configuration for a bucket. The rule specified in the object lock configuration will be applied by default to every new object placed in the specified bucket.

Public Method GetObjectLockConfigurationAsync(GetObjectLockConfigurationRequest, CancellationToken)

Gets the object lock configuration for a bucket. The rule specified in the object lock configuration will be applied by default to every new object placed in the specified bucket.

Public Method GetObjectMetadata(string, string)

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

Public Method GetObjectMetadata(string, string, string)

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

Public Method GetObjectMetadata(GetObjectMetadataRequest)

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

Public Method GetObjectMetadataAsync(string, string, CancellationToken)

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

Public Method GetObjectMetadataAsync(string, string, string, CancellationToken)

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

Public Method GetObjectMetadataAsync(GetObjectMetadataRequest, CancellationToken)

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

Public Method GetObjectRetention(GetObjectRetentionRequest)

Retrieves an object's retention settings.

Public Method GetObjectRetentionAsync(GetObjectRetentionRequest, CancellationToken)

Retrieves an object's retention settings.

Public Method GetObjectTagging(GetObjectTaggingRequest)

Returns the tag-set of an object.

Public Method GetObjectTaggingAsync(GetObjectTaggingRequest, CancellationToken)

Returns the tag-set of an object.

Public Method GetObjectTorrent(string, string)

Return torrent files from a bucket.

Public Method GetObjectTorrent(GetObjectTorrentRequest)

Return torrent files from a bucket.

Public Method GetObjectTorrentAsync(string, string, CancellationToken)

Return torrent files from a bucket.

Public Method GetObjectTorrentAsync(GetObjectTorrentRequest, CancellationToken)

Return torrent files from a bucket.

Public Method GetPreSignedURL(GetPreSignedUrlRequest)

Create a signed URL allowing access to a resource that would usually require authentication.

Public Method GetPublicAccessBlock(GetPublicAccessBlockRequest)

Retrieves the PublicAccessBlock configuration for an Amazon S3 bucket.

Public Method GetPublicAccessBlockAsync(GetPublicAccessBlockRequest, CancellationToken)

Retrieves the PublicAccessBlock configuration for an Amazon S3 bucket.

Public Method InitiateMultipartUpload(string, string)

Initiates a multipart upload and returns an upload ID.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Public Method InitiateMultipartUpload(InitiateMultipartUploadRequest)

Initiates a multipart upload and returns an upload ID.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Public Method InitiateMultipartUploadAsync(string, string, CancellationToken)

Initiates a multipart upload and returns an upload ID.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Public Method InitiateMultipartUploadAsync(InitiateMultipartUploadRequest, CancellationToken)

Initiates a multipart upload and returns an upload ID.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Public Method ListBucketAnalyticsConfigurations(ListBucketAnalyticsConfigurationsRequest)

Lists the analytics configurations for the bucket.

Public Method ListBucketAnalyticsConfigurationsAsync(ListBucketAnalyticsConfigurationsRequest, CancellationToken)

Lists the analytics configurations for the bucket.

Public Method ListBucketInventoryConfigurations(ListBucketInventoryConfigurationsRequest)

Returns a list of inventory configurations for the bucket.

Public Method ListBucketInventoryConfigurationsAsync(ListBucketInventoryConfigurationsRequest, CancellationToken)

Returns a list of inventory configurations for the bucket.

Public Method ListBucketMetricsConfigurations(ListBucketMetricsConfigurationsRequest)

Lists the metrics configurations for the bucket.

Public Method ListBucketMetricsConfigurationsAsync(ListBucketMetricsConfigurationsRequest, CancellationToken)

Lists the metrics configurations for the bucket.

Public Method ListBuckets()

Returns a list of all buckets owned by the authenticated sender of the request.

Public Method ListBuckets(ListBucketsRequest)

Returns a list of all buckets owned by the authenticated sender of the request.

Public Method ListBucketsAsync(CancellationToken)

Returns a list of all buckets owned by the authenticated sender of the request.

Public Method ListBucketsAsync(ListBucketsRequest, CancellationToken)

Returns a list of all buckets owned by the authenticated sender of the request.

Public Method ListMultipartUploads(string)

This operation lists in-progress multipart uploads.

Public Method ListMultipartUploads(string, string)

This operation lists in-progress multipart uploads.

Public Method ListMultipartUploads(ListMultipartUploadsRequest)

This operation lists in-progress multipart uploads.

Public Method ListMultipartUploadsAsync(string, CancellationToken)

This operation lists in-progress multipart uploads.

Public Method ListMultipartUploadsAsync(string, string, CancellationToken)

This operation lists in-progress multipart uploads.

Public Method ListMultipartUploadsAsync(ListMultipartUploadsRequest, CancellationToken)

This operation lists in-progress multipart uploads.

Public Method ListObjects(string)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Public Method ListObjects(string, string)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Public Method ListObjects(ListObjectsRequest)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Public Method ListObjectsAsync(string, CancellationToken)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Public Method ListObjectsAsync(string, string, CancellationToken)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Public Method ListObjectsAsync(ListObjectsRequest, CancellationToken)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Public Method ListObjectsV2(ListObjectsV2Request)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. Note: ListObjectsV2 is the revised List Objects API and we recommend you use this revised API for new application development.

Public Method ListObjectsV2Async(ListObjectsV2Request, CancellationToken)

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. Note: ListObjectsV2 is the revised List Objects API and we recommend you use this revised API for new application development.

Public Method ListParts(string, string, string)

Lists the parts that have been uploaded for a specific multipart upload.

Public Method ListParts(ListPartsRequest)

Lists the parts that have been uploaded for a specific multipart upload.

Public Method ListPartsAsync(ListPartsRequest, CancellationToken)

Lists the parts that have been uploaded for a specific multipart upload.

Public Method ListPartsAsync(string, string, string, CancellationToken)

Lists the parts that have been uploaded for a specific multipart upload.

Public Method ListVersions(string)

Returns metadata about all of the versions of objects in a bucket.

Public Method ListVersions(string, string)

Returns metadata about all of the versions of objects in a bucket.

Public Method ListVersions(ListVersionsRequest)

Returns metadata about all of the versions of objects in a bucket.

Public Method ListVersionsAsync(string, CancellationToken)

Returns metadata about all of the versions of objects in a bucket.

Public Method ListVersionsAsync(string, string, CancellationToken)

Returns metadata about all of the versions of objects in a bucket.

Public Method ListVersionsAsync(ListVersionsRequest, CancellationToken)

Returns metadata about all of the versions of objects in a bucket.

Public Method PutACL(PutACLRequest)

Sets the permissions on a bucket using access control lists (ACL).

Public Method PutACLAsync(PutACLRequest, CancellationToken)

Sets the permissions on a bucket using access control lists (ACL).

Public Method PutBucket(string)

Creates a new bucket.

Public Method PutBucket(PutBucketRequest)

Creates a new bucket.

Public Method PutBucketAccelerateConfiguration(PutBucketAccelerateConfigurationRequest)

Sets the accelerate configuration of an existing bucket.

Public Method PutBucketAccelerateConfigurationAsync(PutBucketAccelerateConfigurationRequest, CancellationToken)

Sets the accelerate configuration of an existing bucket.

Public Method PutBucketAnalyticsConfiguration(PutBucketAnalyticsConfigurationRequest)

Sets an analytics configuration for the bucket (specified by the analytics configuration ID).

Public Method PutBucketAnalyticsConfigurationAsync(PutBucketAnalyticsConfigurationRequest, CancellationToken)

Sets an analytics configuration for the bucket (specified by the analytics configuration ID).

Public Method PutBucketAsync(string, CancellationToken)

Creates a new bucket.

Public Method PutBucketAsync(PutBucketRequest, CancellationToken)

Creates a new bucket.

Public Method PutBucketEncryption(PutBucketEncryptionRequest)

Creates a new server-side encryption configuration (or replaces an existing one, if present).

Public Method PutBucketEncryptionAsync(PutBucketEncryptionRequest, CancellationToken)

Creates a new server-side encryption configuration (or replaces an existing one, if present).

Public Method PutBucketInventoryConfiguration(PutBucketInventoryConfigurationRequest)

Adds an inventory configuration (identified by the inventory ID) from the bucket.

Public Method PutBucketInventoryConfigurationAsync(PutBucketInventoryConfigurationRequest, CancellationToken)

Adds an inventory configuration (identified by the inventory ID) from the bucket.

Public Method PutBucketLogging(PutBucketLoggingRequest)

Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. To set the logging status of a bucket, you must be the bucket owner.

Public Method PutBucketLoggingAsync(PutBucketLoggingRequest, CancellationToken)

Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. To set the logging status of a bucket, you must be the bucket owner.

Public Method PutBucketMetricsConfiguration(PutBucketMetricsConfigurationRequest)

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.

Public Method PutBucketMetricsConfigurationAsync(PutBucketMetricsConfigurationRequest, CancellationToken)

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.

Public Method PutBucketNotification(PutBucketNotificationRequest)

Enables notifications of specified events for a bucket.

Public Method PutBucketNotificationAsync(PutBucketNotificationRequest, CancellationToken)

Enables notifications of specified events for a bucket.

Public Method PutBucketPolicy(string, string)

Applies an Amazon S3 bucket policy to an Amazon S3 bucket.

Public Method PutBucketPolicy(string, string, string)

Applies an Amazon S3 bucket policy to an Amazon S3 bucket.

Public Method PutBucketPolicy(PutBucketPolicyRequest)

Applies an Amazon S3 bucket policy to an Amazon S3 bucket.

Public Method PutBucketPolicyAsync(string, string, CancellationToken)

Applies an Amazon S3 bucket policy to an Amazon S3 bucket.

Public Method PutBucketPolicyAsync(string, string, string, CancellationToken)

Applies an Amazon S3 bucket policy to an Amazon S3 bucket.

Public Method PutBucketPolicyAsync(PutBucketPolicyRequest, CancellationToken)

Applies an Amazon S3 bucket policy to an Amazon S3 bucket.

Public Method PutBucketReplication(PutBucketReplicationRequest)

Creates a replication configuration or replaces an existing one. For more information, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.

Public Method PutBucketReplicationAsync(PutBucketReplicationRequest, CancellationToken)

Creates a replication configuration or replaces an existing one. For more information, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.

Public Method PutBucketRequestPayment(string, RequestPaymentConfiguration)

Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Public Method PutBucketRequestPayment(PutBucketRequestPaymentRequest)

Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Public Method PutBucketRequestPaymentAsync(string, RequestPaymentConfiguration, CancellationToken)

Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Public Method PutBucketRequestPaymentAsync(PutBucketRequestPaymentRequest, CancellationToken)

Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Public Method PutBucketTagging(string, List<Tag>)

Sets the tags for a bucket.

Public Method PutBucketTagging(PutBucketTaggingRequest)

Sets the tags for a bucket.

Public Method PutBucketTaggingAsync(string, List<Tag>, CancellationToken)

Sets the tags for a bucket.

Public Method PutBucketTaggingAsync(PutBucketTaggingRequest, CancellationToken)

Sets the tags for a bucket.

Public Method PutBucketVersioning(PutBucketVersioningRequest)

Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.

Public Method PutBucketVersioningAsync(PutBucketVersioningRequest, CancellationToken)

Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.

Public Method PutBucketWebsite(string, WebsiteConfiguration)

Set the website configuration for a bucket.

Public Method PutBucketWebsite(PutBucketWebsiteRequest)

Set the website configuration for a bucket.

Public Method PutBucketWebsiteAsync(string, WebsiteConfiguration, CancellationToken)

Set the website configuration for a bucket.

Public Method PutBucketWebsiteAsync(PutBucketWebsiteRequest, CancellationToken)

Set the website configuration for a bucket.

Public Method PutCORSConfiguration(string, CORSConfiguration)

Sets the CORS configuration for a bucket.

Public Method PutCORSConfiguration(PutCORSConfigurationRequest)

Sets the CORS configuration for a bucket.

Public Method PutCORSConfigurationAsync(string, CORSConfiguration, CancellationToken)

Sets the CORS configuration for a bucket.

Public Method PutCORSConfigurationAsync(PutCORSConfigurationRequest, CancellationToken)

Sets the CORS configuration for a bucket.

Public Method PutLifecycleConfiguration(string, LifecycleConfiguration)

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

Public Method PutLifecycleConfiguration(PutLifecycleConfigurationRequest)

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

Public Method PutLifecycleConfigurationAsync(string, LifecycleConfiguration, CancellationToken)

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

Public Method PutLifecycleConfigurationAsync(PutLifecycleConfigurationRequest, CancellationToken)

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

Public Method PutObject(PutObjectRequest)

Adds an object to a bucket.

Public Method PutObjectAsync(PutObjectRequest, CancellationToken)

Adds an object to a bucket.

Public Method PutObjectLegalHold(PutObjectLegalHoldRequest)

Applies a Legal Hold configuration to the specified object.

Public Method PutObjectLegalHoldAsync(PutObjectLegalHoldRequest, CancellationToken)

Applies a Legal Hold configuration to the specified object.

Public Method PutObjectLockConfiguration(PutObjectLockConfigurationRequest)

Places an object lock configuration on the specified bucket. The rule specified in the object lock configuration will be applied by default to every new object placed in the specified bucket.

Public Method PutObjectLockConfigurationAsync(PutObjectLockConfigurationRequest, CancellationToken)

Places an object lock configuration on the specified bucket. The rule specified in the object lock configuration will be applied by default to every new object placed in the specified bucket.

Public Method PutObjectRetention(PutObjectRetentionRequest)

Places an Object Retention configuration on an object.

Public Method PutObjectRetentionAsync(PutObjectRetentionRequest, CancellationToken)

Places an Object Retention configuration on an object.

Public Method PutObjectTagging(PutObjectTaggingRequest)

Sets the supplied tag-set to an object that already exists in a bucket

Public Method PutObjectTaggingAsync(PutObjectTaggingRequest, CancellationToken)

Sets the supplied tag-set to an object that already exists in a bucket

Public Method PutPublicAccessBlock(PutPublicAccessBlockRequest)

Creates or modifies the PublicAccessBlock configuration for an Amazon S3 bucket.

Public Method PutPublicAccessBlockAsync(PutPublicAccessBlockRequest, CancellationToken)

Creates or modifies the PublicAccessBlock configuration for an Amazon S3 bucket.

Public Method RestoreObject(string, string)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObject(string, string, int)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObject(string, string, string)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObject(string, string, string, int)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObject(RestoreObjectRequest)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObjectAsync(string, string, CancellationToken)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObjectAsync(string, string, int, CancellationToken)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObjectAsync(string, string, string, CancellationToken)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObjectAsync(string, string, string, int, CancellationToken)

Restores an archived copy of an object back into Amazon S3

Public Method RestoreObjectAsync(RestoreObjectRequest, CancellationToken)

Restores an archived copy of an object back into Amazon S3

Public Method SelectObjectContent(SelectObjectContentRequest)

This operation filters the contents of an Amazon S3 object based on a simple Structured Query Language (SQL) statement. In the request, along with the SQL expression, you must also specify a data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data into records, and returns only records that match the specified SQL expression. You must also specify the data serialization format for the response.

Public Method SelectObjectContentAsync(SelectObjectContentRequest, CancellationToken)

This operation filters the contents of an Amazon S3 object based on a simple Structured Query Language (SQL) statement. In the request, along with the SQL expression, you must also specify a data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data into records, and returns only records that match the specified SQL expression. You must also specify the data serialization format for the response.

Public Method UploadPart(UploadPartRequest)

Uploads a part in a multipart upload.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Public Method UploadPartAsync(UploadPartRequest, CancellationToken)

Uploads a part in a multipart upload.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Events

NameDescription
Event AfterResponseEvent Inherited from Amazon.Runtime.AmazonServiceClient.
Event BeforeRequestEvent Inherited from Amazon.Runtime.AmazonServiceClient.
Event ExceptionEvent Inherited from Amazon.Runtime.AmazonServiceClient.

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

Unity:
Supported Versions: 4.6 and above
Supported Platforms: Android, iOS, Standalone