IDrive^® e2 S3 Compatible API

S3 Put Object :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/<your-key>

Uploads an object to a bucket.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

HEADERS

PATH VARIABLES

REQUEST BODY

The file to be uploaded is the message body. This request accepts binary data and is not encoded in any way.

Example Request

Shell

curl --location --request PUT 'https://s3.<your-region>.idrivee2.com/my-bucket-name/object-1' \

      --data 'object data'
   

Example Response

S3 Copy Object :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/<your-object>

Creates a copy of an object that is already stored in IDrive^® e2 Cloud Storage.

Object Tagging:
The S3-compatible API does not fully support object tagging. The x-amz-tagging header will be explicitly rejected if it is included on the Copy Object (or Put Object) API calls. This implementation is provided for compatibility with certain integrations.

Checksum Data:
Checksum data for replicated or copied objects is maintained. If the source object has a checksum algorithm, copied parts and byte ranges will compute the appropriate checksum value of the source's type. Currently, we do not support the ability to use the S3 Copy Object operation to change the checksum algorithm.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request PUT 'https://s3.<your-region>.idrivee2.com/my-bucket-name/object-2' \

                                    --header 'x-amz-copy-source: my-bucket-name/object-1' \

                                    --data ''

Example Response

<CopyObjectResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

                                 <LastModified>2026-03-30T06:32:10.352Z</LastModified>

                                 <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

                                 </CopyObjectResult>

S3 Delete Object :

DELETE https://s3.<your-region>.idrivee2.com/<bucket>/<key>

Removes a single object from a bucket. If versioning is enabled and no versionId is specified, a delete marker is inserted. If a versionId is specified, that version is permanently deleted.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request DELETE \
'https://s3..idrivee2.com/my-bucket-name/delete-single-object.txt'
  

Example Response

S3 Delete Objects :

DELETE https://s3.<your-region>.idrivee2.com/<bucket>?delete

Deletes multiple objects from a bucket in a single request. Provide the object keys (and optionally version IDs) in the XML request body.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

BODY (raw XML)

XML

<?xml version="1.0" encoding="UTF-8"?>

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

  <Object>

   <Key>delete-batch-1.txt</Key>

  </Object>

  <Object>

   <Key>delete-batch-2.txt</Key>

  </Object>

</Delete>
  

Example Request

Shell

curl --location --request POST \

'https://s3.<your-region>.idrivee2.com/my-bucket-name?delete' \

--header 'Content-Type: application/xml' \

--data '<?xml version="1.0" encoding="UTF-8"?>

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Object>

  <Key>delete-batch-1.txt</Key>

 </Object>

 <Object>

  <Key>delete-batch-2.txt</Key>

 </Object>

</Delete>'
  

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Deleted>

  <Key>delete-batch-1.txt</Key>

 </Deleted>

 <Deleted>

  <Key>delete-batch-2.txt</Key>

 </Deleted>

</DeleteResult>
  

S3 Get Object :

GET https://s3.<your-region>.Idrivee2.com/<your-bucket-name>/<object-name>

This operation retrieves an object from IDrive^® e2 Cloud Storage.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request GET 'https://s3.<your-region>.Idrivee2.com/<your-bucket-name>/<object-name>

Example Response

S3 Get Object Legal Hold :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/<your-key>?legal-hold

Gets an object's current legal hold status. For more information, see Enable Object Lock with the S3-Compatible API.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/object-1?legal-hold=null'

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Status>ON</Status>

</LegalHold>
  

S3 Get Object Retention :

GET https://s3.<your-region>.idrivee2.com/<bucket>/<key>?retention

rieves the retention settings of an object. Requires the bucket to have Object Lock enabled.

Note: The response body root element is <Retention> — not <ObjectLockConfiguration>. The guide incorrectly shows <ObjectLockConfiguration> which belongs to the Get Object Lock Configuration (bucket-level) API.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location \ 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?retention' \

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Mode>COMPLIANCE</Mode>

 <RetainUntilDate>2026-08-16T07:49:18Z</RetainUntilDate>

</Retention>

S3 Head Object :

HEAD https://s3.<your-region>.idriveee2.com/<your-bucket-name>/<your-key>

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you are interested only in an object's metadata.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --head 'https://s3.<your-region>.idrivee2.com/my-bucket-name/object-1

Example Response

S3 Put Object Legal Hold :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/<your-key>?legal-hold

Applies a legal hold configuration to the specified object. For more information, see Enable Object Lock with the S3-Compatible API.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Body (raw XML)

XML

                                       <?xml version="1.0" encoding="UTF-8"?>

                                       <LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

                                        <Status>ON</Status>

                                       </LegalHold>
                                       

Example Request

Shell

                                       curl --location --request PUT 'https://s3.<your-region>.idrivee2.com/my-bucket-name/object-1?legal-hold=null' \

                                       --data '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

                                       <LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

                                        <Status>ON</Status>

                                       </LegalHold>'
                                       

Example Response

S3 Put Object Retention :

PUT https://s3.<your-region>.idrivee2.com/<bucket>/<key>?retention

Places an Object Retention configuration on an object. Requires the bucket to have Object Lock enabled at creation time.

Note: The request body uses <Retention> as the root element — not <ObjectLockConfiguration>. The <ObjectLockConfiguration> element is used only by the Put Object Lock Configuration (bucket-level) API.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Body (raw XML)

XML

<?xml version="1.0" encoding="UTF-8"?>

<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Mode>COMPLIANCE</Mode>

 <RetainUntilDate>2026-08-16T07:49:18Z</RetainUntilDate>

</Retention>
  

Example Request

curl --location --request PUT \

'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?retention' \

--header 'Content-Type: application/xml' \

--data '<?xml version="1.0" encoding="UTF-8"?>

<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Mode>COMPLIANCE</Mode>

 <RetainUntilDate>2026-08-16T07:49:18Z</RetainUntilDate>

</Retention>'
  

Example Response

S3 Put Object Tagging:

PUT https://s3.<your-region>.idrivee2.com/<bucket>/<key>?tagging

Applies a tag set to an existing object.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Request

Shell

curl --location --request PUT 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?tagging' \

--header 'Content-Type: application/xml' \

--data '<?xml version="1.0" encoding="UTF-8"?>

<Tagging>

 <TagSet>

  <Tag>

   <Key>environment</Key>

   <Value>testing</Value>

  </Tag>

  <Tag>

   <Key>team</Key>

   <Value>docs</Value>

  </Tag>

 </TagSet>

</Tagging>'

Example Response

S3 Get Object Tagging :

GET https://s3.<your-region>.idrivee2.com/<bucket>/<key>?tagging

Returns the tag set of an object.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?tagging'

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<Tagging>

 <TagSet>

  <Tag>

   <Key>environment</Key>

   <Value>testing</Value>

  </Tag>

  <Tag>

   <Key>team</Key>

   <Value>docs</Value>

  </Tag>

 </TagSet>

</Tagging>

S3 Delete Object Tagging:

DELETE DELETE https://s3.<your-region>.idrivee2.com/<bucket>/<key>?tagging

Removes the entire tag set from an object.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Request

Shell

curl --location --request DELETE 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?tagging'

Example Response

S3 Select Object Tagging:

POST https://s3.<your-region>.idrivee2.com/<bucket>/<key>?select&select-type=2

Filters the contents of an object based on an SQL expression and returns only the matching data.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Request

Shell

curl --location --request POST 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?select&select-type=2' \

--header 'Content-Type: application/xml' \

--data '<?xml version="1.0" encoding="UTF-8"?>

<SelectObjectContentRequest>

 <Expression>SELECT * FROM S3Object</Expression>

 <ExpressionType>SQL</ExpressionType>

 <InputSerialization>

  <CompressionType>NONE</CompressionType>

  <CSV>

   <FileHeaderInfo>USE</FileHeaderInfo>

  </CSV>

 </InputSerialization>

 <OutputSerialization>

  <CSV />

 </OutputSerialization>

</SelectObjectContentRequest>'

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<Stats>

 <BytesScanned>21</BytesScanned>

 <BytesProcessed>21</BytesProcessed>

 <BytesReturned>16</BytesReturned>

</Stats>

S3 Create Multipart Upload

POST https://s3.<your-region>.idrivee2.com/<bucket>/<key>?uploads=

Initiates a multipart upload for an object. Returns an UploadId used to associate all subsequent part operations.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request POST 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?uploads='

  

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Bucket>idrivee2-multipart-test</Bucket>

 <Key>my-object2</Key>

 <UploadId>32767.a2acaa0c-2b48-4095-90bf-67d2e555ad5b</UploadId>

</InitiateMultipartUploadResult>
  

S3 Upload Part

PUT https://s3.<your-region>.idrivee2.com/<bucket>/<key>?partNumber=&uploadId=

Uploads a single part of a multipart upload. Each part must be at least 5 MB (except the last part).

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request PUT 
 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?partNumber=1&uploadId=UPLOAD_ID' \

--header 'Content-Length: <part-size>' \

--data-binary '@/path/to/part'
      

Example Response

S3 Upload Part Copy

PUT https://s3.<your-region>.idrivee2.com/<bucket>/<key>?partNumber=&uploadId=

Uploads a part by copying data from an existing object in IDrive^® e2 Cloud Storage.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request PUT 
 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?partNumber=2&uploadId=UPLOAD_ID' \

--header 'x-amz-copy-source: source-bucket/source-object'
      

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<CopyPartResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <LastModified>2026-08-15T03:51:19.212Z</LastModified>

 <ETag>"d47b127bc2de2d687ddc82dac354c415"</ETag>

</CopyPartResult>
            

S3 List Parts

GET https://s3.<your-region>.idrivee2.com/<bucket>/<key>?uploadId=

Lists the parts that have been uploaded for a specific multipart upload.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?uploadId=UPLOAD_ID'
      

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Bucket>idrivee2-multipart-test</Bucket>

 <Key>my-object2</Key>

 <UploadId>32767.a2acaa0c-2b48-4095-90bf-67d2e555ad5b</UploadId>

 <Initiator>

  <ID>27daf35761e411efb1583cecef7cca1427daf35761e411efb1583cecef7cca14</ID>

  <DisplayName>27daf35761e411efb1583cecef7cca1427daf35761e411efb1583cecef7cca14</DisplayName>

 </Initiator>

 <Owner>

  <ID>27daf35761e411efb1583cecef7cca1427daf35761e411efb1583cecef7cca14</ID>

  <DisplayName>27daf35761e411efb1583cecef7cca1427daf35761e411efb1583cecef7cca14</DisplayName>

 </Owner>

 <StorageClass>STANDARD</StorageClass>

 <PartNumberMarker>0</PartNumberMarker>

 <NextPartNumberMarker>0</NextPartNumberMarker>

 <MaxParts>2</MaxParts>

 <IsTruncated>false</IsTruncated>

 <Part>

  <PartNumber>1</PartNumber>

  <LastModified>2026-08-15T03:51:11.556Z</LastModified>

  <ETag>"99167c91c1541375b4f9df4b5e051387"</ETag>

  <Size>5242880</Size>

  <ChecksumCRC32>YAgjqw==</ChecksumCRC32>

 </Part>

 <Part>

  <PartNumber>2</PartNumber>

  <LastModified>2026-08-15T03:51:19.212Z</LastModified>

  <ETag>"d47b127bc2de2d687ddc82dac354c415"</ETag>

  <Size>1024</Size>

 </Part>

</ListPartsResult>
            

S3 List Multipart Uploads

GET https://s3.<your-region>.idrivee2.com/<bucket>?uploads

Lists the multipart uploads that are currently in progress for a bucket. An in-progress multipart upload is an upload that has been initiated but has not yet been completed or aborted.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name?uploads'
      

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Bucket>idrivee2-multipart-test</Bucket>

 <KeyMarker></KeyMarker>

 <UploadIdMarker></UploadIdMarker>

 <NextKeyMarker></NextKeyMarker>

 <NextUploadIdMarker></NextUploadIdMarker>

 <Delimiter></Delimiter>

 <Prefix></Prefix>

 <MaxUploads>10000</MaxUploads>

 <IsTruncated>false</IsTruncated>

 <Upload>

  <Key>my-object2</Key>

  <UploadId>32767.a2acaa0c-2b48-4095-90bf-67d2e555ad5b</UploadId>

  <Initiator>

   <ID></ID>

   <DisplayName></DisplayName>

  </Initiator>

  <Owner>

   <ID></ID>

   <DisplayName></DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

  <Initiated>2026-08-15T03:51:08.043Z</Initiated>

 </Upload>

</ListMultipartUploadsResult>
            

S3 Complete Multipart Upload

POST https://s3.<your-region>.idrivee2.com/<bucket>/<key>?uploadId=

Completes a multipart upload by assembling previously uploaded parts.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request POST
 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?uploadId=UPLOAD_ID' \

--header 'Content-Type: application/xml' \

--data '<?xml version="1.0" encoding="UTF-8"?>

<CompleteMultipartUpload xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

    <Part>
        <ETag>"<etag-part-1>"</ETag>
        <PartNumber>1</PartNumber>

    </Part>

    <Part>
        <ETag>"<etag-part-2>"</ETag>
        <PartNumber>2</PartNumber>
    </Part>

</CompleteMultipartUpload>'
      

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Location>http://s3.us-east-1.idrivee2.com/idrivee2-multipart-test/my-object2</Location>

 <Bucket>idrivee2-multipart-test</Bucket>

 <Key>my-object2</Key>

 <ETag>"611b1b978d6b5544dea8466b893888e7-2"</ETag>

</CompleteMultipartUploadResult>
            

S3 Abort Multipart Upload

DELETE https://s3.<your-region>.idrivee2.com/<bucket>/<key>?uploadId=

This operation aborts a multipart upload.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request DELETE 'https://s3.<your-region>.idrivee2.com/my-bucket-name/my-object?uploadId=32767.25480eb3-77b0-4f7a-8210-138fb08b4890'
      

Example Response

S3 Create Bucket :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>

Creates a new bucket.

The bucket name must be globally unique. For restrictions on bucket names such as minimum and maximum length, see Bucket Names.

You can optionally specify a canned ACL of private (the default) or public-read via the x-amz-acl header.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PATH VARIABLES

Body (raw XML)

XML

<?xml version="1.0" encoding="UTF-8"?>

<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <LocationConstraint>us-west-1</LocationConstraint>

</CreateBucketConfiguration>
  

Example Request

Shell

curl --location --request PUT \ 

'https://s3.<your-region>.idrivee2.com/my-bucket-name' \ 

--header 'x-amz-acl: private' \ 

--header 'Authorization: AWS4-HMAC-SHA256 Credential=<your-access-key>/20260331/<your-region>/s3/aws4_request, SignedHeaders=host;x-amz-date, Signature=<signature>' \ 

--header 'x-amz-date: 20260331T133500Z' \ 

--header 'Content-Type: application/xml' \ 

--data '<?xml version="1.0" encoding="UTF-8"?>

<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <LocationConstraint><your-region></LocationConstraint>

</CreateBucketConfiguration>'
  

Example Response

S3 Delete Bucket :

DELETE https://s3.<your-region>.idrivee2.com/<your-bucket-name>

Deletes the bucket specified. Only buckets that contain no versions of any files can be deleted.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PATH VARIABLES

Example Request

Shell

curl --location --request DELETE 'https://s3.<your-region>.idrivee2.com/my-bucket-name'

Example Response

S3 Delete Bucket CORS :

DELETE https://s3.<your-region>.IDrivee2.com/<your-bucket-name>/?cors

Deletes CORS configuration from the bucket.

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request DELETE 'https://s3.<your-region>.idrivee2.com/my-bucket-name/?cors=null'

Example Response

S3 Delete Bucket Encryption :

DELETE https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?encryption

Deletes default encryption configuration from the bucket. For information about the default encryption feature see Default Bucket Encryption.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

Example Request

Shell

curl --location --request DELETE 

         'https://s3.<your-region>.idrivee2.com/my-bucket-name/?encryption=null'

Example Response

S3 Get Bucket CORS :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?cors

Gets the bucket's CORS configuration.

AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrive e2.com/my-bucket-name/?cors=null'

Example Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <CORSRule>

  <AllowedOrigin>https://www.myapp.com</AllowedOrigin>

  <AllowedMethod>POST</AllowedMethod>

  <AllowedMethod>GET</AllowedMethod>

  <AllowedHeader>*</AllowedHeader>

  <ExposeHeader>x-amz-server-side-encryption</ExposeHeader>

  <MaxAgeSeconds>3600</MaxAgeSeconds>

 </CORSRule>

</CORSConfiguration>
  

S3 Get Bucket Encryption :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?encryption

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES :

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/?encryption=null'

Example Response

<ServerSideEncryptionConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Rule>

  <ApplyServerSideEncryptionByDefault>

   <SSEAlgorithm>aws:kms</SSEAlgorithm>

   <KMSMasterKeyID>s1n7_la1_idrivee2-94_com</KMSMasterKeyID>

  </ApplyServerSideEncryptionByDefault>

 </Rule>

</ServerSideEncryptionConfiguration>
  

S3 Get Bucket Location :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?location

Returns the bucket's region.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/?location=null'

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<LocationConstraint

 xmlns="http://s3.amazonaws.com/doc/2006-03-01/">us-west-2</LocationConstraint>

S3 Get Bucket Versioning :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?versioning

Gets the versioning state of the bucket.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/?versioning=null'

Example Response

<VersioningConfiguration

          xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

          <MfaDelete>Disabled</MfaDelete>

          <Status>Enabled</Status>

</VersioningConfiguration>

S3 Put Bucket Versioning :

PUT https://s3.<your-region>.idrivee2.com/<bucket>?versioning

Sets the versioning state of a bucket. Versioning can be set to Enabled or Suspended. Once enabled, versioning cannot be fully disabled — only suspended.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Body (raw XML)

XML — Enable versioning

<?xml version="1.0" encoding="UTF-8"?>

<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Status>Enabled</Status>

</VersioningConfiguration>
  

XML — Suspend versioning

<?xml version="1.0" encoding="UTF-8"?>

<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Status>Suspended</Status>

</VersioningConfiguration>
  

Example Request

Shell

curl --location --request PUT \

'https://s3.<your-region>.idrivee2.com/my-bucket-name?versioning' \

--header 'Content-Type: application/xml' \

--data '<?xml version="1.0" encoding="UTF-8"?>

<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Status>Enabled</Status>

</VersioningConfiguration>'
  

Example Response

Example Response

S3 Get Object Lock Configuration :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?object-lock

Gets the Object Lock configuration for a bucket.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/?object-lock=null'

Example Response

<ObjectLockConfiguration

           xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

           <ObjectLockEnabled>Enabled</ObjectLockEnabled>

           <Rule>

                      <DefaultRetention>…</DefaultRetention>

           </Rule>

</ObjectLockConfiguration>

S3 Head Bucket :

HEAD https://s3.<your-region>.idrivee2.com/<your-bucket-name>/

Determines whether the bucket exists in your idrive^® e2 account, returning 200 OK if it does exist in your B2 account or 404 Not Found if it does not.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PATH VARIABLES

Example Request

Shell

curl --location --head 'https://s3.<your-region>.idrivee2.com/my-bucket-name/'

Example Response

S3 Delete Lifecycle Configuration :

DELETE https://s3.<your-region>.idrivee2.com/<your-bucket-name>?lifecycle

Deletes the lifecycle configuration from a bucket. After the lifecycle configuration is deleted, objects in the bucket no longer expire, and idrivee2 no longer automatically hides or deletes any objects on the basis of rules contained in the deleted lifecycle configuration.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

URI REQUEST PARAMETERS

Example Response

HTTP/1.1 204 No Content

x-amz-id-2: Uuag1LuByRx9e6j5OnimrE2SAMPLEtRPfTaOAa==

x-amz-request-id: 656c76696e672E2SAMPLE5657374

Date: Wed, 01 Apr 2026 12:41:00 GMT

Connection: keep-alive

Server: nginx

S3 Get Lifecycle Configuration :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>?lifecycle

Returns the lifecycle configuration information set on a bucket. For information about lifecycle configuration, see Lifecycle Rules.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

URI REQUEST PARAMETERS

Example Response

<LifecycleConfiguration>

 <Rule>

  <ID>21595010</ID>

  <Status>Enabled</Status>

  <Filter />

  <Expiration>

   <ExpiredObjectDeleteMarker>true</ExpiredObjectDeleteMarker>

  </Expiration>

  <NoncurrentVersionExpiration>

   <NoncurrentDays>2</NoncurrentDays>

  </NoncurrentVersionExpiration>

 </Rule>

 <Rule>

  <ID>11895980</ID>

  <Status>Enabled</Status>

  <Filter>

   <Prefix />

  </Filter>

  <Expiration>

   <Date>2026-04-04T00:00:00Z</Date>

  </Expiration>

  <NoncurrentVersionExpiration>

   <NoncurrentDays>2</NoncurrentDays>

  </NoncurrentVersionExpiration>

 </Rule>

 <Rule>

  <ID>78931562</ID>

  <Status>Enabled</Status>

  <Filter>

   <Prefix />

  </Filter>

  <Expiration>

   <Days>2</Days>

  </Expiration>

  <NoncurrentVersionExpiration>

   <NoncurrentDays>2</NoncurrentDays>

  </NoncurrentVersionExpiration>

 </Rule>

</LifecycleConfiguration>
  

<Error>

 <Code>ObjectLockConfigurationNotFoundError</Code>

 <Message>Object Lock configuration does not exist for this bucket</Message>

 <BucketName>test2</BucketName>

 <Resource>/test2/</Resource>

 <RequestId>18A248F4254899ED</RequestId>

 <HostId>4be4e6e1-63b8-4a6a-89f7-23046b418552</HostId>

</Error>
  

S3 Put Lifecycle Configuration :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>?lifecycle

Creates a new lifecycle configuration for a bucket or replaces an existing lifecycle configuration. This operation will overwrite an existing lifecycle configuration, so if you want to retain any configuration details, they must be included in the new lifecycle configuration. For information about lifecycle configuration, see Lifecycle Rules.

Note : Modifying lifecycle rules through the web console or B2 Native API regenerates the rule IDs. If you track lifecycle rules by their ID values or need IDs to remain stable, use only this API to manage lifecycle rules.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

URI REQUEST PARAMETERS

REQUEST BODY

E2 COMPATIBILITY NOTES

S3 lifecycle rules are mapped to IDrive^® e2 lifecycle rules as follows:

S3 Lifecycle Action :

• Expiration
• NoncurrentVersionExpiration

Supported Features

• Expiration with Days - Hide the current version of objects after a specified number of days.
• Expiration with ExpiredObjectDeleteMarker set to true - Remove orphan delete markers.
• NoncurrentVersionExpiration with NoncurrentDays - Permanently delete noncurrent object versions after a specified number of days.
• Filter with Prefix - Apply rules to objects matching a key name prefix.
• Status set to Enabled - Rules must be enabled.

Example Request

XML

<?xml version="1.0" encoding="UTF-8"?>

<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Rule>

  <Expiration>

   <ExpiredObjectDeleteMarker>true</ExpiredObjectDeleteMarker>

  </Expiration>

  <ID>21595010</ID>

  <Filter />

  <Status>Enabled</Status>

  <NoncurrentVersionExpiration>

   <NoncurrentDays>2</NoncurrentDays>

  </NoncurrentVersionExpiration>

 </Rule>

 <Rule>

  <Expiration>

   <Date>2026-04-04T00:00:00Z</Date>

  </Expiration>

  <ID>11895980</ID>

  <Filter>

   <Prefix></Prefix>

  </Filter>

  <Status>Enabled</Status>

  <NoncurrentVersionExpiration>

   <NoncurrentDays>2</NoncurrentDays>

  </NoncurrentVersionExpiration>

 </Rule>

 <Rule>

  <Expiration>

   <Days>2</Days>

  </Expiration>

  <ID>78931562</ID>

  <Filter>

   <Prefix></Prefix>

  </Filter>

  <Status>Enabled</Status>

  <NoncurrentVersionExpiration>

   <NoncurrentDays>2</NoncurrentDays>

  </NoncurrentVersionExpiration>

 </Rule>

</LifecycleConfiguration>
  

Example Response

HTTP/1.1 200 OK
x-amz-request-id: 18A248F6B99BBA89
Date: Wed, 01 Apr 2026 16:57:00 GMT
Content-Length: 0
Server: ngnix

HTTP/1.1 400 Bad Request
<?xml version="1.0" encoding="UTF-8"?>
<Error>
   <Code>NotSupported</Code>
   <Message>The specified lifecycle configuration feature is not supported.</Message>
</Error>

S3 List Buckets :

GET https://s3.<your-region>.idrivee2.com/

Lists buckets in your account in alphabetical order by bucket name.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/'

Example Response

<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Owner>

  <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

  <DisplayName>s3user</DisplayName>

 </Owner>

 <Buckets>

  <Bucket>

   <Name>bucket-cors</Name>

   <CreationDate>2026-04-01T09:06:52.133000+00:00</CreationDate>

  </Bucket>

 </Buckets>

</ListAllMyBucketsResult>

S3 List Object Versions :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?versions

Returns metadata of the versions of objects in the bucket. Use the query parameters to filter the search.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/?versions'

Example Response

<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <MfaDelete>Disabled</MfaDelete>

 <Status>Enabled</Status>

</VersioningConfiguration>

S3 List Objects :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/

Returns a list of up to 1,000 objects in the bucket, sorted alphabetically by key. Use query parameters to filter the search.

Note: S3 List Objects V2 should be used in preference to this operation, since this API does not support pagination beyond 1,000 results.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/'

Example Response

<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Name>test3</Name>

 <Prefix />

 <Marker />

 <MaxKeys>100</MaxKeys>

 <Delimiter>/</Delimiter>

 <IsTruncated>false</IsTruncated>


 <Contents>

  <Key>2mb2.pdf</Key>

  <LastModified>2026-04-01T17:17:38.282Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>2mb3.pdf</Key>

  <LastModified>2026-04-01T17:17:38.326Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>2mb4.pdf</Key>

  <LastModified>2026-04-01T17:17:38.324Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>2mb5.pdf</Key>

  <LastModified>2026-04-01T17:17:47.164Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>hometest1.pdf</Key>

  <LastModified>2026-04-01T17:39:37.953Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


</ListBucketResult>

S3 List Objects V2 :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?list-type=2

Use the query parameters to filter the search.

By default, sets of up to 1,000 results are returned. You can set the max-keys to set the maximum result set size to less than 1,000. If the search results in more than the maximum result set size, then the first set is returned in the initial response, the <IsTruncated> response element contains the value true and the <NextContinuationToken> element contains a token to retrieve the next set of results. Use this token as the continuation-token query parameter in another request to retrieve the next set of results.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location 'https://s3.<your-region>.idrivee2.com/my-bucket-name/?list-type=2'

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Name>test3</Name>

 <Prefix></Prefix>

 <Marker></Marker>

 <MaxKeys>100</MaxKeys>

 <Delimiter>/</Delimiter>

 <IsTruncated>false</IsTruncated>


 <Contents>

  <Key>2mb2.pdf</Key>

  <LastModified>2026-04-01T17:17:38.282Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>2mb3.pdf</Key>

  <LastModified>2026-04-01T17:17:38.326Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>2mb4.pdf</Key>

  <LastModified>2026-04-01T17:17:38.324Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>2mb5.pdf</Key>

  <LastModified>2026-04-01T17:17:47.164Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


 <Contents>

  <Key>hometest1.pdf</Key>

  <LastModified>2026-04-01T17:39:37.953Z</LastModified>

  <ETag>"d208e3403b7881a5a53930e448c5772f"</ETag>

  <Size>2208728</Size>

  <Owner>

   <ID>d30270b82cfa11f191747cc255e513e2d30270b82cfa11f191747cc255e513e2</ID>

   <DisplayName>s3user</DisplayName>

  </Owner>

  <StorageClass>STANDARD</StorageClass>

 </Contents>


</ListBucketResult>

S3 Put Bucket CORS :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?cors

Sets the bucket's CORS configuration. If the configuration exists, it is replaced.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

<?xml version="1.0" encoding="UTF-8"?>

<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <CORSRule>

  <AllowedHeader>*</AllowedHeader>

  <AllowedMethod>GET</AllowedMethod>

  <AllowedMethod>PUT</AllowedMethod>

  <AllowedOrigin>myapp</AllowedOrigin>

  <MaxAgeSeconds>3000</MaxAgeSeconds>

 </CORSRule>

</CORSConfiguration>

Example Response

S3 Put Bucket Encryption :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?encryption

Sets the bucket's default encryption configuration. For more information on default encryption, see Default Bucket Encryption.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

<?xml version="1.0" encoding="UTF-8"?>

<ServerSideEncryptionConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <Rule>

  <ApplyServerSideEncryptionByDefault>

   <SSEAlgorithm>aws:kms</SSEAlgorithm>

   <KMSMasterKeyID>p7n5_ch_idrivee2-48_com</KMSMasterKeyID>

  </ApplyServerSideEncryptionByDefault>

  <BucketKeyEnabled>true</BucketKeyEnabled>

 </Rule>

</ServerSideEncryptionConfiguration>

Example Response

S3 Put Object Lock Configuration :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>?object-lock

Sets the Object Lock configuration for a bucket. The specified rule will apply by default to new objects created in the bucket.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

<?xml version="1.0" encoding="UTF-8"?>

<ObjectLockConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <ObjectLockEnabled>Enabled</ObjectLockEnabled>

 <Rule>

  <DefaultRetention>

   <Mode>COMPLIANCE</Mode>

   <Days>1</Days>

  </DefaultRetention>

 </Rule>

</ObjectLockConfiguration>

Example Response

S3 Get Bucket Policy :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?policy

Retrieves the bucket policy from a bucket in IDrive^® e2 S3-compatible object storage.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

curl --location 'https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?policy='

Example Response

{"ID":"E2ReadWrite","Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":["*"]},

               "Action":["s3:GetBucketLocation","s3:ListBucket","s3:ListBucketMultipartUploads"],

               "Resource":["arn:aws:s3:::testpolicy"]},{"Effect":"Allow","Principal":{"AWS":["*"]},

               "Action":["s3:AbortMultipartUpload","s3:DeleteObject","s3:GetObject","s3:ListMultipartUploadParts","s3:PutObject"],

               "Resource":["arn:aws:s3:::testpolicy/*"]}]}

S3 Get Bucket Tagging :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?tagging

Retrieves tags associated with a bucket

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

CURL

curl --location --request GET 'https://s3.<your-region>.idrivee2.com/<your-bucket-name>?tagging

Example Response

<Tagging>

 <TagSet>

  <Tag>

   <Key>test2</Key>

   <Value>test2</Value>

  </Tag>

  <Tag>

   <Key>test1</Key>

   <Value>test1</Value>

  </Tag>

  <Tag>

   <Key>test5</Key>

   <Value>test5</Value>

  </Tag>

  <Tag>

   <Key>test4</Key>

   <Value>test4</Value>

  </Tag>

  <Tag>

   <Key>test3</Key>

   <Value>test3</Value>

  </Tag>

 </TagSet>

</Tagging>

S3 Put Bucket Policy :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?policy

Sets or replaces the access policy on a bucket. If a policy already exists it is fully overwritten.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

(raw JSON)

{
 "ID": "E2ReadWrite",

 "Version": "2012-10-17",

 "Statement": [

  {

   "Effect": "Allow",

   "Principal": { "AWS": ["*"] },

   "Action": [

    "s3:GetBucketLocation",

    "s3:ListBucket",

    "s3:ListBucketMultipartUploads"

   ],

   "Resource": ["arn:aws:s3:::<your-bucket-name>"]

  },

  {

   "Effect": "Allow",

   "Principal": { "AWS": ["*"] },

   "Action": [

    "s3:AbortMultipartUpload",

    "s3:DeleteObject",

    "s3:GetObject",

    "s3:ListMultipartUploadParts",

    "s3:PutObject"

   ],

   "Resource": ["arn:aws:s3:::<your-bucket-name>/*"]

  }

 ]

}
  

Example Request

Shell

curl --location --request PUT \

'https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?policy' \

--header 'Content-Type: application/json' \

--data '{

 "ID": "E2ReadWrite",

 "Version": "2012-10-17",

 "Statement": [

  {

   "Effect": "Allow",

   "Principal": { "AWS": ["*"] },

   "Action": ["s3:GetBucketLocation","s3:ListBucket","s3:ListBucketMultipartUploads"],

   "Resource": ["arn:aws:s3:::<your-bucket-name>"]

  },

  {

   "Effect": "Allow",

   "Principal": { "AWS": ["*"] },

   "Action": ["s3:AbortMultipartUpload","s3:DeleteObject","s3:GetObject","s3:ListMultipartUploadParts","s3:PutObject"],

   "Resource": ["arn:aws:s3:::<your-bucket-name>/*"]

  }

 ]

}'
  

Example Response

S3 Put Bucket Tagging :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?tagging

Adds or updates tags on a bucket

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Response

Example Request

CURL

curl --location --request PUT 'https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?tagging --data '

<?xml version="1.0" encoding="UTF-8"?>

<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <TagSet>

  <Tag>

   <Key>test2</Key>

   <Value>test2</Value>

  </Tag>

  <Tag>

   <Key>test1</Key>

   <Value>test1</Value>

  </Tag>

 </TagSet>

</Tagging>'

S3 Delete Bucket Tagging :

DELETE https://s3.<your-region>.idrivee2.com/<your-bucket-name>?tagging

The DeleteBucketTagging operation removes all tags associated with the specified bucket.Once deleted, the bucket will no longer have any tag metadata.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Request

Shell

curl --location --request DELETE 'https://s3.<your-region>.idrivee2.com/<your-bucket-name>?tagging\

Example Response

S3 Get Bucket Notification Configuration :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>?notification

The GetBucketNotificationConfiguration operation retrieves the current event notification configuration for a specified bucket. This configuration defines how the bucket sends notifications (e.g., object creation or deletion events) to external services such as queues, topics, or webhooks.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Request

Shell

curl --location --request GET 'https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?notification=

Example Response

<NotificationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <TopicConfiguration>

  <Id>test-notification</Id>

  <Event>s3:ObjectCreated:*</Event>

  <Event>s3:ObjectRemoved:*</Event>

  <Event>s3:LifecycleExpiration:*</Event>

  <Topic>arn:aws:sns:us-east-1:918213587287:asad-standard</Topic>

 </TopicConfiguration>

 <IsAWSConfig>false</IsAWSConfig>

</NotificationConfiguration>

S3 Put Bucket Notification Configuration :

PUT https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?notification=

PutBucketNotificationConfiguration is an S3 API operation that lets you configure event notifications for a bucket. It defines which events (like object creation or deletion) should trigger notifications and specifies the destination (such as an Amazon SNS topic, SQS queue) where those notifications are sent.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

PARMS

PATH VARIABLES

Example Request

Shell

curl --location --request PUT 'https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?notification=

Example Response

S3 Put Bucket Website

PUT https://<your-public-domain>/<your-bucket-name>/?website

<your-public-domain> : Public DNS assigned to your region, found in the IDrive® e2 console under your bucket summary
(e.g. public bucket URL https://x3t3.c1.e2-8.dev ).

Sets the website configuration for a bucket. Enables static website hosting — once configured alongside a public-read bucket policy, objects are served publicly without authentication.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Body (raw XML)

Variant 1 — Basic (IndexDocument + ErrorDocument)

<?xml version="1.0" encoding="UTF-8"?>

<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <IndexDocument>

  <Suffix>index.html</Suffix>

 </IndexDocument>

 <ErrorDocument>

  <Key>error.html</Key>

 </ErrorDocument>

</WebsiteConfiguration>
      

Variant 2 — With RoutingRules

<?xml version="1.0" encoding="UTF-8"?>

<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <IndexDocument>

  <Suffix>index.html</Suffix>

 </IndexDocument>

 <ErrorDocument>

  <Key>error.html</Key>

 </ErrorDocument>

 <RoutingRules>

  <RoutingRule>

   <Condition>

    <KeyPrefixEquals>docs/</KeyPrefixEquals>

   </Condition>

   <Redirect>

    <ReplaceKeyPrefixWith>documents/</ReplaceKeyPrefixWith>

   </Redirect>

  </RoutingRule>

  <RoutingRule>

   <Condition>

    <HttpErrorCodeReturnedEquals>404</HttpErrorCodeReturnedEquals>

   </Condition>

   <Redirect>

    <HttpRedirectCode>301</HttpRedirectCode>

    <ReplaceKeyWith>error.html</ReplaceKeyWith>

   </Redirect>

  </RoutingRule>

 </RoutingRules>

</WebsiteConfiguration>
      

Example Request

Shell

curl --location --request PUT \

'https://<your-public-domain>/<your-bucket-name>/?website' \

# Live example: https://x3t3.c1.e2-8.dev/live-website-19aug/?website\

--header 'Content-Type: application/xml' \

--data '<?xml version="1.0" encoding="UTF-8"?>

<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <IndexDocument><Suffix>index.html</Suffix></IndexDocument>

 <ErrorDocument><Key>error.html</Key></ErrorDocument>

</WebsiteConfiguration>'
      

Example Response

S3 Get Bucket Website

GET https://<your-public-domain>/<your-bucket-name>/?website

<your-public-domain> : Public DNS assigned to your region, found in the IDrive® e2 console under your bucket summary
(e.g. public bucket URL https://x3t3.c1.e2-8.dev ).

Returns the website configuration of a bucket.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location \

'https://<your-public-domain>/<your-bucket-name>/?website'

# Live example: https://x3t3.c1.e2-8.dev/live-website-19aug/?website
      

Example Response — No Config Set

<?xml version="1.0" encoding="UTF-8"?>

<Error>

 <Code>NoSuchWebsiteConfiguration</Code>

 <Message>The specified bucket does not have a website configuration</Message>

 <BucketName>website-allops-19aug</BucketName>

</Error>
            

Example Response — Config Exists (basic)

<?xml version="1.0" encoding="UTF-8"?>

<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <IndexDocument>

  <Suffix>index.html</Suffix>

 </IndexDocument>

 <ErrorDocument>

  <Key>error.html</Key>

 </ErrorDocument>

</WebsiteConfiguration>
            

Example Response — Config Exists (with RoutingRules)

<?xml version="1.0" encoding="UTF-8"?>

<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <IndexDocument>

  <Suffix>index.html</Suffix>

 </IndexDocument>

 <ErrorDocument>

  <Key>error.html</Key>

 </ErrorDocument>

 <RoutingRules>

  <RoutingRule>

   <Condition>

    <KeyPrefixEquals>docs/</KeyPrefixEquals>

   </Condition>

   <Redirect>

    <ReplaceKeyPrefixWith>documents/</ReplaceKeyPrefixWith>

   </Redirect>

  </RoutingRule>

  <RoutingRule>

   <Condition>

    <HttpErrorCodeReturnedEquals>404</HttpErrorCodeReturnedEquals>

   </Condition>

   <Redirect>

    <HttpRedirectCode>301</HttpRedirectCode>

    <ReplaceKeyWith>error.html</ReplaceKeyWith>

   </Redirect>

  </RoutingRule>

 </RoutingRules>

</WebsiteConfiguration>
            

S3 Delete Bucket Website

DELETE https://<your-public-domain>/<your-bucket-name>/?website

<your-public-domain> : Public DNS assigned to your region, found in the IDrive® e2 console under your bucket summary
(e.g. public bucket URL https://x3t3.c1.e2-8.dev ).

Removes the website configuration from a bucket. After deletion, the bucket no longer serves files via IndexDocument routing or RoutingRules. However, objects remain accessible if a public-read bucket policy is still active.

AUTHORIZATION AWS Signature

This request is using AWS Signature from the IDrive^® e2 Cloud Storage S3 Compatible API.

PARAMS

PATH VARIABLES

Example Request

Shell

curl --location --request DELETE \

'https://<your-public-domain>/<your-bucket-name>/?website'

# Live example: https://x3t3.c1.e2-8.dev/live-website-19aug/?website
      

Example Response

S3 Put Bucket Logging :

PUT https://s3.us-or.idrivee2.com/<bucket-name>/?logging=

Returns the logging status of a bucket with Bucket Access Logs enabled and the permissions users have to view and modify that status.

AUTHORIZATION AWS Signature

This request is using AWS Signature from collection IDrive^® e2 Cloud Storage S3 Compatible API.

URI REQUEST PARAMETERS

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

 <LoggingEnabled>

  <TargetBucket>idrive10</TargetBucket>

  <TargetPrefix></TargetPrefix>

 </LoggingEnabled>

</BucketLoggingStatus>
  

S3 Get Bucket Logging :

GET https://s3.<your-region>.idrivee2.com/<your-bucket-name>/?logging

This operation retrieves an object from IDrive^® e2 Cloud Storage.

AUTHORIZATION AWS Signature

Returns the logging status of a bucket with Bucket Access Logs enabled and the permissions users have to view and modify that status.

URI REQUEST PARAMETERS

Example Response

<BucketLoggingStatus>

 <LoggingEnabled>

  <TargetBucket>test3</TargetBucket>

  <TargetGrants />

  <TargetPrefix>logs/</TargetPrefix>

 </LoggingEnabled>

</BucketLoggingStatus>