IDrive^® e2 S3 Compatible API

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/<your-bucket-name>/<your-object>

Removes an object from a bucket and IDrive^® e2 Cloud Storage. The inclusion of a versionId in the request will determine the behavior of this operation:

• If a versionId is included in the request, an object will be permanently deleted from a bucket and IDrive^® e2 Cloud Storage.
• If no versionId is included in the request, a delete marker will be inserted. This delete marker will become the current version of the object.

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.<region>.idrivee2.com/<bucket>/?delete=' \

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

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

 <Object>

  <Key>file.txt</Key>

 </Object>

</Delete>'
  

Example Response

S3 Delete Objects :

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

Deletes multiple objects from a bucket in a single request. In the XML body, provide the objects keys and, optionally, version IDs if you want to delete a specific object version.

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"?>

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

  <Object>

   <Key>file-1.txt</Key>

  </Object>

  <Object>

   <Key>file-2.jpg</Key>

  </Object>

  <Object>

   <Key>reports/2026/summary.pdf</Key>

  </Object>

</Delete>
  

Example Request

Shell

curl --location --request PUT 'https://s3.<region>.idrivee2.com/<bucket>/?delete=' \

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

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

 <Object>

  <Key>file-1.txt</Key>

 </Object>

 <Object>

  <Key>file-2.jpg</Key>

 </Object>

</Delete>'
  

Example Response

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.<region>.idrivee2.com/<bucket-name>/<object-key>?retention

Retrieves an object's retention settings. 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?retention=null' \

Example Response

<?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>
  

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 :

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 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/<your-bucket-name>/<your-key>?retention

Places an Object Retention configuration on an 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"?>

<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 Request

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

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

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

 <Mode>COMPLIANCE</Mode>

 <RetainUntilDate>2026-02-02T23:56:06.538Z</RetainUntilDate>

</Retention>'
  

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>
  

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 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 Complete Multipart Upload :

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

Completes a multipart upload by assembling previously uploaded parts.

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 POST 'https://s3.<your-region>.idrivee2.com/<your-bucket-name>/<your-key>?uploadId=' \

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

--header 'X-Amz-Content-Sha256: <hash>' \

--header 'X-Amz-Date: <timestamp>' \

--header 'Authorization: <signature>' \

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

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

 <Part>

  <ETag>"580c34cd27234f14cdd934bb362dc8ca"</ETag>

  <PartNumber>1</PartNumber>

 </Part>

 <Part>

  <ETag>"a893aa55cfb8c9e2dacb85b86014b53a"</ETag>

  <PartNumber>2</PartNumber>

 </Part>

 <Part>

  <ETag>"0950cf1118338f610723d2228d73580c"</ETag>

  <PartNumber>3</PartNumber>

 </Part>

 <Part>

  <ETag>"9243931bef892405909958437e49cb8d"</ETag>

  <PartNumber>4</PartNumber>

 </Part>

</CompleteMultipartUpload>'
  

Example Response

S3 Abort Multipart Upload :

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

This operation aborts a multipart upload.

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 DELETE 
'https://s3.<your-region>.idrivee2.com/my-bucket-name/object-1?uploadId=32767.14137a7f-c4af-4221-b59d-5b6d1a979fb4'

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 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