Endpoints

Sending a REST API request, calling the IBM CephaaS CLI, or configuring a storage client requires setting a target endpoint or URL. Each storage appliance have a unique endpoint that is named as https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud.

To retrieve your cephaas-instance-id from the IBM Cloud CLI, do the following steps:

Download the IBM Cloud CLI.
Log in to your IBM Cloud account by using the ibmcloud login command.
Retrieve a list of all IBM CephaaS deployments in your IBM Cloud account by using the software-defined-storage service name.
```
ibmcloud resource service-instances --service-name software-defined-storage
```

Retrieve the IBM CephaaS instance ID (GUID) of the instance you want.

ibm-cloud resource service-instance <cephaas-deployment-name> --guid

Example of an IBM CephaaS endpoint: a5646acb-bf72-4127-bd4d-71b5ba3ae253.software-defined-storage.appdomain.cloud

All IBM® Storage Ceph® as a Service endpoints require either TLS 1.2 or TLS 1.3 encryption.

Management API Endpoints

The CephaaS Management API has a separate host identifier.

For example, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:443

S3 API Endpoints

The Object Storage S3 data access APIs do not have a fully qualified domain name that is assigned by IBM. Instead, a set of IP addresses are provided to you and you can provide your own, custom domain name and certificate. For instructions, see Uploading S3 certificate.