From 6a6ee23bbab1e5d07b45a10547265bc5249c3c4d Mon Sep 17 00:00:00 2001 From: Jon Johnson Date: Tue, 3 Mar 2020 09:28:33 -0800 Subject: [PATCH] Clarify tags listing behavior Registries MAY return a partial set for paginated and non-paginated tag listing requests. Also fix a typo. Signed-off-by: Jon Johnson --- spec.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/spec.md b/spec.md index ca4a7f5a..6ce6b735 100644 --- a/spec.md +++ b/spec.md @@ -1014,7 +1014,8 @@ Host: Authorization: ``` -Return all tags for the repository +Return all tags for the repository. +The implementation MAY impose a maximum limit and return a partial set with pagination links. The following parameters SHOULD be specified on the request: @@ -1189,13 +1190,14 @@ GET /v2//tags/list?n=&last= ``` Return a portion of the tags for the specified repository. +The implementation MAY impose a maximum limit and return a partial set with pagination links. The following parameters SHOULD be specified on the request: | Name | Kind | Description | |--------|-------|---------------------------------------------------------------------------------------------| | `name` | path | Name of the target repository. | -| `n` | query | Limit the number of entries in each response. It not present, all entries will be returned. | +| `n` | query | Limit the number of entries in each response. If not present, all entries will be returned. | | `last` | query | Result set will include values lexically after last. | ###### On Success: OK