diff --git a/spec.md b/spec.md index 956d9e6f..9571aec1 100644 --- a/spec.md +++ b/spec.md @@ -79,7 +79,29 @@ Registry providers can self-certify by submitting conformance results to [openco #### Pull -TODO: describe the Pull category and the high-level details +##### Pulling Blobs + +To pull a blob, perform a `GET` request to a url in the following form: +`/v2//blobs/` + +`` is the namespace of the repository, and `` is the blob's digest. + +A GET request to an existing blob URL MUST provide the expected blob, with a reponse code that MUST be `200 OK`. + +If the blob is not found in the registry, the response code MUST be `404 Not Found`. + +##### Pulling manifests + +To pull a manifest, perform a `GET` request to a url in the following form: +`/v2//manifests/` + +`` refers to the namespace of the repository. `` MUST be either (a) the digest of the manifest or (b) a tag name. + +The `` MUST NOT be in any other format. + +A GET request to an existing manifest URL MUST provide the expected manifest, with a response code that MUST be `200 OK`. + +If the manifest is not found in the registry, the response code MUST be `404 Not Found`. #### Push