Push an image Run in API Explorer

POST /images/{name}/push

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.

Headers

  • X-Registry-Auth string Required

    A base64url-encoded auth configuration.

    Refer to the authentication section for details.

Path parameters

  • name string Required

    Image name or ID.

Query parameters

  • tag string

    The tag to associate with the image on the registry.

Responses

  • 200

    No error

  • 404 application/json

    No such image

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
  • 500 application/json

    Server error

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
POST /images/{name}/push 
curl \
 --request POST 'http://api.example.com/v1.44/images/{name}/push' \
 --header "X-Registry-Auth: string"
Response examples (404) 
{
  "message": "Something went wrong."
}
Response examples (404) 
{
  "message": "Something went wrong."
}
Response examples (500) 
{
  "message": "Something went wrong."
}
Response examples (500) 
{
  "message": "Something went wrong."
}