website icon indicating copy to clipboard operation
website copied to clipboard

Documentation for Range should state that revision filtering does not affect returned count.

Open jcferretti opened this issue 1 month ago • 0 comments
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

jcferretti avatar Sep 26 '25 14:09 jcferretti