Create an image by pulling from a registry or importing from an existing source file

post/images/create

Request

  • Base URL
    /v1.24 (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    none declared

Query parameters

fromImagestring

Name of the image to pull. The name may include a tag or digest. This parameter may only be used when pulling an image. The pull is cancelled if the HTTP connection is closed.

fromSrcstring

Source to import. The value may be a URL from which the image can be retrieved or - to read the image from the request body. This parameter may only be used when importing an image.

repostring

Repository name given to an image when it is imported. The repo may include a tag. This parameter may only be used when importing an image.

tagstring

Tag or digest. If empty when pulling an image, this causes all tags for the given image to be pulled.

Headers

X-Registry-Authstring

A base64-encoded auth configuration. See the authentication section for details.

Request body text/plain

string required

Response

no error

Changes

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