workspaceTemplate_share¶
-
POST /orgs/{oid}/workspaces/{wid}/templates
Summary
- Method:
POST
- Response Code:
201
- Response Formats:
application/xml
application/json
- Since:
UForge 3.3.2
Requests to add an appliance from a user’s Appliance Library to a workspace.
This allows users to share their private appliance templates with other users via a workspace.
The response body is a gallery template
that provides the meta-data of the new appliance template being shared. The actual process is done asynchronously. To poll the status, use workspaceTemplateStatus_get.
Once complete, the appliance template is available for other users.
To cancel the process use workspaceTemplateShare_cancel
Security Summary¶
- Requires Authentication:
true
- Entitlements Required:
appliance_create
HTTP Request Body Parameters¶
A galleryTemplate object
Example Request¶
curl "https://uforge.example.com/api/orgs/{oid}/workspaces/{wid}/templates" -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):
<ns0:galleryTemplate xmlns:ns0="http://www.usharesoft.com/uforge">
<description>This is a description example when sharing a template.</description>
<name>Appliance Example</name>
<version>1.0</version>
<allowComments>true</allowComments>
<applianceUri>users/root/appliances/6</applianceUri>
<publisher>user</publisher>
</ns0:galleryTemplate>
See also
- appliance
- galleryTemplate
- Workspace API Resources
- workspace
- workspaceTemplateInstallProfile_get
- workspaceTemplateLogo_delete
- workspaceTemplateLogo_download
- workspaceTemplateLogo_upload
- workspaceTemplateOSPkgs_get
- workspaceTemplateProjects_get
- workspaceTemplateShare_cancel
- workspaceTemplateStats_get
- workspaceTemplateStatus_get
- workspaceTemplateStudio_get
- workspaceTemplate_delete
- workspaceTemplate_get
- workspaceTemplate_getAll
- workspaceTemplate_update
- Workspace Template Comments API Resources