Skip to content
SHC Docs

shc node label

show a node’s labels, or set and remove its operator labels

With only a node, prints every label it carries: the ones SHC derives (node, location at every level, cloud, runtime, storage, endpoint, control-plane) and the operator’s own. key=value sets an operator label (one value per key, so it replaces the one the node had), key! removes it. control-plane is shown here and changed with shc node update --control-plane. Keys SHC derives are refused. A label value’s own properties (reserved, description, backup repo) are shc label set, which never adds the label to a node.

shc node label <node> [key=value | key!]... [flags]
shc node label n1
shc node label n1 tier=gold rack=r12
shc node label n1 tier!
--dry-run say what would change and change nothing
-h, --help help for label
--config stringArray extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
-d, --debug enable debug mode (default: $SHC_DEBUG)
-e, --environment string environment name (default: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
--exclude string comma-separated dotted paths to drop
--fields string comma-separated columns/keys to show (and their order)
--filter string comma-separated dotted paths to keep (drops everything else)
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-s, --stack string stack name (default: $SHC_STACK)
-t, --tenant string tenant name (default: $SHC_TENANT)
-v, --verbose verbose output (default: $SHC_VERBOSE)
  • shc node - manage and inspect cluster nodes