Ovf Manager Parse Descriptor

Ovf Manager Parse Descriptor

Parse the OVF descriptor and return as much information about it as possible without knowing the host on which it will be imported.

Typically, this method is called once without a deploymentOption parameter to obtain the values for the default deployment option. Part of the result is the list of possible deployment options. To obtain the values for a particular deployment option, call this method again, specifying that option.

Required privileges: System.View

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/OvfManager/{moId}/ParseDescriptor
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case OvfManager/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
ParseDescriptorRequestType of type(s) application/json
Required
"ParseDescriptorRequestType Object"
string
ovfDescriptor
Required

The OVF descriptor to examine.

pdp
Required

Additional parameters for parseDescriptor, wrapped in an instance of ParseDescriptorParams.

Authentication
This operation uses the following authentication methods.
Responses
200

The information about the descriptor

Returns OvfParseDescriptorResult of type(s) application/json
"OvfParseDescriptorResult Object"
array of string
eula
Optional

The list of all EULAs contained in the OVF

array of object
network
Optional

The list of networks required by the OVF

array of string
ipAllocationScheme
Optional

The kind of IP allocation supported by the guest.

See VAppIPAssignmentInfo.

array of string
ipProtocols
Optional

The IP protocols supported by the guest.

See VAppIPAssignmentInfo.

array of object
property
Optional

Metadata about the properties contained in the OVF

productInfo
Optional

The product info contained in the OVF

string
annotation
Required

The annotation info contained in the OVF

integer As int64 As int64
approximateDownloadSize
Optional

The OVF Manager's best guess as to the total amount of data that must be transferred to download the entity.

This may be inaccurate due to disk compression etc.

integer As int64 As int64
approximateFlatDeploymentSize
Optional

The OVF Manager's best guess as to the total amount of space required to deploy the entity if using flat disks.

integer As int64 As int64
approximateSparseDeploymentSize
Optional

The OVF Manager's best guess as to the total amount of space required to deploy the entity using sparse disks.

string
defaultEntityName
Required

The default name to use for the entity, if a product name is not specified.

This is the ID of the OVF top-level entity, or taken from a ProductSection.

boolean
virtualApp
Required

True if the OVF contains a vApp (containing one or more vApps and/or virtual machines), as opposed to a single virtual machine.

array of object
deploymentOption
Optional

The list of possible deployment options.

string
defaultDeploymentOption
Required

The key of the default deployment option.

Empty only if there are no deployment options.

array of object
entityName
Optional

A list of the child entities contained in this package and their location in the vApp hierarchy.

Each entry is a (key,value) pair, where the key is the display name, and the value is a unique path identifier for the entity in the vApp. The path is constructed by appending the id of each entity of the path down to the entity, separated by slashes. For example, the path for a child of the root entity with id = "vm1", would simply be "vm1". If the vm is the child of a VirtualSystemCollection called "webTier", then the path would be "webTier/vm".

annotatedOst
Optional

The annotated OST for the OVF descriptor, generated by OVF consumers.

See OvfConsumer for details.

array of object
error
Optional

Errors that happened during processing.

Something will be wrong with the result.

For example, during export, devices could be missing (in which case this array will contain one or more instances of Unsupported-/UnknownDevice).

array of object
warning
Optional

Non-fatal warnings from the processing.

The result will be valid, but the user may choose to reject it based on these warnings.


500

TaskInProgress: if a required managed entity is busy.

VmConfigFault: if a configuration issue prevents the operation from succeeding. Typically, a more specific subclass is thrown.

ConcurrentAccess: if a concurrency issue prevents the operation from succeeding.

FileFault: if there is a generic file error

InvalidState: if the operation failed due to the current state of the system.

Returns VimFault of type(s) application/json
This response body class contains all of the following: InlineVimFault0
"VimFault Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/OvfManager/{moId}/ParseDescriptor