frostfs-s3-gw/docs/aws_s3_compat.md
Denis Kirillov 4a2575fbf3 [#196] Add GetObjectTagging
Signed-off-by: Denis Kirillov <denis@nspcc.ru>
2021-08-31 10:46:42 +03:00

9.2 KiB

S3 API support

Reference:

Legend
🟢 Supported
🟡 Partially supported
🔴 Not supported yet, but will be in future
🔵 Not applicable or will never be supported

Object

Method Comments
🟢 CopyObject Done on gateway side
🟢 DeleteObject
🟢 DeleteObjects aka DeleteMultipleObjects
🟢 GetObject
🔵 GetObjectTorrent We don't plan implementing BT gateway
🟢 HeadObject
🔴 ListObjectParts
🟢 ListObjects
🟢 ListObjectsV2
🟢 PutObject Content-MD5 header deprecated
🔴 SelectObjectContent Need to have some Lambda to execute SQL
🔴 WriteGetObjectResponse Waiting for Lambda to be developed

ACL

For now there are some limitations:

  • Bucket policy support only one Principal (type AWS) per Statement. To refer all users use "AWS": "*"
  • AWS conditions and wildcard are not supported in resources
  • Only CanonicalUser (with hex encoded public key) and All Users Group are supported in ACL
Method Comments
🟡 GetObjectAcl See Limitations
🟡 PutObjectAcl See Limitations

Locking

Method Comments
🔴 GetObjectLegalHold
🔴 GetObjectLockConfiguration GetBucketObjectLockConfig
🔴 GetObjectRetention
🔴 PutObjectLegalHold
🔴 PutObjectLockConfiguration PutBucketObjectLockConfig
🔴 PutObjectRetention

Multipart

Should be supported soon.

Method Comments
🔴 AbortMultipartUpload
🔴 CompleteMultipartUpload
🔴 CreateMultipartUpload InitiateMultipartUpload and NewMultipartUpload
🔴 ListMultipartUploads
🔴 ListParts
🔴 UploadPart PutObjectPart
🔴 UploadPartCopy CopyObjectPart

Tagging

Method Comments
🔴 DeleteObjectTagging
🟢 GetObjectTagging
🟢 PutObjectTagging

Versioning

See also GetObject and other method parameters.

Method Comments
🟢 ListObjectVersions ListBucketObjectVersions
🔴 RestoreObject

Bucket

Method Comments
🟢 CreateBucket PutBucket
🟢 DeleteBucket
🔴 GetBucketLocation
🟢 HeadBucket
🟢 ListBuckets
🔴 PutPublicAccessBlock

Acceleration

Method Comments
🔵 GetBucketAccelerateConfiguration GetBucketAccelerate
🔵 PutBucketAccelerateConfiguration

ACL

Method Comments
🟢 GetBucketAcl Supported
🟢 PutBucketAcl Supported

Analytics

Method Comments
🔴 DeleteBucketAnalyticsConfiguration
🔴 GetBucketAnalyticsConfiguration
🔴 ListBucketAnalyticsConfigurations
🔴 PutBucketAnalyticsConfiguration

CORS

Method Comments
🔴 DeleteBucketCors
🔴 GetBucketCors
🔴 PutBucketCors

Encryption

Method Comments
🔴 DeleteBucketEncryption
🔴 GetBucketEncryption
🔴 PutBucketEncryption

Inventory

Method Comments
🔴 DeleteBucketInventoryConfiguration
🔴 GetBucketInventoryConfiguration
🔴 ListBucketInventoryConfigurations
🔴 PutBucketInventoryConfiguration

Lifecycle

Method Comments
🔴 DeleteBucketLifecycle
🔴 GetBucketLifecycle
🔴 GetBucketLifecycleConfiguration
🔴 PutBucketLifecycle
🔴 PutBucketLifecycleConfiguration

Logging

Method Comments
🔴 GetBucketLogging
🔴 PutBucketLogging

Metrics

Method Comments
🔴 DeleteBucketMetricsConfiguration
🔴 GetBucketMetricsConfiguration
🔴 ListBucketMetricsConfigurations
🔴 PutBucketMetricsConfiguration

Notifications

Method Comments
🔴 GetBucketNotification
🔴 GetBucketNotificationConfiguration
🔴 ListenBucketNotification non-standard?
🔴 PutBucketNotification
🔴 PutBucketNotificationConfiguration

Ownership controls

Method Comments
🔴 DeleteBucketOwnershipControls
🔴 GetBucketOwnershipControls
🔴 PutBucketOwnershipControls

Policy and replication

Method Comments
🔴 DeleteBucketPolicy
🔴 DeleteBucketReplication
🔴 DeletePublicAccessBlock
🟢 GetBucketPolicy
🔴 GetBucketPolicyStatus
🔴 GetBucketReplication
🔴 PostPolicyBucket non-standard?
🟢 PutBucketPolicy
🔴 PutBucketReplication

Request payment

Method Comments
🔵 GetBucketRequestPayment
🔵 PutBucketRequestPayment

Tagging

Method Comments
🔴 DeleteBucketTagging
🔴 GetBucketTagging
🔴 PutBucketTagging

Tiering

Method Comments
🔴 DeleteBucketIntelligentTieringConfiguration
🔴 GetBucketIntelligentTieringConfiguration
🔴 ListBucketIntelligentTieringConfigurations
🟢 PutBucketIntelligentTieringConfiguration

Versioning

Method Comments
🟢 GetBucketVersioning
🟢 PutBucketVersioning

Website

Method Comments
🔴 DeleteBucketWebsite
🔴 GetBucketWebsite
🔴 PutBucketWebsite