Image

Push an image

Push an image to a registry.

If you wish to push an image on to a private registry, that image must already have a tag which references the registry. For example, registry.example.com/myimage:latest.

The push is cancelled if the HTTP connection is closed.

post/images/{name}/push

Request

  • Base URL
    /v1.44 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /v1.44/images/{name}/push
  • Auth
    none declared. Required headers: X-Registry-Auth

Path parameters

namestring required

Image name or ID.

Query parameters

tagstring

The tag to associate with the image on the registry.

Headers

X-Registry-Authstring required

A base64url-encoded auth configuration.

Refer to the authentication section for details.

Response

No error

Changes

No recorded changes to this operation across all 70 revisions of this API.