IBM Cloud Docs
For developers of IBM Cloud Object Storage

For developers of IBM Cloud Object Storage

The powerful tools of IBM Cloud® Object Storage are available to a developer directly from the command line.

First, ensure that you have the IBM Cloud® Platform CLI and IBM Developer Tools installed.

Create an instance of IBM Cloud Object Storage

  1. First, make sure that you have an API key. Get it from IBM Cloud Identity and Access Management.

  2. Log in to IBM Cloud Platform by using the CLI. It's also possible to store the API key in a file or set it as an environment variable.

    ibmcloud login --apikey <value>
    
  3. Next, create an instance of IBM Cloud Object Storage specifying the name for the instance, the ID, and the wanted plan (lite or standard). Now we have a CRN for the instance. If you have an upgraded account, specify the standard plan. Otherwise, specify lite.

    ibmcloud resource service-instance-create <instance-name> cloud-object-storage <plan> global
    

Some users may encounter the error No resource group targeted when trying to create a new instance. This indicates that the default resource group is not available and that a resource group must be explicitly set. A list of available resource groups can be found using ibmcloud resource groups and the target can be set with ibmcloud target -g <resource-group>.

The Getting Started guide walks through the basic steps of creating buckets and objects, as well as inviting users and creating policies. A list of basic 'curl' commands can be found here.

Learn more about using the IBM Cloud CLI to create applications, manage Kubernetes clusters, and more in the documentation.

Using the API

For managing data stored in Object Storage, you can use S3 API compatible tools like the AWS CLIwith HMAC credentials for compatibility. As IAM tokens are relatively easy to work with, curl is a good choice for basic testing and interaction with your storage. More information can be found in the curl reference, as well as the API reference documentation.

Using libraries and SDKs

IBM COS SDKs are available for Python, Java, Go, and Node.js. These libraries are forked and modified versions of the AWS S3 SDKs that support IAM token-based authentication, as well as support for Key Protect.

Building applications on IBM Cloud

IBM Cloud® provides flexibility to developers in choosing the right architectural and deployment options for a given application. Run your code on bare metal, in virtual machines, by using a serverless framework, in containers, or by using Cloud Foundry.

The Cloud Native Computing Foundation fostered Kubernetes container orchestration framework, which forms the foundation for the IBM Cloud® Kubernetes Service. Developers who want to use Object Storage for persistent storage in their Kubernetes applications can learn more at the following links: