Files
deb-python-pyvmomi/docs/vim/OvfManager/FileItem.rst
Shawn Hartsock 15f7be9a52 pyVmomi reStructured Text Documentation
This external documentation for pyVmomi was generated using Googly Docs
(aka Google Standard Documentation) which renders very cleanly in
GitHub. Internal documentation for a class should be done in Sphinx
format because tools like pyCharm and Eclipse can use that documentation
as a hint for code completion.

Note: External docs as Googly Docs, internal docs as Sphinx.

Closes bug#15
2014-06-17 14:07:42 -04:00

48 lines
2.3 KiB
ReStructuredText

.. _int: https://docs.python.org/2/library/stdtypes.html
.. _str: https://docs.python.org/2/library/stdtypes.html
.. _long: https://docs.python.org/2/library/stdtypes.html
.. _bool: https://docs.python.org/2/library/stdtypes.html
.. _VirtualApp: ../../vim/VirtualApp.rst
.. _VirtualMachine: ../../vim/VirtualMachine.rst
.. _vSphere API 4.0: ../../vim/version.rst#vimversionversion5
.. _vmodl.DynamicData: ../../vmodl/DynamicData.rst
.. _ResourcePool.importVApp: ../../vim/ResourcePool.rst#importVApp
vim.OvfManager.FileItem
=======================
An FileItem represents a file that must be uploaded by the caller when the inventory objects has been created in VI. These objects are created by `ResourcePool.importVApp`_ .Files can either be new files, in which case the "create" flag will be true, or updates to existing files in VI. The latter is used to support the OVF parentRef mechanism for Disks.
:extends: vmodl.DynamicData_
:since: `vSphere API 4.0`_
Attributes:
deviceId (`str`_):
Uniquely identifies the device (disk, CD-ROM etc.) within the entity hierarchy.When `ResourcePool.importVApp`_ is called to create the `VirtualMachine`_ s and `VirtualApp`_ s, it returns a map, device ID -> URL, of where to upload the backing files.
path (`str`_):
The path of the item to upload, relative to the path of the OVF descriptor.
compressionMethod (`str`_, optional):
The compression method as specified by the OVF specification (for example "gzip" or "bzip2").
chunkSize (`long`_, optional):
The chunksize as specified by the OVF specification. If this attribute is set, the "path" attribute is a prefix to each chunk of the complete file. For example, if chunksize is 2000000000 bytes, the actual files might be: myfile.000000000 (2000000000 bytes) myfile.000000001 (2000000000 bytes) myfile.000000002 (1500000000 bytes)
size (`long`_, optional):
The complete size of the file, if it is specified in the OVF descriptor.
cimType (`int`_):
The CIM type of the device for which this file provides backing.For example, the value 17 means "Disk drive".
create (`bool`_):
True if the item is not expected to exist in the infrastructure and should therefore be created by the caller (for example using HTTP PUT).