AmazonS3 (AWS SDK for Android

Overview

Package

Class

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.amazonaws.services.s3
Interface AmazonS3

All Known Implementing Classes:: AmazonS3Client, AmazonS3EncryptionClient

public interface AmazonS3

Provides an interface for accessing the Amazon S3 web service.

Amazon S3 provides storage for the Internet, and is designed to make web-scale computing easier for developers.

The Amazon S3 Java SDK provides a simple interface that can be used to store and retrieve any amount of data, at any time, from anywhere on the web. It gives any developer access to the same highly scalable, reliable, secure, fast, inexpensive infrastructure that Amazon uses to run its own global network of web sites. The service aims to maximize benefits of scale and to pass those benefits on to developers.

For more information about Amazon S3, please see http://aws.amazon.com/s3

Method Summary
`void`	`abortMultipartUpload(AbortMultipartUploadRequest request)` Aborts a multipart upload.
`void`	`changeObjectStorageClass(String bucketName, String key, StorageClass newStorageClass)` Changes the Amazon S3 storage class for a specified object.
`CompleteMultipartUploadResult`	`completeMultipartUpload(CompleteMultipartUploadRequest request)` Completes a multipart upload by assembling previously uploaded parts.
`CopyObjectResult`	`copyObject(CopyObjectRequest copyObjectRequest)` Copies a source object to a new destination in Amazon S3.
`CopyObjectResult`	`copyObject(String sourceBucketName, String sourceKey, String destinationBucketName, String destinationKey)` Copies a source object to a new destination in Amazon S3.
`CopyPartResult`	`copyPart(CopyPartRequest copyPartRequest)` Copies a source object to a part of a multipart upload.
`Bucket`	`createBucket(CreateBucketRequest createBucketRequest)` Creates a new Amazon S3 bucket in the default region, `Region.US_Standard`.
`Bucket`	`createBucket(String bucketName)` Creates a new Amazon S3 bucket with the specified name in the default (US) region, `Region.US_Standard`.
`Bucket`	`createBucket(String bucketName, Region region)` Creates a new Amazon S3 bucket with the specified name in the specified Amazon S3 region.
`Bucket`	`createBucket(String bucketName, String region)` Creates a new Amazon S3 bucket with the specified name in the specified Amazon S3 region.
`void`	`deleteBucket(DeleteBucketRequest deleteBucketRequest)` Deletes the specified bucket.
`void`	`deleteBucket(String bucketName)` Deletes the specified bucket.
`void`	`deleteBucketCrossOriginConfiguration(String bucketName)` Delete the cross origin configuration for the specified bucket.
`void`	`deleteBucketLifecycleConfiguration(String bucketName)` Removes the lifecycle configuration for the bucket specified.
`void`	`deleteBucketPolicy(DeleteBucketPolicyRequest deleteBucketPolicyRequest)` Deletes the policy associated with the specified bucket.
`void`	`deleteBucketPolicy(String bucketName)` Deletes the policy associated with the specified bucket.
`void`	`deleteBucketTaggingConfiguration(String bucketName)` Removes the Tagging configuration for the bucket specified.
`void`	`deleteBucketWebsiteConfiguration(DeleteBucketWebsiteConfigurationRequest deleteBucketWebsiteConfigurationRequest)` This operation removes the website configuration for a bucket.
`void`	`deleteBucketWebsiteConfiguration(String bucketName)` This operation removes the website configuration for a bucket.
`void`	`deleteObject(DeleteObjectRequest deleteObjectRequest)` Deletes the specified object in the specified bucket.
`void`	`deleteObject(String bucketName, String key)` Deletes the specified object in the specified bucket.
`DeleteObjectsResult`	`deleteObjects(DeleteObjectsRequest deleteObjectsRequest)` Deletes multiple objects in a single bucket from S3.
`void`	`deleteVersion(DeleteVersionRequest deleteVersionRequest)` Deletes a specific version of an object in the specified bucket.
`void`	`deleteVersion(String bucketName, String key, String versionId)` Deletes a specific version of the specified object in the specified bucket.
`boolean`	`doesBucketExist(String bucketName)` Checks if the specified bucket exists.
`URL`	`generatePresignedUrl(GeneratePresignedUrlRequest generatePresignedUrlRequest)` Returns a pre-signed URL for accessing an Amazon S3 resource.
`URL`	`generatePresignedUrl(String bucketName, String key, Date expiration)` Returns a pre-signed URL for accessing an Amazon S3 resource.
`URL`	`generatePresignedUrl(String bucketName, String key, Date expiration, HttpMethod method)` Returns a pre-signed URL for accessing an Amazon S3 resource.
`AccessControlList`	`getBucketAcl(GetBucketAclRequest getBucketAclRequest)` Gets the `AccessControlList` (ACL) for the specified Amazon S3 bucket.
`AccessControlList`	`getBucketAcl(String bucketName)` Gets the `AccessControlList` (ACL) for the specified Amazon S3 bucket.
`BucketCrossOriginConfiguration`	`getBucketCrossOriginConfiguration(String bucketName)` Gets the cross origin configuration for the specified bucket, or null if no configuration has been established.
`BucketLifecycleConfiguration`	`getBucketLifecycleConfiguration(String bucketName)` Gets the lifecycle configuration for the specified bucket, or null if no configuration has been established.
`String`	`getBucketLocation(GetBucketLocationRequest getBucketLocationRequest)` Gets the geographical region where Amazon S3 stores the specified bucket.
`String`	`getBucketLocation(String bucketName)` Gets the geographical region where Amazon S3 stores the specified bucket.
`BucketLoggingConfiguration`	`getBucketLoggingConfiguration(String bucketName)` Gets the logging configuration for the specified bucket.
`BucketNotificationConfiguration`	`getBucketNotificationConfiguration(String bucketName)` Gets the notification configuration for the specified bucket.
`BucketPolicy`	`getBucketPolicy(GetBucketPolicyRequest getBucketPolicyRequest)` Gets the policy for the specified bucket.
`BucketPolicy`	`getBucketPolicy(String bucketName)` Gets the policy for the specified bucket.
`BucketTaggingConfiguration`	`getBucketTaggingConfiguration(String bucketName)` Gets the tagging configuration for the specified bucket, or null if no configuration has been established.
`BucketVersioningConfiguration`	`getBucketVersioningConfiguration(String bucketName)` Returns the versioning configuration for the specified bucket.
`BucketWebsiteConfiguration`	`getBucketWebsiteConfiguration(GetBucketWebsiteConfigurationRequest getBucketWebsiteConfigurationRequest)` Returns the website configuration for the specified bucket.
`BucketWebsiteConfiguration`	`getBucketWebsiteConfiguration(String bucketName)` Returns the website configuration for the specified bucket.
`S3ResponseMetadata`	`getCachedResponseMetadata(AmazonWebServiceRequest request)` Gets additional metadata for a previously executed successful request.
`S3Object`	`getObject(GetObjectRequest getObjectRequest)` Gets the object stored in Amazon S3 under the specified bucket and key.
`ObjectMetadata`	`getObject(GetObjectRequest getObjectRequest, File destinationFile)` Gets the object metadata for the object stored in Amazon S3 under the specified bucket and key, and saves the object contents to the specified file.
`S3Object`	`getObject(String bucketName, String key)` Gets the object stored in Amazon S3 under the specified bucket and key.
`AccessControlList`	`getObjectAcl(String bucketName, String key)` Gets the `AccessControlList` (ACL) for the specified object in Amazon S3.
`AccessControlList`	`getObjectAcl(String bucketName, String key, String versionId)` Gets the `AccessControlList` (ACL) for the specified object with the specified version in Amazon S3.
`ObjectMetadata`	`getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest)` Gets the metadata for the specified Amazon S3 object without actually fetching the object itself.
`ObjectMetadata`	`getObjectMetadata(String bucketName, String key)` Gets the metadata for the specified Amazon S3 object without actually fetching the object itself.
`Owner`	`getS3AccountOwner()` Gets the current owner of the AWS account that the authenticated sender of the request is using.
`InitiateMultipartUploadResult`	`initiateMultipartUpload(InitiateMultipartUploadRequest request)` Initiates a multipart upload and returns an InitiateMultipartUploadResult which contains an upload ID.
`List<Bucket>`	`listBuckets()` Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
`List<Bucket>`	`listBuckets(ListBucketsRequest listBucketsRequest)` Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
`MultipartUploadListing`	`listMultipartUploads(ListMultipartUploadsRequest request)` Lists in-progress multipart uploads.
`ObjectListing`	`listNextBatchOfObjects(ObjectListing previousObjectListing)` Provides an easy way to continue a truncated object listing and retrieve the next page of results.
`VersionListing`	`listNextBatchOfVersions(VersionListing previousVersionListing)` Provides an easy way to continue a truncated `VersionListing` and retrieve the next page of results.
`ObjectListing`	`listObjects(ListObjectsRequest listObjectsRequest)` Returns a list of summary information about the objects in the specified bucket.
`ObjectListing`	`listObjects(String bucketName)` Returns a list of summary information about the objects in the specified buckets.
`ObjectListing`	`listObjects(String bucketName, String prefix)` Returns a list of summary information about the objects in the specified bucket.
`PartListing`	`listParts(ListPartsRequest request)` Lists the parts that have been uploaded for a specific multipart upload.
`VersionListing`	`listVersions(ListVersionsRequest listVersionsRequest)` Returns a list of summary information about the versions in the specified bucket.
`VersionListing`	`listVersions(String bucketName, String prefix)` Returns a list of summary information about the versions in the specified bucket.
`VersionListing`	`listVersions(String bucketName, String prefix, String keyMarker, String versionIdMarker, String delimiter, Integer maxResults)` Returns a list of summary information about the versions in the specified bucket.
`PutObjectResult`	`putObject(PutObjectRequest putObjectRequest)` Uploads a new object to the specified Amazon S3 bucket.
`PutObjectResult`	`putObject(String bucketName, String key, File file)` Uploads the specified file to Amazon S3 under the specified bucket and key name.
`PutObjectResult`	`putObject(String bucketName, String key, InputStream input, ObjectMetadata metadata)` Uploads the specified input stream and object metadata to Amazon S3 under the specified bucket and key name.
`void`	`setBucketAcl(SetBucketAclRequest setBucketAclRequest)` Sets the `AccessControlList` for the specified Amazon S3 bucket.
`void`	`setBucketAcl(String bucketName, AccessControlList acl)` Sets the `AccessControlList` for the specified Amazon S3 bucket.
`void`	`setBucketAcl(String bucketName, CannedAccessControlList acl)` Sets the `CannedAccessControlList` for the specified Amazon S3 bucket using one of the pre-configured `CannedAccessControlLists`.
`void`	`setBucketCrossOriginConfiguration(String bucketName, BucketCrossOriginConfiguration bucketCrossOriginConfiguration)` Sets the cross origin configuration for the specified bucket.
`void`	`setBucketLifecycleConfiguration(String bucketName, BucketLifecycleConfiguration bucketLifecycleConfiguration)` Sets the lifecycle configuration for the specified bucket.
`void`	`setBucketLoggingConfiguration(SetBucketLoggingConfigurationRequest setBucketLoggingConfigurationRequest)` Sets the logging configuration for the specified bucket.
`void`	`setBucketNotificationConfiguration(String bucketName, BucketNotificationConfiguration bucketNotificationConfiguration)` Sets the notification configuration for the specified bucket.
`void`	`setBucketPolicy(SetBucketPolicyRequest setBucketPolicyRequest)` Sets the policy associated with the specified bucket.
`void`	`setBucketPolicy(String bucketName, String policyText)` Sets the policy associated with the specified bucket.
`void`	`setBucketTaggingConfiguration(String bucketName, BucketTaggingConfiguration bucketTaggingConfiguration)` Sets the tagging configuration for the specified bucket.
`void`	`setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest setBucketVersioningConfigurationRequest)` Sets the versioning configuration for the specified bucket.
`void`	`setBucketWebsiteConfiguration(SetBucketWebsiteConfigurationRequest setBucketWebsiteConfigurationRequest)` Sets the website configuration for the specified bucket.
`void`	`setBucketWebsiteConfiguration(String bucketName, BucketWebsiteConfiguration configuration)` Sets the website configuration for the specified bucket.
`void`	`setEndpoint(String endpoint)` Overrides the default endpoint for this client.
`void`	`setObjectAcl(String bucketName, String key, AccessControlList acl)` Sets the `AccessControlList` for the specified object in Amazon S3.
`void`	`setObjectAcl(String bucketName, String key, CannedAccessControlList acl)` Sets the `CannedAccessControlList` for the specified object in Amazon S3 using one of the pre-configured `CannedAccessControlLists`.
`void`	`setObjectAcl(String bucketName, String key, String versionId, AccessControlList acl)` Sets the `CannedAccessControlList` for the specified object with the specified version in Amazon S3.
`void`	`setObjectAcl(String bucketName, String key, String versionId, CannedAccessControlList acl)` Sets the `CannedAccessControlList` for the specified object with the specified version ID in Amazon S3 using one of the pre-configured `CannedAccessControlLists`.
`UploadPartResult`	`uploadPart(UploadPartRequest request)` Uploads a part in a multipart upload.

Method Detail

setEndpoint

void setEndpoint(String endpoint)

Overrides the default endpoint for this client. Use this method to send requests to the specified AWS region.

Pass the endpoint (e.g. "s3.amazonaws.com") or a full URL, including the protocol (e.g. "https://s3.amazonaws.com"). If the protocol is not specified, the protocol from this client's ClientConfiguration is used.

Parameters:: endpoint - The endpoint (e.g. "s3.amazonaws.com") or the full URL, including the protocol (e.g. "https://s3.amazonaws.com"), of the region-specific AWS endpoint this client will communicate with.
Throws:: IllegalArgumentException - If the specified endpoint is not a valid URL endpoint.

changeObjectStorageClass

void changeObjectStorageClass(String bucketName,
                              String key,
                              StorageClass newStorageClass)
                              throws AmazonClientException,
                                     AmazonServiceException

Changes the Amazon S3 storage class for a specified object. Amazon S3 offers multiple storage classes for developers' different needs.

Note that changing the storage class of an object in a bucket that has enabled versioning creates a new version of the object with the new storage class. The existing version of the object persists in the current storage class.

Parameters:: bucketName - The name of the bucket containing the object.; key - The key of the object within the specified bucket.; newStorageClass - The new storage class for the specified object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

listObjects

ObjectListing listObjects(String bucketName)
                          throws AmazonClientException,
                                 AmazonServiceException

Returns a list of summary information about the objects in the specified buckets. List results are always returned in lexicographic (alphabetical) order.

Because buckets can contain a virtually unlimited number of keys, the complete results of a list query can be extremely large. To manage large result sets, Amazon S3 uses pagination to split them into multiple responses. Always check the ObjectListing.isTruncated() method to see if the returned listing is complete or if additional calls are needed to get more results. Alternatively, use the AmazonS3Client.listNextBatchOfObjects(ObjectListing) method as an easy way to get the next page of object listings.

The total number of keys in a bucket doesn't substantially affect list performance.

Parameters:: bucketName - The name of the Amazon S3 bucket to list.
Returns:: A listing of the objects in the specified bucket, along with any other associated information, such as common prefixes (if a delimiter was specified), the original request parameters, etc.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listObjects(String, String), AmazonS3Client.listObjects(ListObjectsRequest)

listObjects

ObjectListing listObjects(String bucketName,
                          String prefix)
                          throws AmazonClientException,
                                 AmazonServiceException

Returns a list of summary information about the objects in the specified bucket. Depending on request parameters, additional information is returned, such as common prefixes if a delimiter was specified. List results are always returned in lexicographic (alphabetical) order.

For example, consider a bucket that contains the following keys:

"foo/bar/baz"
"foo/bar/bash"
"foo/bar/bang"
"foo/boo"

If calling listObjects with a prefix value of "foo/" and a delimiter value of "/" on this bucket, an ObjectListing is returned that contains one key ("foo/boo") and one entry in the common prefixes list ("foo/bar/"). To see deeper into the virtual hierarchy, make another call to listObjects setting the prefix parameter to any interesting common prefix to list the individual keys under that prefix.

The total number of keys in a bucket doesn't substantially affect list performance.

Parameters:: bucketName - The name of the Amazon S3 bucket to list.; prefix - An optional parameter restricting the response to keys beginning with the specified prefix. Use prefixes to separate a bucket into different sets of keys, similar to how a file system organizes files into directories.
Returns:: A listing of the objects in the specified bucket, along with any other associated information, such as common prefixes (if a delimiter was specified), the original request parameters, etc.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listObjects(String), AmazonS3Client.listObjects(ListObjectsRequest)

listObjects

ObjectListing listObjects(ListObjectsRequest listObjectsRequest)
                          throws AmazonClientException,
                                 AmazonServiceException

Returns a list of summary information about the objects in the specified bucket. Depending on the request parameters, additional information is returned, such as common prefixes if a delimiter was specified. List results are always returned in lexicographic (alphabetical) order.

Calling ListObjectsRequest.setDelimiter(String) sets the delimiter, allowing groups of keys that share the delimiter-terminated prefix to be included in the returned listing. This allows applications to organize and browse their keys hierarchically, similar to how a file system organizes files into directories. These common prefixes can be retrieved through the ObjectListing.getCommonPrefixes() method.

For example, consider a bucket that contains the following keys:

"foo/bar/baz"
"foo/bar/bash"
"foo/bar/bang"
"foo/boo"

If calling listObjects with a prefix value of "foo/" and a delimiter value of "/" on this bucket, an ObjectListing is returned that contains one key ("foo/boo") and one entry in the common prefixes list ("foo/bar/"). To see deeper into the virtual hierarchy, make another call to listObjects setting the prefix parameter to any interesting common prefix to list the individual keys under that prefix.

The total number of keys in a bucket doesn't substantially affect list performance.

Parameters:: listObjectsRequest - The request object containing all options for listing the objects in a specified bucket.
Returns:: A listing of the objects in the specified bucket, along with any other associated information, such as common prefixes (if a delimiter was specified), the original request parameters, etc.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listObjects(String), AmazonS3Client.listObjects(String, String)

listNextBatchOfObjects

ObjectListing listNextBatchOfObjects(ObjectListing previousObjectListing)
                                     throws AmazonClientException,
                                            AmazonServiceException

Provides an easy way to continue a truncated object listing and retrieve the next page of results.

To continue the object listing and retrieve the next page of results, call the initial ObjectListing from one of the listObjects methods. If truncated (indicated when ObjectListing.isTruncated() returns true), pass the ObjectListing back into this method in order to retrieve the next page of results. Continue using this method to retrieve more results until the returned ObjectListing indicates that it is not truncated.

Parameters:: previousObjectListing - The previous truncated ObjectListing. If a non-truncated ObjectListing is passed in, an empty ObjectListing is returned without ever contacting Amazon S3.
Returns:: The next set of ObjectListing results, beginning immediately after the last result in the specified previous ObjectListing.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listObjects(String), AmazonS3Client.listObjects(String, String), AmazonS3Client.listObjects(ListObjectsRequest)

listVersions

VersionListing listVersions(String bucketName,
                            String prefix)
                            throws AmazonClientException,
                                   AmazonServiceException

Returns a list of summary information about the versions in the specified bucket.

The returned version summaries are ordered first by key and then by version. Keys are sorted lexicographically (alphabetically) while versions are sorted from most recent to least recent. Both versions with data and delete markers are included in the results.

Because buckets can contain a virtually unlimited number of versions, the complete results of a list query can be extremely large. To manage large result sets, Amazon S3 uses pagination to split them into multiple responses. Always check the VersionListing.isTruncated() method to determine if the returned listing is complete or if additional calls are needed to get more results. Callers are encouraged to use listNextBatchOfVersions(VersionListing) as an easy way to get the next page of results.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: bucketName - The name of the Amazon S3 bucket whose versions are to be listed.; prefix - An optional parameter restricting the response to keys beginning with the specified prefix. Use prefixes to separate a bucket into different sets of keys, similar to how a file system organizes files into directories.
Returns:: A listing of the versions in the specified bucket, along with any other associated information and original request parameters.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listVersions(ListVersionsRequest), AmazonS3Client.listVersions(String, String, String, String, String, Integer)

listNextBatchOfVersions

VersionListing listNextBatchOfVersions(VersionListing previousVersionListing)
                                       throws AmazonClientException,
                                              AmazonServiceException

Provides an easy way to continue a truncated VersionListing and retrieve the next page of results.

Obtain the initial VersionListing from one of the listVersions methods. If the result is truncated (indicated when ObjectListing.isTruncated() returns true), pass the VersionListing back into this method in order to retrieve the next page of results. From there, continue using this method to retrieve more results until the returned VersionListing indicates that it is not truncated.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: previousVersionListing - The previous truncated VersionListing. If a non-truncated VersionListing is passed in, an empty VersionListing is returned without ever contacting Amazon S3.
Returns:: The next set of VersionListing results, beginning immediately after the last result in the specified previous VersionListing.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listVersions(String, String), AmazonS3Client.listVersions(ListVersionsRequest), AmazonS3Client.listVersions(String, String, String, String, String, Integer)

listVersions

VersionListing listVersions(String bucketName,
                            String prefix,
                            String keyMarker,
                            String versionIdMarker,
                            String delimiter,
                            Integer maxResults)
                            throws AmazonClientException,
                                   AmazonServiceException

Returns a list of summary information about the versions in the specified bucket.

The returned version summaries are ordered first by key and then by version. Keys are sorted lexicographically (alphabetically) and versions are sorted from most recent to least recent. Versions with data and delete markers are included in the results.

The keyMarker and versionIdMarker parameters allow callers to specify where to start the version listing.

The delimiter parameter allows groups of keys that share a delimiter-terminated prefix to be included in the returned listing. This allows applications to organize and browse their keys hierarchically, much like how a file system organizes files into directories. These common prefixes can be retrieved by calling the VersionListing.getCommonPrefixes() method.

For example, consider a bucket that contains the following keys:

"foo/bar/baz"
"foo/bar/bash"
"foo/bar/bang"
"foo/boo"

If calling listVersions with a prefix value of "foo/" and a delimiter value of "/" on this bucket, a VersionListing is returned that contains:

all the versions for one key ("foo/boo")
one entry in the common prefixes list ("foo/bar/")

To see deeper into the virtual hierarchy, make another call to listVersions setting the prefix parameter to any interesting common prefix to list the individual versions under that prefix.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: bucketName - The name of the Amazon S3 bucket whose versions are to be listed.; prefix - An optional parameter restricting the response to keys that begin with the specified prefix. Use prefixes to separate a bucket into different sets of keys, similar to how a file system organizes files into directories.; keyMarker - Optional parameter indicating where in the sorted list of all versions in the specified bucket to begin returning results. Results are always ordered first lexicographically (i.e. alphabetically) and then from most recent version to least recent version. If a keyMarker is used without a versionIdMarker, results begin immediately after that key's last version. When a keyMarker is used with a versionIdMarker, results begin immediately after the version with the specified key and version ID.
This enables pagination; to get the next page of results use the next key marker and next version ID marker (from VersionListing.getNextKeyMarker() and VersionListing.getNextVersionIdMarker()) as the markers for the next request to list versions, or use the convenience method listNextBatchOfVersions(VersionListing); versionIdMarker - Optional parameter indicating where in the sorted list of all versions in the specified bucket to begin returning results. Results are always ordered first lexicographically (i.e. alphabetically) and then from most recent version to least recent version. A keyMarker must be specified when specifying a versionIdMarker. Results begin immediately after the version with the specified key and version ID.
This enables pagination; to get the next page of results use the next key marker and next version ID marker (from VersionListing.getNextKeyMarker() and VersionListing.getNextVersionIdMarker()) as the markers for the next request to list versions, or use the convenience method listNextBatchOfVersions(VersionListing); delimiter - Optional parameter that causes keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the VersionListing.getCommonPrefixes() list. These rolled-up keys are not returned elsewhere in the response. The most commonly used delimiter is "/", which simulates a hierarchical organization similar to a file system directory structure.; maxResults - Optional parameter indicating the maximum number of results to include in the response. Amazon S3 might return fewer than this, but will not return more. Even if maxKeys is not specified, Amazon S3 will limit the number of results in the response.
Returns:: A listing of the versions in the specified bucket, along with any other associated information such as common prefixes (if a delimiter was specified), the original request parameters, etc.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listVersions(String, String), AmazonS3Client.listVersions(ListVersionsRequest), AmazonS3Client.listNextBatchOfVersions(VersionListing)

listVersions

VersionListing listVersions(ListVersionsRequest listVersionsRequest)
                            throws AmazonClientException,
                                   AmazonServiceException

Returns a list of summary information about the versions in the specified bucket.

The keyMarker and versionIdMarker parameters allow callers to specify where to start the version listing.

For example, consider a bucket that contains the following keys:

"foo/bar/baz"
"foo/bar/bash"
"foo/bar/bang"
"foo/boo"

If calling listVersions with a prefix value of "foo/" and a delimiter value of "/" on this bucket, a VersionListing is returned that contains:

all the versions for one key ("foo/boo")
one entry in the common prefixes list ("foo/bar/")

To see deeper into the virtual hierarchy, make another call to listVersions setting the prefix parameter to any interesting common prefix to list the individual versions under that prefix.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: listVersionsRequest - The request object containing all options for listing the versions in a specified bucket.
Returns:: A listing of the versions in the specified bucket, along with any other associated information such as common prefixes (if a delimiter was specified), the original request parameters, etc.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.listVersions(String, String), AmazonS3Client.listVersions(String, String, String, String, String, Integer), AmazonS3Client.listNextBatchOfVersions(VersionListing)

getS3AccountOwner

Owner getS3AccountOwner()
                        throws AmazonClientException,
                               AmazonServiceException

Gets the current owner of the AWS account that the authenticated sender of the request is using.

The caller must authenticate with a valid AWS Access Key ID that is registered with Amazon S3.

Returns:: The account of the authenticated sender
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

doesBucketExist

boolean doesBucketExist(String bucketName)
                        throws AmazonClientException,
                               AmazonServiceException

Checks if the specified bucket exists. Amazon S3 buckets are named in a global namespace; use this method to determine if a specified bucket name already exists, and therefore can't be used to create a new bucket.

Parameters:: bucketName - The name of the bucket to check.
Returns:: The value true if the specified bucket exists in Amazon S3; the value false if there is no bucket in Amazon S3 with that name.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: createBucket(CreateBucketRequest)

listBuckets

List<Bucket> listBuckets()
                         throws AmazonClientException,
                                AmazonServiceException

Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.

Users must authenticate with a valid AWS Access Key ID that is registered with Amazon S3. Anonymous requests cannot list buckets, and users cannot list buckets that they did not create.

Returns:: A list of all of the Amazon S3 buckets owned by the authenticated sender of the request.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: listBuckets(ListBucketsRequest)

listBuckets

List<Bucket> listBuckets(ListBucketsRequest listBucketsRequest)
                         throws AmazonClientException,
                                AmazonServiceException

Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.

Users must authenticate with a valid AWS Access Key ID that is registered with Amazon S3. Anonymous requests cannot list buckets, and users cannot list buckets that they did not create.

Parameters:: request - The request containing all of the options related to the listing of buckets.
Returns:: A list of all of the Amazon S3 buckets owned by the authenticated sender of the request.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: listBuckets()

getBucketLocation

String getBucketLocation(String bucketName)
                         throws AmazonClientException,
                                AmazonServiceException

Gets the geographical region where Amazon S3 stores the specified bucket.

To view the location constraint of a bucket, the user must be the bucket owner.

Use Region.fromValue(String) to get the Region enumeration value, but be prepared to handle an IllegalArgumentException if the value passed is not a known Region value.

Note that Region enumeration values are not returned directly from this method.

Parameters:: bucketName - The name of the Amazon S3 bucket to look up. This must be a bucket the user owns.
Returns:: The location of the specified Amazon S3 bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: Region

getBucketLocation

String getBucketLocation(GetBucketLocationRequest getBucketLocationRequest)
                         throws AmazonClientException,
                                AmazonServiceException

Gets the geographical region where Amazon S3 stores the specified bucket.

To view the location constraint of a bucket, the user must be the bucket owner.

Use Region.fromValue(String) to get the Region enumeration value, but be prepared to handle an IllegalArgumentException if the value passed is not a known Region value.

Note that Region enumeration values are not returned directly from this method.

Parameters:: getBucketLocationRequest - The request object containing the name of the Amazon S3 bucket to look up. This must be a bucket the user owns.
Returns:: The location of the specified Amazon S3 bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: Region

createBucket

Bucket createBucket(CreateBucketRequest createBucketRequest)
                    throws AmazonClientException,
                           AmazonServiceException

Creates a new Amazon S3 bucket in the default region, Region.US_Standard.

Every object stored in Amazon S3 is contained within a bucket. Buckets partition the namespace of objects stored in Amazon S3 at the top level. Within a bucket, any name can be used for objects. However, bucket names must be unique across all of Amazon S3.

Bucket ownership is similar to the ownership of Internet domain names. Within Amazon S3, only a single user owns each bucket. Once a uniquely named bucket is created in Amazon S3, organize and name the objects within the bucket in any way. Ownership of the bucket is retained as long as the owner has an Amazon S3 account.

To conform with DNS requirements, the following constraints apply:

Bucket names should not contain underscores
Bucket names should be between 3 and 63 characters long
Bucket names should not end with a dash
Bucket names cannot contain adjacent periods
Bucket names cannot contain dashes next to periods (e.g., "my-.bucket.com" and "my.-bucket" are invalid)
Bucket names cannot contain uppercase characters

There are no limits to the number of objects that can be stored in a bucket. Performance does not vary based on the number of buckets used. Store all objects within a single bucket or organize them across several buckets.

Buckets cannot be nested; buckets cannot be created within other buckets.

Do not make bucket create or delete calls in the high availability code path of an application. Create or delete buckets in a separate initialization or setup routine that runs less often.

To create a bucket, authenticate with an account that has a valid AWS Access Key ID and is registered with Amazon S3. Anonymous requests are never allowed to create buckets.

Parameters:: createBucketRequest - The request object containing all options for creating an Amazon S3 bucket.
Returns:: The newly created bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

createBucket

Bucket createBucket(String bucketName)
                    throws AmazonClientException,
                           AmazonServiceException

Creates a new Amazon S3 bucket with the specified name in the default (US) region, Region.US_Standard.

To conform with DNS requirements, the following constraints apply:

Bucket names should not contain underscores
Bucket names should be between 3 and 63 characters long
Bucket names should not end with a dash
Bucket names cannot contain adjacent periods
Bucket names cannot contain dashes next to periods (e.g., "my-.bucket.com" and "my.-bucket" are invalid)
Bucket names cannot contain uppercase characters

Buckets cannot be nested; buckets cannot be created within other buckets.

Do not make bucket create or delete calls in the high availability code path of an application. Create or delete buckets in a separate initialization or setup routine that runs less often.

To create a bucket, authenticate with an account that has a valid AWS Access Key ID and is registered with Amazon S3. Anonymous requests are never allowed to create buckets.

Parameters:: bucketName - The name of the bucket to create. All buckets in Amazon S3 share a single namespace; ensure the bucket is given a unique name.
Returns:: The newly created bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

createBucket

Bucket createBucket(String bucketName,
                    Region region)
                    throws AmazonClientException,
                           AmazonServiceException

Creates a new Amazon S3 bucket with the specified name in the specified Amazon S3 region.

To conform with DNS requirements, the following constraints apply:

Bucket names should not contain underscores
Bucket names should be between 3 and 63 characters long
Bucket names should not end with a dash
Bucket names cannot contain adjacent periods
Bucket names cannot contain dashes next to periods (e.g., "my-.bucket.com" and "my.-bucket" are invalid)
Bucket names cannot contain uppercase characters

Buckets cannot be nested; buckets cannot be created within other buckets.

Do not make bucket create or delete calls in the high availability code path of an application. Create or delete buckets in a separate initialization or setup routine that runs less often.

To create a bucket, authenticate with an account that has a valid AWS Access Key ID and is registered with Amazon S3. Anonymous requests are never allowed to create buckets.

Parameters:: bucketName - The name of the bucket to create.; region - The Amazon S3 region in which to create the new bucket.
Returns:: The newly created bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: Region

createBucket

Bucket createBucket(String bucketName,
                    String region)
                    throws AmazonClientException,
                           AmazonServiceException

Creates a new Amazon S3 bucket with the specified name in the specified Amazon S3 region. This method is provided for non-standard cases; use createBucket(String, Region) and pass in a Region enumeration value in standard cases.

To conform with DNS requirements, the following constraints apply:

Bucket names should not contain underscores
Bucket names should be between 3 and 63 characters long
Bucket names should not end with a dash
Bucket names cannot contain adjacent periods
Bucket names cannot contain dashes next to periods (e.g., "my-.bucket.com" and "my.-bucket" are invalid)
Bucket names cannot contain uppercase characters

Buckets cannot be nested; buckets cannot be created within other buckets.

Do not make bucket create or delete calls in the high availability code path of an application. Create or delete buckets in a separate initialization or setup routine that runs less often.

To create a bucket, authenticate with an account that has a valid AWS Access Key ID and is registered with Amazon S3. Anonymous requests are never allowed to create buckets.

Parameters:: bucketName - The name of the bucket to create.; region - The Amazon S3 region in which to create the new bucket.
Returns:: The newly created bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: Region

getObjectAcl

AccessControlList getObjectAcl(String bucketName,
                               String key)
                               throws AmazonClientException,
                                      AmazonServiceException

Gets the AccessControlList (ACL) for the specified object in Amazon S3.

Each bucket and object in Amazon S3 has an ACL that defines its access control policy. When a request is made, Amazon S3 authenticates the request using its standard authentication procedure and then checks the ACL to verify the sender was granted access to the bucket or object. If the sender is approved, the request proceeds. Otherwise, Amazon S3 returns an error.

Parameters:: bucketName - The name of the bucket containing the object whose ACL is being retrieved.; key - The key of the object within the specified bucket whose ACL is being retrieved.
Returns:: The AccessControlList for the specified Amazon S3 object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getObjectAcl(String, String, String)

getObjectAcl

AccessControlList getObjectAcl(String bucketName,
                               String key,
                               String versionId)
                               throws AmazonClientException,
                                      AmazonServiceException

Gets the AccessControlList (ACL) for the specified object with the specified version in Amazon S3. Each version of an object has its own associated ACL.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: bucketName - The name of the bucket containing the object whose ACL is being retrieved.; key - The key of the object within the specified bucket whose ACL is being retrieved.; versionId - The version ID of the object version whose ACL is being retrieved.
Returns:: The AccessControlList for the specified Amazon S3 object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getObjectAcl(String, String)

setObjectAcl

void setObjectAcl(String bucketName,
                  String key,
                  AccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Sets the AccessControlList for the specified object in Amazon S3.

When constructing a custom AccessControlList, callers typically retrieve the existing AccessControlList for an object ( AmazonS3Client.getObjectAcl(String, String)), modify it as necessary, and then use this method to upload the new ACL.

Parameters:: bucketName - The name of the bucket containing the object whose ACL is being set.; key - The key of the object within the specified bucket whose ACL is being set.; acl - The new AccessControlList for the specified object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setObjectAcl(String, String, CannedAccessControlList), setObjectAcl(String, String, String, AccessControlList), setObjectAcl(String, String, String, CannedAccessControlList)

setObjectAcl

void setObjectAcl(String bucketName,
                  String key,
                  CannedAccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Sets the CannedAccessControlList for the specified object in Amazon S3 using one of the pre-configured CannedAccessControlLists. A CannedAccessControlList provides a quick way to configure an object or bucket with commonly used access control policies.

Parameters:: bucketName - The name of the bucket containing the object whose ACL is being set.; key - The key of the object within the specified bucket whose ACL is being set.; acl - The new pre-configured CannedAccessControlList for the specified object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setObjectAcl(String, String, AccessControlList), setObjectAcl(String, String, String, AccessControlList), setObjectAcl(String, String, String, CannedAccessControlList)

setObjectAcl

void setObjectAcl(String bucketName,
                  String key,
                  String versionId,
                  AccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Sets the CannedAccessControlList for the specified object with the specified version in Amazon S3. Each version of an object has its own associated ACL.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: bucketName - The name of the bucket containing the object whose ACL is being set.; key - The key of the object within the specified bucket whose ACL is being set.; versionId - The version ID of the object version whose ACL is being set.; acl - The new AccessControlList for the specified object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setObjectAcl(String, String, AccessControlList), setObjectAcl(String, String, CannedAccessControlList), setObjectAcl(String, String, String, CannedAccessControlList)

setObjectAcl

void setObjectAcl(String bucketName,
                  String key,
                  String versionId,
                  CannedAccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Sets the CannedAccessControlList for the specified object with the specified version ID in Amazon S3 using one of the pre-configured CannedAccessControlLists. A CannedAccessControlList provides a quick way to configure an object or bucket with commonly used access control policies.

Each bucket and object in Amazon S3 has an ACL that defines its access control policy and each version of an object has its own associated ACL. When a request is made, Amazon S3 authenticates the request using its standard authentication procedure and then checks the ACL to verify the sender was granted access to the bucket or object. If the sender is approved, the request proceeds. Otherwise, Amazon S3 returns an error.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: bucketName - The name of the bucket containing the object whose ACL is being set.; key - The key of the object within the specified bucket whose ACL is being set.; versionId - The version ID of the object version whose ACL is being set.; acl - The new pre-configured CannedAccessControlList for the specified object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setObjectAcl(String, String, AccessControlList), setObjectAcl(String, String, CannedAccessControlList), setObjectAcl(String, String, String, AccessControlList)

getBucketAcl

AccessControlList getBucketAcl(String bucketName)
                               throws AmazonClientException,
                                      AmazonServiceException

Gets the AccessControlList (ACL) for the specified Amazon S3 bucket.

Parameters:: bucketName - The name of the bucket whose ACL is being retrieved.
Returns:: The AccessControlList for the specified S3 bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

setBucketAcl

void setBucketAcl(SetBucketAclRequest setBucketAclRequest)
                  throws AmazonClientException,
                         AmazonServiceException

Sets the AccessControlList for the specified Amazon S3 bucket.

When constructing a custom AccessControlList, callers typically retrieve the existing AccessControlList for a bucket ( AmazonS3Client.getBucketAcl(String)), modify it as necessary, and then use this method to upload the new ACL.

Parameters:: setBucketAclRequest - The request object containing the bucket to modify and the ACL to set.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

getBucketAcl

AccessControlList getBucketAcl(GetBucketAclRequest getBucketAclRequest)
                               throws AmazonClientException,
                                      AmazonServiceException

Gets the AccessControlList (ACL) for the specified Amazon S3 bucket.

Parameters:: getBucketAclRequest - The request containing the name of the bucket whose ACL is being retrieved.
Returns:: The AccessControlList for the specified S3 bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

setBucketAcl

void setBucketAcl(String bucketName,
                  AccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Sets the AccessControlList for the specified Amazon S3 bucket.

Parameters:: bucketName - The name of the bucket whose ACL is being set.; acl - The new AccessControlList for the specified bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setBucketAcl(String, CannedAccessControlList)

setBucketAcl

void setBucketAcl(String bucketName,
                  CannedAccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Sets the CannedAccessControlList for the specified Amazon S3 bucket using one of the pre-configured CannedAccessControlLists. A CannedAccessControlList provides a quick way to configure an object or bucket with commonly used access control policies.

Parameters:: bucketName - The name of the bucket whose ACL is being set.; acl - The pre-configured CannedAccessControlLists to set for the specified bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setBucketAcl(String, AccessControlList)

getObjectMetadata

ObjectMetadata getObjectMetadata(String bucketName,
                                 String key)
                                 throws AmazonClientException,
                                        AmazonServiceException

Gets the metadata for the specified Amazon S3 object without actually fetching the object itself. This is useful in obtaining only the object metadata, and avoids wasting bandwidth on fetching the object data.

The object metadata contains information such as content type, content disposition, etc., as well as custom user metadata that can be associated with an object in Amazon S3.

Parameters:: bucketName - The name of the bucket containing the object's whose metadata is being retrieved.; key - The key of the object whose metadata is being retrieved.
Returns:: All Amazon S3 object metadata for the specified object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getObjectMetadata(GetObjectMetadataRequest)

getObjectMetadata

ObjectMetadata getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest)
                                 throws AmazonClientException,
                                        AmazonServiceException

The object metadata contains information such as content type, content disposition, etc., as well as custom user metadata that can be associated with an object in Amazon S3.

For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

Parameters:: getObjectMetadataRequest - The request object specifying the bucket, key and optional version ID of the object whose metadata is being retrieved.
Returns:: All S3 object metadata for the specified object.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getObjectMetadata(String, String)

getObject

S3Object getObject(String bucketName,
                   String key)
                   throws AmazonClientException,
                          AmazonServiceException

Gets the object stored in Amazon S3 under the specified bucket and key.

Be extremely careful when using this method; the returned Amazon S3 object contains a direct stream of data from the HTTP connection. The underlying HTTP connection cannot be closed until the user finishes reading the data and closes the stream. Therefore:

Use the data from the input stream in Amazon S3 object as soon as possible
Close the input stream in Amazon S3 object as soon as possible

If these rules are not followed, the client can run out of resources by allocating too many open, but unused, HTTP connections.

To get an object from Amazon S3, the caller must have Permission.Read access to the object.

If the object fetched is publicly readable, it can also read it by pasting its URL into a browser.

For more advanced options (such as downloading only a range of an object's content, or placing constraints on when the object should be downloaded) callers can use getObject(GetObjectRequest).

Parameters:: bucketName - The name of the bucket containing the desired object.; key - The key under which the desired object is stored.
Returns:: The object stored in Amazon S3 in the specified bucket and key.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getObject(GetObjectRequest), getObject(GetObjectRequest, File)

getObject

S3Object getObject(GetObjectRequest getObjectRequest)
                   throws AmazonClientException,
                          AmazonServiceException

Gets the object stored in Amazon S3 under the specified bucket and key. Returns null if the specified constraints weren't met.

Callers should be very careful when using this method; the returned Amazon S3 object contains a direct stream of data from the HTTP connection. The underlying HTTP connection cannot be closed until the user finishes reading the data and closes the stream. Callers should therefore:

Use the data from the input stream in Amazon S3 object as soon as possible,
Close the input stream in Amazon S3 object as soon as possible.

If callers do not follow those rules, then the client can run out of resources if allocating too many open, but unused, HTTP connections.

To get an object from Amazon S3, the caller must have Permission.Read access to the object.

If the object fetched is publicly readable, it can also read it by pasting its URL into a browser.

When specifying constraints in the request object, the client needs to be prepared to handle this method returning null if the provided constraints aren't met when Amazon S3 receives the request.

If the advanced options provided in GetObjectRequest aren't needed, use the simpler getObject(String bucketName, String key) method.

Parameters:: getObjectRequest - The request object containing all the options on how to download the object.
Returns:: The object stored in Amazon S3 in the specified bucket and key. Returns null if constraints were specified but not met.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getObject(String, String), getObject(GetObjectRequest, File)

getObject

ObjectMetadata getObject(GetObjectRequest getObjectRequest,
                         File destinationFile)
                         throws AmazonClientException,
                                AmazonServiceException

Gets the object metadata for the object stored in Amazon S3 under the specified bucket and key, and saves the object contents to the specified file. Returns null if the specified constraints weren't met.

Instead of using getObject(GetObjectRequest), use this method to ensure that the underlying HTTP stream resources are automatically closed as soon as possible. The Amazon S3 clients handles immediate storage of the object contents to the specified file.

To get an object from Amazon S3, the caller must have Permission.Read access to the object.

If the object fetched is publicly readable, it can also read it by pasting its URL into a browser.

When specifying constraints in the request object, the client needs to be prepared to handle this method returning null if the provided constraints aren't met when Amazon S3 receives the request.

Parameters:: getObjectRequest - The request object containing all the options on how to download the Amazon S3 object content.; destinationFile - Indicates the file (which might already exist) where to save the object content being downloading from Amazon S3.
Returns:: All S3 object metadata for the specified object. Returns null if constraints were specified but not met.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request, handling the response, or writing the incoming data from S3 to the specified destination file.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getObject(String, String), getObject(GetObjectRequest)

deleteBucket

void deleteBucket(DeleteBucketRequest deleteBucketRequest)
                  throws AmazonClientException,
                         AmazonServiceException

Deletes the specified bucket. All objects (and all object versions, if versioning was ever enabled) in the bucket must be deleted before the bucket itself can be deleted.

Only the owner of a bucket can delete it, regardless of the bucket's access control policy (ACL).

Parameters:: deleteBucketRequest - The request object containing all options for deleting an Amazon S3 bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: deleteBucket(String)

deleteBucket

void deleteBucket(String bucketName)
                  throws AmazonClientException,
                         AmazonServiceException

Deletes the specified bucket. All objects (and all object versions, if versioning was ever enabled) in the bucket must be deleted before the bucket itself can be deleted.

Only the owner of a bucket can delete it, regardless of the bucket's access control policy.

Parameters:: bucketName - The name of the bucket to delete.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: deleteBucket(String)

putObject

PutObjectResult putObject(PutObjectRequest putObjectRequest)
                          throws AmazonClientException,
                                 AmazonServiceException

Uploads a new object to the specified Amazon S3 bucket. The PutObjectRequest contains all the details of the request, including the bucket to upload to, the key the object will be uploaded under, and the file or input stream containing the data to upload.

Amazon S3 never stores partial objects; if during this call an exception wasn't thrown, the entire object was stored.

Depending on whether a file or input stream is being uploaded, this method has slightly different behavior.

When uploading a file:

The client automatically computes a checksum of the file. Amazon S3 uses checksums to validate the data in each file.
Using the file extension, Amazon S3 attempts to determine the correct content type and content disposition to use for the object.

When uploading directly from an input stream:

Be careful to set the correct content type in the metadata object before directly sending a stream. Unlike file uploads, content types from input streams cannot be automatically determined. If the caller doesn't explicitly set the content type, it will not be set in Amazon S3.
Content length must be specified before data can be uploaded to Amazon S3. Amazon S3 explicitly requires that the content length be sent in the request headers before it will accept any of the data. If the caller doesn't provide the length, the library must buffer the contents of the input stream in order to calculate it.

If versioning is enabled for the specified bucket, this operation will never overwrite an existing object with the same key, but will keep the existing object as an older version until that version is explicitly deleted (see deleteVersion(String, String, String).

If versioning is not enabled, this operation will overwrite an existing object with the same key; Amazon S3 will store the last write request. Amazon S3 does not provide object locking. If Amazon S3 receives multiple write requests for the same object nearly simultaneously, all of the objects might be stored. However, a single object will be stored with the final write request.

When specifying a location constraint when creating a bucket, all objects added to the bucket are stored in the bucket's region. For example, if specifying a Europe (EU) region constraint for a bucket, all of that bucket's objects are stored in the EU region.

The specified bucket must already exist and the caller must have Permission.Write permission to the bucket to upload an object.

Parameters:: putObjectRequest - The request object containing all the parameters to upload a new object to Amazon S3.
Returns:: A PutObjectResult object containing the information returned by Amazon S3 for the newly created object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: putObject(String, String, File), putObject(String, String, InputStream, ObjectMetadata)

putObject

PutObjectResult putObject(String bucketName,
                          String key,
                          File file)
                          throws AmazonClientException,
                                 AmazonServiceException

Uploads the specified file to Amazon S3 under the specified bucket and key name.

Amazon S3 never stores partial objects; if during this call an exception wasn't thrown, the entire object was stored.

The client automatically computes a checksum of the file. Amazon S3 uses checksums to validate the data in each file.

Using the file extension, Amazon S3 attempts to determine the correct content type and content disposition to use for the object.

If versioning is enabled for the specified bucket, this operation will this operation will never overwrite an existing object with the same key, but will keep the existing object as an older version until that version is explicitly deleted (see deleteVersion(String, String, String).

The specified bucket must already exist and the caller must have Permission.Write permission to the bucket to upload an object.

Parameters:: bucketName - The name of an existing bucket, to which you have Permission.Write permission.; key - The key under which to store the specified file.; file - The file containing the data to be uploaded to Amazon S3.
Returns:: A PutObjectResult object containing the information returned by Amazon S3 for the newly created object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: putObject(PutObjectRequest), putObject(String, String, InputStream, ObjectMetadata)

putObject

PutObjectResult putObject(String bucketName,
                          String key,
                          InputStream input,
                          ObjectMetadata metadata)
                          throws AmazonClientException,
                                 AmazonServiceException

Uploads the specified input stream and object metadata to Amazon S3 under the specified bucket and key name.

Amazon S3 never stores partial objects; if during this call an exception wasn't thrown, the entire object was stored.

The client automatically computes a checksum of the file. This checksum is verified against another checksum that is calculated once the data reaches Amazon S3, ensuring the data has not corrupted in transit over the network.

Using the file extension, Amazon S3 attempts to determine the correct content type and content disposition to use for the object.

Content length must be specified before data can be uploaded to Amazon S3. If the caller doesn't provide it, the library will have to buffer the contents of the input stream in order to calculate it because Amazon S3 explicitly requires that the content length be sent in the request headers before any of the data is sent.

If versioning is enabled for the specified bucket, this operation will never overwrite an existing object at the same key, but instead will keep the existing object around as an older version until that version is explicitly deleted (see deleteVersion(String, String, String).

The specified bucket must already exist and the caller must have Permission.Write permission to the bucket to upload an object.

Parameters:: bucketName - The name of an existing bucket, to which you have Permission.Write permission.; key - The key under which to store the specified file.; input - The input stream containing the data to be uploaded to Amazon S3.; metadata - Additional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).
Returns:: A PutObjectResult object containing the information returned by Amazon S3 for the newly created object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: putObject(String, String, File), putObject(PutObjectRequest)

copyObject

CopyObjectResult copyObject(String sourceBucketName,
                            String sourceKey,
                            String destinationBucketName,
                            String destinationKey)
                            throws AmazonClientException,
                                   AmazonServiceException

Copies a source object to a new destination in Amazon S3.

By default, all object metadata for the source object are copied to the new destination object. The Amazon S3 AcccessControlList (ACL) is not copied to the new object; the new object will have the default Amazon S3 ACL, CannedAccessControlList.Private.

To copy an object, the caller's account must have read access to the source object and write access to the destination bucket

This method only exposes the basic options for copying an Amazon S3 object. Additional options are available by calling the AmazonS3Client.copyObject(CopyObjectRequest) method, including conditional constraints for copying objects, setting ACLs, overwriting object metadata, etc.

Parameters:: sourceBucketName - The name of the bucket containing the source object to copy.; sourceKey - The key in the source bucket under which the source object is stored.; destinationBucketName - The name of the bucket in which the new object will be created. This can be the same name as the source bucket's.; destinationKey - The key in the destination bucket under which the new object will be created.
Returns:: A CopyObjectResult object containing the information returned by Amazon S3 for the newly created object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.copyObject(CopyObjectRequest)

copyObject

CopyObjectResult copyObject(CopyObjectRequest copyObjectRequest)
                            throws AmazonClientException,
                                   AmazonServiceException

Copies a source object to a new destination in Amazon S3.

By default, all object metadata for the source object are copied to the new destination object, unless new object metadata in the specified CopyObjectRequest is provided.

The Amazon S3 Acccess Control List (ACL) is not copied to the new object. The new object will have the default Amazon S3 ACL, CannedAccessControlList.Private, unless one is explicitly provided in the specified CopyObjectRequest.

To copy an object, the caller's account must have read access to the source object and write access to the destination bucket.

If constraints are specified in the CopyObjectRequest (e.g. CopyObjectRequest.setMatchingETagConstraints(List)) and are not satisfied when Amazon S3 receives the request, this method returns null. This method returns a non-null result under all other circumstances.

This method exposes all the advanced options for copying an Amazon S3 object. For simple needs, use the AmazonS3Client.copyObject(String, String, String, String) method.

Parameters:: copyObjectRequest - The request object containing all the options for copying an Amazon S3 object.
Returns:: A CopyObjectResult object containing the information returned by Amazon S3 about the newly created object, or null if constraints were specified that weren't met when Amazon S3 attempted to copy the object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.copyObject(String, String, String, String)

copyPart

CopyPartResult copyPart(CopyPartRequest copyPartRequest)
                        throws AmazonClientException,
                               AmazonServiceException

Copies a source object to a part of a multipart upload. To copy an object, the caller's account must have read access to the source object and write access to the destination bucket.

If constraints are specified in the CopyPartRequest (e.g. CopyPartRequest.setMatchingETagConstraints(List)) and are not satisfied when Amazon S3 receives the request, this method returns null. This method returns a non-null result under all other circumstances.

Parameters:: copyPartRequest - The request object containing all the options for copying an Amazon S3 object.
Returns:: A CopyPartResult object containing the information returned by Amazon S3 about the newly created object, or null if constraints were specified that weren't met when Amazon S3 attempted to copy the object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.copyObject(CopyObjectRequest), AmazonS3Client.initiateMultipartUpload(InitiateMultipartUploadRequest)

deleteObject

void deleteObject(String bucketName,
                  String key)
                  throws AmazonClientException,
                         AmazonServiceException

Deletes the specified object in the specified bucket. Once deleted, the object can only be restored if versioning was enabled when the object was deleted.

If attempting to delete an object that does not exist, Amazon S3 returns a success message instead of an error message.

Parameters:: bucketName - The name of the Amazon S3 bucket containing the object to delete.; key - The key of the object to delete.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.deleteObject(DeleteObjectRequest)

deleteObject

void deleteObject(DeleteObjectRequest deleteObjectRequest)
                  throws AmazonClientException,
                         AmazonServiceException

Deletes the specified object in the specified bucket. Once deleted, the object can only be restored if versioning was enabled when the object was deleted.

If attempting to delete an object that does not exist, Amazon S3 will return a success message instead of an error message.

Parameters:: deleteObjectRequest - The request object containing all options for deleting an Amazon S3 object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: AmazonS3Client.deleteObject(String, String)

deleteObjects

DeleteObjectsResult deleteObjects(DeleteObjectsRequest deleteObjectsRequest)
                                  throws AmazonClientException,
                                         AmazonServiceException

Deletes multiple objects in a single bucket from S3.

In some cases, some objects will be successfully deleted, while some attempts will cause an error. If any object in the request cannot be deleted, this method throws a MultiObjectDeleteException with details of the error.

Parameters:: deleteObjectsRequest - The request object containing all options for deleting multiple objects.
Throws:: MultiObjectDeleteException - if one or more of the objects couldn't be deleted.; AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

deleteVersion

void deleteVersion(String bucketName,
                   String key,
                   String versionId)
                   throws AmazonClientException,
                          AmazonServiceException

Deletes a specific version of the specified object in the specified bucket. Once deleted, there is no method to restore or undelete an object version. This is the only way to permanently delete object versions that are protected by versioning.

Deleting an object version is permanent and irreversible. It is a privileged operation that only the owner of the bucket containing the version can perform.

Users can only delete a version of an object if versioning is enabled for the bucket. For more information about enabling versioning for a bucket, see setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

If attempting to delete an object that does not exist, Amazon S3 will return a success message instead of an error message.

Parameters:: bucketName - The name of the Amazon S3 bucket containing the object to delete.; key - The key of the object to delete.; versionId - The version of the object to delete.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

deleteVersion

void deleteVersion(DeleteVersionRequest deleteVersionRequest)
                   throws AmazonClientException,
                          AmazonServiceException

Deletes a specific version of an object in the specified bucket. Once deleted, there is no method to restore or undelete an object version. This is the only way to permanently delete object versions that are protected by versioning.

Deleting an object version is permanent and irreversible. It is a privileged operation that only the owner of the bucket containing the version can perform.

If attempting to delete an object that does not exist, Amazon S3 will return a success message instead of an error message.

Parameters:: deleteVersionRequest - The request object containing all options for deleting a specific version of an Amazon S3 object.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

getBucketLoggingConfiguration

BucketLoggingConfiguration getBucketLoggingConfiguration(String bucketName)
                                                         throws AmazonClientException,
                                                                AmazonServiceException

Gets the logging configuration for the specified bucket. The bucket logging configuration object indicates if server access logging is enabled the specified bucket, the destination bucket where server access logs are delivered, and the optional log file prefix.

Parameters:: bucketName - The name of the bucket whose bucket logging configuration is being retrieved.
Returns:: The bucket logging configuration for the specified bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setBucketLoggingConfiguration(SetBucketLoggingConfigurationRequest)

setBucketLoggingConfiguration

void setBucketLoggingConfiguration(SetBucketLoggingConfigurationRequest setBucketLoggingConfigurationRequest)
                                   throws AmazonClientException,
                                          AmazonServiceException

Sets the logging configuration for the specified bucket. The bucket logging configuration object indicates whether server access logging is enabled or not for the specified bucket, the destination bucket where server access logs are delivered, and the optional log file prefix.

In order to deliver server access logs, the destination bucket must have log delivery write permissions. You can use the CannedAccessControlList.LogDeliveryWrite ACL to quickly add the correct permissions to your destination bucket, or you can modify the bucket's existing ACL to grant the GroupGrantee.LogDelivery group grantee the Permission.Write permission.

Changes to the logging status for a bucket are visible in the configuration API immediately, but they take time to actually affect the delivery of log files. For example, if logging is enabled for a bucket, some requests made in the following hour might be logged, while others might not. Or, if you change the target bucket for logging from bucket A to bucket B, some logs for the next hour might continue to be delivered to bucket A, while others might be delivered to the new target bucket B. In all cases, the new settings will eventually take effect without any further action on your part.

Parameters:: setBucketLoggingConfigurationRequest - The request object containing all options for setting the bucket logging configuration.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getBucketLoggingConfiguration(String)

getBucketVersioningConfiguration

BucketVersioningConfiguration getBucketVersioningConfiguration(String bucketName)
                                                               throws AmazonClientException,
                                                                      AmazonServiceException

Returns the versioning configuration for the specified bucket.

A bucket's versioning configuration can be in one of three possible states:

By default, new buckets are in the off state. Once versioning is enabled for a bucket the status can never be reverted to off.

The versioning configuration of a bucket has different implications for each operation performed on that bucket or for objects within that bucket. For example, when versioning is enabled a PutObject operation creates a unique object version-id for the object being uploaded. The The PutObject API guarantees that, if versioning is enabled for a bucket at the time of the request, the new object can only be permanently deleted using a DeleteVersion operation. It can never be overwritten. Additionally, the PutObject API guarantees that, if versioning is enabled for a bucket the request, no other object will be overwritten by that request. Refer to the documentation sections for each API for information on how versioning status affects the semantics of that particular API.

Amazon S3 is eventually consistent. It can take time for the versioning status of a bucket to be propagated throughout the system.

Parameters:: bucketName - The bucket whose versioning configuration will be retrieved.
Returns:: The bucket versioning configuration for the specified bucket.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest)

setBucketVersioningConfiguration

void setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest setBucketVersioningConfigurationRequest)
                                      throws AmazonClientException,
                                             AmazonServiceException

Sets the versioning configuration for the specified bucket.

A bucket's versioning configuration can be in one of three possible states:

By default, new buckets are in the off state. Once versioning is enabled for a bucket the status can never be reverted to off.

Objects created before versioning was enabled or when versioning is suspended will be given the default null version ID (see Constants.NULL_VERSION_ID). Note that the null version ID is a valid version ID and is not the same as not having a version ID.

Amazon S3 is eventually consistent. It can take time for the versioning status of a bucket to be propagated throughout the system.

Parameters:: setBucketVersioningConfigurationRequest - The request object containing all options for setting the bucket versioning configuration.
Throws:: AmazonClientException - If any errors are encountered in the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.
See Also:: getBucketVersioningConfiguration(String)

getBucketLifecycleConfiguration

BucketLifecycleConfiguration getBucketLifecycleConfiguration(String bucketName)

Gets the lifecycle configuration for the specified bucket, or null if no configuration has been established.

Parameters:: bucketName - The name of the bucket for which to retrieve lifecycle configuration.

setBucketLifecycleConfiguration

void setBucketLifecycleConfiguration(String bucketName,
                                     BucketLifecycleConfiguration bucketLifecycleConfiguration)

Sets the lifecycle configuration for the specified bucket.

Parameters:: bucketName - The name of the bucket for which to set the lifecycle configuration.; bucketLifecycleConfiguration - The new lifecycle configuration for this bucket, which completely replaces any existing configuration.

deleteBucketLifecycleConfiguration

void deleteBucketLifecycleConfiguration(String bucketName)

Removes the lifecycle configuration for the bucket specified.

Parameters:: bucketName - The name of the bucket for which to remove the lifecycle configuration.

getBucketCrossOriginConfiguration

BucketCrossOriginConfiguration getBucketCrossOriginConfiguration(String bucketName)

Gets the cross origin configuration for the specified bucket, or null if no configuration has been established.

Parameters:: bucketName - The name of the bucket for which to retrieve cross origin configuration.

setBucketCrossOriginConfiguration

void setBucketCrossOriginConfiguration(String bucketName,
                                       BucketCrossOriginConfiguration bucketCrossOriginConfiguration)

Sets the cross origin configuration for the specified bucket.

Parameters:: bucketName - The name of the bucket for which to retrieve cross origin configuration.; bucketCrossOriginConfiguration - The new cross origin configuration for this bucket, which completely replaces any existing configuration.

deleteBucketCrossOriginConfiguration

void deleteBucketCrossOriginConfiguration(String bucketName)

Delete the cross origin configuration for the specified bucket.

Parameters:: bucketName - The name of the bucket for which to retrieve cross origin configuration.

getBucketTaggingConfiguration

BucketTaggingConfiguration getBucketTaggingConfiguration(String bucketName)

Gets the tagging configuration for the specified bucket, or null if no configuration has been established.

Parameters:: bucketName - The name of the bucket for which to retrieve tagging configuration.

setBucketTaggingConfiguration

void setBucketTaggingConfiguration(String bucketName,
                                   BucketTaggingConfiguration bucketTaggingConfiguration)

Sets the tagging configuration for the specified bucket.

Parameters:: bucketName - The name of the bucket for which to set the tagging configuration.; bucketTaggingConfiguration - The new tagging configuration for this bucket, which completely replaces any existing configuration.

deleteBucketTaggingConfiguration

void deleteBucketTaggingConfiguration(String bucketName)

Removes the Tagging configuration for the bucket specified.

Parameters:: bucketName - The name of the bucket for which to remove the tagging configuration.

getBucketNotificationConfiguration

BucketNotificationConfiguration getBucketNotificationConfiguration(String bucketName)
                                                                   throws AmazonClientException,
                                                                          AmazonServiceException

Gets the notification configuration for the specified bucket.

By default, new buckets have no notification configuration.

The notification configuration of a bucket provides near realtime notifications of events the user is interested in, using SNS as the delivery service. Notification is turned on by enabling configuration on a bucket, specifying the events and the SNS topic. This configuration can only be turned on by the bucket owner. If a notification configuration already exists for the specified bucket, the new notification configuration will replace the existing notification configuration. To remove the notification configuration pass in an empty request. Currently, buckets may only have a single event and topic configuration.

S3 is eventually consistent. It may take time for the notification status of a bucket to be propagated throughout the system.

Parameters:: bucketName - The bucket whose notification configuration will be retrieved.
Returns:: The bucket notification configuration for the specified bucket.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

setBucketNotificationConfiguration

void setBucketNotificationConfiguration(String bucketName,
                                        BucketNotificationConfiguration bucketNotificationConfiguration)
                                        throws AmazonClientException,
                                               AmazonServiceException

Sets the notification configuration for the specified bucket.

By default, new buckets have no notification configuration set.

S3 is eventually consistent. It may take time for the notification status of a bucket to be propagated throughout the system.

Parameters:: bucketName - The name of the Amazon S3 bucket whose notification configuration is being set.; bucketNotificationConfiguration - The request object containing all options for setting the bucket notification configuration.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

getBucketWebsiteConfiguration

BucketWebsiteConfiguration getBucketWebsiteConfiguration(String bucketName)
                                                         throws AmazonClientException,
                                                                AmazonServiceException

Returns the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.

For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.

This operation requires the S3:GetBucketWebsite permission. By default, only the bucket owner can read the bucket website configuration. However, bucket owners can allow other users to read the website configuration by writing a bucket policy granting them the S3:GetBucketWebsite permission.

Parameters:: bucketName - The name of the bucket whose website configuration is being retrieved.
Returns:: The bucket website configuration for the specified bucket, otherwise null if there is no website configuration set for the specified bucket.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

getBucketWebsiteConfiguration

BucketWebsiteConfiguration getBucketWebsiteConfiguration(GetBucketWebsiteConfigurationRequest getBucketWebsiteConfigurationRequest)
                                                         throws AmazonClientException,
                                                                AmazonServiceException

For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting. html.

Parameters:: getBucketWebsiteConfigurationRequest - The request object containing all the information on the specific bucket whose website configuration is to be retrieved.
Returns:: The bucket website configuration for the specified bucket, otherwise null if there is no website configuration set for the specified bucket.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

setBucketWebsiteConfiguration

void setBucketWebsiteConfiguration(String bucketName,
                                   BucketWebsiteConfiguration configuration)
                                   throws AmazonClientException,
                                          AmazonServiceException

Sets the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.

For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.

This operation requires the S3:PutBucketWebsite permission. By default, only the bucket owner can configure the website attached to a bucket. However, bucket owners can allow other users to set the website configuration by writing a bucket policy granting them the S3:PutBucketWebsite permission.

Parameters:: bucketName - The name of the bucket whose website configuration is being set.; configuration - The configuration describing how the specified bucket will serve web requests (i.e. default index page, error page).
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

setBucketWebsiteConfiguration

void setBucketWebsiteConfiguration(SetBucketWebsiteConfigurationRequest setBucketWebsiteConfigurationRequest)
                                   throws AmazonClientException,
                                          AmazonServiceException

For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting. html.

Parameters:: setBucketWebsiteConfigurationRequest - The request object containing the name of the bucket whose website configuration is being updated, and the new website configuration values.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

deleteBucketWebsiteConfiguration

void deleteBucketWebsiteConfiguration(String bucketName)
                                      throws AmazonClientException,
                                             AmazonServiceException

This operation removes the website configuration for a bucket. Calling this operation on a bucket with no website configuration does not throw an exception. Calling this operation a bucket that does not exist will throw an exception.

For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.

This operation requires the S3:DeleteBucketWebsite permission. By default, only the bucket owner can delete the website configuration attached to a bucket. However, bucket owners can grant other users permission to delete the website configuration by writing a bucket policy granting them the S3:DeleteBucketWebsite permission.

Parameters:: bucketName - The name of the bucket whose website configuration is being deleted.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

deleteBucketWebsiteConfiguration

void deleteBucketWebsiteConfiguration(DeleteBucketWebsiteConfigurationRequest deleteBucketWebsiteConfigurationRequest)
                                      throws AmazonClientException,
                                             AmazonServiceException

For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting. html.

Parameters:: deleteBucketWebsiteConfigurationRequest - The request object specifying the name of the bucket whose website configuration is to be deleted.
Throws:: AmazonClientException - If any errors are encountered on the client while making the request or handling the response.; AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

getBucketPolicy

BucketPolicy getBucketPolicy(String bucketName)
                             throws AmazonClientException,
                                    AmazonServiceException

Gets the policy for the specified bucket. Only the owner of the bucket can retrieve the policy. If no policy has been set for the bucket, then an empty result object with a null policy text field will be returned.