Skip to content

Commit 6074d5f

Browse files
committed
Update language and add example
1 parent 8fe2fe8 commit 6074d5f

1 file changed

Lines changed: 12 additions & 2 deletions

File tree

spec.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -473,11 +473,21 @@ The Docker-Content-Digest header returns the canonical digest of the uploaded bl
473473
Clients MAY ignore the value but if it is used, the client SHOULD verify the value against the uploaded blob data.
474474

475475
When pushing a manifest by digest, the registry MAY support the pushing of tags specified by addition of `tag` query parameters.
476-
If a registry supports this, it MUST:
476+
If a registry supports this, it:
477477

478-
1. Not limit the number of tags that can be pushed at once.
478+
1. MUST support pushing 5 times at once, and SHOULD NOT set an upper limit
479479
1. For each tag that was successfully pushed, include an `OCI-Tag` response header in accordance with [RFC 2616 (section 4.2)](https://datatracker.ietf.org/doc/html/rfc2616#section-4.2) semantics.
480480

481+
For example, if the client pushed a manifest with the following tags:
482+
```
483+
PUT /v2/<name>/manifests/<digest>?tag=1.2.3&tag=1.2&tag=1&tag=latest
484+
```
485+
486+
The server would respond with the following header:
487+
```
488+
OCI-Tag: 1.2.3, 1.2, 1, latest
489+
```
490+
481491
An attempt to pull a nonexistent repository MUST return response code `404 Not Found`.
482492

483493
A registry SHOULD enforce some limit on the maximum manifest size that it can accept.

0 commit comments

Comments
 (0)