spec for vApp


Specifies how to update a vApp configuration.

The following table contains the definition for the child elements of spec.

Child elements - spec

Element

Definition

Required

<product>

Specifies information about the product installed in the virtual machines in the vApp

For information about the child elements of <product>, see product.

No

<property-list>

Specifies the list of properties for the vApp

Even a single property must be contained in the <property-list> element.

For infomation about the child elements of <property-list>, see property-list.

No

<ip-assignment>

Specifies the IP assignment policy

For information about the child elements of <ip-assignment>, see ip-assignment.

No

<eula>

Specifies the end-user license agreements

Valid value: Any string

No

<ovf-section-list>

Specifies the non-interpreted OVF metadata sections

Even a single <ovf-section> element must be contained in the <ovf-section-list> element.

For information about the child elements of <ovf-section-list>, see ovf-section.

No

<ovf-environment transport>

Specifies the list of transports to use for the properties of the vApp

Valid values: iso, com.vmware.guestInfo

No

<install-boot-stop-delay>

Specifies the delay, in seconds, to wait for the virtual machine to power off after the initial boot

For example, a value of 0 indicates wait forever.
AN
Valid value: Any number

Conditional

Used only if <install-boot-required> is set to true

<install-boot-required>

Specify this element on a virtual machine object, if the virtual machine needs an initial boot before the deployment is complete

For a VApp object, this element indicates that one or more virtual machines need an initial reboot
This flag is automatically reset once the reboot process is complete.

Valid value: Boolean

No

<entity-config-list>

Specifies the configuration of sub-entities such as virtual machine or vApp container

The entity list contains the updated configuration for one or more than one sub-entities. Even for a single sub-entity, you must provide the configuration inside the <entity-config-list> element.

For more information about the child elements, see entity-config.

No

<annotation>

Specifies the updated description of the vApp

Valid value: Any string

No

The following figure shows the sample for spec.

XML sample for spec

<spec>
   <product>
       <info>
       <app-url></app-url>
       <class-id></class-id>
       <full-version></full-version>
       <name></name>
       <product-url></product-url>
       <vendor></vendor>
       <version></version>
       <vendor-url></vendor-url>
       </info>
    </product>
    <ovf-environment-transport></ovf-environment-transport>
    <install-boot-required></install-boot-required>
    <install-boot-stop-delay></install-boot-stop-delay>
    <annotation></annotation>
    <property-list>
     <property>
       <operation></operation>
       <info>
         <category></category>
         <default-value></default-value>
         <type></type>
         <id></id>
         <description>/description>
         <key></key>
         <label></label>
       </info>
     </property>
   </property-list>
     <ip-assignment>
       <ip-allocation-policy></ip-allocation-policy>
       <ip-protocol></ip-protocol>
     </ip-assignment>
     <eula></eula>
   <ovf-section-list>
     <ovf-section>
       <operation></operation>
       <info>
         <key></key>
         <contents></contents>
         <namespace></namespace>
         <type></type>
         <at-envelope-level></at-envelope-level>
       </info>
     </ovf-section>
  <ovf-environment-transport></ovf-environment-transport>
  <install-boot-required></install-boot-required>
  <install-boot-stop-delay></install-boot-stop-delay>
  <entity-config>
 <destroy-with-parent></destroy-with-parent>
 <key></key>
 <start-action></start-action>
 <start-delay></start-delay>
 <start-order></start-order>
 <stop-action></stop-action>
 <stop-delay></stop-delay>
 <tag></tag>
 <waiting-for-guest>e</waiting-for-guest>
 </entity-config>
 <annotation></annotation>
</spec>
 </ovf-section>
</ovf-section-list>
<entity-config-list>
  <entity-config>
       <destroy-with-parent></destroy-with-parent>
       <key></key>
       <start-action></start-action>
       <start-delay></start-delay>
       <start-order></start-order>
       <stop-action></stop-action>
       <stop-delay></stop-delay>
       <tag></tag>
  </entity-config>
     <entity-config>
       <destroy-with-parent></destroy-with-parent>
       <key></key>
       <start-action></start-action>
       <start-delay></start-delay>
       <start-order></start-order>
       <stop-action></stop-action>
       <stop-delay></stop-delay>
       <tag></tag>
    </entity-config>
 </entity-config-list>
</spec>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Orchestration Content 20.18.01