Struct aws_sdk_rust::aws::s3::s3client::S3Client

pub struct S3Client<P, D> where P: AwsCredentialsProvider, D: DispatchSignedRequest {
    // some fields omitted
}

S3Client - Base client all Virtual Hosting S3 docs - http://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html

Methods

impl<P> S3Client<P, Client> where P: AwsCredentialsProvider

fn new(credentials_provider: P, endpoint: Endpoint) -> Self

impl<P, D> S3Client<P, D> where P: AwsCredentialsProvider, D: DispatchSignedRequest

fn with_request_dispatcher(request_dispatcher: D, credentials_provider: P, endpoint: Endpoint) -> Self

fn endpoint(&self) -> &Endpoint

fn create_bucket(&self, input: &CreateBucketRequest) -> Result<CreateBucketOutput, S3Error>

Creates a new bucket. All requests go to the us-east-1/us-standard endpoint, but can create buckets anywhere.

fn head_bucket(&self, input: &HeadBucketRequest) -> Result<(), S3Error>

head_bucket is good for seeing if a bucket exists and you have permission to access it. AWS will return 200 if it found it and you have permission. It will return 404 or 403 if the bucket is not found or you don't have permission.

head_bucket returns Ok(()) if found and you have permission else error.

fn list_buckets(&self) -> Result<ListBucketsOutput, S3Error>

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

fn put_bucket_lifecycle(&self, input: &PutBucketLifecycleRequest) -> Result<(), S3Error>

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

fn put_bucket_acl(&self, input: &PutBucketAclRequest) -> Result<(), S3Error>

fn put_bucket_policy(&self, input: &PutBucketPolicyRequest) -> Result<(), S3Error>

Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.

fn put_bucket_website(&self, input: &PutBucketWebsiteRequest) -> Result<(), S3Error>

Set the website configuration for a bucket.

fn put_bucket_logging(&self, input: &PutBucketLoggingRequest) -> Result<(), S3Error>

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.

fn put_bucket_replication(&self, input: &PutBucketReplicationRequest) -> Result<(), S3Error>

Creates a new replication configuration (or replaces an existing one, if present).

fn put_bucket_versioning(&self, input: &PutBucketVersioningRequest) -> Result<(), S3Error>

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

fn delete_bucket(&self, input: &DeleteBucketRequest) -> Result<(), S3Error>

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.

fn delete_bucket_tagging(&self, input: &DeleteBucketTaggingRequest) -> Result<(), S3Error>

Deletes the tags from the bucket.

fn delete_bucket_cors(&self, input: &DeleteBucketCorsRequest) -> Result<(), S3Error>

Deletes the cors configuration information set for the bucket.

fn delete_bucket_website(&self, input: &DeleteBucketWebsiteRequest) -> Result<(), S3Error>

This operation removes the website configuration from the bucket.

fn delete_bucket_policy(&self, input: &DeleteBucketPolicyRequest) -> Result<(), S3Error>

Deletes the policy from the bucket.

fn delete_bucket_replication(&self, input: &DeleteBucketReplicationRequest) -> Result<(), S3Error>

Deletes bucket replication.

fn get_bucket_cors(&self, input: &GetBucketCorsRequest) -> Result<GetBucketCorsOutput, S3Error>

Returns the cors configuration for the bucket.

fn get_bucket_acl(&self, input: &GetBucketAclRequest) -> Result<AccessControlPolicy, S3Error>

Gets the access control policy for the bucket.

fn get_bucket_logging(&self, input: &GetBucketLoggingRequest) -> Result<GetBucketLoggingOutput, S3Error>

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.

fn get_bucket_notification_configuration(&self, input: &GetBucketNotificationConfigurationRequest) -> Result<NotificationConfiguration, S3Error>

Returns the notification configuration of a bucket.

fn get_bucket_versioning(&self, input: &GetBucketVersioningRequest) -> Result<GetBucketVersioningOutput, S3Error>

fn list_objects(&self, input: &ListObjectsRequest) -> Result<ListObjectsOutput, S3Error>

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.

fn get_object(&self, input: &GetObjectRequest) -> Result<GetObjectOutput, S3Error>

Retrieves objects from Amazon S3.

fn get_value_for_header(header_name: String, response: &HttpResponse) -> Result<String, S3Error>

fn get_object_from_response(response: &mut HttpResponse) -> Result<GetObjectOutput, S3Error>

Use the Hyper resposne to populate the GetObjectOutput

fn copy_object(&self, input: &CopyObjectRequest) -> Result<CopyObjectOutput, S3Error>

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

fn create_multipart_upload(&self, input: &CreateMultipartUploadRequest) -> Result<CreateMultipartUploadOutput, S3Error>

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.

fn upload_part(&self, input: &UploadPartRequest) -> Result<String, S3Error>

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.

fn complete_multipart_upload(&self, input: &CompleteMultipartUploadRequest) -> Result<CompleteMultipartUploadOutput, S3Error>

Completes a multipart upload by assembling previously uploaded parts.

fn delete_objects(&self, input: &DeleteObjectsRequest) -> Result<DeleteObjectsOutput, S3Error>

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

fn delete_object(&self, input: &DeleteObjectRequest) -> Result<DeleteObjectOutput, S3Error>

fn restore_object(&self, input: &RestoreObjectRequest) -> Result<RestoreObjectOutput, S3Error>

Restores an archived copy of an object back into Amazon S3

fn put_object(&self, input: &PutObjectRequest) -> Result<PutObjectOutput, S3Error>

Adds an object to a bucket.

fn list_object_versions(&self, input: &ListObjectVersionsRequest) -> Result<ListVersionsResult, S3Error>

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

Trait Implementations

impl<P: Debug, D: Debug> Debug for S3Client<P, D> where P: AwsCredentialsProvider, D: DispatchSignedRequest

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.