AI agent builder

ACL DRYRUN

Syntax text Syntax diagram API methods

ACL DRYRUN username command [arg [arg ...]]

Client:

acl_dryrun(
    username: str,
    *args: Any,
    **kwargs: Any
) → str

aclDryRun(
    username: String,
    args: String...
) → String

acl(
    $subcommand: string,
    $args: mixed
) → string

Available since:: Redis Open Source 7.0.0
Time complexity:: O(1).
ACL categories:: @admin, @slow, @dangerous,
Compatibility:: Redis Software and Redis Cloud compatibility

Simulate the execution of a given command by a given user. This command can be used to test the permissions of a given user without having to enable the user or cause the side effects of running the command.

Required arguments

username

The user to run the simulated command as.

command

The command to test.

Optional arguments

arg [arg ...]

The arguments to pass to the tested command.

Examples

> ACL SETUSER VIRGINIA +SET ~*
"OK"
> ACL DRYRUN VIRGINIA SET foo bar
"OK"
> ACL DRYRUN VIRGINIA GET foo
"User VIRGINIA has no permissions to run the 'get' command"

Redis Software and Redis Cloud compatibility

Redis Software	Redis Cloud	Notes
✅ Standard ✅ Active-Active	✅ Standard ✅ Active-Active	Might reply with "unknown user" for LDAP users even if `AUTH` succeeds.

Return information

RESP2 RESP3

Any of the following:

Simple string reply: OK on success.
Bulk string reply: an error describing why the user can't execute the command.