Export VApp As OVF Template operation


The Export VApp As OVF Template operation exports the specified vApp as an Open Virtualization Format (OVF) template and also downloads the files associated with the vApp entity.

Warning

Note

The vApp that you want to export as an OVF template must not contain child resource pools.

The following table describes the elements for this request.

Adapter request elements for the Export VApp As OVF Template operation

Element

Definition

Required

<operation-type>

Defines the type of the operation: Configure_VApp

Yes

<operation-name>

Defines the name of the operation: Export_VApp_As_OVF_Template

Yes

<soap-url>

Specifies the URL for the remote SOAP service running on the VMware VirtualCenter

If the <soap-url> element is not specified, the request uses the VirtualCenter Server details specified in the adapter configuration.

Default format for HTTPS: https://<hostName>:<port>/sdk/vim

Default format for HTTP: http://<hostName>:<port>/sdk/vim

Warning

Note

If you want to use an HTTP value, you might need to change the configuration of the VMware Infrastructure application.

No

<transport>

Specifies the transport protocol for the message

If the <transport> element is not provided, the request uses the VirtualCenter Server details specified in the adapter configuration.

Valid values: https-rpc (default), http-rpc

Warning

Note

If the value of the <transport> element is https-rpc, you must install the security certificate for the VMware Virtual Center to the keystore of the peer on which the adapter is enabled.

No

<user-name>

Specifies the user name that is used for HTTP basic authentication on the VMware Virtual Center

If no user name is specified, the request is executed with the user name that is specified in the configuration.

No

<password>

Specifies the password corresponding to <user-name>

Conditional; required if <user-name> is specified

<parameters>

Contains the elements required to execute the operation

Yes

<virtual-app>

Specifies the name of the vApp that you want to export as an OVF template

Valid value: Any string

Yes

<ovf-download-directory>

Specifies the directory on the local TrueSight Orchestration peer where the virtual appliance OVF descriptor and other entity files are exported to
Valid value: Any string

Yes

<cdp>

Contains the list of parameters required for generating the OVF descriptor

Sample format:

<cdp>
  <name></name>
  <description></description>
</cdp>

No

<name>

Specifies the OVF ID to use for the top-level OVF entity. If the OVF ID is not set, the entity's product name is used. If the product name is not available, the VMware Infrastructure entity name is used.

Valid value: String

No

<description>

Specifies the contents of the annotation section of the top-level OVF Entity. If the description is not set, any existing annotation on the entity is left unchanged.

Valid value: Any string

No

The following code sample shows a sample adapter request for the Export VApp As OVF Template operation.

Sample adapter request for the Export VApp As OVF Template operation

<vmware-infrastructure-request>
   <operation-type>Configure_VApp</operation-type>
   <operation-name>Export_VApp_As_OVF_Template</operation-name>
   <parameters>
     <virtual-app>vApptest</virtual-app>
     <ovf-download-directory>/home/test</ovf-download-directory>
     <cdp>
       <name>vApptest_OVF</name>
       <description>OVF Format of vApptest</description>
     </cdp>
   </parameters>
</vmware-infrastructure-request>

The following code sample shows the response for the sample Export VApp As OVF Template operation.

Sample adapter response for the Export VApp As OVF Template operation

<vmware-infrastructure-response>
 <metadata>
   <status>success</status>
 </metadata>
 <ExportVAppResponse>
   <ovf-download-directory>/home/test</ovf-download-directory>
 </ExportVAppResponse>
</vmware-infrastructure-response>

 

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

TrueSight Orchestration Content 20.19.02