To use Object Storage Unit (OSU), you can use different tools compatible with 3DS OUTSCALE security requirements:

  • Ceph API, the open source API that OSU is based on.
  • AWS CLI, a command-line interface that enables you to access OSU through a terminal.
  • Clients such as:
    • Cyberduck, an application that enables you to browse, edit and transfer your objects stored on OSU.
    • TNTDrive and ExpanDrive, applications that enable you to mount a drive on your computer, synchronized with your OSU buckets.

The following topics are discussed: 

Ceph API

The OSU solution is based on the open source Ceph API. Therefore, you can use the Ceph API to use OSU. For more information, see the official Ceph documentation. It provides request samples in various languages, for example Python, Java and C++.


The v4 version of the API signing process is currently supported for the eu-west-2 and us-west-1 Regions only. For other Regions, you need to use tools compatible with the v2 version.


Note that if you are using the Java SDK:

  • The expect:100-continue header is not supported by OSU. For performance reasons, you need to deactivate this header.
    The following example shows how to do so for the upload, by replacing the Upload upload = tm.upload(BUCKET_NAME, key, f); line by this code block:

     PutObjectRequest request = new PutObjectRequest(bucketName, key, f);
     ObjectMetadata meta = new ObjectMetadata();
     meta.setHeader("Expect", "");
     request.setMetadata(meta);
     Upload upload = tm.upload(request);
  • The x-amz-version-id header is not supported by Ceph. To manage versions, you need to bypass this header using the following code block:

     List<S3VersionSummary> versions = listing.getVersionSummaries();
            if (versions != null && versions.size() > 0) {
                String versionId = versions.get(0).getVersionId();
                System.out.println("versionId=" + versionId);
            }



AWS CLI

AWS CLI is a SDK that enables you to manage resources on OSU. To use OSU with AWS CLI, you need a 3DS OUTSCALE account and a valid access key. For more information, see About Your Account and About Access Keys.

AWS CLI enables you, for example, to manage buckets and objects, to manage access to these buckets and objects, and to store large objects.

This documentation uses s3api commands. The more accessible s3 commands are also provided in tip boxes when available. For more information, see About Tools to Use OSU.

For more information about how to configure AWS CLI, see Installing and Configuring AWS CLI.



Clients

Cyberduck

Cyberduck is an application available for Windows and macOS. It enables you to browse your buckets and objects on your OSU account. You can also edit your objects directly from Cyberduck using any external editor installed on your machine. You can also share your buckets and objects with other users.

When configuring Cyberduck for OSU, you specify:

For more information about how to use Cyberduck, see the official Cyberduck documentation.



TNTDrive

TNTDrive is available for Windows only.

You cannot install both TNTDrive and ExpanDrive on the same computer.

To download an OSU-compatible TNTDrive version, click the following link: https://tntdrive.com/download.aspx.

When creating your TNTDrive, you need to specify the following parameters:

  • Storage Type: Must be set to S3-compatible bucket.
  • REST Endpoint: The OSU endpoint corresponding to the Region you want to use. For more information, see Regions, Endpoints and Availability Zones Reference.
  • Access Key ID: Your access key ID.
  • Secret Access Key: Your secret key.
  • Amazon S3 bucket: The name of an existing bucket you want to mount.

    Once you provide your access key and secret key, you can click Refresh next to the Amazon S3 bucket field to display a list of your existing buckets. You can choose to mount either one bucket or all of them.


  • Mapped Drive Letter: The drive letter you want to use for your TNTDrive.

This application enables you to mount a drive on your computer, synchronized with your OSU buckets. You can then:

  • Create buckets by creating directories at the root of your drive. These buckets must have a unique name.
  • Create subdirectories and copy objects directly in your drive, that are thus automatically syncronized and added to your OSU account.

For more information about how to use TNTDrive, see the TNTDrive documentation.



ExpanDrive

ExpanDrive is available for Windows and macOS.

You cannot install both TNTDrive and ExpanDrive on the same computer.

To download an OSU-compatible ExpanDrive version, click one of the following links:

When creating your ExpanDrive, you need to specify the following parameters:

  • Server: The OSU endpoint corresponding to the Region you want to use. For more information, see Regions, Endpoints and Availability Zones Reference.
  • Access Key ID: Your access key ID.
  • Secret Access Key: Your secret key.
  • Nickname: The name you want to give to your ExpanDrive.
  • Remote path: The name of an existing bucket you want to mount.

This application enables you to mount a drive on your computer, synchronized with your OSU buckets. You can then:

  • Create buckets by creating directories at the root of your drive. These buckets must have a unique name.
  • Create subdirectories and copy objects directly in your drive, that are thus automatically syncronized and added to your OSU account.

For more information about how to use ExpanDrive, see the ExpanDrive documentation.




AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.

Windows® is a registered trademark of Microsoft Corporation in the United States and/or other countries.