Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Cloud Access Control

Manage users, roles, and ACLs for Redis Cloud.

Users

List Users

redisctl cloud user list

Get User

redisctl cloud user get <user-id>

Create User

redisctl cloud user create --data '{
  "name": "app-user",
  "email": "user@example.com",
  "role": "viewer"
}'

Update User

redisctl cloud user update <user-id> --data '{
  "role": "member"
}'

Delete User

redisctl cloud user delete <user-id>

Roles

List Roles

redisctl cloud acl role list

Get Role

redisctl cloud acl role get <role-id>

Create Role

redisctl cloud acl role create --data '{
  "name": "read-only",
  "redisRules": [
    {
      "ruleName": "Read-Only",
      "databases": [
        {"subscriptionId": 123456, "databaseId": 789}
      ]
    }
  ]
}'

Update Role

redisctl cloud acl role update <role-id> --data '{
  "name": "read-write"
}'

Delete Role

redisctl cloud acl role delete <role-id>

Redis Rules

Redis ACL rules define permissions at the Redis command level.

List Redis Rules

redisctl cloud acl redis-rule list

Get Redis Rule

redisctl cloud acl redis-rule get <rule-id>

Create Redis Rule

redisctl cloud acl redis-rule create --data '{
  "name": "Read-Only",
  "acl": "+@read ~*"
}'

Common ACL Patterns

PatternDescription
+@all ~*Full access to all keys
+@read ~*Read-only access
+@write ~cache:*Write only to cache:* keys
-@dangerousDeny dangerous commands

Examples

Set Up Read-Only User

# Create redis rule
redisctl cloud acl redis-rule create --data '{
  "name": "readonly-rule",
  "acl": "+@read -@dangerous ~*"
}'

# Create role with rule
redisctl cloud acl role create --data '{
  "name": "readonly-role",
  "redisRules": [{"ruleName": "readonly-rule", "databases": [...]}]
}'

Audit Access

# List all users and their roles
redisctl cloud user list -q "[].{name:name,role:role,email:email}" -o table

API Reference

These commands use the following REST endpoints:

  • GET/POST /v1/acl/users - User management
  • GET/POST /v1/acl/roles - Role management
  • GET/POST /v1/acl/redisRules - Redis rule management

For direct API access: redisctl api cloud get /acl/users