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 |