Skip to content

Commit

Permalink
Remove the unimplemented monolithic upload section from the API docum…
Browse files Browse the repository at this point in the history
…entation.

Signed-off-by: Richard Scothern <richard.scothern@docker.com>
  • Loading branch information
Richard Scothern committed May 4, 2016
1 parent c047d34 commit 2a4deee
Show file tree
Hide file tree
Showing 2 changed files with 0 additions and 40 deletions.
20 changes: 0 additions & 20 deletions docs/spec/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -618,26 +618,6 @@ The "digest" parameter must be included with the PUT request. Please see the
[_Completed Upload_](#completed-upload) section for details on the parameters
and expected responses.

Additionally, the upload can be completed with a single `POST` request to
the uploads endpoint, including the "size" and "digest" parameters:

```
POST /v2/<name>/blobs/uploads/?digest=<digest>
Content-Length: <size of layer>
Content-Type: application/octet-stream
<Layer Binary Data>
```

On the registry service, this should allocate a download, accept and verify
the data and return the same response as the final chunk of an upload. If the
POST request fails collecting the data in any way, the registry should attempt
to return an error response to the client with the `Location` header providing
a place to continue the download.

The single `POST` method is provided for convenience and most clients should
implement `POST` + `PUT` to support reliable resume of uploads.

##### Chunked Upload

To carry out an upload of a chunk, the client can specify a range header and
Expand Down
20 changes: 0 additions & 20 deletions docs/spec/api.md.tmpl
Original file line number Diff line number Diff line change
Expand Up @@ -618,26 +618,6 @@ The "digest" parameter must be included with the PUT request. Please see the
[_Completed Upload_](#completed-upload) section for details on the parameters
and expected responses.

Additionally, the upload can be completed with a single `POST` request to
the uploads endpoint, including the "size" and "digest" parameters:

```
POST /v2/<name>/blobs/uploads/?digest=<digest>
Content-Length: <size of layer>
Content-Type: application/octet-stream

<Layer Binary Data>
```

On the registry service, this should allocate a download, accept and verify
the data and return the same response as the final chunk of an upload. If the
POST request fails collecting the data in any way, the registry should attempt
to return an error response to the client with the `Location` header providing
a place to continue the download.

The single `POST` method is provided for convenience and most clients should
implement `POST` + `PUT` to support reliable resume of uploads.

##### Chunked Upload

To carry out an upload of a chunk, the client can specify a range header and
Expand Down

0 comments on commit 2a4deee

Please sign in to comment.