Cluster policy requests

Cluster policy requests

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
RATE THIS PAGE
Back to top ↑