opencontainers / distribution-spec

OCI Distribution Specification
https://opencontainers.org
Apache License 2.0
828 stars 205 forks source link

Inconsistent specification for endpoint end-8b's (`.../tags/list`) parameter `last`. #327

Open nairb774 opened 2 years ago

nairb774 commented 2 years ago

The specification of the last query parameter differs between the Endpoints table and the textual description in the "Content Discovery" section. The Endpoints table lists the API endpoint as /v2/<name>/tags/list?n=<integer>&last=<integer> - notice that last is specified as an <integer>. The "Content Discovery" section lists the API endpoint as /v2/<name>/tags/list?n=<int>&last=<tagname> and provides this additional commentary:

... <tagname> is the value of the last tag. <tagname> MUST NOT be a numerical index, but rather it MUST be a proper tag.

If I had to guess, the Endpoints table is incorrect and should be updated to match the specification described in the "Content Discovery" section.