Oracle Cloud Infrastructure Documentation

Listing Clusters

View a list of the OCI Cache clusters in a compartment.

Each non-sharded cluster is composed of one primary node and optionally one or more data nodes, based on the options that you specify when you create the cluster.

For reliability purposes, we recommend a minimum three node cluster configuration. Reliability isn't guaranteed for one to two node cluster configurations.

Each sharded cluster is composed of a minimum of three shards, with each shard composed of one primary node, and optionally one to four data nodes, based on the options you specify when you create the cluster. The maximum number of nodes per sharded cluster is 100, for more information, see Sharded Clusters.
Caution

Clusters can only be created in subnets that don't have IPv6 enabled. If you select an existing subnet with IPv6 enabled, cluster creation fails.
    1. Open the navigation menu  and select Databases. Under OCI Cache, select Clusters.

      The Clusters list page opens. All clusters in the selected compartment are displayed in a table.

    2. To view the clusters in a different compartment, use the Compartment filter to switch compartments.

      You must have permission to work in a compartment to see the resources in it. If you're not sure which compartment to use, contact an administrator. For more information, see Understanding Compartments.

    Filtering List Results

    Use filters to limit the clusters in the list. Perform one of the following actions depending on the options that you see:

    • From the Search and Filter box above the list table, select one or more filters and specify the values that you want to use to narrow the list. In general, the filters correspond to the columns shown in the list table, although some filters represent attributes that aren't shown in the table. The Compartment filter is always displayed next to Applied filters.
    • On the left side of the list page, select a value from one of the available filters, such as compartment, state, or tags.

    Change the order of the items in the list table by using the sort icons next to the column names.

    Actions

    In the list table, select the name of a cluster to open its details page, where you can view its status and perform other tasks.

    To perform an action on a cluster directly from the list table, select any of the following options from the Actions menu (Actions Menu) in the row for that cluster:

    To create a cluster, select Create cluster.

  • Use the oci redis redis-cluster-summary list-redis-clusters command and required parameters to list the clusters in a compartment:

    oci redis redis-cluster-summary list-redis-clusters --compartment-id compartment_id [OPTIONS]

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

    Run the ListRedisClusters operation to list the clusters.