---
name: cephaas-endpoints
title: Endpoints
description: Sending a REST API request, calling the IBM Storage Ceph as a Service 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`.
last-updated: 2025-10-30
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/cephaas?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Endpoints
{: #endpoints}

Sending a REST API request, calling the IBM Storage Ceph as a Service 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:

1. Download the IBM Cloud CLI.

2. Log in to your IBM Cloud account by using the `ibmcloud login` command.

3. Retrieve a list of all IBM Storage Ceph as a Service deployments in your IBM Cloud account by using the `software-defined-storage` service name.

    ```sh
    ibmcloud resource service-instances --service-name software-defined-storage
    ```
    {: pre}

4. Retrieve the IBM Storage Ceph as a Service instance ID (GUID) of the instance you want.

    ```sh
    ibm-cloud resource service-instance <cephaas-deployment-name> --guid
    ```
    {: pre}

Example of an  IBM Storage Ceph as a Service endpoint: `a5646acb-bf72-4127-bd4d-71b5ba3ae253.software-defined-storage.appdomain.cloud`

All IBM&reg; Storage Ceph&reg; as a Service endpoints require either TLS 1.2 or TLS 1.3 encryption.
{: note}

## Management API Endpoints
{: #mgmt-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
{: #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](https://cloud.ibm.com/docs/cephaas?topic=cephaas-uploading-s3-certificate&format=markdown).