client-capa.3valkey - Man Page
A client claims its capability.
Synopsis
CLIENT CAPA
capability [capability...]
Description
Clients can declare their capabilities to Valkey using the CLIENT CAPA
command, and Valkey will adjust the corresponding features for the current connection based on the declared client capabilities.
Multiple capabilities can be declared in the command. If any capabilities are unrecognized, Valkey will ignore them instead of returning an error.
The capabilities currently supported are:
redirect
- This indicates that the client is capable of handling redirect messages. When accessing a replica node in standalone mode, if a data operation is performed (read or write commands), Valkey will return-REDIRECT primary-ip:port
to this connection. Using theREADONLY
command can enable this connection to execute read commands on the replica node.
Complexity
O(1)
Acl Categories
@connection @slow
History
- Available since: 8.0.0
See Also
auth(3valkey), client(3valkey), client-caching(3valkey), client-getname(3valkey), client-getredir(3valkey), client-help(3valkey), client-id(3valkey), client-info(3valkey), client-kill(3valkey), client-list(3valkey), client-no-evict(3valkey), client-no-touch(3valkey), client-pause(3valkey), client-reply(3valkey), client-setinfo(3valkey), client-setname(3valkey), client-tracking(3valkey), client-trackinginfo(3valkey), client-unblock(3valkey), client-unpause(3valkey), echo(3valkey), hello(3valkey), ping(3valkey), reset(3valkey), select(3valkey)