diff --git a/spec.md b/spec.md index 5f6f1cfa..4ed4eeaf 100644 --- a/spec.md +++ b/spec.md @@ -526,6 +526,8 @@ In this case, the path will look like the following: `/v2//tags/list?n=` is the namespace of the repository, and `` is an integer specifying the number of tags requested. The response to such a request MAY return fewer than `` results, but only when the total number of tags attached to the repository is less than ``. Otherwise, the response MUST include `` results. +A `Link` header MAY be included in the response when additional tags are available. +If included, the `Link` header MUST be set according to [RFC5988](https://www.rfc-editor.org/rfc/rfc5988.html) with the Relation Type `rel="next"`. When `n` is zero, this endpoint MUST return an empty list, and MUST NOT include a `Link` header. Without the `last` query parameter (described next), the list returned will start at the beginning of the list and include `` results. As above, the tags MUST be in lexical order. @@ -541,6 +543,10 @@ The tags MUST be in lexical order. When using the `last` query parameter, the `n` parameter is OPTIONAL. +The registry SHOULD support at least `n=100` tags in a single response. +The client SHOULD avoid requesting more than `n=100` tags in a single request. +If the registry is unable to return all tags requested by the client, the registry MUST return a `400 Bad Request` with `TAG_LIMIT_EXCEEDED` error [code-15](#error-codes) and include the header `OCI-Tag-Limit: `, where `` is the maximum tags per request supported by the registry. + ##### Listing Referrers *Note: this feature was added in distibution-spec 1.1. @@ -738,8 +744,8 @@ This endpoint MAY be used for authentication/authorization purposes, but this is | end-5 | `PATCH` | `/v2//blobs/uploads/` | `202` | `404`/`416` | | end-6 | `PUT` | `/v2//blobs/uploads/?digest=` | `201` | `404`/`400` | | end-7 | `PUT` | `/v2//manifests/` | `201` | `404` | -| end-8a | `GET` | `/v2//tags/list` | `200` | `404` | -| end-8b | `GET` | `/v2//tags/list?n=&last=` | `200` | `404` | +| end-8a | `GET` | `/v2//tags/list` | `200` | `404`/`400` | +| end-8b | `GET` | `/v2//tags/list?n=&last=` | `200` | `404`/`400` | | end-9 | `DELETE` | `/v2//manifests/` | `202` | `404`/`400`/`405` | | end-10 | `DELETE` | `/v2//blobs/` | `202` | `404`/`405` | | end-11 | `POST` | `/v2//blobs/uploads/?mount=&from=` | `201` | `404` | @@ -787,6 +793,7 @@ The `code` field MUST be one of the following: | code-12 | `DENIED` | requested access to the resource is denied | | code-13 | `UNSUPPORTED` | the operation is unsupported | | code-14 | `TOOMANYREQUESTS` | too many requests | +| code-15 | `TAG_LIMIT_EXCEEDED` | too many tags were requested | #### Warnings