Returns a list of all buckets owned by the authenticated sender of the request.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTServiceGET.html
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListBucketsOutput
|
object |
Owner
|
Owner | ||||||||||||||||||
|
|||||||||||||||||||
Buckets
|
Buckets | ||||||||||||||||||
|
{
"Buckets": [
{
"CreationDate": "2012-02-15T21: 03: 02.000Z",
"Name": "examplebucket"
},
{
"CreationDate": "2011-07-24T19: 33: 50.000Z",
"Name": "examplebucket2"
},
{
"CreationDate": "2010-12-17T00: 56: 49.000Z",
"Name": "examplebucket3"
}
],
"Owner": {
"DisplayName": "own-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31"
}
}
Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
analytics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketAnalyticsConfigurationRequest
|
object |
Deletes the CORS configuration information set for the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEcors.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
cors
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketCorsRequest
|
object |
{
"Bucket": "examplebucket"
}
Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETE.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketRequest
|
object |
{
"Bucket": "forrandall2"
}
Deletes the server-side encryption configuration from the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
encryption
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketEncryptionRequest
|
object |
Deletes an inventory configuration (identified by the inventory ID) from the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
inventory
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketInventoryConfigurationRequest
|
object |
Deletes the lifecycle configuration from the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETElifecycle.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
lifecycle
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketLifecycleRequest
|
object |
{
"Bucket": "examplebucket"
}
Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
metrics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketMetricsConfigurationRequest
|
object |
Deletes the policy from the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEpolicy.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
policy
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketPolicyRequest
|
object |
{
"Bucket": "examplebucket"
}
Deletes the replication configuration from the bucket. For information about replication configuration, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
replication
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketReplicationRequest
|
object |
{
"Bucket": "example"
}
Deletes the tags from the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEtagging.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
tagging
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketTaggingRequest
|
object |
{
"Bucket": "examplebucket"
}
This operation removes the website configuration from the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEwebsite.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
website
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteBucketWebsiteRequest
|
object |
{
"Bucket": "examplebucket"
}
This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.
http://docs.amazonwebservices.com/AmazonS3/latest/API/multiobjectdeleteapi.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
delete
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteObjectsRequest
|
object |
Delete
|
Delete | |||||||||||||||||||||||||
Properties
|
{
"Bucket": "examplebucket",
"Delete": {
"Objects": [
{
"Key": "HappyFace.jpg",
"VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
},
{
"Key": "HappyFace.jpg",
"VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
}
],
"Quiet": false
}
}
Name | Data Type | Description |
---|---|---|
DeleteObjectsOutput
|
object |
Errors
|
Errors | ||||||||||||||||||||||||
|
|||||||||||||||||||||||||
Deleted
|
DeletedObjects | ||||||||||||||||||||||||
|
{
"Deleted": [
{
"Key": "HappyFace.jpg",
"VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
},
{
"Key": "HappyFace.jpg",
"VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
}
]
}
Removes the PublicAccessBlock
configuration from an Amazon S3 bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
publicAccessBlock
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeletePublicAccessBlockRequest
|
object |
Returns the accelerate configuration of a bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
accelerate
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketAccelerateConfigurationRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetBucketAccelerateConfigurationOutput
|
object |
Status
|
BucketAccelerateStatus |
The accelerate configuration of the bucket. |
||||
|
Gets the access control policy for the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETacl.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
acl
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketAclRequest
|
object |
Gets an analytics configuration for the bucket (specified by the analytics configuration ID).
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
analytics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketAnalyticsConfigurationRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetBucketAnalyticsConfigurationOutput
|
object |
AnalyticsConfiguration
|
AnalyticsConfiguration |
The configuration and any analyses for the analytics filter. |
||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Returns the CORS configuration for the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETcors.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
cors
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketCorsRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketCorsOutput
|
object |
CORSRules
|
CORSRules | |||||||||||||||||||||||||||
|
{
"CORSRules": [
{
"AllowedHeaders": [
"Authorization"
],
"AllowedMethods": [
"GET"
],
"AllowedOrigins": [
"*"
],
"MaxAgeSeconds": 3000
}
]
}
Returns the server-side encryption configuration of a bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
encryption
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketEncryptionRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetBucketEncryptionOutput
|
object |
ServerSideEncryptionConfiguration
|
ServerSideEncryptionConfiguration | |||||||||||||||
Properties
|
Returns an inventory configuration (identified by the inventory ID) from the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
inventory
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketInventoryConfigurationRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetBucketInventoryConfigurationOutput
|
object |
InventoryConfiguration
|
InventoryConfiguration |
Specifies the inventory configuration. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Returns the lifecycle configuration information set on the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
lifecycle
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketLifecycleConfigurationRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketLifecycleConfigurationOutput
|
object |
Rules
|
LifecycleRules | |||||||||||||||||||||||||||||||||||||||
|
{
"Rules": [
{
"ID": "Rule for TaxDocs\/",
"Prefix": "TaxDocs",
"Status": "Enabled",
"Transitions": [
{
"Days": 365,
"StorageClass": "STANDARD_IA"
}
]
}
]
}
Deprecated, see the GetBucketLifecycleConfiguration operation.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlifecycle.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
lifecycle
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketLifecycleRequest
|
object |
{
"Bucket": "acl1"
}
Name | Data Type | Description |
---|---|---|
GetBucketLifecycleOutput
|
object |
Rules
|
Rules | ||||||||||||||||||||||||||||||||||||
|
{
"Rules": [
{
"Expiration": {
"Days": 1
},
"ID": "delete logs",
"Prefix": "123\/",
"Status": "Enabled"
}
]
}
Returns the region the bucket resides in.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlocation.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
location
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketLocationRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketLocationOutput
|
object |
LocationConstraint
|
BucketLocationConstraint | |||||
|
{
"LocationConstraint": "us-west-2"
}
Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlogging.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
logging
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketLoggingRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetBucketLoggingOutput
|
object |
LoggingEnabled
|
LoggingEnabled | |||||||||||||||||||||||||||||||||||
Properties
|
Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
metrics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketMetricsConfigurationRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetBucketMetricsConfigurationOutput
|
object |
MetricsConfiguration
|
MetricsConfiguration |
Specifies the metrics configuration. |
|||||||||||||||||||||||||||||||||
Properties
|
Returns the notification configuration of a bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
notification
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketNotificationConfigurationRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
NotificationConfiguration
|
object |
A container for specifying the notification configuration of the bucket. If this element is empty, notifications are turned off for the bucket. |
LambdaFunctionConfigurations
|
LambdaFunctionConfigurationList | ||||||||||||||||||||||||
|
|||||||||||||||||||||||||
QueueConfigurations
|
QueueConfigurationList | ||||||||||||||||||||||||
|
|||||||||||||||||||||||||
TopicConfigurations
|
TopicConfigurationList | ||||||||||||||||||||||||
|
Deprecated, see the GetBucketNotificationConfiguration operation.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETnotification.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
notification
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketNotificationConfigurationRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
NotificationConfigurationDeprecated
|
object |
CloudFunctionConfiguration
|
CloudFunctionConfiguration | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
QueueConfiguration
|
QueueConfigurationDeprecated | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TopicConfiguration
|
TopicConfigurationDeprecated | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
{
"QueueConfiguration": {
"Event": "s3:ObjectCreated:Put",
"Events": [
"s3:ObjectCreated:Put"
],
"Id": "MDQ2OGQ4NDEtOTBmNi00YTM4LTk0NzYtZDIwN2I3NWQ1NjIx",
"Queue": "arn:aws:sqs:us-east-1:acct-id:S3ObjectCreatedEventQueue"
},
"TopicConfiguration": {
"Event": "s3:ObjectCreated:Copy",
"Events": [
"s3:ObjectCreated:Copy"
],
"Id": "YTVkMWEzZGUtNTY1NS00ZmE2LWJjYjktMmRlY2QwODFkNTJi",
"Topic": "arn:aws:sns:us-east-1:acct-id:S3ObjectCreatedEventTopic"
}
}
Returns the policy of a specified bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETpolicy.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
policy
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketPolicyRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketPolicyOutput
|
object |
Policy
|
Policy |
The bucket policy as a JSON document. |
||||
|
{
"Policy": "{\"Version\":\"2008-10-17\",\"Id\":\"LogPolicy\",\"Statement\":[{\"Sid\":\"Enables the log delivery group to publish logs to your bucket \",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"111122223333\"},\"Action\":[\"s3:GetBucketAcl\",\"s3:GetObjectAcl\",\"s3:PutObject\"],\"Resource\":[\"arn:aws:s3:::policytest1\/*\",\"arn:aws:s3:::policytest1\"]}]}"
}
Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
policyStatus
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketPolicyStatusRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetBucketPolicyStatusOutput
|
object |
PolicyStatus
|
PolicyStatus |
The policy status for the specified bucket. |
||||||||||||||
Properties
|
Returns the replication configuration of a bucket.
It can take a while to propagate the put or delete a replication configuration to all Amazon S3 systems. Therefore, a get request soon after put or delete can return a wrong result.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
replication
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketReplicationRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketReplicationOutput
|
object |
ReplicationConfiguration
|
ReplicationConfiguration | |||||||||||||||||||||||||
Properties
|
{
"ReplicationConfiguration": {
"Role": "arn:aws:iam::acct-id:role\/example-role",
"Rules": [
{
"Destination": {
"Bucket": "arn:aws:s3:::destination-bucket"
},
"ID": "MWIwNTkwZmItMTE3MS00ZTc3LWJkZDEtNzRmODQwYzc1OTQy",
"Prefix": "Tax",
"Status": "Enabled"
}
]
}
}
Returns the request payment configuration of a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentGET.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
requestPayment
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketRequestPaymentRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketRequestPaymentOutput
|
object |
Payer
|
Payer |
Specifies who pays for the download and request fees. |
||||
|
{
"Payer": "BucketOwner"
}
Returns the tag set associated with the bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETtagging.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
tagging
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketTaggingRequest
|
object |
{
"Bucket": "examplebucket"
}
Returns the versioning state of a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETversioningStatus.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
versioning
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketVersioningRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketVersioningOutput
|
object |
MFADelete
|
MFADeleteStatus |
Specifies whether MFA delete is enabled in the bucket versioning configuration. This element is only returned if the bucket has been configured with MFA delete. If the bucket has never been so configured, this element is not returned. |
||||
|
||||||
Status
|
BucketVersioningStatus |
The versioning state of the bucket. |
||||
|
{
"MFADelete": "Disabled",
"Status": "Enabled"
}
Returns the website configuration for a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETwebsite.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
website
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetBucketWebsiteRequest
|
object |
{
"Bucket": "examplebucket"
}
Name | Data Type | Description |
---|---|---|
GetBucketWebsiteOutput
|
object |
RoutingRules
|
RoutingRules | |||||||||||||||||||||||||
|
||||||||||||||||||||||||||
ErrorDocument
|
ErrorDocument | |||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||
IndexDocument
|
IndexDocument | |||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||
RedirectAllRequestsTo
|
RedirectAllRequestsTo | |||||||||||||||||||||||||
Properties
|
{
"ErrorDocument": {
"Key": "error.html"
},
"IndexDocument": {
"Suffix": "index.html"
}
}
Gets the Object Lock configuration for a bucket. The rule specified in the Object Lock configuration will be applied by default to every new object placed in the specified bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
object-lock
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetObjectLockConfigurationRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetObjectLockConfigurationOutput
|
object |
ObjectLockConfiguration
|
ObjectLockConfiguration |
The specified bucket's Object Lock configuration. |
|||||||||||||||||||||||||||
Properties
|
Retrieves the PublicAccessBlock
configuration for an Amazon S3 bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
publicAccessBlock
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetPublicAccessBlockRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetPublicAccessBlockOutput
|
object |
PublicAccessBlockConfiguration
|
PublicAccessBlockConfiguration |
The |
||||||||||||||||||||||||||||||||||||||||||||
Properties
|
This operation is useful to determine if a bucket exists and you have permission to access it.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketHEAD.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
HeadBucketRequest
|
object |
{
"Bucket": "acl1"
}
Name | Data Type | Description |
---|---|---|
NoSuchBucket
|
Lists the analytics configurations for the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
analytics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListBucketAnalyticsConfigurationsRequest
|
object |
Name | Data Type | Description |
---|---|---|
ListBucketAnalyticsConfigurationsOutput
|
object |
AnalyticsConfigurationList
|
AnalyticsConfigurationList |
The list of analytics configurations for a bucket. |
||||||||||||||||||||
|
||||||||||||||||||||||
NextContinuationToken
|
NextToken |
NextContinuationToken is sent when isTruncated is true, which indicates that there are more analytics configurations to list. The next request must include this NextContinuationToken. The token is obfuscated and is not a usable value. |
||||||||||||||||||||
|
||||||||||||||||||||||
ContinuationToken
|
Token |
The ContinuationToken that represents where this request began. |
||||||||||||||||||||
|
||||||||||||||||||||||
IsTruncated
|
IsTruncated |
Indicates whether the returned list of analytics configurations is complete. A value of true indicates that the list is not complete and the NextContinuationToken will be provided for a subsequent request. |
||||||||||||||||||||
|
Returns a list of inventory configurations for the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
inventory
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListBucketInventoryConfigurationsRequest
|
object |
Name | Data Type | Description |
---|---|---|
ListBucketInventoryConfigurationsOutput
|
object |
NextContinuationToken
|
NextToken |
The marker used to continue this inventory configuration listing. Use the NextContinuationToken from this response to continue the listing in a subsequent request. The continuation token is an opaque value that Amazon S3 understands. |
||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||
IsTruncated
|
IsTruncated |
Indicates whether the returned list of inventory configurations is truncated in this response. A value of true indicates that the list is truncated. |
||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||
InventoryConfigurationList
|
InventoryConfigurationList |
The list of inventory configurations for a bucket. |
||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||
ContinuationToken
|
Token |
If sent in the request, the marker that is used as a starting point for this inventory configuration list response. |
||||||||||||||||||||||||||||||||
|
Lists the metrics configurations for the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
metrics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListBucketMetricsConfigurationsRequest
|
object |
Name | Data Type | Description |
---|---|---|
ListBucketMetricsConfigurationsOutput
|
object |
MetricsConfigurationList
|
MetricsConfigurationList |
The list of metrics configurations for a bucket. |
|||||||||||||||||
|
|||||||||||||||||||
NextContinuationToken
|
NextToken |
The marker used to continue a metrics configuration listing that has been truncated. Use the NextContinuationToken from a previously truncated list response to continue the listing. The continuation token is an opaque value that Amazon S3 understands. |
|||||||||||||||||
|
|||||||||||||||||||
ContinuationToken
|
Token |
The marker that is used as a starting point for this metrics configuration list response. This value is present if it was sent in the request. |
|||||||||||||||||
|
|||||||||||||||||||
IsTruncated
|
IsTruncated |
Indicates whether the returned list of metrics configurations is complete. A value of true indicates that the list is not complete and the NextContinuationToken will be provided for a subsequent request. |
|||||||||||||||||
|
This operation lists in-progress multipart uploads.
http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadListMPUpload.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
uploads
|
string | |
UploadIdMarker
|
string |
Pagination token |
KeyMarker
|
string |
Pagination token |
MaxUploads
|
string |
Pagination limit |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListMultipartUploadsRequest
|
object |
{
"Bucket": "examplebucket",
"KeyMarker": "nextkeyfrompreviousresponse",
"MaxUploads": "2",
"UploadIdMarker": "valuefrompreviousresponse"
}
Name | Data Type | Description |
---|---|---|
ListMultipartUploadsOutput
|
object |
EncodingType
|
EncodingType |
Encoding type used by Amazon S3 to encode object keys in the response. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
CommonPrefixes
|
CommonPrefixList | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Uploads
|
MultipartUploadList | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
IsTruncated
|
IsTruncated |
Indicates whether the returned list of multipart uploads is truncated. A value of true indicates that the list was truncated. The list can be truncated if the number of multipart uploads exceeds the limit allowed or specified by max uploads. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
MaxUploads
|
MaxUploads |
Maximum number of multipart uploads that could have been included in the response. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
NextUploadIdMarker
|
NextUploadIdMarker |
When a list is truncated, this element specifies the value that should be used for the upload-id-marker request parameter in a subsequent request. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Delimiter
|
Delimiter | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Prefix
|
Prefix |
When a prefix is provided in the request, this field contains the specified prefix. The result contains only keys starting with the specified prefix. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
NextKeyMarker
|
NextKeyMarker |
When a list is truncated, this element specifies the value that should be used for the key-marker request parameter in a subsequent request. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
UploadIdMarker
|
UploadIdMarker |
Upload ID after which listing began. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
KeyMarker
|
KeyMarker |
The key at or after which the listing began. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Bucket
|
BucketName |
Name of the bucket to which the multipart upload was initiated. |
|||||||||||||||||||||||||||||
|
{
"Bucket": "acl1",
"IsTruncated": true,
"KeyMarker": "",
"MaxUploads": "2",
"NextKeyMarker": "someobjectkey",
"NextUploadIdMarker": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
"UploadIdMarker": "",
"Uploads": [
{
"Initiated": "2014-05-01T05:40:58.000Z",
"Initiator": {
"DisplayName": "ownder-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"Key": "JavaFile",
"Owner": {
"DisplayName": "mohanataws",
"ID": "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"StorageClass": "STANDARD",
"UploadId": "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
},
{
"Initiated": "2014-05-01T05:41:27.000Z",
"Initiator": {
"DisplayName": "ownder-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"Key": "JavaFile",
"Owner": {
"DisplayName": "ownder-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"StorageClass": "STANDARD",
"UploadId": "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
}
]
}
Returns metadata about all of the versions of objects in a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETVersion.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
versions
|
string | |
VersionIdMarker
|
string |
Pagination token |
KeyMarker
|
string |
Pagination token |
MaxKeys
|
string |
Pagination limit |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListObjectVersionsRequest
|
object |
{
"Bucket": "examplebucket",
"Prefix": "HappyFace.jpg"
}
Name | Data Type | Description |
---|---|---|
ListObjectVersionsOutput
|
object |
EncodingType
|
EncodingType |
Encoding type used by Amazon S3 to encode object keys in the response. |
|||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
CommonPrefixes
|
CommonPrefixList | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
MaxKeys
|
MaxKeys | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
Delimiter
|
Delimiter | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
Prefix
|
Prefix | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
Name
|
BucketName | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
DeleteMarkers
|
DeleteMarkers | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
Versions
|
ObjectVersionList | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
NextVersionIdMarker
|
NextVersionIdMarker |
Use this value for the next version id marker parameter in a subsequent request. |
|||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
NextKeyMarker
|
NextKeyMarker |
Use this value for the key marker request parameter in a subsequent request. |
|||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
VersionIdMarker
|
VersionIdMarker | ||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
KeyMarker
|
KeyMarker |
Marks the last Key returned in a truncated response. |
|||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||
IsTruncated
|
IsTruncated |
A flag that indicates whether or not Amazon S3 returned all of the results that satisfied the search criteria. If your results were truncated, you can make a follow-up paginated request using the NextKeyMarker and NextVersionIdMarker response parameters as a starting place in another request to return the rest of the results. |
|||||||||||||||||||||||||||||||||||
|
{
"Versions": [
{
"ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
"IsLatest": true,
"Key": "HappyFace.jpg",
"LastModified": "2016-12-15T01:19:41.000Z",
"Owner": {
"DisplayName": "owner-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"Size": 3191,
"StorageClass": "STANDARD",
"VersionId": "null"
},
{
"ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
"IsLatest": false,
"Key": "HappyFace.jpg",
"LastModified": "2016-12-13T00:58:26.000Z",
"Owner": {
"DisplayName": "owner-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"Size": 3191,
"StorageClass": "STANDARD",
"VersionId": "PHtexPGjH2y.zBgT8LmB7wwLI2mpbz.k"
}
]
}
Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGET.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
Marker
|
string |
Pagination token |
MaxKeys
|
string |
Pagination limit |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListObjectsRequest
|
object |
{
"Bucket": "examplebucket",
"MaxKeys": "2"
}
Name | Data Type | Description |
---|---|---|
ListObjectsOutput
|
object |
EncodingType
|
EncodingType |
Encoding type used by Amazon S3 to encode object keys in the response. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
CommonPrefixes
|
CommonPrefixList | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
MaxKeys
|
MaxKeys | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Delimiter
|
Delimiter | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Prefix
|
Prefix | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Name
|
BucketName | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Contents
|
ObjectList | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
NextMarker
|
NextMarker |
When response is truncated (the IsTruncated element value in the response is true), you can use the key name in this field as marker in the subsequent request to get next set of objects. Amazon S3 lists objects in alphabetical order Note: This element is returned only if you have delimiter request parameter specified. If response does not include the NextMaker and it is truncated, you can use the value of the last Key in the response as the marker in the subsequent request to get the next set of object keys. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Marker
|
Marker | ||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
IsTruncated
|
IsTruncated |
A flag that indicates whether or not Amazon S3 returned all of the results that satisfied the search criteria. |
|||||||||||||||||||||||||||||
|
{
"Contents": [
{
"ETag": "\"70ee1738b6b21e2c8a43f3a5ab0eee71\"",
"Key": "example1.jpg",
"LastModified": "2014-11-21T19:40:05.000Z",
"Owner": {
"DisplayName": "myname",
"ID": "12345example25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"Size": 11,
"StorageClass": "STANDARD"
},
{
"ETag": "\"9c8af9a76df052144598c115ef33e511\"",
"Key": "example2.jpg",
"LastModified": "2013-11-15T01:10:49.000Z",
"Owner": {
"DisplayName": "myname",
"ID": "12345example25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
},
"Size": 713193,
"StorageClass": "STANDARD"
}
],
"NextMarker": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ=="
}
Name | Data Type | Description |
---|---|---|
NoSuchBucket
|
Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. Note: ListObjectsV2 is the revised List Objects API and we recommend you use this revised API for new application development.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
list-type
|
string Allowed values: - 2 |
|
ContinuationToken
|
string |
Pagination token |
MaxKeys
|
string |
Pagination limit |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
ListObjectsV2Request
|
object |
{
"Bucket": "examplebucket",
"MaxKeys": "2"
}
Name | Data Type | Description |
---|---|---|
ListObjectsV2Output
|
object |
StartAfter
|
StartAfter |
StartAfter is where you want Amazon S3 to start listing from. Amazon S3 starts listing after this specified key. StartAfter can be any key in the bucket |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
NextContinuationToken
|
NextToken |
NextContinuationToken is sent when isTruncated is true which means there are more keys in the bucket that can be listed. The next list requests to Amazon S3 can be continued with this NextContinuationToken. NextContinuationToken is obfuscated and is not a real key |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
ContinuationToken
|
Token |
ContinuationToken indicates Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
KeyCount
|
KeyCount |
KeyCount is the number of keys returned with this request. KeyCount will always be less than equals to MaxKeys field. Say you ask for 50 keys, your result will include less than equals 50 keys |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
EncodingType
|
EncodingType |
Encoding type used by Amazon S3 to encode object keys in the response. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
CommonPrefixes
|
CommonPrefixList |
CommonPrefixes contains all (if there are any) keys between Prefix and the next occurrence of the string specified by delimiter |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
MaxKeys
|
MaxKeys |
Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Delimiter
|
Delimiter |
A delimiter is a character you use to group keys. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Prefix
|
Prefix |
Limits the response to keys that begin with the specified prefix. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Name
|
BucketName |
Name of the bucket to list. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
Contents
|
ObjectList |
Metadata about each object returned. |
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||
IsTruncated
|
IsTruncated |
A flag that indicates whether or not Amazon S3 returned all of the results that satisfied the search criteria. |
|||||||||||||||||||||||||||||
|
{
"Contents": [
{
"ETag": "\"70ee1738b6b21e2c8a43f3a5ab0eee71\"",
"Key": "happyface.jpg",
"LastModified": "2014-11-21T19:40:05.000Z",
"Size": 11,
"StorageClass": "STANDARD"
},
{
"ETag": "\"becf17f89c30367a9a44495d62ed521a-1\"",
"Key": "test.jpg",
"LastModified": "2014-05-02T04:51:50.000Z",
"Size": 4192256,
"StorageClass": "STANDARD"
}
],
"IsTruncated": true,
"KeyCount": "2",
"MaxKeys": "2",
"Name": "examplebucket",
"NextContinuationToken": "1w41l63U0xa8q7smH50vCxyTQqdxo69O3EmK28Bi5PcROI4wI\/EyIJg==",
"Prefix": ""
}
Name | Data Type | Description |
---|---|---|
NoSuchBucket
|
Sets the accelerate configuration of an existing bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
accelerate
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketAccelerateConfigurationRequest
|
object |
AccelerateConfiguration
|
AccelerateConfiguration |
Specifies the Accelerate Configuration you want to set for the bucket. |
||||||||||||||
Properties
|
Sets the permissions on a bucket using access control lists (ACL).
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTacl.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
acl
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketAclRequest
|
object |
AccessControlPolicy
|
AccessControlPolicy | ||
{
"Bucket": "examplebucket",
"GrantFullControl": "id=examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484",
"GrantWrite": "uri=http:\/\/acs.amazonaws.com\/groups\/s3\/LogDelivery"
}
Sets an analytics configuration for the bucket (specified by the analytics configuration ID).
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
analytics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketAnalyticsConfigurationRequest
|
object |
AnalyticsConfiguration
|
AnalyticsConfiguration |
The configuration and any analyses for the analytics filter. |
||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Sets the CORS configuration for a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTcors.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
cors
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketCorsRequest
|
object |
CORSConfiguration
|
CORSConfiguration | ||
|
{
"Bucket": "",
"CORSConfiguration": {
"CORSRules": [
{
"AllowedHeaders": [
"*"
],
"AllowedMethods": [
"PUT",
"POST",
"DELETE"
],
"AllowedOrigins": [
"http:\/\/www.example.com"
],
"ExposeHeaders": [
"x-amz-server-side-encryption"
],
"MaxAgeSeconds": 3000
},
{
"AllowedHeaders": [
"Authorization"
],
"AllowedMethods": [
"GET"
],
"AllowedOrigins": [
"*"
],
"MaxAgeSeconds": 3000
}
]
},
"ContentMD5": ""
}
Creates a new server-side encryption configuration (or replaces an existing one, if present).
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
encryption
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketEncryptionRequest
|
object |
ServerSideEncryptionConfiguration
|
ServerSideEncryptionConfiguration | |||||||||||||||
Properties
|
Adds an inventory configuration (identified by the inventory ID) from the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
inventory
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketInventoryConfigurationRequest
|
object |
InventoryConfiguration
|
InventoryConfiguration |
Specifies the inventory configuration. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
lifecycle
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketLifecycleConfigurationRequest
|
object |
LifecycleConfiguration
|
BucketLifecycleConfiguration | |||||||||||||||
Properties
|
{
"Bucket": "examplebucket",
"LifecycleConfiguration": {
"Rules": [
{
"Expiration": {
"Days": 3650
},
"Filter": {
"Prefix": "documents\/"
},
"ID": "TestOnly",
"Status": "Enabled",
"Transitions": [
{
"Days": 365,
"StorageClass": "GLACIER"
}
]
}
]
}
}
Deprecated, see the PutBucketLifecycleConfiguration operation.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlifecycle.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
lifecycle
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketLifecycleRequest
|
object |
LifecycleConfiguration
|
LifecycleConfiguration | ||
|
Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. To set the logging status of a bucket, you must be the bucket owner.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlogging.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
logging
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketLoggingRequest
|
object |
BucketLoggingStatus
|
BucketLoggingStatus | ||||||||||||||||||||||||
Properties
|
{
"Bucket": "sourcebucket",
"BucketLoggingStatus": {
"LoggingEnabled": {
"TargetBucket": "targetbucket",
"TargetGrants": [
{
"Grantee": {
"Type": "Group",
"URI": "http:\/\/acs.amazonaws.com\/groups\/global\/AllUsers"
},
"Permission": "READ"
}
],
"TargetPrefix": "MyBucketLogs\/"
}
}
}
Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
metrics
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketMetricsConfigurationRequest
|
object |
MetricsConfiguration
|
MetricsConfiguration |
Specifies the metrics configuration. |
|||||||||||||||||||||||||||||||||
Properties
|
Enables notifications of specified events for a bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
notification
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketNotificationConfigurationRequest
|
object |
NotificationConfiguration
|
NotificationConfiguration | |||||||||||||||||||||||||||||||||||
Properties
|
{
"Bucket": "examplebucket",
"NotificationConfiguration": {
"TopicConfigurations": [
{
"Events": [
"s3:ObjectCreated:*"
],
"TopicArn": "arn:aws:sns:us-west-2:123456789012:s3-notification-topic"
}
]
}
}
Deprecated, see the PutBucketNotificationConfiguraiton operation.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTnotification.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
notification
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketNotificationRequest
|
object |
NotificationConfiguration
|
NotificationConfigurationDeprecated | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
Examples
|
Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTpolicy.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
policy
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketPolicyRequest
|
object |
Policy
|
Policy |
The bucket policy as a JSON document. |
||||
|
{
"Bucket": "examplebucket",
"Policy": "{\"Version\": \"2012-10-17\", \"Statement\": [{ \"Sid\": \"id-1\",\"Effect\": \"Allow\",\"Principal\": {\"AWS\": \"arn:aws:iam::123456789012:root\"}, \"Action\": [ \"s3:PutObject\",\"s3:PutObjectAcl\"], \"Resource\": [\"arn:aws:s3:::acl3\/*\" ] } ]}"
}
Creates a replication configuration or replaces an existing one. For more information, see Cross-Region Replication (CRR) in the Amazon S3 Developer Guide.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
replication
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketReplicationRequest
|
object |
ReplicationConfiguration
|
ReplicationConfiguration | |||||||||||||||||||||||||
Properties
|
{
"Bucket": "examplebucket",
"ReplicationConfiguration": {
"Role": "arn:aws:iam::123456789012:role\/examplerole",
"Rules": [
{
"Destination": {
"Bucket": "arn:aws:s3:::destinationbucket",
"StorageClass": "STANDARD"
},
"Prefix": "",
"Status": "Enabled"
}
]
}
}
Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentPUT.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
requestPayment
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketRequestPaymentRequest
|
object |
RequestPaymentConfiguration
|
RequestPaymentConfiguration | |||||||||||||||
Properties
|
{
"Bucket": "examplebucket",
"RequestPaymentConfiguration": {
"Payer": "Requester"
}
}
Sets the tags for a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTtagging.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
tagging
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
versioning
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketVersioningRequest
|
object |
VersioningConfiguration
|
VersioningConfiguration | |||||||||||||||||||||||||
Properties
|
{
"Bucket": "examplebucket",
"VersioningConfiguration": {
"MFADelete": "Disabled",
"Status": "Enabled"
}
}
Set the website configuration for a bucket.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTwebsite.html
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
website
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutBucketWebsiteRequest
|
object |
WebsiteConfiguration
|
WebsiteConfiguration | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
{
"Bucket": "examplebucket",
"ContentMD5": "",
"WebsiteConfiguration": {
"ErrorDocument": {
"Key": "error.html"
},
"IndexDocument": {
"Suffix": "index.html"
}
}
}
Places an Object Lock configuration on the specified bucket. The rule specified in the Object Lock configuration will be applied by default to every new object placed in the specified bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
object-lock
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutObjectLockConfigurationRequest
|
object |
ObjectLockConfiguration
|
ObjectLockConfiguration |
The Object Lock configuration that you want to apply to the specified bucket. |
|||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
PutObjectLockConfigurationOutput
|
object |
Creates or modifies the PublicAccessBlock
configuration for an Amazon S3 bucket.
Name | Data Type | Description |
---|---|---|
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
publicAccessBlock
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
PutPublicAccessBlockRequest
|
object |
PublicAccessBlockConfiguration
|
PublicAccessBlockConfiguration |
The |
||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Initiates a multipart upload and returns an upload ID.
Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.
http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadInitiate.html
Name | Data Type | Description |
---|---|---|
Key
|
string | |
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
uploads
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
CreateMultipartUploadRequest
|
object |
Metadata
|
Metadata |
A map of metadata to store with the object in S3. |
||||
|
{
"Bucket": "examplebucket",
"Key": "largeobject"
}
Name | Data Type | Description |
---|---|---|
CreateMultipartUploadOutput
|
object |
UploadId
|
MultipartUploadId |
ID for the initiated multipart upload. |
||||
|
||||||
Key
|
ObjectKey |
Object key for which the multipart upload was initiated. |
||||
|
||||||
Bucket
|
BucketName |
Name of the bucket to which the multipart upload was initiated. |
||||
|
{
"Bucket": "examplebucket",
"Key": "largeobject",
"UploadId": "ibZBv_75gd9r8lH_gqXatLdxMVpAlj6ZQjEs.OwyF3953YdwbcQnMA2BLGn8Lx12fQNICtMw5KyteFeHw.Sjng--"
}
Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectDELETE.html
Name | Data Type | Description |
---|---|---|
Key
|
string | |
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteObjectRequest
|
object |
{
"Bucket": "ExampleBucket",
"Key": "HappyFace.jpg"
}
Name | Data Type | Description |
---|---|---|
DeleteObjectOutput
|
object |
Removes the tag-set from an existing object.
Name | Data Type | Description |
---|---|---|
Key
|
string | |
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
tagging
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
DeleteObjectTaggingRequest
|
object |
{
"Bucket": "examplebucket",
"Key": "HappyFace.jpg"
}
Name | Data Type | Description |
---|---|---|
DeleteObjectTaggingOutput
|
object |
{
"VersionId": "null"
}
Returns the access control list (ACL) of an object.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectGETacl.html
Name | Data Type | Description |
---|---|---|
Key
|
string | |
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
acl
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetObjectAclRequest
|
object |
{
"Bucket": "examplebucket",
"Key": "HappyFace.jpg"
}
Name | Data Type | Description |
---|---|---|
GetObjectAclOutput
|
object |
Grants
|
Grants |
A list of grants. |
|||||||||||||||||
|
|||||||||||||||||||
Owner
|
Owner | ||||||||||||||||||
|
{
"Grants": [
{
"Grantee": {
"DisplayName": "owner-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
"Type": "CanonicalUser"
},
"Permission": "WRITE"
},
{
"Grantee": {
"DisplayName": "owner-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
"Type": "CanonicalUser"
},
"Permission": "WRITE_ACP"
},
{
"Grantee": {
"DisplayName": "owner-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
"Type": "CanonicalUser"
},
"Permission": "READ"
},
{
"Grantee": {
"DisplayName": "owner-display-name",
"ID": "852b113eexamplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
"Type": "CanonicalUser"
},
"Permission": "READ_ACP"
}
],
"Owner": {
"DisplayName": "owner-display-name",
"ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
}
}
Name | Data Type | Description |
---|---|---|
NoSuchKey
|
Retrieves objects from Amazon S3.
http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectGET.html
Name | Data Type | Description |
---|---|---|
Key
|
string | |
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetObjectRequest
|
object |
{
"Bucket": "examplebucket",
"Key": "SampleFile.txt",
"Range": "bytes=0-9"
}
Name | Data Type | Description |
---|---|---|
GetObjectOutput
|
object |
Metadata
|
Metadata |
A map of metadata to store with the object in S3. |
||||
|
||||||
Body
|
Body |
Object data. |
||||
|
{
"AcceptRanges": "bytes",
"ContentLength": "10",
"ContentRange": "bytes 0-9\/43",
"ContentType": "text\/plain",
"ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
"LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
"Metadata": [],
"VersionId": "null"
}
Name | Data Type | Description |
---|---|---|
NoSuchKey
|
Gets an object's current Legal Hold status.
Name | Data Type | Description |
---|---|---|
Key
|
string | |
Bucket
|
string |
Name | Data Type | Description |
---|---|---|
legal-hold
|
string |
Name | Data Type | Description |
---|---|---|
x-amz-security-token
|
string |
Name | Data Type | Description |
---|---|---|
GetObjectLegalHoldRequest
|
object |
Name | Data Type | Description |
---|---|---|
GetObjectLegalHoldOutput
|
object |
LegalHold
|
ObjectLockLegalHold |
The current Legal Hold status for the specified object. |
|||||||||||
Properties
|