Lyve Cloud API Guides
Lyve Cloud API 

Was this content helpful?

OPEN MENU CLOSE MENU

S3 API Compatibility Guide

This guide provides details of the supported, and unsupported Lyve Cloud API calls relative to Amazon Web Services’ Simple Storage Service (AWS S3). This guide is intended for S3 aware application developers and architects responsible for storing data.

Public bucket access

Lyve Cloud does not support:

  • Any anonymous access to buckets, as all API calls to Lyve Cloud must be authenticated.
  • Generating a pre-signed URL with a custom domain name to access s3 buckets.
  • Cross-Origin Resource Sharing (CORS) for websites, nor does it support hosting static websites using custom domains.
  • Creating a prefix with an empty name.
  • Creating an object with the same prefix name at the same level.
  • Unlisting of prefixes when using the ls command, even if it contains only delete markers when versioning is enabled.

Signature Versions

Lyve Cloud supports Signature Version 4 (SigV4).

Supported S3 API calls

Lyve Cloud supports the most commonly used standard S3 API calls as listed in the following table. Some API calls are rejected if the service account does not have appropriate permissions. Lyve Cloud supports Signature Version 4 (SigV4). The following list specifies API calls allowed for each Lyve Cloud permission type.

   

Permissions
General API All Operations Read Only Write Only
    Specific buckets All buckets
Buckets CreateBucket × ✓ × ×
DeleteBucket ✓ ✓ × ×
GetBucketLocation ✓ ✓ ✓ ✓
GetBucketReplication ✓ ✓ ✓ ×
HeadBucket ✓ ✓ ✓ ×
ListBucket ✓ ✓ ✓ ×
GetObjectLockConfiguration ✓ ✓ ✓ ×
PutObjectLockConfiguration ✓ ✓ × ×
Object CopyObject ✓ ✓ × ✓
DeleteObject ✓ ✓ × ×
DeleteObjects ✓ ✓ × ×
GetObject ✓ ✓ ✓ ×
GetObjectRetention ✓ ✓ ✓ ×
HeadObject ✓ ✓ ✓ ×
ListObjects ✓ ✓ ✓ ×
ListObjectsV2 ✓ ✓ ✓ ×
ListObjectVersions ✓ ✓ ✓ ×
PutObject ✓ ✓ × ✓
PutObjectRetention ✓ ✓ × ×
SelectObjectContent ✓ ✓ ✓ ×
Upload AbortMultipartUpload ✓ ✓ × ✓
CreateMultipartUpload ✓ ✓ × ✓
CompleteMultipartUpload ✓ ✓ × ✓
ListMultipartUploads ✓ ✓ × ✓
ListParts ✓ ✓ × ✓
UploadPart ✓ ✓ × ✓
UploadPartCopy ✓ ✓ × ✓
Tagging DeleteBucketTagging ✓ ✓ × ×
GetBucketTagging ✓ ✓ ✓ ×
GetObjectTagging ✓ ✓ ✓ ×
PutBucketTagging ✓ ✓ × ✓
PutObjectTagging ✓ ✓ × ✓

Unsupported S3 API calls

The following S3 calls are not supported in Lyve Cloud.

  • ACL – GetBucketAcl, GetObjectAcl, PutBucketAcl, and PutObjectAcl

  • Analytics – DeleteBucketAnalyticsConfiguration, GetBucketAnalyticsConfiguration, ListBucketAnalyticsConfigurations, and PutBucketAnalyticsConfiguration

  • Bucket Inventory – DeleteBucketInventoryConfiguration, GetBucketInventoryConfiguration, ListBucketInventoryConfigurations, PutBucketInventoryConfiguration

  • Bucket Ownership – DeleteBucketOwnershipControls, GetBucketOwnershipControls, PutBucketOwnershipControls

  • Bucket Website – DeleteBucketWebsite, GetBucketWebsite, PutBucketWebsite

  • Bucket Notification – GetBucketNotification, GetBucketNotificationConfiguration, PutBucketNotification, PutBucketNotificationConfiguration

  • Bucket Encryption – DeleteBucketEncryption, GetBucketEncryption, PutBucketEncryption

  • Bucket Lifecycle – DeleteBucketLifecycle, GetBucketLifecycle, GetBucketLifecycleConfiguration, PutBucketLifecycle, PutBucketLifecycleConfiguration

  • Bucket Policy – DeleteBucketPolicy, GetBucketPolicy, GetBucketPolicyStatus, PutBucketPolicy

  • CORS - DeleteBucketCors, GetBucketCors, PutBucketCors

  • Logging - GetBucketLogging, PutBucketLogging

  • Metrics - DeleteBucketMetricsConfiguration, GetBucketMetricsConfiguration, ListBucketMetricsConfigurations, PutBucketMetricsConfiguration

  • Object Locking - GetObjectLegalHold, PutObjectLegalHold

  • Public Access - DeletePublicAccessBlock, GetPublicAccessBlock, PutPublicAccessBlock

  • Replication- DeleteBucketReplication, PutBucketReplication, GetBucketReplication

  • Tiering - DeleteBucketIntelligentTieringConfiguration, GetBucketIntelligentTieringConfiguration, ListBucketIntelligentTieringConfigurations, PutBucketIntelligentTieringConfiguration, RestoreObject

  • Transfer acceleration - GetBucketAccelerateConfiguration, PutBucketAccelerateConfiguration

  • Torrent - GetObjectTorrent

  • Payment – PutBucketRequestPayment, GetBucketRequestPayment

  • Versioning – PutBucketVersioning, GetBucketVersioning

Lyve Cloud API Guides

Click here to access an up-to-date online versionof this document. You will also find the most recent content as well as expandable illustrations, easier navigation, and search capability.