website
website copied to clipboard
Documentation for Range should state that revision filtering does not affect returned count.
trafficstars
The description of Range here: https://etcd.io/docs/v3.6/learning/api/ should help users avoid a common pitfall in the API: When any of the filtering options (min_mod_revision, max_mod_revision, min_create_revision, max_create_revision) is used, that affects only the actual list of keys returned, it does NOT affect the count returned. This is specially confusing since you can request count_only, which makes the actual API behavior inconsistent. But that is how it is, there was a decision not to fix this bug but just change the docs to explain the behavior, see: https://github.com/etcd-io/etcd/issues/18267#issuecomment-3336693213