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
Request
Example HTTP request
GET /cluster/policy
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
Request
Example HTTP request
PUT /cluster/policy
Example JSON body
{
"default_shards_placement": "sparse",
"default_sharded_proxy_policy": "all-nodes"
}
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