The reference object for this parameter Amazon S3 (Simple Storage Service) is an online storage web service offered by Amazon Web Services. Amazon S3 provides storage through web services interfaces (REST, SOAP, and BitTorrent). Characteristics of the connection pool. Give a name to this configuration so it can be later referenced by config-ref. The optional proxy username The optional proxy port The optional proxy password The optional proxy port The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Creates a new bucket; connector must not be configured as anonymous for this operation to succeed. Bucket names must be unique across all of Amazon S3, that is, among all their users. 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, buckets names must: not contain underscores, be between 3 and 63 characters long, not end with a dash, not contain adjacent periods, not contain dashes next to periods and not contain uppercase characters. 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. Specify which configuration to use for this invocation. The bucket to create. It must not exist yet. the region where to create the new bucket the access control list of the new bucket Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations 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; this restriction can be relaxed by specifying the attribute force="true". Specify which configuration to use for this invocation. the bucket to delete optional true if the bucket must be deleted even if it is not empty, false if operation should fail in such scenario. Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Removes the website configuration for a bucket; this operation requires the 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 <code>S3:DeleteBucketWebsite</code> permission. Calling this operation on a bucket with no website configuration does not fail, but calling this operation a bucket that does not exist does. Specify which configuration to use for this invocation. the bucket whose policy to delete Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Answers the policy for the given bucket. Only the owner of the bucket can retrieve it. If no policy has been set for the bucket, then a null policy text field will be returned. Specify which configuration to use for this invocation. the bucket whose policy to retrieve Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Sets the bucket's policy, overriding any previously set. Only the owner of the bucket can set a 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. Specify which configuration to use for this invocation. the bucket name the policy text Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Deletes the bucket's policy. 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. Specify which configuration to use for this invocation. the bucket whose policy to delete Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Sets the given bucket's website configuration. This operation requires the 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. Specify which configuration to use for this invocation. the target bucket's name The document to serve when a directory is specified, relative to the requested resource the full path to error document the bucket will use as error page for 4XX errors Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Answers the website of the given bucket. This operation requires the 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 GetBucketWebsite permission. Specify which configuration to use for this invocation. the target bucket's name Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Answers 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. Specify which configuration to use for this invocation. Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Lazily lists all objects for a given prefix. As S3 does not limit in any way the number of objects, such listing can retrieve an arbitrary amount of objects, and may need to perform extra calls to the api while it is iterated. Specify which configuration to use for this invocation. the target bucket's name the prefix of the objects to be listed. If unspecified, all objects are listed Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Lazily lists all object versions for a given bucket that has versioning enabled. As S3 does not limit in any way the number of objects, such listing can retrieve an arbitrary amount of object versions, and may need to perform extra calls to the api while it is iterated. Specify which configuration to use for this invocation. the target bucket's name Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Uploads an object to S3. Supported contents are InputStreams, Strings, byte arrays and Files. a map of arbitrary object properties keys and values The reference object for this parameter Specify which configuration to use for this invocation. the object's bucket the object's key the content length. If content is a InputStream, this parameter should be specified, as not doing so will introduce a performance loss as the contents will have to be persisted on disk before being uploaded. Otherwise, it is ignored. An exception to this rule are InputStreams returned by Mule Http Connector: if stream has Content-Length information, it will be used. In any case a content length of 0 is interpreted as an unspecified content length the content md5, encoded in base 64. If content is a file, it is ignored. the content type of the new object. the access control list of the new object the storage class of the new object Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Deletes a given object, only the owner of the bucket containing the version can perform this operation. If version is specified, versioning must be enabled, and once deleted, there is no method to restore such version. Otherwise, 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. Specify which configuration to use for this invocation. the object's bucket the object's key the specific version of the object to delete, if versioning is enabled. Left unspecified if the latest version is desired, or versioning is not enabled. Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Sets the Amazon S3 storage class for the given object. 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 preservers the previous storage class. Specify which configuration to use for this invocation. the object's bucket name the object's key the storage class to set Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Copies a source object to a new destination; to copy an object, the caller's account must have read access to the source object and write access to the destination bucket. By default, all object metadata for the source object are copied to the new destination object, unless new object metadata in the specified is provided. The AccesControlList is not copied to the new object, and, unless another ACL specified, PRIVATE is assumed. If no destination bucket is specified, the same that the source bucket is used - local copy. the new metadata of the destination object, that if specified, overrides that copied from the source object The reference object for this parameter Specify which configuration to use for this invocation. the source object's bucket the source object's key the specific version of the source object to copy, if versioning is enabled. Left unspecified if the latest version is desired, or versioning is not enabled. the destination object's bucket. If none provided, a local copy is performed, that is, it is copied within the same bucket. the destination object's key the acl of the destination object. one of enumerated values, defaults to The modified constraint that restricts this request to executing only if the object has been modified after the specified date. This constraint is specified but does not match, no copy is performed The unmodified constraint that restricts this request to executing only if the object has not been modified after this date. This constraint is specified but does not match, no copy is performed Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Returns a pre-signed URL for accessing an Amazon S3 object. The pre-signed URL can be shared to other users, allowing access to the resource without providing an account's AWS security credentials. Specify which configuration to use for this invocation. the object's bucket the object's key the specific version of the object to create the URI, if versioning is enabled. Left unspecified if the latest version is desired, or versioning is not enabled. The time at which the returned pre-signed URL will expire. The HTTP method verb to use for this URL Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Gets the content of an object stored in Amazon S3 under the specified bucket and key. Returns null if the specified constraints weren't met. To get an object's content from Amazon S3, the caller must have access to the object. Regarding conditional get constraints, Amazon S3 will ignore any dates occurring in the future. Specify which configuration to use for this invocation. the object's bucket the object's key the specific version of the object to get its contents, if versioning is enabled, left unspecified if the latest version is desired, or versioning is not enabled. The modified constraint that restricts this request to executing only if the object has been modified after the specified date. The unmodified constraint that restricts this request to executing only if the object has not been modified after this date. Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Gets the object stored in Amazon S3 under the specified bucket and key. Returns null if the specified constraints weren't met. To get an object from Amazon S3, the caller must have access to the object. 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. Regarding conditional get constraints, Amazon S3 will ignore any dates occurring in the future. Specify which configuration to use for this invocation. the object's bucket the object's key the specific version of the object to get its contents, if versioning is enabled. Left unspecified if the latest version is desired, or versioning is not enabled. The modified constraint that restricts this request to executing only if the object has been modified after the specified date. The unmodified constraint that restricts this request to executing only if the object has not been modified after this date. Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations 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. Specify which configuration to use for this invocation. the object's bucket the object's key the object metadata for the given bucketName and key Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Sets the versioning status for the given bucket. A bucket's versioning configuration can be in one of three possible states: Off, Enabled and 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. Specify which configuration to use for this invocation. the target bucket name the version status to set Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations Creates an http URI for the given object id. The useDefaultServer option enables using default US Amazon server subdomain in the URI regardless of the region. The main benefit of such feature is that this operation does not need to hit the Amazon servers, but the drawback is that using the given URI as an URL to the resource have unnecessary latency penalties for standard regions other than US_STANDARD. Specify which configuration to use for this invocation. the object's bucket the object's key if the default US Amazon server subdomain should be used in the URI regardless of the region. whether to use http or https Specify how many times this operation can be retried automatically. The access key provided by Amazon, needed for non annoynous operations The secrete key provided by Amazon, needed for non annoynous operations