KR.ADMIN SET-SHARD-STATUS
Changes the operational status of a shard.
Syntax
Section titled “Syntax”KR.ADMIN SET-SHARD-STATUS <shard-kind> <shard-id> <shard-status>Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
shard-kind | string | STASH or BUCKET. Case-insensitive. |
shard-id | integer or * | Zero-based shard index, or * to target all shards atomically. |
shard-status | string | READWRITE, READONLY, or INOPERABLE. Case-insensitive. |
Note:
STASHis an experimental shard kind, disabled by default. See Stash in the configuration reference.
Return Value
Section titled “Return Value”Simple string. Returns OK on success.
Behavior
Section titled “Behavior”Updates the operational status of a shard (or all shards when * is used) atomically. It only affects the logical
access-control layer and does not alter replication roles or volume state.
Shard statuses:
READWRITE: the shard accepts reads and writes.READONLY: the shard accepts reads but rejects writes.INOPERABLE: the shard is unavailable and all access is rejected.
When * is passed as the shard ID, the status is applied to every shard of the specified kind atomically.
Changes propagate to other cluster members automatically.
Requires cluster initialization.
Typical workflows: maintenance (set READONLY before failover), incident response (INOPERABLE to isolate a
shard), post-initialization (set READWRITE after assigning routes).
Errors
Section titled “Errors”Argument errors:
| Error Code | Error message | Cause |
|---|---|---|
ERR | invalid number of parameters | - |
ERR | Unknown shard kind: '<value>' | The shard kind must be STASH or BUCKET. |
ERR | invalid shard id | The shard ID is not a valid integer, or is out of the configured range. |
ERR | Unknown shard status: '<value>' | The status must be READWRITE, READONLY, or INOPERABLE. |
Cluster errors:
| Error Code | Error message | Cause |
|---|---|---|
ERR | cluster has not been initialized yet | - |
Examples
Section titled “Examples”Set all bucket shards to READWRITE:
127.0.0.1:3320> KR.ADMIN SET-SHARD-STATUS BUCKET * READWRITEOKSet a specific bucket shard to READONLY:
127.0.0.1:3320> KR.ADMIN SET-SHARD-STATUS BUCKET 2 READONLYOKSet a shard to INOPERABLE:
127.0.0.1:3320> KR.ADMIN SET-SHARD-STATUS BUCKET 0 INOPERABLEOKInvalid shard status:
127.0.0.1:3320> KR.ADMIN SET-SHARD-STATUS BUCKET 0 DISABLED(error) ERR Unknown shard status: 'DISABLED'Shard ID out of range:
127.0.0.1:3320> KR.ADMIN SET-SHARD-STATUS BUCKET 999999 READONLY(error) ERR invalid shard id