VAST Cluster supports a subset of S3 requests listed below.
Bucket Operations
Task | S3 Request | S3 Action |
|---|---|---|
List the buckets on the S3 server | ListBuckets | ListAllMyBuckets |
Create a bucket | CreateBucket | CreateBucket |
List the objects in bucket | ListObjects or ListObjectsV2 | ListBucket |
Delete a bucket | DeleteBucket | DeleteBucket |
Return the region in which the bucket resides | GetBucketLocation | GetBucketLocation |
Return metadata from an object without returning the object itself. | HeadBucket | ListBucket |
Return the policy for the bucket | GetBucketPolicy | GetBucketPolicy |
Create a policy for the bucket | PutBucketPolicy | PutBucketPolicy |
Delete a bucket policy | DeleteBucketPolicy | DeleteBucketPolicy |
Bucket ACL Operations
Task | S3 Request | S3 Action |
|---|---|---|
Set the ACL of a bucket | PutBucketAcl | PutBucketAcl |
Return the ACL of a bucket | GetBucketAcl | GetBucketAcl |
Bucket Tagging Operations
Task | S3 Request | S3 Action |
|---|---|---|
Set tags on a bucket | PutBucketTagging | PutBucketTagging |
Return the tag set associated with a bucket | GetBucketTagging | GetBucketTagging |
Delete the tags from a bucket | DeleteBucketTagging | PutBucketTagging |
Bucket Logging Operations
Task | S3 Request | S3 Action |
|---|---|---|
Configure bucket logging | PutBucketLogging | PutBucketLogging |
Return bucket logging confirmation | GetBucketLogging | GetBucketLogging |
Bucket Event Notification Operations
Task | S3 Request | S3 Action |
|---|---|---|
Configure bucket event notifications | PutBucketNotificationConfiguration | PutBucketNotification |
Return bucket event notifications configuration | GetBucketNotificationConfiguration | GetBucketNotfication |
Bucket CORS Operations
Task | S3 Request | S3 Action |
|---|---|---|
Set CORS rules for the bucket | PutBucketCors | PutBucketCors |
Get bucket CORS rules | PutBucketCors | PutBucketCors |
Delete bucket CORS rules | DeleteBucketCors | DeleteBucketCors |
Object Operations
Task | S3 Request | S3 Action |
|---|---|---|
Create an object | PutObject | PutObject |
Create a copy of an object | CopyObject | GetObject and PutObject. Object rename is also supported with a VAST rename header. See Renaming Objects. |
Retrieve an object | GetObject | GetObject |
Retrieve metadata of an object without returning the object itself | HeadObject | GetObject |
Delete an object | DeleteObject | DeleteObject |
Delete multiple objects in a bucket | DeleteObjects | DeleteObject |
Object ACL Operations
Task | S3 Request | S3 Action |
|---|---|---|
Set ACL permissions on an existing object | PutObjectAcl | PutObjectAcl |
Return the ACL of an object | GetObjectAcl | GetObjectAcl |
Upload Operations
Task | S3 Request | S3 Action |
|---|---|---|
Initiate upload of a file in multiple parts (multipart upload) | CreateMultipartUpload | PutObject |
Abort a multipart upload | AbortMultipartUpload | AbortMultipartUpload |
Complete a multipart upload | CompleteMultipartUpload | PutObject |
Upload a part in a multipart upload. | UploadPart | PutObject |
Upload a part by copying data from an existing object as data source. | UploadPartCopy | PutObject, GetObject |
List the parts that have been uploaded for a specific multipart upload. | ListParts | ListMultipartUploadParts |
List multipart uploads | ListMultipartUploads | ListBucketMultipartUploads |
Object Versioning Operations
Task | S3 Request | S3 Action |
|---|---|---|
Set versioning state on a bucket. | PutBucketVersion | PutBucketVersion |
Get versioning state of a bucket | GetBucketVersion | GetBucketVersion |
Return metadata about all versions of the objects in a bucket | ListObjectVersions | ListBucketVersions |
Return object version | GetObject | GetObjectVersion |
Retrieve metadata of an object version without returning the object version itself | GetObject | GetObjectVersion |
Set object version ACL | PutObjectAcl | PutObjectVersionAcl |
Return object version ACL | GetObjectAcl | GetObjectVersionAcl |
Delete object(s) version | DeleteObject, DeleteObjects | DeleteObjectVersion |
Object Locking Operations
Task | S3 Request | S3 Action |
|---|---|---|
Place an object lock configuration on a bucket | PutObjectLockConfiguration | PutBucketObjectLockConfiguration |
Get the object lock configuration for a bucket | GetObjectLockConfiguration | GetBucketObjectLockConfiguration |
Place an object retention configuration on an object | PutObjectRetention | PutObjectRetention |
Get an object's retention settings | GetObjectRetention | GetObjectRetention |
Apply a legal hold configuration to an object | PutObjectLegalHold | PutObjectLegalHold |
Get an object's current legal hold status | GetObjectLegalHold | GetObjectLegalHold |
Object Tagging Operations
Task | S3 Request | S3 Action |
|---|---|---|
Set a supplied tag-set to an object that already exists in a bucket | PutObjectTagging | PutObjectTagging |
Set a supplied tag-set to a version of an object that already exists in a bucket | PutObjectTagging | PutObjectVersionTagging |
Return the tag-set of an object | GetObjectTagging | GetObjectTagging |
Return the tag-set of a version of an object | GetObjectTagging | GetObjectVersionTagging |
Remove the tag-set from an object | DeleteObjectTagging | DeleteObjectTagging |
Remove the tag-set from a version of an object | DeleteObjectTagging | DeleteObjectVersionTagging |