Oracle Cloud Infrastructure Documentation

Getting an OCI Cache Sharded Cluster's Connection Details

View the private IPs you use to connect to an OCI Cache sharded cluster.

Unlike non-sharded clusters, sharded clusters don't have primary or replica endpoints at the cluster level that you use to connect to the cluster. Instead, the sharded cluster has private endpoints to each shard's node. For reliability purposes, we recommend that you specify the primary node private endpoint for three of the cluster's shards in your application's connection code. The endpoint identifies the shard and node that the endpoint connects to, using the following endpoint pattern:

<ID>-<shard_number>-<node_number>.redis.<region_ID>.oci.oraclecloud.com

The <node_number> in a primary node's endpoint is always 1. For example, the following endpoint is for the second shard's primary node, for a sharded cluster in the us-phoenix-1 region:

<Unique_ID>-2-1.redis.us-phoenix-1.oci.oraclecloud.com
    1. On the Clusters list page, select the cluster that you want to work with. If you need help finding the list page or the cluster, see Listing OCI Cache Clusters.
    2. On the cluster's details page, select Cluster nodes.
    3. In the Cluster nodes section, find the primary node for the cluster's shards.
      Tip

      To find a primary node by name, enter its name in the Search field.
    4. In the Private endpoint column, select Show to display the full value for a field in the Console, and select Copy to copy the value.

  • Use the oci redis redis-cluster node-summary list-redis-cluster-nodes command and required parameters to get the node details for a cluster:

    oci redis redis-cluster node-summary list-redis-cluster-nodes --redis-cluster-id <cluster_OCID> [OPTIONS]
    For information about using the CLI, see Command Line Interface (CLI). For a complete list of flags and options available for CLI commands, see the CLI Command Reference.

  • Run the ListRedisClusterNodes operation to get the node details for a cluster.