Method Path Description
GET /v1/cluster/policy Get cluster policy settings
PUT /v1/cluster/policy Update cluster policy settings

Get cluster policy

GET /v1/cluster/policy

Gets the cluster’s current policy settings.

Required permissions

Permission name
view_cluster_info

Request

Example HTTP request

GET /cluster/policy 

Request headers

Key Value Description
Host cnm.cluster.fqdn Domain name
Accept application/json Accepted media type

Response

Returns a cluster settings object.

Example JSON body

{
    "db_conns_auditing": false,
    "default_non_sharded_proxy_policy": "single",
    "default_provisioned_redis_version": "6.0",
    "default_sharded_proxy_policy": "single",
    "default_shards_placement": "dense",
    "redis_upgrade_policy": "major",
    "// additional fields..."
}

Status codes

Code Description
200 OK Success

Update cluster policy

PUT /v1/cluster/policy

Update cluster policy settings.

Required permissions

Permission name
update_cluster

Request

Example HTTP request

PUT /cluster/policy

Example JSON body

{
    "default_shards_placement": "sparse",
    "default_sharded_proxy_policy": "all-nodes"
}

Request headers

Key Value Description
Host cnm.cluster.fqdn Domain name
Accept application/json Accepted media type

Request body

Include a cluster settings object with updated fields in the request body.

Response

Returns a status code that indicates the success or failure of the cluster settings update.

Status codes

Code Description
200 OK Success
400 Bad Request Failed to set parameters