IBM Cloud Object Storage System™ Version 3.14.3 Simple Object HTTP API 2.5 Developer Guide
Published by IBM, this developer guide describes the Simple Object HTTP (SOH) API 2.5 for IBM Cloud Object Storage System Version 3.14.3. It explains the REST URI format, API version reporting, request IDs, authentication, and the requests for vault listing and status, object write, read, delete, and listing.
According to the guide, the SOH API is part of the Dispersed Storage Object API Family and is automatically deployed on IBM Cloud Object Storage Accesser appliances. Clients reach it at http://{accesser-ip}/soh/{vault-name}/{object-id}, or at the root URL when the SOH API is set as the default API; HTTPS access is also supported. Version 2.5 adds the X-Clv-Request-Id response header.
| API version | 2.5 |
|---|---|
| Base URL scheme | http://{accesser-ip}/soh/{vault-name}/{object-id} |
| Authentication methods | User name and password, or X.509 certificate and private key pair |
| Request ID header | X-Clv-Request-Id, unique for each response |
| Version header | X-SOH-Version |
| HTTPS support | Supported |
| Default API in ClevOS 2.8.0 | SOH API |
| Deployment | Automatically deployed on IBM Cloud Object Storage Accesser appliances |
The Simple Object HTTP API is a REST API that lets application developers access object vaults on an IBM Cloud Object Storage System; it is part of the Dispersed Storage Object API Family.
All HTTP responses now include an X-Clv-Request-Id header with an identifier unique to each response, which can be used by a Cleversafe Support Engineer for diagnostics and troubleshooting.
From the JSON document returned by a vault listing or vault status query, or from the X-SOH-Version header included in each server response.
http://{accesser-ip}/soh/{vault-name}/{object-id}, where {accesser-ip} is the Accesser appliance address and {vault-name} selects the vault.