PUT Bucket accelerate
This implementation of the
PUT operation uses the
subresource to set the Transfer Acceleration state of an existing bucket. Amazon S3 Transfer Acceleration
is a bucket-level feature that enables you to perform faster data transfers
to Amazon S3.
To use this operation, you must have permission to perform the
The bucket owner has this permission by default. The bucket owner can grant this permission to others.
For more information about permissions, see
Permissions Related to Bucket Subresource Operations and
Managing Access Permissions to Your
Amazon S3 Resources in the Amazon Simple Storage Service Developer Guide.
The Transfer Acceleration state of a bucket can be set to one of the following two values:
Enabled– Enables accelerated data transfers to the bucket.
Suspended– Disables accelerated data transfers to the bucket.
The GET Bucket accelerate operation returns the transfer acceleration state of a bucket.
After setting the Transfer Acceleration state of a bucket to
might take up to thirty minutes before the data transfer rates to the bucket increase.
The name of the bucket used for Transfer Acceleration must be DNS-compliant and must not contain periods (".").
For more information about transfer acceleration, see Transfer Acceleration in the Amazon Simple Storage Service Developer Guide.
PUT /?accelerate HTTP/1.1 Host:
authorization string(see Authenticating Requests (AWS Signature Version 4))
Transfer acceleration configuration in the request body
This implementation of the operation does not use request parameters.
This implementation of the operation uses only request headers that are common to all operations. For more information, see Common Request Headers.
In the request, you specify the acceleration configuration in the request body. The
acceleration configuration is specified as XML. The following is an example of an
acceleration configuration used in a request. The
whether to set the transfer acceleration state to
<AccelerateConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Status>
transfer acceleration state</Status> </AccelerateConfiguration>
The following table describes the XML elements in the acceleration configuration:
Container for setting the transfer acceleration state.
Sets the transfer acceleration state of the bucket.
Valid Values: Enabled | Suspended
This implementation of the operation uses only response headers that are common to most responses. For more information, see Common Response Headers.
This implementation of the operation does not return response elements.
This implementation of the operation does not return special errors. For general information about Amazon S3 errors and a list of error codes, see Error Responses.
Example 1: Add Transfer Acceleration Configuration to Set Acceleration Status
The following is an example of a
PUT /?accelerate request that enables
transfer acceleration for the bucket named
PUT /?accelerate HTTP/1.1 Host: examplebucket.s3.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:
authorization stringContent-Type: text/plain Content-Length:
length<AccelerateConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Status>Enabled</Status> </AccelerateConfiguration>
The following is an example response:
HTTP/1.1 200 OK x-amz-id-2: YgIPIfBiKa2bj0KMg95r/0zo3emzU4dzsD4rcKCHQUAdQkf3ShJTOOpXUueF6QKo x-amz-request-id: 236A8905248E5A01 Date: Mon, 11 Apr 2016 12:00:00 GMT Content-Length: 0 Server: AmazonS3