Skip to content

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

@jcferretti

Description

@jcferretti

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:
etcd-io/etcd#18267 (comment)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions