Push an image

/v1.33

POST

/images/{name}/push

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1.33/images//push' \
--header 'X-Registry-Auth;'

Response Example

200 - Example 1

{}

Request

Path Params

name

string

required

Image name or ID.

Query Params

tag

string

optional

The tag to associate with the image on the registry.

Header Params

X-Registry-Auth

string

required

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

Responses

🟢200No error

application/json

Body

object {0}

🟠404No such image

🔴500Server error

Modified at 2022-09-10 17:56:06

Inspect an image

Tag an image