Although a vApp template is intended to be an immutable record of vApp configuration, you can update several template properties, such as name and description, that do not affect the vApp configuration.

You can update the following sections of a vApp template.

Name and description

You can use a PUT request to update the value of the template's name attribute or the contents of its Description element.

Owner

You can use a PUT request to update the value of the template's Owner element. See View or Change the Owner of an Object.

ProductSection elements

You can retrieve or update the template's ProductSection elements, which provide a way to pass runtime information to the virtual machines defined in the template. See Retrieve or Modify ProductSection Elements.

Except for the Owner element, all updates to a vApp template propagate to the vApp during instantiation. The owner of the vApp is set to the identity of the user who instantiates the template.

Verify that you are logged in to the vCloud API endpoint as an End User.

1

Retrieve the vApp template.

GET https://vcloud.example.com/api/vAppTemplate/vappTemplate-111
2

Modify the returned VAppTemplate to change the value of the name attribute, the Description element, or both.

As an alternative, you can simply construct a new VAppTemplateelement that contains only the new name and Description. See Example: Update a vApp Template Name and Description

3

Update the template with your modifications.

Find the Link element in the VAppTemplate where rel="edit". Make a PUT request to the URL in that link's href attribute value, and supply the modified VAppTemplate as the request body.

This example updates the name and description of a vApp template. The request body includes just the subset of the template contents that can be updated. As an alternative, you can supply the entire VAppTemplate, with a modified name and Description, as the request body. The results are the same in either case.

Request:

Put https://vcloud.example.com/api/vAppTemplate/vappTemplate-111
Content-Type: application/vnd.vmware.vcloud.vAppTemplate+xml
...
<VAppTemplate
   xmlns="http://www.vmware.com/vcloud/v1.5"
   name="new name">
   <Description>New Description</Description>
</VAppTemplate>

Response:

202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ... operation="Updating Virtual Application new name (11)" ...>
   ...
</Task>