containerTemplateImage_publish

POST /users/{uid}/mysoftware/{msid}/templates/{tid}/images/{tiid}/pimages

Summary

  • Method: POST
  • Response Code: 201
  • Response Formats: application/xml application/json
  • Since: UForge 3.8.9

Publishes a generated machine image to a target cloud environment.

The response body is a publish image ticket that provides the meta-data of the published machine image. The actual publication is done asynchronously. To poll the status of this publication, use scanPublishedImageStatus_get.

Security Summary

  • Requires Authentication: true
  • Entitlements Required: image_publish

URI Parameters

  • uid (required): the user name (login name) of the user
  • msid (required): the id of the mySoftware
  • tiid (required): the id of the image
  • tid (required): the id of the containerTemplate

HTTP Request Body Parameters

A publishImage object

Example Request

curl "https://uforge.example.com/api/users/{uid}/mysoftware/{msid}/templates/{tid}/images/{tiid}/pimages" -X POST \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml"-H "Content-type: application/xml" --data-binary "@representation.xml"

Example of representation.xml content (the request body):

See also