com.amazonaws.services.s3

Class AmazonS3Client

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.s3.AmazonS3Client

All Implemented Interfaces:

AmazonS3, com.amazonaws.services.s3.internal.S3DirectSpi

Direct Known Subclasses:

AmazonS3EncryptionClient

public class AmazonS3Client
extends AmazonWebServiceClient
implements AmazonS3

Provides the client 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 Android Client 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

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	S3_SERVICE_NAME

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Constructor Summary

Constructors

Constructor and Description
AmazonS3Client() Deprecated.
AmazonS3Client(AWSCredentials awsCredentials) Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentials, com.amazonaws.regions.Region) instead.
AmazonS3Client(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration) Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentials, com.amazonaws.regions.Region, ClientConfiguration) instead.
AmazonS3Client(AWSCredentialsProvider credentialsProvider) Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentialsProvider, com.amazonaws.regions.Region) instead.
AmazonS3Client(AWSCredentialsProvider credentialsProvider, ClientConfiguration clientConfiguration) Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentialsProvider, com.amazonaws.regions.Region, ClientConfiguration) instead.
AmazonS3Client(AWSCredentialsProvider credentialsProvider, ClientConfiguration clientConfiguration, HttpClient httpClient) Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentialsProvider, com.amazonaws.regions.Region, ClientConfiguration, HttpClient) instead.
AmazonS3Client(AWSCredentialsProvider credentialsProvider, ClientConfiguration clientConfiguration, com.amazonaws.metrics.RequestMetricCollector requestMetricCollector) Deprecated.
AmazonS3Client(AWSCredentialsProvider awsCredentialsProvider, Region region)
AmazonS3Client(AWSCredentialsProvider awsCredentialsProvider, Region region, ClientConfiguration clientConfiguration)
AmazonS3Client(AWSCredentialsProvider awsCredentialsProvider, Region region, ClientConfiguration clientConfiguration, HttpClient httpClient)
AmazonS3Client(AWSCredentials awsCredentials, Region region)
AmazonS3Client(AWSCredentials awsCredentials, Region region, ClientConfiguration clientConfiguration)
AmazonS3Client(AWSCredentials awsCredentials, Region region, ClientConfiguration clientConfiguration, HttpClient httpClient)
AmazonS3Client(ClientConfiguration clientConfiguration) Deprecated. Use AmazonS3Client#AmazonS3Client(ClientConfiguration, com.amazonaws.regions.Region) instead.
AmazonS3Client(ClientConfiguration clientConfiguration, Region region) Constructs a new client using the specified client configuration to access Amazon S3.

Method Summary

Modifier and Type	Method and Description
void	abortMultipartUpload(AbortMultipartUploadRequest abortMultipartUploadRequest) Aborts a multipart upload.
void	changeObjectStorageClass(java.lang.String bucketName, java.lang.String key, StorageClass newStorageClass) Changes the Amazon S3 storage class for a specified object.
CompleteMultipartUploadResult	completeMultipartUpload(CompleteMultipartUploadRequest completeMultipartUploadRequest) 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(java.lang.String sourceBucketName, java.lang.String sourceKey, java.lang.String destinationBucketName, java.lang.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(java.lang.String bucketName) Creates a new Amazon S3 bucket with the specified name in the default (US) region, Region.US_Standard.
Bucket	createBucket(java.lang.String bucketName, Region region) Creates a new Amazon S3 bucket with the specified name in the specified Amazon S3 region.
Bucket	createBucket(java.lang.String bucketName, java.lang.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(java.lang.String bucketName) Deletes the specified bucket.
DeleteBucketAnalyticsConfigurationResult	deleteBucketAnalyticsConfiguration(DeleteBucketAnalyticsConfigurationRequest deleteBucketAnalyticsConfigurationRequest) Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).
DeleteBucketAnalyticsConfigurationResult	deleteBucketAnalyticsConfiguration(java.lang.String bucketName, java.lang.String id) Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).
void	deleteBucketCrossOriginConfiguration(DeleteBucketCrossOriginConfigurationRequest deleteBucketCrossOriginConfigurationRequest) Delete the cross origin configuration for the specified bucket.
void	deleteBucketCrossOriginConfiguration(java.lang.String bucketName) Delete the cross origin configuration for the specified bucket.
DeleteBucketInventoryConfigurationResult	deleteBucketInventoryConfiguration(DeleteBucketInventoryConfigurationRequest deleteBucketInventoryConfigurationRequest) Deletes an inventory configuration (identified by the inventory ID) from the bucket.
DeleteBucketInventoryConfigurationResult	deleteBucketInventoryConfiguration(java.lang.String bucketName, java.lang.String id) Deletes an inventory configuration (identified by the inventory ID) from the bucket.
void	deleteBucketLifecycleConfiguration(DeleteBucketLifecycleConfigurationRequest deleteBucketLifecycleConfigurationRequest) Removes the lifecycle configuration for the bucket specified.
void	deleteBucketLifecycleConfiguration(java.lang.String bucketName) Removes the lifecycle configuration for the bucket specified.
DeleteBucketMetricsConfigurationResult	deleteBucketMetricsConfiguration(DeleteBucketMetricsConfigurationRequest deleteBucketMetricsConfigurationRequest) Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.
DeleteBucketMetricsConfigurationResult	deleteBucketMetricsConfiguration(java.lang.String bucketName, java.lang.String id) Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.
void	deleteBucketPolicy(DeleteBucketPolicyRequest deleteBucketPolicyRequest) Deletes the policy associated with the specified bucket.
void	deleteBucketPolicy(java.lang.String bucketName) Deletes the policy associated with the specified bucket.
void	deleteBucketReplicationConfiguration(DeleteBucketReplicationConfigurationRequest deleteBucketReplicationConfigurationRequest) Deletes the replication configuration for the given Amazon S3 bucket.
void	deleteBucketReplicationConfiguration(java.lang.String bucketName) Deletes the replication configuration for the given Amazon S3 bucket.
void	deleteBucketTaggingConfiguration(DeleteBucketTaggingConfigurationRequest deleteBucketTaggingConfigurationRequest) Removes the tagging configuration for the bucket specified.
void	deleteBucketTaggingConfiguration(java.lang.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(java.lang.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(java.lang.String bucketName, java.lang.String key) Deletes the specified object in the specified bucket.
DeleteObjectsResult	deleteObjects(DeleteObjectsRequest deleteObjectsRequest) Deletes multiple objects in a single bucket from S3.
DeleteObjectTaggingResult	deleteObjectTagging(DeleteObjectTaggingRequest deleteObjectTaggingRequest) Remove the tags for the specified object.
void	deleteVersion(DeleteVersionRequest deleteVersionRequest) Deletes a specific version of an object in the specified bucket.
void	deleteVersion(java.lang.String bucketName, java.lang.String key, java.lang.String versionId) Deletes a specific version of the specified object in the specified bucket.
void	disableRequesterPays(java.lang.String bucketName) Allows Amazon S3 bucket owner to disable the Requester Pays for the given bucket name.
boolean	doesBucketExist(java.lang.String bucketName) Checks if the specified bucket exists.
boolean	doesObjectExist(java.lang.String bucketName, java.lang.String objectName)
void	enableRequesterPays(java.lang.String bucketName) Allows Amazon S3 bucket owner to enable the Requester Pays for the given bucket name.
java.net.URL	generatePresignedUrl(GeneratePresignedUrlRequest generatePresignedUrlRequest) Returns a pre-signed URL for accessing an Amazon S3 resource.
java.net.URL	generatePresignedUrl(java.lang.String bucketName, java.lang.String key, java.util.Date expiration) Returns a pre-signed URL for accessing an Amazon S3 resource.
java.net.URL	generatePresignedUrl(java.lang.String bucketName, java.lang.String key, java.util.Date expiration, HttpMethod method) Returns a pre-signed URL for accessing an Amazon S3 resource.
BucketAccelerateConfiguration	getBucketAccelerateConfiguration(GetBucketAccelerateConfigurationRequest getBucketAccelerateConfigurationRequest) Retrieves the accelerate configuration for the given bucket.
BucketAccelerateConfiguration	getBucketAccelerateConfiguration(java.lang.String bucketName) Retrieves the accelerate configuration for the given bucket.
AccessControlList	getBucketAcl(GetBucketAclRequest getBucketAclRequest) Gets the AccessControlList (ACL) for the specified Amazon S3 bucket.
AccessControlList	getBucketAcl(java.lang.String bucketName) Gets the AccessControlList (ACL) for the specified Amazon S3 bucket.
GetBucketAnalyticsConfigurationResult	getBucketAnalyticsConfiguration(GetBucketAnalyticsConfigurationRequest getBucketAnalyticsConfigurationRequest) Gets an analytics configuration for the bucket (specified by the analytics configuration ID).
GetBucketAnalyticsConfigurationResult	getBucketAnalyticsConfiguration(java.lang.String bucketName, java.lang.String id) Gets an analytics configuration for the bucket (specified by the analytics configuration ID).
BucketCrossOriginConfiguration	getBucketCrossOriginConfiguration(GetBucketCrossOriginConfigurationRequest getBucketCrossOriginConfigurationRequest) Gets the cross origin configuration for the specified bucket, or null if no configuration has been established.
BucketCrossOriginConfiguration	getBucketCrossOriginConfiguration(java.lang.String bucketName) Gets the cross origin configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.
GetBucketInventoryConfigurationResult	getBucketInventoryConfiguration(GetBucketInventoryConfigurationRequest getBucketInventoryConfigurationRequest) Returns an inventory configuration (identified by the inventory ID) from the bucket.
GetBucketInventoryConfigurationResult	getBucketInventoryConfiguration(java.lang.String bucketName, java.lang.String id) Returns an inventory configuration (identified by the inventory ID) from the bucket.
BucketLifecycleConfiguration	getBucketLifecycleConfiguration(GetBucketLifecycleConfigurationRequest getBucketLifecycleConfigurationRequest) Gets the lifecycle configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.
BucketLifecycleConfiguration	getBucketLifecycleConfiguration(java.lang.String bucketName) Gets the lifecycle configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.
java.lang.String	getBucketLocation(GetBucketLocationRequest getBucketLocationRequest) Gets the geographical region where Amazon S3 stores the specified bucket.
java.lang.String	getBucketLocation(java.lang.String bucketName) Gets the geographical region where Amazon S3 stores the specified bucket.
BucketLoggingConfiguration	getBucketLoggingConfiguration(GetBucketLoggingConfigurationRequest getBucketLoggingConfigurationRequest) Gets the logging configuration for the specified bucket.
BucketLoggingConfiguration	getBucketLoggingConfiguration(java.lang.String bucketName) Gets the logging configuration for the specified bucket.
GetBucketMetricsConfigurationResult	getBucketMetricsConfiguration(GetBucketMetricsConfigurationRequest getBucketMetricsConfigurationRequest) Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.
GetBucketMetricsConfigurationResult	getBucketMetricsConfiguration(java.lang.String bucketName, java.lang.String id) Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.
BucketNotificationConfiguration	getBucketNotificationConfiguration(GetBucketNotificationConfigurationRequest getBucketNotificationConfigurationRequest) Gets the notification configuration for the specified bucket.
BucketNotificationConfiguration	getBucketNotificationConfiguration(java.lang.String bucketName) Gets the notification configuration for the specified bucket.
BucketPolicy	getBucketPolicy(GetBucketPolicyRequest getBucketPolicyRequest) Gets the policy for the specified bucket.
BucketPolicy	getBucketPolicy(java.lang.String bucketName) Gets the policy for the specified bucket.
BucketReplicationConfiguration	getBucketReplicationConfiguration(GetBucketReplicationConfigurationRequest getBucketReplicationConfigurationRequest) Retrieves the replication configuration for the given Amazon S3 bucket.
BucketReplicationConfiguration	getBucketReplicationConfiguration(java.lang.String bucketName) Retrieves the replication configuration for the given Amazon S3 bucket.
BucketTaggingConfiguration	getBucketTaggingConfiguration(GetBucketTaggingConfigurationRequest getBucketTaggingConfigurationRequest) Gets the tagging configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.
BucketTaggingConfiguration	getBucketTaggingConfiguration(java.lang.String bucketName) Gets the tagging configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.
BucketVersioningConfiguration	getBucketVersioningConfiguration(GetBucketVersioningConfigurationRequest getBucketVersioningConfigurationRequest) Returns the versioning configuration for the specified bucket.
BucketVersioningConfiguration	getBucketVersioningConfiguration(java.lang.String bucketName) Returns the versioning configuration for the specified bucket.
BucketWebsiteConfiguration	getBucketWebsiteConfiguration(GetBucketWebsiteConfigurationRequest getBucketWebsiteConfigurationRequest) Returns the website configuration for the specified bucket.
BucketWebsiteConfiguration	getBucketWebsiteConfiguration(java.lang.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, java.io.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(java.lang.String bucketName, java.lang.String key) Gets the object stored in Amazon S3 under the specified bucket and key.
AccessControlList	getObjectAcl(GetObjectAclRequest getObjectAclRequest) Gets the AccessControlList (ACL) for the specified object in Amazon S3.
AccessControlList	getObjectAcl(java.lang.String bucketName, java.lang.String key) Gets the AccessControlList (ACL) for the specified object in Amazon S3.
AccessControlList	getObjectAcl(java.lang.String bucketName, java.lang.String key, java.lang.String versionId) Gets the AccessControlList (ACL) for the specified object with the specified version in Amazon S3.
java.lang.String	getObjectAsString(java.lang.String bucketName, java.lang.String key) Retrieves and decodes the contents of an S3 object to a String.
ObjectMetadata	getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest) Gets the metadata for the specified Amazon S3 object without actually fetching the object itself.
ObjectMetadata	getObjectMetadata(java.lang.String bucketName, java.lang.String key) Gets the metadata for the specified Amazon S3 object without actually fetching the object itself.
GetObjectTaggingResult	getObjectTagging(GetObjectTaggingRequest getObjectTaggingRequest) Returns the tags for the specified object.
Region	getRegion() Returns the region with which the client is configured.
java.lang.String	getRegionName() Returns a string representation of the region with which this client is configured
java.lang.String	getResourceUrl(java.lang.String bucketName, java.lang.String key) Returns the URL to the key in the bucket given, using the client's scheme and endpoint.
Owner	getS3AccountOwner() Gets the current owner of the AWS account that the authenticated sender of the request is using.
Owner	getS3AccountOwner(GetS3AccountOwnerRequest getS3AccountOwnerRequest) Gets the current owner of the AWS account that the authenticated sender of the request is using.
java.net.URL	getUrl(java.lang.String bucketName, java.lang.String key) Returns an URL for the object stored in the specified bucket and key.
HeadBucketResult	headBucket(HeadBucketRequest headBucketRequest) Performs a head bucket operation on the requested bucket name.
InitiateMultipartUploadResult	initiateMultipartUpload(InitiateMultipartUploadRequest initiateMultipartUploadRequest) Initiates a multipart upload and returns an InitiateMultipartUploadResult which contains an upload ID.
boolean	isRequesterPaysEnabled(java.lang.String bucketName) Retrieves the Requester Pays configuration associated with an Amazon S3 bucket.
ListBucketAnalyticsConfigurationsResult	listBucketAnalyticsConfigurations(ListBucketAnalyticsConfigurationsRequest listBucketAnalyticsConfigurationsRequest) Lists the analytics configurations for the bucket.
ListBucketInventoryConfigurationsResult	listBucketInventoryConfigurations(ListBucketInventoryConfigurationsRequest listBucketInventoryConfigurationsRequest) Returns the list of inventory configurations for the bucket.
ListBucketMetricsConfigurationsResult	listBucketMetricsConfigurations(ListBucketMetricsConfigurationsRequest listBucketMetricsConfigurationsRequest) Lists the metrics configurations for the bucket.
java.util.List<Bucket>	listBuckets() Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
java.util.List<Bucket>	listBuckets(ListBucketsRequest listBucketsRequest) Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
MultipartUploadListing	listMultipartUploads(ListMultipartUploadsRequest listMultipartUploadsRequest) Lists in-progress multipart uploads.
ObjectListing	listNextBatchOfObjects(ListNextBatchOfObjectsRequest listNextBatchOfObjectsRequest) Provides an easy way to continue a truncated object listing and retrieve the next page of results.
ObjectListing	listNextBatchOfObjects(ObjectListing previousObjectListing) Provides an easy way to continue a truncated object listing and retrieve the next page of results.
VersionListing	listNextBatchOfVersions(ListNextBatchOfVersionsRequest listNextBatchOfVersionsRequest) Provides an easy way to continue a truncated VersionListing 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(java.lang.String bucketName) Returns a list of summary information about the objects in the specified buckets.
ObjectListing	listObjects(java.lang.String bucketName, java.lang.String prefix) Returns a list of summary information about the objects in the specified bucket.
ListObjectsV2Result	listObjectsV2(ListObjectsV2Request listObjectsV2Request)
ListObjectsV2Result	listObjectsV2(java.lang.String bucketName)
ListObjectsV2Result	listObjectsV2(java.lang.String bucketName, java.lang.String prefix)
PartListing	listParts(ListPartsRequest listPartsRequest) 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(java.lang.String bucketName, java.lang.String prefix) Returns a list of summary information about the versions in the specified bucket.
VersionListing	listVersions(java.lang.String bucketName, java.lang.String prefix, java.lang.String keyMarker, java.lang.String versionIdMarker, java.lang.String delimiter, java.lang.Integer maxKeys) 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(java.lang.String bucketName, java.lang.String key, java.io.File file) Uploads the specified file to Amazon S3 under the specified bucket and key name.
PutObjectResult	putObject(java.lang.String bucketName, java.lang.String key, java.io.InputStream input, ObjectMetadata metadata) Uploads the specified input stream and object metadata to Amazon S3 under the specified bucket and key name.
PutObjectResult	putObject(java.lang.String bucketName, java.lang.String key, java.lang.String content) Encodes a String into the contents of an S3 object.
void	resolveRequestEndpoint(Request<?> request, java.lang.String bucketName, java.lang.String key) Set the request's endpoint and resource path with the new region provided From versions 2.4.+ until 2.10.+, AmazonS3Client adds an additional layer of URL Encoding for the key names.
void	resolveRequestEndpoint(Request<?> request, java.lang.String bucketName, java.lang.String key, java.net.URI endpoint) Set the request's endpoint and resource path with the new region provided.
void	restoreObject(RestoreObjectRequest restoreObjectRequest) Restore an object, which was transitioned to Amazon Glacier from Amazon S3 when it was expired, into Amazon S3 again.
void	restoreObject(java.lang.String bucketName, java.lang.String key, int expirationInDays) (non-Javadoc)
void	setBucketAccelerateConfiguration(SetBucketAccelerateConfigurationRequest setBucketAccelerateConfigurationRequest) Sets the accelerate configuration for the specified bucket.
void	setBucketAccelerateConfiguration(java.lang.String bucketName, BucketAccelerateConfiguration accelerateConfiguration) Sets the accelerate configuration for the specified bucket.
void	setBucketAcl(SetBucketAclRequest setBucketAclRequest) Sets the AccessControlList for the specified Amazon S3 bucket.
void	setBucketAcl(java.lang.String bucketName, AccessControlList acl) Sets the AccessControlList for the specified Amazon S3 bucket.
void	setBucketAcl(java.lang.String bucketName, AccessControlList acl, com.amazonaws.metrics.RequestMetricCollector requestMetricCollector) Same as setBucketAcl(String, AccessControlList) but allows specifying a request metric collector.
void	setBucketAcl(java.lang.String bucketName, CannedAccessControlList acl) Sets the CannedAccessControlList for the specified Amazon S3 bucket using one of the pre-configured CannedAccessControlLists.
void	setBucketAcl(java.lang.String bucketName, CannedAccessControlList acl, com.amazonaws.metrics.RequestMetricCollector requestMetricCollector) Same as setBucketAcl(String, CannedAccessControlList) but allows specifying a request metric collector.
SetBucketAnalyticsConfigurationResult	setBucketAnalyticsConfiguration(SetBucketAnalyticsConfigurationRequest setBucketAnalyticsConfigurationRequest) Sets an analytics configuration for the bucket (specified by the analytics configuration ID).
SetBucketAnalyticsConfigurationResult	setBucketAnalyticsConfiguration(java.lang.String bucketName, AnalyticsConfiguration analyticsConfiguration) Sets an analytics configuration for the bucket (specified by the analytics configuration ID).
void	setBucketCrossOriginConfiguration(SetBucketCrossOriginConfigurationRequest setBucketCrossOriginConfigurationRequest) Sets the cross origin configuration for the specified bucket.
void	setBucketCrossOriginConfiguration(java.lang.String bucketName, BucketCrossOriginConfiguration bucketCrossOriginConfiguration) Sets the cross origin configuration for the specified bucket.
SetBucketInventoryConfigurationResult	setBucketInventoryConfiguration(SetBucketInventoryConfigurationRequest setBucketInventoryConfigurationRequest) Sets an inventory configuration (identified by the inventory ID) to the bucket.
SetBucketInventoryConfigurationResult	setBucketInventoryConfiguration(java.lang.String bucketName, InventoryConfiguration inventoryConfiguration) Sets an inventory configuration (identified by the inventory ID) to the bucket.
void	setBucketLifecycleConfiguration(SetBucketLifecycleConfigurationRequest setBucketLifecycleConfigurationRequest) Sets the lifecycle configuration for the specified bucket.
void	setBucketLifecycleConfiguration(java.lang.String bucketName, BucketLifecycleConfiguration bucketLifecycleConfiguration) Sets the lifecycle configuration for the specified bucket.
void	setBucketLoggingConfiguration(SetBucketLoggingConfigurationRequest setBucketLoggingConfigurationRequest) Sets the logging configuration for the specified bucket.
SetBucketMetricsConfigurationResult	setBucketMetricsConfiguration(SetBucketMetricsConfigurationRequest setBucketMetricsConfigurationRequest) Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.
SetBucketMetricsConfigurationResult	setBucketMetricsConfiguration(java.lang.String bucketName, MetricsConfiguration metricsConfiguration) Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.
void	setBucketNotificationConfiguration(SetBucketNotificationConfigurationRequest setBucketNotificationConfigurationRequest) Sets the notification configuration for the specified bucket.
void	setBucketNotificationConfiguration(java.lang.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(java.lang.String bucketName, java.lang.String policyText) Sets the policy associated with the specified bucket.
void	setBucketReplicationConfiguration(SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest) Sets a replication configuration for the Amazon S3 bucket.
void	setBucketReplicationConfiguration(java.lang.String bucketName, BucketReplicationConfiguration configuration) Sets a replication configuration for the Amazon S3 bucket.
void	setBucketTaggingConfiguration(SetBucketTaggingConfigurationRequest setBucketTaggingConfigurationRequest) Sets the tagging configuration for the specified bucket.
void	setBucketTaggingConfiguration(java.lang.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(java.lang.String bucketName, BucketWebsiteConfiguration configuration) Sets the website configuration for the specified bucket.
void	setEndpoint(java.lang.String endpoint) Overrides the default endpoint for this client.
void	setNotificationThreshold(int threshold) Sets the number of Kbytes that need to be written before updates to the listener occur.
void	setObjectAcl(SetObjectAclRequest setObjectAclRequest) Sets the AccessControlList for the specified Amazon S3 object with an optional version ID.
void	setObjectAcl(java.lang.String bucketName, java.lang.String key, AccessControlList acl) Sets the AccessControlList for the specified object in Amazon S3.
void	setObjectAcl(java.lang.String bucketName, java.lang.String key, CannedAccessControlList acl) Sets the CannedAccessControlList for the specified object in Amazon S3 using one of the pre-configured CannedAccessControlLists.
void	setObjectAcl(java.lang.String bucketName, java.lang.String key, java.lang.String versionId, AccessControlList acl) Sets the CannedAccessControlList for the specified object with the specified version in Amazon S3.
void	setObjectAcl(java.lang.String bucketName, java.lang.String key, java.lang.String versionId, AccessControlList acl, com.amazonaws.metrics.RequestMetricCollector requestMetricCollector) Same as setObjectAcl(String, String, String, AccessControlList) but allows specifying a request metric collector.
void	setObjectAcl(java.lang.String bucketName, java.lang.String key, java.lang.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.
void	setObjectAcl(java.lang.String bucketName, java.lang.String key, java.lang.String versionId, CannedAccessControlList acl, com.amazonaws.metrics.RequestMetricCollector requestMetricCollector) Same as setObjectAcl(String, String, String, CannedAccessControlList) but allows specifying a request metric collector.
void	setObjectRedirectLocation(java.lang.String bucketName, java.lang.String key, java.lang.String newRedirectLocation) Changes the Amazon S3 redirect location for a specific object.
SetObjectTaggingResult	setObjectTagging(SetObjectTaggingRequest setObjectTaggingRequest) Set the tags for the specified object.
void	setRegion(Region region) An alternative to AmazonWebServiceClient.setEndpoint(String), sets the regional endpoint for this client's service calls.
void	setS3ClientOptions(S3ClientOptions clientOptions) Override the default S3 client options for this client.
UploadPartResult	uploadPart(UploadPartRequest uploadPartRequest) Uploads a part in a multipart upload.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, getEndpoint, getEndpointPrefix, getRegions, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerRegionOverride, getTimeOffset, removeRequestHandler, removeRequestHandler, setConfiguration, setEndpoint, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

S3_SERVICE_NAME

public static final java.lang.String S3_SERVICE_NAME

See Also:

Constant Field Values

Constructor Detail

AmazonS3Client

@Deprecated
public AmazonS3Client()

Deprecated.

Constructs a new client to invoke service methods on Amazon S3. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Credential profiles file at the default location (~/.aws/credentials) shared by all AWS SDKs and the AWS CLI
• Instance Profile Credentials - delivered through the Amazon EC2 metadata service

If no credentials are found in the chain, this client will attempt to work in an anonymous mode where requests aren't signed. Only a subset of the Amazon S3 API will work with anonymous (i.e. unsigned) requests, but this can prove useful in some situations. For example:

• If an Amazon S3 bucket has Permission.Read permission for the GroupGrantee.AllUsers group, anonymous clients can call listObjects(String) to see what objects are stored in a bucket.
• If an object has Permission.Read permission for the GroupGrantee.AllUsers group, anonymous clients can call getObject(String, String) and getObjectMetadata(String, String) to pull object content and metadata.
• If a bucket has Permission.Write permission for the GroupGrantee.AllUsers group, anonymous clients can upload objects to the bucket.

You can force the client to operate in an anonymous mode, and skip the credentials provider chain, by passing in null for the credentials.

See Also:

AmazonS3Client(AWSCredentials), AmazonS3Client(AWSCredentials, ClientConfiguration)

AmazonS3Client

@Deprecated
public AmazonS3Client(AWSCredentials awsCredentials)

Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentials, com.amazonaws.regions.Region) instead.

Constructs a new Amazon S3 client using the specified AWS credentials to access Amazon S3.

Parameters:

awsCredentials - The AWS credentials to use when making requests to Amazon S3 with this client.

See Also:

AmazonS3Client(), AmazonS3Client(AWSCredentials, ClientConfiguration)

AmazonS3Client

@Deprecated
public AmazonS3Client(AWSCredentials awsCredentials,
                                  ClientConfiguration clientConfiguration)

Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentials, com.amazonaws.regions.Region, ClientConfiguration) instead.

Constructs a new Amazon S3 client using the specified AWS credentials and client configuration to access Amazon S3.

Parameters:

awsCredentials - The AWS credentials to use when making requests to Amazon S3 with this client.

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

See Also:

AmazonS3Client(), AmazonS3Client(AWSCredentials)

AmazonS3Client

@Deprecated
public AmazonS3Client(AWSCredentialsProvider credentialsProvider)

Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentialsProvider, com.amazonaws.regions.Region) instead.

Constructs a new Amazon S3 client using the specified AWS credentials provider to access Amazon S3.

Parameters:

credentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

AmazonS3Client

@Deprecated
public AmazonS3Client(AWSCredentialsProvider credentialsProvider,
                                  ClientConfiguration clientConfiguration)

Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentialsProvider, com.amazonaws.regions.Region, ClientConfiguration) instead.

Constructs a new Amazon S3 client using the specified AWS credentials and client configuration to access Amazon S3.

Parameters:

credentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

AmazonS3Client

@Deprecated
public AmazonS3Client(AWSCredentialsProvider credentialsProvider,
                                  ClientConfiguration clientConfiguration,
                                  com.amazonaws.metrics.RequestMetricCollector requestMetricCollector)

Deprecated.

Constructs a new Amazon S3 client using the specified AWS credentials, client configuration and request metric collector to access Amazon S3.

Parameters:

credentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

requestMetricCollector - request metric collector

AmazonS3Client

@Deprecated
public AmazonS3Client(AWSCredentialsProvider credentialsProvider,
                                  ClientConfiguration clientConfiguration,
                                  HttpClient httpClient)

Deprecated. Use AmazonS3Client#AmazonS3Client(AWSCredentialsProvider, com.amazonaws.regions.Region, ClientConfiguration, HttpClient) instead.

Constructs a new Amazon S3 client using the specified AWS credentials, client configuration and request metric collector to access Amazon S3.

Parameters:

credentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

httpClient -

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

AmazonS3Client

@Deprecated
public AmazonS3Client(ClientConfiguration clientConfiguration)

Deprecated. Use AmazonS3Client#AmazonS3Client(ClientConfiguration, com.amazonaws.regions.Region) instead.

Constructs a new client using the specified client configuration to access Amazon S3. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance Profile Credentials - delivered through the Amazon EC2 metadata service

If no credentials are found in the chain, this client will attempt to work in an anonymous mode where requests aren't signed. Only a subset of the Amazon S3 API will work with anonymous (i.e. unsigned) requests, but this can prove useful in some situations. For example:

• If an Amazon S3 bucket has Permission.Read permission for the GroupGrantee.AllUsers group, anonymous clients can call listObjects(String) to see what objects are stored in a bucket.
• If an object has Permission.Read permission for the GroupGrantee.AllUsers group, anonymous clients can call getObject(String, String) and getObjectMetadata(String, String) to pull object content and metadata.
• If a bucket has Permission.Write permission for the GroupGrantee.AllUsers group, anonymous clients can upload objects to the bucket.

You can force the client to operate in an anonymous mode, and skip the credentials provider chain, by passing in null for the credentials.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

See Also:

AmazonS3Client(AWSCredentials), AmazonS3Client(AWSCredentials, ClientConfiguration)

AmazonS3Client

public AmazonS3Client(AWSCredentials awsCredentials,
                      Region region)

Parameters:

awsCredentials - The AWS credentials to use when making requests to Amazon S3 with this client.

region - the AWS region

AmazonS3Client

public AmazonS3Client(AWSCredentials awsCredentials,
                      Region region,
                      ClientConfiguration clientConfiguration)

Parameters:

awsCredentials - The AWS credentials to use when making requests to Amazon S3 with this client.

region - the AWS region

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

AmazonS3Client

public AmazonS3Client(AWSCredentials awsCredentials,
                      Region region,
                      ClientConfiguration clientConfiguration,
                      HttpClient httpClient)

Parameters:

awsCredentials - The AWS credentials to use when making requests to Amazon S3 with this client.

region - the AWS region

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

httpClient -

AmazonS3Client

public AmazonS3Client(AWSCredentialsProvider awsCredentialsProvider,
                      Region region)

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

region - the AWS region

AmazonS3Client

public AmazonS3Client(AWSCredentialsProvider awsCredentialsProvider,
                      Region region,
                      ClientConfiguration clientConfiguration)

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

region - the AWS region

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

AmazonS3Client

public AmazonS3Client(AWSCredentialsProvider awsCredentialsProvider,
                      Region region,
                      ClientConfiguration clientConfiguration,
                      HttpClient httpClient)

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

region - the AWS region

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

httpClient - the custome httpclient to send requests and receive responses

AmazonS3Client

public AmazonS3Client(ClientConfiguration clientConfiguration,
                      Region region)

Constructs a new client using the specified client configuration to access Amazon S3. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance Profile Credentials - delivered through the Amazon EC2 metadata service

If no credentials are found in the chain, this client will attempt to work in an anonymous mode where requests aren't signed. Only a subset of the Amazon S3 API will work with anonymous (i.e. unsigned) requests, but this can prove useful in some situations. For example:

• If an Amazon S3 bucket has Permission.Read permission for the GroupGrantee.AllUsers group, anonymous clients can call listObjects(String) to see what objects are stored in a bucket.
• If an object has Permission.Read permission for the GroupGrantee.AllUsers group, anonymous clients can call getObject(String, String) and getObjectMetadata(String, String) to pull object content and metadata.
• If a bucket has Permission.Write permission for the GroupGrantee.AllUsers group, anonymous clients can upload objects to the bucket.

You can force the client to operate in an anonymous mode, and skip the credentials provider chain, by passing in null for the credentials.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to Amazon S3 (e.g. proxy settings, retry counts, etc).

See Also:

AmazonS3Client(AWSCredentials, com.amazonaws.regions.Region), AmazonS3Client#AmazonS3Client(AWSCredentials, ClientConfiguration, com.amazonaws.regions.Region)

Method Detail

setNotificationThreshold

public void setNotificationThreshold(int threshold)

Sets the number of Kbytes that need to be written before updates to the listener occur.

Parameters:

threshold - Number of Kbytes that needs to be written before write update notification occurs. Minimum value supported is 128 KB due to the limitations imposed by the HttpClient while reading the data from the stream.

setEndpoint

public void setEndpoint(java.lang.String endpoint)

Description copied from class: AmazonWebServiceClient

Overrides the default endpoint for this client. Callers can use this method to control which AWS region they want to work with.

This method is not threadsafe. Endpoints should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit.

Callers can pass in just the endpoint (ex: "ec2.amazonaws.com") or a full URL, including the protocol (ex: "https://ec2.amazonaws.com"). If the protocol is not specified here, the default protocol from this client's ClientConfiguration will be used, which by default is HTTPS.

For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: https://docs.aws.amazon.com/general/latest/gr/rande.html

Specified by:

setEndpoint in interface AmazonS3

Overrides:

setEndpoint in class AmazonWebServiceClient

Parameters:

endpoint - The endpoint (ex: "ec2.amazonaws.com") or a full URL, including the protocol (ex: "https://ec2.amazonaws.com") of the region specific AWS endpoint this client will communicate with.

setRegion

public void setRegion(Region region)

Description copied from class: AmazonWebServiceClient

An alternative to AmazonWebServiceClient.setEndpoint(String), sets the regional endpoint for this client's service calls. Callers can use this method to control which AWS region they want to work with.

This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.

By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the ClientConfiguration supplied at construction.

Specified by:

setRegion in interface AmazonS3

Overrides:

setRegion in class AmazonWebServiceClient

Parameters:

region - The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions) for accessing a given region.

See Also:

Region.getRegion(com.amazonaws.regions.Regions), Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)

setS3ClientOptions

public void setS3ClientOptions(S3ClientOptions clientOptions)

Override the default S3 client options for this client. Also set the endpoint to s3-accelerate if such is specified in the S3 client options.

Specified by:

setS3ClientOptions in interface AmazonS3

Parameters:

clientOptions - The S3 client options to use.

listNextBatchOfVersions

public VersionListing listNextBatchOfVersions(VersionListing previousVersionListing)
                                       throws AmazonClientException,
                                              AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .

Specified by:

listNextBatchOfVersions in interface AmazonS3

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:

listVersions(String, String), listVersions(ListVersionsRequest), listVersions(String, String, String, String, String, Integer)

listNextBatchOfVersions

public VersionListing listNextBatchOfVersions(ListNextBatchOfVersionsRequest listNextBatchOfVersionsRequest)
                                       throws AmazonClientException,
                                              AmazonServiceException

Description copied from interface: AmazonS3

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 VersionListing.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 AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .

Specified by:

listNextBatchOfVersions in interface AmazonS3

Parameters:

listNextBatchOfVersionsRequest - The request object for listing next batch of versions using the previous truncated VersionListing. If a non-truncated VersionListing is passed in by the request object, 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:

listVersions(String, String), listVersions(ListVersionsRequest), listVersions(String, String, String, String, String, Integer), listNextBatchOfVersions(VersionListing)

listVersions

public VersionListing listVersions(java.lang.String bucketName,
                                   java.lang.String prefix)
                            throws AmazonClientException,
                                   AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.listNextBatchOfVersions(VersionListing) as an easy way to get the next page of results.

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

Specified by:

listVersions in interface AmazonS3

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:

listVersions(ListVersionsRequest), listVersions(String, String, String, String, String, Integer)

listVersions

public VersionListing listVersions(java.lang.String bucketName,
                                   java.lang.String prefix,
                                   java.lang.String keyMarker,
                                   java.lang.String versionIdMarker,
                                   java.lang.String delimiter,
                                   java.lang.Integer maxKeys)
                            throws AmazonClientException,
                                   AmazonServiceException

Description copied from interface: AmazonS3

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.

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 AmazonS3.listNextBatchOfVersions(VersionListing) as an easy way to get the next page of 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 AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .

Specified by:

listVersions in interface AmazonS3

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 AmazonS3.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 AmazonS3.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.

maxKeys - 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:

listVersions(String, String), listVersions(ListVersionsRequest), listNextBatchOfVersions(VersionListing)

listVersions

public VersionListing listVersions(ListVersionsRequest listVersionsRequest)
                            throws AmazonClientException,
                                   AmazonServiceException

Description copied from interface: AmazonS3

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.

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 AmazonS3.listNextBatchOfVersions(VersionListing) as an easy way to get the next page of 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 AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .

Specified by:

listVersions in interface AmazonS3

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:

listVersions(String, String), listVersions(String, String, String, String, String, Integer), listNextBatchOfVersions(VersionListing)

listObjects

public ObjectListing listObjects(java.lang.String bucketName)
                          throws AmazonClientException,
                                 AmazonServiceException

Description copied from interface: AmazonS3

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 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.

Specified by:

listObjects in interface AmazonS3

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:

listObjects(String, String), listObjects(ListObjectsRequest)

listObjects

public ObjectListing listObjects(java.lang.String bucketName,
                                 java.lang.String prefix)
                          throws AmazonClientException,
                                 AmazonServiceException

Description copied from interface: AmazonS3

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.

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 listNextBatchOfObjects(ObjectListing) method as an easy way to get the next page of object listings.

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.

Specified by:

listObjects in interface AmazonS3

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:

listObjects(String), listObjects(ListObjectsRequest)

listObjects

public ObjectListing listObjects(ListObjectsRequest listObjectsRequest)
                          throws AmazonClientException,
                                 AmazonServiceException

Description copied from interface: AmazonS3

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.

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 listNextBatchOfObjects(ObjectListing) method as an easy way to get the next page of object listings.

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.

Specified by:

listObjects in interface AmazonS3

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:

listObjects(String), listObjects(String, String)

listObjectsV2

public ListObjectsV2Result listObjectsV2(java.lang.String bucketName)
                                  throws AmazonClientException,
                                         AmazonServiceException

Specified by:

listObjectsV2 in interface AmazonS3

Throws:

AmazonClientException

AmazonServiceException

listObjectsV2

public ListObjectsV2Result listObjectsV2(java.lang.String bucketName,
                                         java.lang.String prefix)
                                  throws AmazonClientException,
                                         AmazonServiceException

Specified by:

listObjectsV2 in interface AmazonS3

Throws:

AmazonClientException

AmazonServiceException

listObjectsV2

public ListObjectsV2Result listObjectsV2(ListObjectsV2Request listObjectsV2Request)
                                  throws AmazonClientException,
                                         AmazonServiceException

Specified by:

listObjectsV2 in interface AmazonS3

Throws:

AmazonClientException

AmazonServiceException

listNextBatchOfObjects

public ObjectListing listNextBatchOfObjects(ObjectListing previousObjectListing)
                                     throws AmazonClientException,
                                            AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

listNextBatchOfObjects in interface AmazonS3

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:

listObjects(String), listObjects(String, String), listObjects(ListObjectsRequest)

listNextBatchOfObjects

public ObjectListing listNextBatchOfObjects(ListNextBatchOfObjectsRequest listNextBatchOfObjectsRequest)
                                     throws AmazonClientException,
                                            AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

listNextBatchOfObjects in interface AmazonS3

Parameters:

listNextBatchOfObjectsRequest - The request object for listing next batch of objects using the previous truncated ObjectListing. If a non-truncated ObjectListing is passed in by the request object, 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:

listObjects(String), listObjects(String, String), listObjects(ListObjectsRequest), listNextBatchOfObjects(ObjectListing)

getS3AccountOwner

public Owner getS3AccountOwner()
                        throws AmazonClientException,
                               AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getS3AccountOwner in interface AmazonS3

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.

getS3AccountOwner

public Owner getS3AccountOwner(GetS3AccountOwnerRequest getS3AccountOwnerRequest)
                        throws AmazonClientException,
                               AmazonServiceException

Description copied from interface: AmazonS3

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 AWS.

Specified by:

getS3AccountOwner in interface AmazonS3

Parameters:

getS3AccountOwnerRequest - The request object for retrieving the S3 account owner.

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.

See Also:

AmazonS3.getS3AccountOwner()

listBuckets

public java.util.List<Bucket> listBuckets(ListBucketsRequest listBucketsRequest)
                                   throws AmazonClientException,
                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

listBuckets in interface AmazonS3

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:

AmazonS3.listBuckets()

listBuckets

public java.util.List<Bucket> listBuckets()
                                   throws AmazonClientException,
                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

listBuckets in interface AmazonS3

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:

AmazonS3.listBuckets(ListBucketsRequest)

getBucketLocation

public java.lang.String getBucketLocation(GetBucketLocationRequest getBucketLocationRequest)
                                   throws AmazonClientException,
                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getBucketLocation in interface AmazonS3

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

getBucketLocation

public java.lang.String getBucketLocation(java.lang.String bucketName)
                                   throws AmazonClientException,
                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getBucketLocation in interface AmazonS3

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

createBucket

public Bucket createBucket(java.lang.String bucketName)
                    throws AmazonClientException,
                           AmazonServiceException

Description copied from interface: AmazonS3

Creates a new Amazon S3 bucket with the specified name in the default (US) 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.

Specified by:

createBucket in interface AmazonS3

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

public Bucket createBucket(java.lang.String bucketName,
                           Region region)
                    throws AmazonClientException,
                           AmazonServiceException

Description copied from interface: AmazonS3

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

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.

Specified by:

createBucket in interface AmazonS3

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

public Bucket createBucket(java.lang.String bucketName,
                           java.lang.String region)
                    throws AmazonClientException,
                           AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.createBucket(String, Region) and pass in a Region enumeration value in standard cases.

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.

Specified by:

createBucket in interface AmazonS3

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

public Bucket createBucket(CreateBucketRequest createBucketRequest)
                    throws AmazonClientException,
                           AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

createBucket in interface AmazonS3

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.

getObjectAcl

public AccessControlList getObjectAcl(java.lang.String bucketName,
                                      java.lang.String key)
                               throws AmazonClientException,
                                      AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getObjectAcl in interface AmazonS3

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:

AmazonS3.getObjectAcl(String, String, String)

getObjectAcl

public AccessControlList getObjectAcl(java.lang.String bucketName,
                                      java.lang.String key,
                                      java.lang.String versionId)
                               throws AmazonClientException,
                                      AmazonServiceException

Description copied from interface: AmazonS3

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.

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.

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

Specified by:

getObjectAcl in interface AmazonS3

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:

AmazonS3.getObjectAcl(String, String)

getObjectAcl

public AccessControlList getObjectAcl(GetObjectAclRequest getObjectAclRequest)
                               throws AmazonClientException,
                                      AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getObjectAcl in interface AmazonS3

Parameters:

getObjectAclRequest - the request object containing all the information needed for retrieving the object ACL.

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:

AmazonS3.getObjectAcl(String, String, String)

setObjectAcl

public void setObjectAcl(java.lang.String bucketName,
                         java.lang.String key,
                         AccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

Sets the AccessControlList 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.

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

Specified by:

setObjectAcl in interface AmazonS3

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:

AmazonS3.setObjectAcl(String, String, CannedAccessControlList), AmazonS3.setObjectAcl(String, String, String, AccessControlList), AmazonS3.setObjectAcl(String, String, String, CannedAccessControlList)

setObjectAcl

public void setObjectAcl(java.lang.String bucketName,
                         java.lang.String key,
                         CannedAccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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.

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.

Specified by:

setObjectAcl in interface AmazonS3

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:

AmazonS3.setObjectAcl(String, String, AccessControlList), AmazonS3.setObjectAcl(String, String, String, AccessControlList), AmazonS3.setObjectAcl(String, String, String, CannedAccessControlList)

setObjectAcl

public void setObjectAcl(java.lang.String bucketName,
                         java.lang.String key,
                         java.lang.String versionId,
                         AccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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

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.

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

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

Specified by:

setObjectAcl in interface AmazonS3

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:

AmazonS3.setObjectAcl(String, String, AccessControlList), AmazonS3.setObjectAcl(String, String, CannedAccessControlList), AmazonS3.setObjectAcl(String, String, String, CannedAccessControlList)

setObjectAcl

public void setObjectAcl(java.lang.String bucketName,
                         java.lang.String key,
                         java.lang.String versionId,
                         AccessControlList acl,
                         com.amazonaws.metrics.RequestMetricCollector requestMetricCollector)
                  throws AmazonClientException,
                         AmazonServiceException

Same as setObjectAcl(String, String, String, AccessControlList) but allows specifying a request metric collector.

Throws:

AmazonClientException

AmazonServiceException

setObjectAcl

public void setObjectAcl(java.lang.String bucketName,
                         java.lang.String key,
                         java.lang.String versionId,
                         CannedAccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .

Specified by:

setObjectAcl in interface AmazonS3

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:

AmazonS3.setObjectAcl(String, String, AccessControlList), AmazonS3.setObjectAcl(String, String, CannedAccessControlList), AmazonS3.setObjectAcl(String, String, String, AccessControlList)

setObjectAcl

public void setObjectAcl(java.lang.String bucketName,
                         java.lang.String key,
                         java.lang.String versionId,
                         CannedAccessControlList acl,
                         com.amazonaws.metrics.RequestMetricCollector requestMetricCollector)

Same as setObjectAcl(String, String, String, CannedAccessControlList) but allows specifying a request metric collector.

setObjectAcl

public void setObjectAcl(SetObjectAclRequest setObjectAclRequest)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

Sets the AccessControlList for the specified Amazon S3 object with an optional version ID.

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.

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

Specified by:

setObjectAcl in interface AmazonS3

Parameters:

setObjectAclRequest - The request object containing the S3 object 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

public AccessControlList getBucketAcl(java.lang.String bucketName)
                               throws AmazonClientException,
                                      AmazonServiceException

Description copied from interface: AmazonS3

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

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.

Specified by:

getBucketAcl in interface AmazonS3

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.

getBucketAcl

public AccessControlList getBucketAcl(GetBucketAclRequest getBucketAclRequest)
                               throws AmazonClientException,
                                      AmazonServiceException

Description copied from interface: AmazonS3

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

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.

Specified by:

getBucketAcl in interface AmazonS3

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

public void setBucketAcl(java.lang.String bucketName,
                         AccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

Sets the AccessControlList for the specified Amazon S3 bucket.

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.

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

Specified by:

setBucketAcl in interface AmazonS3

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:

AmazonS3.setBucketAcl(String, CannedAccessControlList)

setBucketAcl

public void setBucketAcl(java.lang.String bucketName,
                         AccessControlList acl,
                         com.amazonaws.metrics.RequestMetricCollector requestMetricCollector)

Same as setBucketAcl(String, AccessControlList) but allows specifying a request metric collector.

setBucketAcl

public void setBucketAcl(SetBucketAclRequest setBucketAclRequest)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

Sets the AccessControlList for the specified Amazon S3 bucket.

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.

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

Specified by:

setBucketAcl in interface AmazonS3

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.

setBucketAcl

public void setBucketAcl(java.lang.String bucketName,
                         CannedAccessControlList acl)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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.

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.

Specified by:

setBucketAcl in interface AmazonS3

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:

AmazonS3.setBucketAcl(String, AccessControlList)

setBucketAcl

public void setBucketAcl(java.lang.String bucketName,
                         CannedAccessControlList acl,
                         com.amazonaws.metrics.RequestMetricCollector requestMetricCollector)
                  throws AmazonClientException,
                         AmazonServiceException

Same as setBucketAcl(String, CannedAccessControlList) but allows specifying a request metric collector.

Throws:

AmazonClientException

AmazonServiceException

getObjectMetadata

public ObjectMetadata getObjectMetadata(java.lang.String bucketName,
                                        java.lang.String key)
                                 throws AmazonClientException,
                                        AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getObjectMetadata in interface AmazonS3

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:

AmazonS3.getObjectMetadata(GetObjectMetadataRequest)

getObjectMetadata

public ObjectMetadata getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest)
                                 throws AmazonClientException,
                                        AmazonServiceException

Description copied from interface: AmazonS3

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.

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

Specified by:

getObjectMetadata in interface AmazonS3

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:

AmazonS3.getObjectMetadata(String, String)

getObject

public S3Object getObject(java.lang.String bucketName,
                          java.lang.String key)
                   throws AmazonClientException,
                          AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.getObject(GetObjectRequest).

If you are accessing AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

getObject in interface AmazonS3

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:

AmazonS3.getObject(GetObjectRequest), AmazonS3.getObject(GetObjectRequest, File)

doesBucketExist

public boolean doesBucketExist(java.lang.String bucketName)
                        throws AmazonClientException,
                               AmazonServiceException

Description copied from interface: AmazonS3

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. If invalid security credentials are used to execute this method, the client is not able to distinguish between bucket permission errors and invalid credential errors, and this method could return an incorrect result.

Specified by:

doesBucketExist in interface AmazonS3

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:

AmazonS3.createBucket(CreateBucketRequest)

doesObjectExist

public boolean doesObjectExist(java.lang.String bucketName,
                               java.lang.String objectName)
                        throws AmazonServiceException,
                               AmazonClientException

Specified by:

doesObjectExist in interface AmazonS3

Parameters:

bucketName - Name of bucket that presumably contains object

objectName - Name of object that has to be checked

Returns:

result of the search

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

headBucket

public HeadBucketResult headBucket(HeadBucketRequest headBucketRequest)
                            throws AmazonClientException,
                                   AmazonServiceException

Description copied from interface: AmazonS3

Performs a head bucket operation on the requested bucket name. This operation is useful to determine if a bucket exists and you have permission to access it.

Specified by:

headBucket in interface AmazonS3

Parameters:

headBucketRequest - The request containing the bucket name.

Returns:

This method returns a HeadBucketResult if the bucket exists and you have permission to access it. Otherwise, the method will throw an AmazonServiceException with status code '404 Not Found' if the bucket does not exist, '403 Forbidden' if the user does not have access to the bucket, or '301 Moved Permanently' if the bucket is in a different region than the client is configured with

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.

changeObjectStorageClass

public void changeObjectStorageClass(java.lang.String bucketName,
                                     java.lang.String key,
                                     StorageClass newStorageClass)
                              throws AmazonClientException,
                                     AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

changeObjectStorageClass in interface AmazonS3

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.

setObjectRedirectLocation

public void setObjectRedirectLocation(java.lang.String bucketName,
                                      java.lang.String key,
                                      java.lang.String newRedirectLocation)
                               throws AmazonClientException,
                                      AmazonServiceException

Description copied from interface: AmazonS3

Changes the Amazon S3 redirect location for a specific object.

Specified by:

setObjectRedirectLocation in interface AmazonS3

Parameters:

bucketName - The name of the bucket containing the object.

key - The key of the object within the specified bucket.

newRedirectLocation - The new redirect location 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.

getObject

public S3Object getObject(GetObjectRequest getObjectRequest)
                   throws AmazonClientException,
                          AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.getObject(String bucketName, String key) method.

Specified by:

getObject in interface AmazonS3

Specified by:

getObject in interface com.amazonaws.services.s3.internal.S3DirectSpi

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:

AmazonS3.getObject(String, String), AmazonS3.getObject(GetObjectRequest, File)

getObject

public ObjectMetadata getObject(GetObjectRequest getObjectRequest,
                                java.io.File destinationFile)
                         throws AmazonClientException,
                                AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.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.

If you are accessing AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

getObject in interface AmazonS3

Specified by:

getObject in interface com.amazonaws.services.s3.internal.S3DirectSpi

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:

AmazonS3.getObject(String, String), AmazonS3.getObject(GetObjectRequest)

deleteBucket

public void deleteBucket(java.lang.String bucketName)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

deleteBucket in interface AmazonS3

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:

AmazonS3.deleteBucket(String)

deleteBucket

public void deleteBucket(DeleteBucketRequest deleteBucketRequest)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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).

Specified by:

deleteBucket in interface AmazonS3

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:

AmazonS3.deleteBucket(String)

putObject

public PutObjectResult putObject(java.lang.String bucketName,
                                 java.lang.String key,
                                 java.io.File file)
                          throws AmazonClientException,
                                 AmazonServiceException

Description copied from interface: AmazonS3

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.

If you are uploading or accessing AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

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 AmazonS3.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 EU region.

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

Specified by:

putObject in interface AmazonS3

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:

AmazonS3.putObject(PutObjectRequest), AmazonS3.putObject(String, String, InputStream, ObjectMetadata)

putObject

public PutObjectResult putObject(java.lang.String bucketName,
                                 java.lang.String key,
                                 java.io.InputStream input,
                                 ObjectMetadata metadata)
                          throws AmazonClientException,
                                 AmazonServiceException

Description copied from interface: AmazonS3

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.

If you are uploading or accessing AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

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 AmazonS3.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 EU region.

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

Specified by:

putObject in interface AmazonS3

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:

AmazonS3.putObject(String, String, File), AmazonS3.putObject(PutObjectRequest)

putObject

public PutObjectResult putObject(PutObjectRequest putObjectRequest)
                          throws AmazonClientException,
                                 AmazonServiceException

Description copied from interface: AmazonS3

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.

If you are uploading or accessing AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

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 AmazonS3.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.

Specified by:

putObject in interface AmazonS3

Specified by:

putObject in interface com.amazonaws.services.s3.internal.S3DirectSpi

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:

AmazonS3.putObject(String, String, File), AmazonS3.putObject(String, String, InputStream, ObjectMetadata)

copyObject

public CopyObjectResult copyObject(java.lang.String sourceBucketName,
                                   java.lang.String sourceKey,
                                   java.lang.String destinationBucketName,
                                   java.lang.String destinationKey)
                            throws AmazonClientException,
                                   AmazonServiceException

Description copied from interface: AmazonS3

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

By default, all object metadata for the source object except server-side-encryption, storage-class and website-redirect-location 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

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

If you are copying AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

copyObject in interface AmazonS3

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:

copyObject(CopyObjectRequest)

copyObject

public CopyObjectResult copyObject(CopyObjectRequest copyObjectRequest)
                            throws AmazonClientException,
                                   AmazonServiceException

Description copied from interface: AmazonS3

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

By default, all object metadata for the source object except server-side-encryption, storage-class and website-redirect-location 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 copyObject(String, String, String, String) method.

If you are copying AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

copyObject in interface AmazonS3

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:

copyObject(String, String, String, String)

copyPart

public CopyPartResult copyPart(CopyPartRequest copyPartRequest)

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.

Specified by:

copyPart in interface AmazonS3

Specified by:

copyPart in interface com.amazonaws.services.s3.internal.S3DirectSpi

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:

AmazonS3.copyObject(CopyObjectRequest), AmazonS3.initiateMultipartUpload(InitiateMultipartUploadRequest)

deleteObject

public void deleteObject(java.lang.String bucketName,
                         java.lang.String key)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

deleteObject in interface AmazonS3

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:

deleteObject(DeleteObjectRequest)

deleteObject

public void deleteObject(DeleteObjectRequest deleteObjectRequest)
                  throws AmazonClientException,
                         AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

deleteObject in interface AmazonS3

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:

deleteObject(String, String)

deleteObjects

public DeleteObjectsResult deleteObjects(DeleteObjectsRequest deleteObjectsRequest)

Description copied from interface: AmazonS3

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.

Specified by:

deleteObjects in interface AmazonS3

Parameters:

deleteObjectsRequest - The request object containing all options for deleting multiple objects.

deleteVersion

public void deleteVersion(java.lang.String bucketName,
                          java.lang.String key,
                          java.lang.String versionId)
                   throws AmazonClientException,
                          AmazonServiceException

Description copied from interface: AmazonS3

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 AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .

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

Specified by:

deleteVersion in interface AmazonS3

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

public void deleteVersion(DeleteVersionRequest deleteVersionRequest)
                   throws AmazonClientException,
                          AmazonServiceException

Description copied from interface: AmazonS3

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.

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 AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .

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

Specified by:

deleteVersion in interface AmazonS3

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.

setBucketVersioningConfiguration

public void setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest setBucketVersioningConfigurationRequest)
                                      throws AmazonClientException,
                                             AmazonServiceException

Description copied from interface: AmazonS3

Sets the versioning configuration for the specified bucket.

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

• BucketVersioningConfiguration.OFF
• BucketVersioningConfiguration.ENABLED
• BucketVersioningConfiguration.SUSPENDED

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.

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.

Specified by:

setBucketVersioningConfiguration in interface AmazonS3

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:

AmazonS3.getBucketVersioningConfiguration(String)

getBucketVersioningConfiguration

public BucketVersioningConfiguration getBucketVersioningConfiguration(java.lang.String bucketName)
                                                               throws AmazonClientException,
                                                                      AmazonServiceException

Description copied from interface: AmazonS3

Returns the versioning configuration for the specified bucket.

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

• BucketVersioningConfiguration.OFF
• BucketVersioningConfiguration.ENABLED
• BucketVersioningConfiguration.SUSPENDED

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.

Specified by:

getBucketVersioningConfiguration in interface AmazonS3

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:

AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest), AmazonS3.getBucketVersioningConfiguration(GetBucketVersioningConfigurationRequest)

getBucketVersioningConfiguration

public BucketVersioningConfiguration getBucketVersioningConfiguration(GetBucketVersioningConfigurationRequest getBucketVersioningConfigurationRequest)
                                                               throws AmazonClientException,
                                                                      AmazonServiceException

Description copied from interface: AmazonS3

Returns the versioning configuration for the specified bucket.

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

• BucketVersioningConfiguration.OFF
• BucketVersioningConfiguration.ENABLED
• BucketVersioningConfiguration.SUSPENDED

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.

Specified by:

getBucketVersioningConfiguration in interface AmazonS3

Parameters:

getBucketVersioningConfigurationRequest - The request object for retrieving the bucket versioning configuration.

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:

AmazonS3.setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest), AmazonS3.getBucketVersioningConfiguration(String)

getBucketWebsiteConfiguration

public BucketWebsiteConfiguration getBucketWebsiteConfiguration(java.lang.String bucketName)
                                                         throws AmazonClientException,
                                                                AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getBucketWebsiteConfiguration in interface AmazonS3

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

public BucketWebsiteConfiguration getBucketWebsiteConfiguration(GetBucketWebsiteConfigurationRequest getBucketWebsiteConfigurationRequest)
                                                         throws AmazonClientException,
                                                                AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getBucketWebsiteConfiguration in interface AmazonS3

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.

getBucketLifecycleConfiguration

public BucketLifecycleConfiguration getBucketLifecycleConfiguration(java.lang.String bucketName)

Description copied from interface: AmazonS3

Gets the lifecycle configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.

Specified by:

getBucketLifecycleConfiguration in interface AmazonS3

Parameters:

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

See Also:

AmazonS3.getBucketLifecycleConfiguration(GetBucketLifecycleConfigurationRequest)

getBucketLifecycleConfiguration

public BucketLifecycleConfiguration getBucketLifecycleConfiguration(GetBucketLifecycleConfigurationRequest getBucketLifecycleConfigurationRequest)

Description copied from interface: AmazonS3

Gets the lifecycle configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.

Specified by:

getBucketLifecycleConfiguration in interface AmazonS3

Parameters:

getBucketLifecycleConfigurationRequest - The request object for retrieving the bucket lifecycle configuration.

See Also:

AmazonS3.getBucketLifecycleConfiguration(String)

setBucketLifecycleConfiguration

public void setBucketLifecycleConfiguration(java.lang.String bucketName,
                                            BucketLifecycleConfiguration bucketLifecycleConfiguration)

Description copied from interface: AmazonS3

Sets the lifecycle configuration for the specified bucket.

Specified by:

setBucketLifecycleConfiguration in interface AmazonS3

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.

setBucketLifecycleConfiguration

public void setBucketLifecycleConfiguration(SetBucketLifecycleConfigurationRequest setBucketLifecycleConfigurationRequest)

Description copied from interface: AmazonS3

Sets the lifecycle configuration for the specified bucket.

Specified by:

setBucketLifecycleConfiguration in interface AmazonS3

Parameters:

setBucketLifecycleConfigurationRequest - The request object containing all options for setting the bucket lifecycle configuration.

deleteBucketLifecycleConfiguration

public void deleteBucketLifecycleConfiguration(java.lang.String bucketName)

Description copied from interface: AmazonS3

Removes the lifecycle configuration for the bucket specified.

Specified by:

deleteBucketLifecycleConfiguration in interface AmazonS3

Parameters:

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

deleteBucketLifecycleConfiguration

public void deleteBucketLifecycleConfiguration(DeleteBucketLifecycleConfigurationRequest deleteBucketLifecycleConfigurationRequest)

Description copied from interface: AmazonS3

Removes the lifecycle configuration for the bucket specified.

Specified by:

deleteBucketLifecycleConfiguration in interface AmazonS3

Parameters:

deleteBucketLifecycleConfigurationRequest - The request object containing all options for removing the bucket lifecycle configuration.

getBucketCrossOriginConfiguration

public BucketCrossOriginConfiguration getBucketCrossOriginConfiguration(java.lang.String bucketName)

Description copied from interface: AmazonS3

Gets the cross origin configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.

Specified by:

getBucketCrossOriginConfiguration in interface AmazonS3

Parameters:

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

See Also:

AmazonS3.getBucketCrossOriginConfiguration(GetBucketCrossOriginConfigurationRequest)

getBucketCrossOriginConfiguration

public BucketCrossOriginConfiguration getBucketCrossOriginConfiguration(GetBucketCrossOriginConfigurationRequest getBucketCrossOriginConfigurationRequest)

Description copied from interface: AmazonS3

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

Specified by:

getBucketCrossOriginConfiguration in interface AmazonS3

Parameters:

getBucketCrossOriginConfigurationRequest - The request object for retrieving the bucket cross origin configuration.

See Also:

AmazonS3.getBucketCrossOriginConfiguration(String)

setBucketCrossOriginConfiguration

public void setBucketCrossOriginConfiguration(java.lang.String bucketName,
                                              BucketCrossOriginConfiguration bucketCrossOriginConfiguration)

Description copied from interface: AmazonS3

Sets the cross origin configuration for the specified bucket.

Specified by:

setBucketCrossOriginConfiguration in interface AmazonS3

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.

setBucketCrossOriginConfiguration

public void setBucketCrossOriginConfiguration(SetBucketCrossOriginConfigurationRequest setBucketCrossOriginConfigurationRequest)

Description copied from interface: AmazonS3

Sets the cross origin configuration for the specified bucket.

Specified by:

setBucketCrossOriginConfiguration in interface AmazonS3

Parameters:

setBucketCrossOriginConfigurationRequest - The request object containing all options for setting the bucket cross origin configuration.

deleteBucketCrossOriginConfiguration

public void deleteBucketCrossOriginConfiguration(java.lang.String bucketName)

Description copied from interface: AmazonS3

Delete the cross origin configuration for the specified bucket.

Specified by:

deleteBucketCrossOriginConfiguration in interface AmazonS3

Parameters:

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

deleteBucketCrossOriginConfiguration

public void deleteBucketCrossOriginConfiguration(DeleteBucketCrossOriginConfigurationRequest deleteBucketCrossOriginConfigurationRequest)

Description copied from interface: AmazonS3

Delete the cross origin configuration for the specified bucket.

Specified by:

deleteBucketCrossOriginConfiguration in interface AmazonS3

Parameters:

deleteBucketCrossOriginConfigurationRequest - The request object containing all options for deleting the bucket cross origin configuration.

getBucketTaggingConfiguration

public BucketTaggingConfiguration getBucketTaggingConfiguration(java.lang.String bucketName)

Description copied from interface: AmazonS3

Gets the tagging configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.

Specified by:

getBucketTaggingConfiguration in interface AmazonS3

Parameters:

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

See Also:

AmazonS3.getBucketTaggingConfiguration(GetBucketTaggingConfigurationRequest)

getBucketTaggingConfiguration

public BucketTaggingConfiguration getBucketTaggingConfiguration(GetBucketTaggingConfigurationRequest getBucketTaggingConfigurationRequest)

Description copied from interface: AmazonS3

Gets the tagging configuration for the specified bucket, or null if the specified bucket does not exists, or an empty list if no configuration has been established.

Specified by:

getBucketTaggingConfiguration in interface AmazonS3

Parameters:

getBucketTaggingConfigurationRequest - The request object for retrieving the bucket tagging configuration.

See Also:

AmazonS3.getBucketTaggingConfiguration(String)

setBucketTaggingConfiguration

public void setBucketTaggingConfiguration(java.lang.String bucketName,
                                          BucketTaggingConfiguration bucketTaggingConfiguration)

Description copied from interface: AmazonS3

Sets the tagging configuration for the specified bucket.

Specified by:

setBucketTaggingConfiguration in interface AmazonS3

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.

setBucketTaggingConfiguration

public void setBucketTaggingConfiguration(SetBucketTaggingConfigurationRequest setBucketTaggingConfigurationRequest)

Description copied from interface: AmazonS3

Sets the tagging configuration for the specified bucket.

Specified by:

setBucketTaggingConfiguration in interface AmazonS3

Parameters:

setBucketTaggingConfigurationRequest - The request object containing all options for setting the bucket tagging configuration.

deleteBucketTaggingConfiguration

public void deleteBucketTaggingConfiguration(java.lang.String bucketName)

Description copied from interface: AmazonS3

Removes the tagging configuration for the bucket specified.

Specified by:

deleteBucketTaggingConfiguration in interface AmazonS3

Parameters:

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

deleteBucketTaggingConfiguration

public void deleteBucketTaggingConfiguration(DeleteBucketTaggingConfigurationRequest deleteBucketTaggingConfigurationRequest)

Description copied from interface: AmazonS3

Removes the tagging configuration for the bucket specified.

Specified by:

deleteBucketTaggingConfiguration in interface AmazonS3

setBucketWebsiteConfiguration

public void setBucketWebsiteConfiguration(java.lang.String bucketName,
                                          BucketWebsiteConfiguration configuration)
                                   throws AmazonClientException,
                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

setBucketWebsiteConfiguration in interface AmazonS3

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

public void setBucketWebsiteConfiguration(SetBucketWebsiteConfigurationRequest setBucketWebsiteConfigurationRequest)
                                   throws AmazonClientException,
                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

setBucketWebsiteConfiguration in interface AmazonS3

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

public void deleteBucketWebsiteConfiguration(java.lang.String bucketName)
                                      throws AmazonClientException,
                                             AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

deleteBucketWebsiteConfiguration in interface AmazonS3

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

public void deleteBucketWebsiteConfiguration(DeleteBucketWebsiteConfigurationRequest deleteBucketWebsiteConfigurationRequest)
                                      throws AmazonClientException,
                                             AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

deleteBucketWebsiteConfiguration in interface AmazonS3

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.

setBucketNotificationConfiguration

public void setBucketNotificationConfiguration(java.lang.String bucketName,
                                               BucketNotificationConfiguration bucketNotificationConfiguration)
                                        throws AmazonClientException,
                                               AmazonServiceException

Description copied from interface: AmazonS3

Sets the notification configuration for the specified bucket.

By default, new buckets have no notification configuration set.

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.

Specified by:

setBucketNotificationConfiguration in interface AmazonS3

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.

setBucketNotificationConfiguration

public void setBucketNotificationConfiguration(SetBucketNotificationConfigurationRequest setBucketNotificationConfigurationRequest)
                                        throws AmazonClientException,
                                               AmazonServiceException

Description copied from interface: AmazonS3

Sets the notification configuration for the specified bucket.

By default, new buckets have no notification configuration set.

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.

Specified by:

setBucketNotificationConfiguration in interface AmazonS3

Parameters:

setBucketNotificationConfigurationRequest - 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.

getBucketNotificationConfiguration

public BucketNotificationConfiguration getBucketNotificationConfiguration(java.lang.String bucketName)
                                                                   throws AmazonClientException,
                                                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getBucketNotificationConfiguration in interface AmazonS3

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.

See Also:

AmazonS3.getBucketNotificationConfiguration(GetBucketNotificationConfigurationRequest)

getBucketNotificationConfiguration

public BucketNotificationConfiguration getBucketNotificationConfiguration(GetBucketNotificationConfigurationRequest getBucketNotificationConfigurationRequest)
                                                                   throws AmazonClientException,
                                                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getBucketNotificationConfiguration in interface AmazonS3

Parameters:

getBucketNotificationConfigurationRequest - The bucket notification configuration request.

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.

getBucketLoggingConfiguration

public BucketLoggingConfiguration getBucketLoggingConfiguration(java.lang.String bucketName)
                                                         throws AmazonClientException,
                                                                AmazonServiceException

Description copied from interface: AmazonS3

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

Specified by:

getBucketLoggingConfiguration in interface AmazonS3

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:

AmazonS3.setBucketLoggingConfiguration(SetBucketLoggingConfigurationRequest), AmazonS3.getBucketLoggingConfiguration(GetBucketLoggingConfigurationRequest)

getBucketLoggingConfiguration

public BucketLoggingConfiguration getBucketLoggingConfiguration(GetBucketLoggingConfigurationRequest getBucketLoggingConfigurationRequest)
                                                         throws AmazonClientException,
                                                                AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

getBucketLoggingConfiguration in interface AmazonS3

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:

AmazonS3.setBucketLoggingConfiguration(SetBucketLoggingConfigurationRequest), AmazonS3.getBucketLoggingConfiguration(String)

setBucketLoggingConfiguration

public void setBucketLoggingConfiguration(SetBucketLoggingConfigurationRequest setBucketLoggingConfigurationRequest)
                                   throws AmazonClientException,
                                          AmazonServiceException

Description copied from interface: AmazonS3

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.

Specified by:

setBucketLoggingConfiguration in interface AmazonS3

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:

AmazonS3.getBucketLoggingConfiguration(String)

getBucketAccelerateConfiguration

public BucketAccelerateConfiguration getBucketAccelerateConfiguration(java.lang.String bucketName)
                                                               throws AmazonServiceException,
                                                                      AmazonClientException

Description copied from interface: AmazonS3

Retrieves the accelerate configuration for the given bucket.

Specified by:

getBucketAccelerateConfiguration in interface AmazonS3

Returns:

the accelerate configuration of the bucket.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

getBucketAccelerateConfiguration

public BucketAccelerateConfiguration getBucketAccelerateConfiguration(GetBucketAccelerateConfigurationRequest getBucketAccelerateConfigurationRequest)
                                                               throws AmazonServiceException,
                                                                      AmazonClientException

Description copied from interface: AmazonS3

Retrieves the accelerate configuration for the given bucket.

Specified by:

getBucketAccelerateConfiguration in interface AmazonS3

Parameters:

getBucketAccelerateConfigurationRequest - The request object for retrieving the bucket accelerate configuration.

Returns:

the accelerate configuration of the bucket.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

setBucketAccelerateConfiguration

public void setBucketAccelerateConfiguration(java.lang.String bucketName,
                                             BucketAccelerateConfiguration accelerateConfiguration)
                                      throws AmazonServiceException,
                                             AmazonClientException

Description copied from interface: AmazonS3

Sets the accelerate configuration for the specified bucket. *

Specified by:

setBucketAccelerateConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket whose accelerate configuration is being set.

accelerateConfiguration - The new accelerate configuration for this bucket, which completely replaces any existing configuration.

Throws:

AmazonServiceException

AmazonClientException

setBucketAccelerateConfiguration

public void setBucketAccelerateConfiguration(SetBucketAccelerateConfigurationRequest setBucketAccelerateConfigurationRequest)
                                      throws AmazonServiceException,
                                             AmazonClientException

Description copied from interface: AmazonS3

Sets the accelerate configuration for the specified bucket.

Specified by:

setBucketAccelerateConfiguration in interface AmazonS3

Parameters:

setBucketAccelerateConfigurationRequest - The request object containing all options for setting the bucket accelerate configuration.

Throws:

AmazonServiceException

AmazonClientException

getBucketPolicy

public BucketPolicy getBucketPolicy(java.lang.String bucketName)
                             throws AmazonClientException,
                                    AmazonServiceException

Description copied from interface: AmazonS3

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.

Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.

See the Amazon S3 developer guide for more information on forming bucket polices.

Specified by:

getBucketPolicy in interface AmazonS3

Parameters:

bucketName - The name of the Amazon S3 bucket whose policy is being retrieved.

Returns:

The Amazon S3 bucket policy 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:

AmazonS3.setBucketPolicy(String, String)

setBucketPolicy

public void setBucketPolicy(java.lang.String bucketName,
                            java.lang.String policyText)
                     throws AmazonClientException,
                            AmazonServiceException

Description copied from interface: AmazonS3

Sets the policy associated with the specified bucket. Only the owner of the bucket can set a bucket policy. If a policy already exists for the specified bucket, the new policy replaces the existing policy.

Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.

See the Amazon S3 developer guide for more information on forming bucket polices.

Specified by:

setBucketPolicy in interface AmazonS3

Parameters:

bucketName - The name of the Amazon S3 bucket whose policy is being set.

policyText - The policy to apply to 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.

deleteBucketPolicy

public void deleteBucketPolicy(java.lang.String bucketName)
                        throws AmazonClientException,
                               AmazonServiceException

Description copied from interface: AmazonS3

Deletes the policy associated with the specified bucket. Only the owner of the bucket can delete the bucket policy.

Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.

See the Amazon S3 developer guide for more information on forming bucket polices.

Specified by:

deleteBucketPolicy in interface AmazonS3

Parameters:

bucketName - The name of the Amazon S3 bucket whose policy is being deleted.

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.

getBucketPolicy

public BucketPolicy getBucketPolicy(GetBucketPolicyRequest getBucketPolicyRequest)
                             throws AmazonClientException,
                                    AmazonServiceException

Description copied from interface: AmazonS3

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.

Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.

See the Amazon S3 developer guide for more information on forming bucket polices.

Specified by:

getBucketPolicy in interface AmazonS3

Parameters:

getBucketPolicyRequest - The request object containing all of the details for retreiving a bucket's policy.

Returns:

The Amazon S3 bucket policy 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:

AmazonS3.setBucketPolicy(String, String)

setBucketPolicy

public void setBucketPolicy(SetBucketPolicyRequest setBucketPolicyRequest)
                     throws AmazonClientException,
                            AmazonServiceException

Description copied from interface: AmazonS3

Sets the policy associated with the specified bucket. Only the owner of the bucket can set a bucket policy. If a policy already exists for the specified bucket, the new policy replaces the existing policy.

Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.

See the Amazon S3 developer guide for more information on forming bucket polices.

Specified by:

setBucketPolicy in interface AmazonS3

Parameters:

setBucketPolicyRequest - The request object containing the details of the bucket and policy to update.

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.

deleteBucketPolicy

public void deleteBucketPolicy(DeleteBucketPolicyRequest deleteBucketPolicyRequest)
                        throws AmazonClientException,
                               AmazonServiceException

Description copied from interface: AmazonS3

Deletes the policy associated with the specified bucket. Only the owner of the bucket can delete the bucket policy.

Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.

See the Amazon S3 developer guide for more information on forming bucket polices.

Specified by:

deleteBucketPolicy in interface AmazonS3

Parameters:

deleteBucketPolicyRequest - The request object containing all the details for deleting a bucket's policy.

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.

generatePresignedUrl

public java.net.URL generatePresignedUrl(java.lang.String bucketName,
                                         java.lang.String key,
                                         java.util.Date expiration)
                                  throws AmazonClientException

Description copied from interface: AmazonS3

Returns a pre-signed URL for accessing an Amazon S3 resource.

Pre-signed URLs allow clients to form a URL for an Amazon S3 resource, and then sign it with the current AWS security credentials. The pre-signed URL can be shared to other users, allowing access to the resource without providing an account's AWS security credentials.

Pre-signed URLs are useful in many situations where AWS security credentials aren't available from the client that needs to make the actual request to Amazon S3.

For example, an application may need remote users to upload files to the application owner's Amazon S3 bucket, but doesn't need to ship the AWS security credentials with the application. A pre-signed URL to PUT an object into the owner's bucket can be generated from a remote location with the owner's AWS security credentials, then the pre-signed URL can be passed to the end user's application to use.

If you are generating presigned url for AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

generatePresignedUrl in interface AmazonS3

Parameters:

bucketName - The name of the bucket containing the desired object.

key - The key in the specified bucket under which the desired object is stored.

expiration - The time at which the returned pre-signed URL will expire.

Returns:

A pre-signed URL which expires at the specified time, and can be used to allow anyone to download the specified object from S3, without exposing the owner's AWS secret access key.

Throws:

AmazonClientException - If there were any problems pre-signing the request for the specified S3 object.

See Also:

AmazonS3.generatePresignedUrl(String, String, Date, HttpMethod), AmazonS3.generatePresignedUrl(GeneratePresignedUrlRequest)

generatePresignedUrl

public java.net.URL generatePresignedUrl(java.lang.String bucketName,
                                         java.lang.String key,
                                         java.util.Date expiration,
                                         HttpMethod method)
                                  throws AmazonClientException

Description copied from interface: AmazonS3

Returns a pre-signed URL for accessing an Amazon S3 resource.

Pre-signed URLs allow clients to form a URL for an Amazon S3 resource, and then sign it with the current AWS security credentials. The pre-signed URL can be shared to other users, allowing access to the resource without providing an account's AWS security credentials.

Pre-signed URLs are useful in many situations where AWS security credentials aren't available from the client that needs to make the actual request to Amazon S3.

For example, an application may need remote users to upload files to the application owner's Amazon S3 bucket, but doesn't need to ship the AWS security credentials with the application. A pre-signed URL to PUT an object into the owner's bucket can be generated from a remote location with the owner's AWS security credentials, then the pre-signed URL can be passed to the end user's application to use.

If you are generating presigned url for AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

generatePresignedUrl in interface AmazonS3

Parameters:

bucketName - The name of the bucket containing the desired object.

key - The key in the specified bucket under which the desired object is stored.

expiration - The time at which the returned pre-signed URL will expire.

method - The HTTP method verb to use for this URL

Returns:

A pre-signed URL which expires at the specified time, and can be used to allow anyone to download the specified object from S3, without exposing the owner's AWS secret access key.

Throws:

AmazonClientException - If there were any problems pre-signing the request for the specified S3 object.

See Also:

AmazonS3.generatePresignedUrl(String, String, Date), AmazonS3.generatePresignedUrl(GeneratePresignedUrlRequest)

generatePresignedUrl

public java.net.URL generatePresignedUrl(GeneratePresignedUrlRequest generatePresignedUrlRequest)
                                  throws AmazonClientException

Description copied from interface: AmazonS3

Returns a pre-signed URL for accessing an Amazon S3 resource.

Pre-signed URLs allow clients to form a URL for an Amazon S3 resource, and then sign it with the current AWS security credentials. The pre-signed URL can be shared to other users, allowing access to the resource without providing an account's AWS security credentials.

Pre-signed URLs are useful in many situations where AWS security credentials aren't available from the client that needs to make the actual request to Amazon S3.

For example, an application may need remote users to upload files to the application owner's Amazon S3 bucket, but doesn't need to ship the AWS security credentials with the application. A pre-signed URL to PUT an object into the owner's bucket can be generated from a remote location with the owner's AWS security credentials, then the pre-signed URL can be passed to the end user's application to use.

Note that presigned URLs cannot be used to upload an object with an attached policy, as described in this blog post. That method is only suitable for POSTs from HTML forms by browsers.

If you are generating presigned url for AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

generatePresignedUrl in interface AmazonS3

Parameters:

generatePresignedUrlRequest - The request object containing all the options for generating a pre-signed URL (bucket name, key, expiration date, etc).

Returns:

A pre-signed URL that can be used to access an Amazon S3 resource without requiring the user of the URL to know the account's AWS security credentials.

Throws:

AmazonClientException - If there were any problems pre-signing the request for the Amazon S3 resource.

See Also:

AmazonS3.generatePresignedUrl(String, String, Date), AmazonS3.generatePresignedUrl(String, String, Date, HttpMethod)

abortMultipartUpload

public void abortMultipartUpload(AbortMultipartUploadRequest abortMultipartUploadRequest)
                          throws AmazonClientException,
                                 AmazonServiceException

Description copied from interface: AmazonS3

Aborts a multipart upload. After a multipart upload is aborted, no additional parts can be uploaded using that upload ID. The storage consumed by any previously uploaded parts will be freed. However, if any part uploads are currently in progress, those part uploads may or may not succeed. As a result, it may be necessary to abort a given multipart upload multiple times in order to completely free all storage consumed by all parts.

Specified by:

abortMultipartUpload in interface AmazonS3

Specified by:

abortMultipartUpload in interface com.amazonaws.services.s3.internal.S3DirectSpi

Parameters:

abortMultipartUploadRequest - The AbortMultipartUploadRequest object that specifies all the parameters of this operation.

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.

completeMultipartUpload

public CompleteMultipartUploadResult completeMultipartUpload(CompleteMultipartUploadRequest completeMultipartUploadRequest)
                                                      throws AmazonClientException,
                                                             AmazonServiceException

Description copied from interface: AmazonS3

Completes a multipart upload by assembling previously uploaded parts.

You first upload all parts using the AmazonS3.uploadPart(UploadPartRequest) method. After successfully uploading all individual parts of an upload, you call this operation to complete the upload. Upon receiving this request, Amazon S3 concatenates all the parts in ascending order by part number to create a new object. In the CompleteMultipartUpload request, you must provide the parts list. For each part in the list, you provide the part number and the ETag header value, returned after that part was uploaded.

Processing of a CompleteMultipartUpload request may take several minutes to complete.

If you are perfoming a complete multipart upload for AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

completeMultipartUpload in interface AmazonS3

Specified by:

completeMultipartUpload in interface com.amazonaws.services.s3.internal.S3DirectSpi

Parameters:

completeMultipartUploadRequest - The CompleteMultipartUploadRequest object that specifies all the parameters of this operation.

Returns:

A CompleteMultipartUploadResult from S3 containing the ETag for the new object composed of the individual parts.

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.

initiateMultipartUpload

public InitiateMultipartUploadResult initiateMultipartUpload(InitiateMultipartUploadRequest initiateMultipartUploadRequest)
                                                      throws AmazonClientException,
                                                             AmazonServiceException

Description copied from interface: AmazonS3

Initiates a multipart upload and returns an InitiateMultipartUploadResult which contains an upload ID. This upload ID associates all the parts in the specific upload and is used in each of your subsequent AmazonS3.uploadPart(UploadPartRequest) requests. You also include this upload ID in the final request to either complete, or abort the multipart upload request.

Note: After you initiate a multipart upload and upload one or more parts, you must either complete or abort the multipart upload in order to stop getting charged for storage of the uploaded parts. Once you complete or abort the multipart upload Amazon S3 will release the stored parts and stop charging you for their storage.

If you are initiating a multipart upload for AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

initiateMultipartUpload in interface AmazonS3

Specified by:

initiateMultipartUpload in interface com.amazonaws.services.s3.internal.S3DirectSpi

Parameters:

initiateMultipartUploadRequest - The InitiateMultipartUploadRequest object that specifies all the parameters of this operation.

Returns:

An InitiateMultipartUploadResult from Amazon S3.

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.

listMultipartUploads

public MultipartUploadListing listMultipartUploads(ListMultipartUploadsRequest listMultipartUploadsRequest)
                                            throws AmazonClientException,
                                                   AmazonServiceException

Description copied from interface: AmazonS3

Lists in-progress multipart uploads. An in-progress multipart upload is a multipart upload that has been initiated, using the InitiateMultipartUpload request, but has not yet been completed or aborted.

This operation returns at most 1,000 multipart uploads in the response by default. The number of multipart uploads can be further limited using the MaxUploads property on the request parameter. If there are additional multipart uploads that satisfy the list criteria, the response will contain an IsTruncated property with the value set to true. To list the additional multipart uploads use the KeyMarker and UploadIdMarker properties on the request parameters.

Specified by:

listMultipartUploads in interface AmazonS3

Parameters:

listMultipartUploadsRequest - The ListMultipartUploadsRequest object that specifies all the parameters of this operation.

Returns:

A MultipartUploadListing from Amazon S3.

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.

listParts

public PartListing listParts(ListPartsRequest listPartsRequest)
                      throws AmazonClientException,
                             AmazonServiceException

Description copied from interface: AmazonS3

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

This method must include the upload ID, returned by the AmazonS3.initiateMultipartUpload(InitiateMultipartUploadRequest) operation. This request returns a maximum of 1000 uploaded parts by default. You can restrict the number of parts returned by specifying the MaxParts property on the ListPartsRequest. If your multipart upload consists of more parts than allowed in the ListParts response, the response returns a IsTruncated field with value true, and a NextPartNumberMarker property. In subsequent ListParts request you can include the PartNumberMarker property and set its value to the NextPartNumberMarker property value from the previous response.

Specified by:

listParts in interface AmazonS3

Parameters:

listPartsRequest - The ListPartsRequest object that specifies all the parameters of this operation.

Returns:

Returns a PartListing from Amazon S3.

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.

uploadPart

public UploadPartResult uploadPart(UploadPartRequest uploadPartRequest)
                            throws AmazonClientException,
                                   AmazonServiceException

Description copied from interface: AmazonS3

Uploads a part in a multipart upload. You must initiate a multipart upload before you can upload any part.

Your UploadPart request must include an upload ID and a part number. The upload ID is the ID returned by Amazon S3 in response to your Initiate Multipart Upload request. Part number can be any number between 1 and 10,000, inclusive. A part number uniquely identifies a part and also defines its position within the object being uploaded. If you upload a new part using the same part number that was specified in uploading a previous part, the previously uploaded part is overwritten.

To ensure data is not corrupted traversing the network, specify the Content-MD5 header in the Upload Part request. Amazon S3 checks the part data against the provided MD5 value. If they do not match, Amazon S3 returns an error.

When you upload a part, the returned UploadPartResult contains an ETag property. You should record this ETag property value and the part number. After uploading all parts, you must send a CompleteMultipartUpload request. At that time Amazon S3 constructs a complete object by concatenating all the parts you uploaded, in ascending order based on the part numbers. The CompleteMultipartUpload request requires you to send all the part numbers and the corresponding ETag values.

Note: After you initiate a multipart upload and upload one or more parts, you must either complete or abort the multipart upload in order to stop getting charged for storage of the uploaded parts. Once you complete or abort the multipart upload Amazon S3 will release the stored parts and stop charging you for their storage.

If you are performing upload part for AWS KMS-encrypted objects, you need to specify the correct region of the bucket on your client and configure AWS Signature Version 4 for added security. For more information on how to do this, see http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html# specify-signature-version

Specified by:

uploadPart in interface AmazonS3

Specified by:

uploadPart in interface com.amazonaws.services.s3.internal.S3DirectSpi

Parameters:

uploadPartRequest - The UploadPartRequest object that specifies all the parameters of this operation.

Returns:

An UploadPartResult from Amazon S3 containing the part number and ETag of the new part.

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.

getCachedResponseMetadata

public S3ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Description copied from interface: AmazonS3

Gets additional metadata for a previously executed successful request. The returned metadata is typically used for debugging issues when a service isn't acting as expected. This data isn't considered part of the result data returned by an operation; as so, it's available through this separate diagnostic interface.

Response metadata is only cached for a limited period of time. Use this method to retrieve the response metadata as soon as possible after executing a request.

Specified by:

getCachedResponseMetadata in interface AmazonS3

Parameters:

request - The originally executed request.

Returns:

The response metadata for the specified request, or null if none is available.

restoreObject

public void restoreObject(RestoreObjectRequest restoreObjectRequest)
                   throws AmazonServiceException

Description copied from interface: AmazonS3

Restore an object, which was transitioned to Amazon Glacier from Amazon S3 when it was expired, into Amazon S3 again. This copy is by nature temporary and is always stored as RRS in Amazon S3. The customer will be able to set / re-adjust the lifetime of this copy. By re-adjust we mean the customer can call this API to shorten or extend the lifetime of the copy. Note the request will only be accepted when there is no ongoing restore request. One needs to have the new s3:RestoreObject permission to perform this operation.

Specified by:

restoreObject in interface AmazonS3

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

See Also:

restoreObject(String, String, int)

restoreObject

public void restoreObject(java.lang.String bucketName,
                          java.lang.String key,
                          int expirationInDays)
                   throws AmazonServiceException

(non-Javadoc)

Specified by:

restoreObject in interface AmazonS3

Parameters:

bucketName - The name of an existing bucket.

key - The key under which to store the specified file.

expirationInDays - The number of days after which the object will expire.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

See Also:

com.amazonaws.services.s3.AmazonS3#copyGlacierObject((java.lang.String , java.lang.String, int)

getResourceUrl

public java.lang.String getResourceUrl(java.lang.String bucketName,
                                       java.lang.String key)

Returns the URL to the key in the bucket given, using the client's scheme and endpoint. Returns null if the given bucket and key cannot be converted to a URL.

getUrl

public java.net.URL getUrl(java.lang.String bucketName,
                           java.lang.String key)

Returns an URL for the object stored in the specified bucket and key.

If the object identified by the given bucket and key has public read permissions (ex: CannedAccessControlList.PublicRead), then this URL can be directly accessed to retrieve the object's data.

Specified by:

getUrl in interface AmazonS3

Parameters:

bucketName - The name of the bucket containing the object whose URL is being requested.

key - The key under which the object whose URL is being requested is stored.

Returns:

A unique URL for the object stored in the specified bucket and key.

getRegion

public Region getRegion()

Description copied from interface: AmazonS3

Returns the region with which the client is configured.

Specified by:

getRegion in interface AmazonS3

Returns:

The region this client will communicate with.

enableRequesterPays

public void enableRequesterPays(java.lang.String bucketName)

Description copied from interface: AmazonS3

Allows Amazon S3 bucket owner to enable the Requester Pays for the given bucket name. If enabled, the requester of an Amazon S3 object in the bucket is charged for the downloading the data from the bucket.

If a bucket is enabled for Requester Pays, then any attempt to read an object from it without Requester Pays enabled in getObject will result in a 403 error and the bucket owner will be charged for the request.

Enabling Requester Pays disables the ability to have anonymous access to this bucket

For more information on Requester pays, @see http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Specified by:

enableRequesterPays in interface AmazonS3

Parameters:

bucketName - The name of the bucket being enabled for Requester Pays.

See Also:

AmazonS3.disableRequesterPays(String), AmazonS3.isRequesterPaysEnabled(String)

disableRequesterPays

public void disableRequesterPays(java.lang.String bucketName)

Description copied from interface: AmazonS3

Allows Amazon S3 bucket owner to disable the Requester Pays for the given bucket name. Note:

If a bucket is enabled for Requester Pays, then any attempt to read an object from it without Requester Pays enabled in getObject will result in a 403 error and the bucket owner will be charged for the request.

Enabling Requester Pays disables the ability to have anonymous access to this bucket

For more information on Requester pays, @see http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Specified by:

disableRequesterPays in interface AmazonS3

Parameters:

bucketName - The name of bucket being disabled for Requester Pays.

See Also:

AmazonS3.enableRequesterPays(String), AmazonS3.isRequesterPaysEnabled(String)

isRequesterPaysEnabled

public boolean isRequesterPaysEnabled(java.lang.String bucketName)

Description copied from interface: AmazonS3

Retrieves the Requester Pays configuration associated with an Amazon S3 bucket. Note:

If a bucket is enabled for Requester Pays, then any attempt to read an object from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.

Enabling Requester Pays disables the ability to have anonymous access to this bucket.

For more information on Requester pays, @see http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Specified by:

isRequesterPaysEnabled in interface AmazonS3

Parameters:

bucketName - The name of the bucket being checked for Requester Pays.

Returns:

true if the bucket is enabled for Requester Pays else false.

See Also:

AmazonS3.enableRequesterPays(String), AmazonS3.disableRequesterPays(String)

setBucketReplicationConfiguration

public void setBucketReplicationConfiguration(java.lang.String bucketName,
                                              BucketReplicationConfiguration configuration)
                                       throws AmazonServiceException,
                                              AmazonClientException

Description copied from interface: AmazonS3

Sets a replication configuration for the Amazon S3 bucket.

Specified by:

setBucketReplicationConfiguration in interface AmazonS3

Parameters:

bucketName - The Amazon S3 bucket for which the replication configuration is set.

configuration - The replication configuration.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

See Also:

AmazonS3.setBucketReplicationConfiguration(SetBucketReplicationConfigurationRequest), AmazonS3.getBucketReplicationConfiguration(String), AmazonS3.deleteBucketReplicationConfiguration(String)

setBucketReplicationConfiguration

public void setBucketReplicationConfiguration(SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest)
                                       throws AmazonServiceException,
                                              AmazonClientException

Description copied from interface: AmazonS3

Sets a replication configuration for the Amazon S3 bucket.

Specified by:

setBucketReplicationConfiguration in interface AmazonS3

Parameters:

setBucketReplicationConfigurationRequest - The request object containing all the options for setting a replication configuration for an Amazon S3 bucket.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

See Also:

AmazonS3.setBucketReplicationConfiguration(String, BucketReplicationConfiguration), AmazonS3.getBucketReplicationConfiguration(String), AmazonS3.deleteBucketReplicationConfiguration(String)

getBucketReplicationConfiguration

public BucketReplicationConfiguration getBucketReplicationConfiguration(java.lang.String bucketName)
                                                                 throws AmazonServiceException,
                                                                        AmazonClientException

Description copied from interface: AmazonS3

Retrieves the replication configuration for the given Amazon S3 bucket.

Specified by:

getBucketReplicationConfiguration in interface AmazonS3

Parameters:

bucketName - The bucket name for which the replication configuration is to be retrieved.

Returns:

the replication configuration of the bucket.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

See Also:

AmazonS3.setBucketReplicationConfiguration(String, BucketReplicationConfiguration), AmazonS3.deleteBucketReplicationConfiguration(String)

getBucketReplicationConfiguration

public BucketReplicationConfiguration getBucketReplicationConfiguration(GetBucketReplicationConfigurationRequest getBucketReplicationConfigurationRequest)
                                                                 throws AmazonServiceException,
                                                                        AmazonClientException

Description copied from interface: AmazonS3

Retrieves the replication configuration for the given Amazon S3 bucket.

Specified by:

getBucketReplicationConfiguration in interface AmazonS3

Parameters:

getBucketReplicationConfigurationRequest - The request object for retrieving the bucket replication configuration.

Returns:

the replication configuration of the bucket.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

See Also:

AmazonS3.setBucketReplicationConfiguration(String, BucketReplicationConfiguration), AmazonS3.deleteBucketReplicationConfiguration(String)

deleteBucketReplicationConfiguration

public void deleteBucketReplicationConfiguration(java.lang.String bucketName)
                                          throws AmazonServiceException,
                                                 AmazonClientException

Description copied from interface: AmazonS3

Deletes the replication configuration for the given Amazon S3 bucket.

Specified by:

deleteBucketReplicationConfiguration in interface AmazonS3

Parameters:

bucketName - The bucket name for which the replication configuration is to be deleted.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

See Also:

AmazonS3.setBucketReplicationConfiguration(String, BucketReplicationConfiguration), AmazonS3.getBucketReplicationConfiguration(String), AmazonS3.deleteBucketReplicationConfiguration(DeleteBucketReplicationConfigurationRequest)

deleteBucketReplicationConfiguration

public void deleteBucketReplicationConfiguration(DeleteBucketReplicationConfigurationRequest deleteBucketReplicationConfigurationRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

Description copied from interface: AmazonS3

Deletes the replication configuration for the given Amazon S3 bucket.

Specified by:

deleteBucketReplicationConfiguration in interface AmazonS3

Parameters:

deleteBucketReplicationConfigurationRequest - The request object for delete bucket replication configuration.

Throws:

AmazonServiceException - If any errors occurred in Amazon S3 while processing the request.

AmazonClientException - If any errors are encountered in the client while making the request or handling the response.

See Also:

AmazonS3.setBucketReplicationConfiguration(String, BucketReplicationConfiguration), AmazonS3.getBucketReplicationConfiguration(String), AmazonS3.deleteBucketReplicationConfiguration(String)

deleteBucketMetricsConfiguration

public DeleteBucketMetricsConfigurationResult deleteBucketMetricsConfiguration(java.lang.String bucketName,
                                                                               java.lang.String id)
                                                                        throws AmazonServiceException,
                                                                               AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

deleteBucketMetricsConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket from which the metrics configuration is to be deleted

id - The ID of the metrics configuration to delete.

Throws:

AmazonServiceException

AmazonClientException

deleteBucketMetricsConfiguration

public DeleteBucketMetricsConfigurationResult deleteBucketMetricsConfiguration(DeleteBucketMetricsConfigurationRequest deleteBucketMetricsConfigurationRequest)
                                                                        throws AmazonServiceException,
                                                                               AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

deleteBucketMetricsConfiguration in interface AmazonS3

Parameters:

deleteBucketMetricsConfigurationRequest - The request object to delete the metrics configuration.

Throws:

AmazonServiceException

AmazonClientException

getBucketMetricsConfiguration

public GetBucketMetricsConfigurationResult getBucketMetricsConfiguration(java.lang.String bucketName,
                                                                         java.lang.String id)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

getBucketMetricsConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket to get the metrics configuration from.

id - The ID of the metrics configuration to get.

Returns:

The result containing the requested metrics configuration.

Throws:

AmazonServiceException

AmazonClientException

getBucketMetricsConfiguration

public GetBucketMetricsConfigurationResult getBucketMetricsConfiguration(GetBucketMetricsConfigurationRequest getBucketMetricsConfigurationRequest)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

getBucketMetricsConfiguration in interface AmazonS3

Parameters:

getBucketMetricsConfigurationRequest - The request object to retrieve the metrics configuration.

Returns:

The result containing the requested metrics configuration.

Throws:

AmazonServiceException

AmazonClientException

setBucketMetricsConfiguration

public SetBucketMetricsConfigurationResult setBucketMetricsConfiguration(java.lang.String bucketName,
                                                                         MetricsConfiguration metricsConfiguration)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

setBucketMetricsConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket to set the metrics configuration.

metricsConfiguration - The metrics configuration to set.

Throws:

AmazonServiceException

AmazonClientException

setBucketMetricsConfiguration

public SetBucketMetricsConfigurationResult setBucketMetricsConfiguration(SetBucketMetricsConfigurationRequest setBucketMetricsConfigurationRequest)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

setBucketMetricsConfiguration in interface AmazonS3

Parameters:

setBucketMetricsConfigurationRequest - The request object to set the metrics configuration.

Throws:

AmazonServiceException

AmazonClientException

listBucketMetricsConfigurations

public ListBucketMetricsConfigurationsResult listBucketMetricsConfigurations(ListBucketMetricsConfigurationsRequest listBucketMetricsConfigurationsRequest)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

Lists the metrics configurations for the bucket.

Specified by:

listBucketMetricsConfigurations in interface AmazonS3

Parameters:

listBucketMetricsConfigurationsRequest - The request object to list all the metrics configurations for a bucket.

Returns:

The result containing the list of all the metrics configurations for the bucket.

Throws:

AmazonServiceException

AmazonClientException

deleteBucketAnalyticsConfiguration

public DeleteBucketAnalyticsConfigurationResult deleteBucketAnalyticsConfiguration(java.lang.String bucketName,
                                                                                   java.lang.String id)
                                                                            throws AmazonServiceException,
                                                                                   AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

deleteBucketAnalyticsConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket from which the analytics configuration is to be deleted

id - The ID of the analytics configuration to delete.

Throws:

AmazonServiceException

AmazonClientException

deleteBucketAnalyticsConfiguration

public DeleteBucketAnalyticsConfigurationResult deleteBucketAnalyticsConfiguration(DeleteBucketAnalyticsConfigurationRequest deleteBucketAnalyticsConfigurationRequest)
                                                                            throws AmazonServiceException,
                                                                                   AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

deleteBucketAnalyticsConfiguration in interface AmazonS3

Parameters:

deleteBucketAnalyticsConfigurationRequest - The request object to delete the analytics configuration.

Throws:

AmazonServiceException

AmazonClientException

getBucketAnalyticsConfiguration

public GetBucketAnalyticsConfigurationResult getBucketAnalyticsConfiguration(java.lang.String bucketName,
                                                                             java.lang.String id)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

getBucketAnalyticsConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket to get the analytics configuration from.

id - The ID of the analytics configuration to get.

Returns:

The result containing the requested analytics configuration.

Throws:

AmazonServiceException

AmazonClientException

getBucketAnalyticsConfiguration

public GetBucketAnalyticsConfigurationResult getBucketAnalyticsConfiguration(GetBucketAnalyticsConfigurationRequest getBucketAnalyticsConfigurationRequest)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

getBucketAnalyticsConfiguration in interface AmazonS3

Parameters:

getBucketAnalyticsConfigurationRequest - The request object to retrieve the analytics configuration.

Returns:

The result containing the requested analytics configuration.

Throws:

AmazonServiceException

AmazonClientException

setBucketAnalyticsConfiguration

public SetBucketAnalyticsConfigurationResult setBucketAnalyticsConfiguration(java.lang.String bucketName,
                                                                             AnalyticsConfiguration analyticsConfiguration)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

setBucketAnalyticsConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket to set the analytics configuration.

analyticsConfiguration - The analytics configuration to set.

Throws:

AmazonServiceException

AmazonClientException

setBucketAnalyticsConfiguration

public SetBucketAnalyticsConfigurationResult setBucketAnalyticsConfiguration(SetBucketAnalyticsConfigurationRequest setBucketAnalyticsConfigurationRequest)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

setBucketAnalyticsConfiguration in interface AmazonS3

Parameters:

setBucketAnalyticsConfigurationRequest - The request object to set the analytics configuration.

Throws:

AmazonServiceException

AmazonClientException

listBucketAnalyticsConfigurations

public ListBucketAnalyticsConfigurationsResult listBucketAnalyticsConfigurations(ListBucketAnalyticsConfigurationsRequest listBucketAnalyticsConfigurationsRequest)
                                                                          throws AmazonServiceException,
                                                                                 AmazonClientException

Description copied from interface: AmazonS3

Lists the analytics configurations for the bucket.

Specified by:

listBucketAnalyticsConfigurations in interface AmazonS3

Parameters:

listBucketAnalyticsConfigurationsRequest - The request object to list all the analytics configurations for a bucket.

Returns:

All the analytics configurations for the bucket.

Throws:

AmazonServiceException

AmazonClientException

deleteBucketInventoryConfiguration

public DeleteBucketInventoryConfigurationResult deleteBucketInventoryConfiguration(java.lang.String bucketName,
                                                                                   java.lang.String id)
                                                                            throws AmazonServiceException,
                                                                                   AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

deleteBucketInventoryConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket from which the inventory configuration is to be deleted.

id - The ID of the inventory configuration to delete.

Throws:

AmazonServiceException

AmazonClientException

deleteBucketInventoryConfiguration

public DeleteBucketInventoryConfigurationResult deleteBucketInventoryConfiguration(DeleteBucketInventoryConfigurationRequest deleteBucketInventoryConfigurationRequest)
                                                                            throws AmazonServiceException,
                                                                                   AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

deleteBucketInventoryConfiguration in interface AmazonS3

Parameters:

deleteBucketInventoryConfigurationRequest - The request object for deleting an inventory configuration.

Throws:

AmazonServiceException

AmazonClientException

getBucketInventoryConfiguration

public GetBucketInventoryConfigurationResult getBucketInventoryConfiguration(java.lang.String bucketName,
                                                                             java.lang.String id)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

getBucketInventoryConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket to get the inventory configuration from.

id - The ID of the inventory configuration to delete.

Returns:

An GetBucketInventoryConfigurationResult object containing the inventory configuration.

Throws:

AmazonServiceException

AmazonClientException

getBucketInventoryConfiguration

public GetBucketInventoryConfigurationResult getBucketInventoryConfiguration(GetBucketInventoryConfigurationRequest getBucketInventoryConfigurationRequest)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

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

Specified by:

getBucketInventoryConfiguration in interface AmazonS3

Parameters:

getBucketInventoryConfigurationRequest - The request object to retreive an inventory configuration.

Returns:

An GetBucketInventoryConfigurationResult object containing the inventory configuration.

Throws:

AmazonServiceException

AmazonClientException

setBucketInventoryConfiguration

public SetBucketInventoryConfigurationResult setBucketInventoryConfiguration(java.lang.String bucketName,
                                                                             InventoryConfiguration inventoryConfiguration)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

Sets an inventory configuration (identified by the inventory ID) to the bucket.

Specified by:

setBucketInventoryConfiguration in interface AmazonS3

Parameters:

bucketName - The name of the bucket to set the inventory configuration to.

inventoryConfiguration - The inventory configuration to set.

Throws:

AmazonServiceException

AmazonClientException

setBucketInventoryConfiguration

public SetBucketInventoryConfigurationResult setBucketInventoryConfiguration(SetBucketInventoryConfigurationRequest setBucketInventoryConfigurationRequest)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

Description copied from interface: AmazonS3

Sets an inventory configuration (identified by the inventory ID) to the bucket.

Specified by:

setBucketInventoryConfiguration in interface AmazonS3

Parameters:

setBucketInventoryConfigurationRequest - The request object for setting an inventory configuration.

Throws:

AmazonServiceException

AmazonClientException

listBucketInventoryConfigurations

public ListBucketInventoryConfigurationsResult listBucketInventoryConfigurations(ListBucketInventoryConfigurationsRequest listBucketInventoryConfigurationsRequest)
                                                                          throws AmazonServiceException,
                                                                                 AmazonClientException

Description copied from interface: AmazonS3

Returns the list of inventory configurations for the bucket.

Specified by:

listBucketInventoryConfigurations in interface AmazonS3

Parameters:

listBucketInventoryConfigurationsRequest - The request object to list the inventory configurations in a bucket.

Returns:

An ListBucketInventoryConfigurationsResult object containing the list of InventoryConfigurations.

Throws:

AmazonServiceException

AmazonClientException

getObjectAsString

public java.lang.String getObjectAsString(java.lang.String bucketName,
                                          java.lang.String key)
                                   throws AmazonServiceException,
                                          AmazonClientException

Description copied from interface: AmazonS3

Retrieves and decodes the contents of an S3 object to a String.

Specified by:

getObjectAsString in interface AmazonS3

Parameters:

bucketName - The name of the bucket containing the object to retrieve.

key - The key of the object to retrieve.

Returns:

contents of the object as a String

Throws:

AmazonServiceException

AmazonClientException

getObjectTagging

public GetObjectTaggingResult getObjectTagging(GetObjectTaggingRequest getObjectTaggingRequest)

Description copied from interface: AmazonS3

Returns the tags for the specified object.

Specified by:

getObjectTagging in interface AmazonS3

Parameters:

getObjectTaggingRequest - The request object containing all the options on how to retrieve the Amazon S3 object tags.

Returns:

The tags for the specified object.

setObjectTagging

public SetObjectTaggingResult setObjectTagging(SetObjectTaggingRequest setObjectTaggingRequest)

Description copied from interface: AmazonS3

Set the tags for the specified object.

Specified by:

setObjectTagging in interface AmazonS3

Parameters:

setObjectTaggingRequest - The request object containing all the options for setting the tags for the specified object.

deleteObjectTagging

public DeleteObjectTaggingResult deleteObjectTagging(DeleteObjectTaggingRequest deleteObjectTaggingRequest)

Description copied from interface: AmazonS3

Remove the tags for the specified object.

Specified by:

deleteObjectTagging in interface AmazonS3

Parameters:

deleteObjectTaggingRequest - The request object containing all the options for deleting the tags for the specified object.

Returns:

a DeleteObjectTaggingResult object containing the information returned by S3 for the the tag deletion.

putObject

public PutObjectResult putObject(java.lang.String bucketName,
                                 java.lang.String key,
                                 java.lang.String content)
                          throws AmazonServiceException,
                                 AmazonClientException

Description copied from interface: AmazonS3

Encodes a String into the contents of an S3 object.

String will be encoded to bytes with UTF-8 encoding.

Specified by:

putObject in interface AmazonS3

Parameters:

bucketName - The name of the bucket to place the new object in.

key - The key of the object to create.

content - The String to encode

Throws:

AmazonServiceException

AmazonClientException

getRegionName

public java.lang.String getRegionName()

Description copied from interface: AmazonS3

Returns a string representation of the region with which this client is configured

Specified by:

getRegionName in interface AmazonS3

Returns:

String value representing the region this client will communicate with

resolveRequestEndpoint

public void resolveRequestEndpoint(Request<?> request,
                                   java.lang.String bucketName,
                                   java.lang.String key)

Set the request's endpoint and resource path with the new region provided From versions 2.4.+ until 2.10.+, AmazonS3Client adds an additional layer of URL Encoding for the key names. This resulted in the key name being double encoded because the Core Runtime (UrlHttpClient) encodes the Http Url which contains the key name. Starting 2.11.0, AmazonS3Client does not do the extra encoding for the key name and just uses te key name that is passed in.

Parameters:

request - Request to set endpoint for

bucketName - the name of the bucket

key - key that identifies the object

resolveRequestEndpoint

public void resolveRequestEndpoint(Request<?> request,
                                   java.lang.String bucketName,
                                   java.lang.String key,
                                   java.net.URI endpoint)

Set the request's endpoint and resource path with the new region provided. From versions 2.4.+ until 2.10.+, AmazonS3Client adds an additional layer of URL Encoding for the key names. This resulted in the key name being double encoded because the Core Runtime (UrlHttpClient) encodes the Http Url which contains the key name. Starting 2.11.0, AmazonS3Client does not do the extra encoding for the key name and just uses te key name that is passed in.

Parameters:

request - Request to set endpoint for

bucketName - the name of the bucket

key - key that identifies the object

endpoint - the endpoint URI