SUBSCRIBE
Syntax
SUBSCRIBE channel [channel ...]
- Available since:
- 2.0.0
- Time complexity:
- O(N) where N is the number of channels to subscribe to.
- ACL categories:
-
@pubsub
,@slow
,
Subscribes the client to the specified channels.
Once the client enters the subscribed state it is not supposed to issue any
other commands, except for additional SUBSCRIBE
, SSUBSCRIBE
, PSUBSCRIBE
, UNSUBSCRIBE
, SUNSUBSCRIBE
,
PUNSUBSCRIBE
, PING
, RESET
and QUIT
commands.
However, if RESP3 is used (see HELLO
) it is possible for a client to issue any commands while in subscribed state.
For more information, see Pub/sub.
Return
When successful, this command doesn't return anything. Instead, for each channel, one message with the first element being the string "subscribe" is pushed as a confirmation that the command succeeded.
Behavior change history
>= 6.2.0
:RESET
can be called to exit subscribed state.