<spanid="com-vmware-vcenter-vm-guest-package"></span><h1>com.vmware.vcenter.vm.guest package<aclass="headerlink"href="#module-com.vmware.vcenter.vm.guest"title="Permalink to this headline">¶</a></h1>
<divclass="section"id="submodules">
<h2>Submodules<aclass="headerlink"href="#submodules"title="Permalink to this headline">¶</a></h2>
<spanid="com-vmware-vcenter-vm-guest-filesystem-client-module"></span><h2>com.vmware.vcenter.vm.guest.filesystem_client module<aclass="headerlink"href="#module-com.vmware.vcenter.vm.guest.filesystem_client"title="Permalink to this headline">¶</a></h2>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.filesystem_client.</span></code><codeclass="sig-name descname"><spanclass="pre">Directories</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">config</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Directories"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Directories</span></code> class provides methods to manage directories in the
guest filesystem. This class was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>config</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
<codeclass="sig-name descname"><spanclass="pre">create</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">create_parents</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Directories.create"title="Permalink to this definition">¶</a></dt>
<dd><p>Creates a directory in the guest operating system.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the directory to be created.</p></li>
<li><p><strong>create_parents</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Whether any parent directories should be created. If any failure
occurs, some parent directories could be left behind.
If None parent directories are not created.</p></li>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> does not exist and <codeclass="docutils literal notranslate"><spanclass="pre">create_parents</span></code> is not set. The
value of <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will
contain all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<codeclass="sig-name descname"><spanclass="pre">create_temporary</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">prefix</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">suffix</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">parent_path</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Directories.create_temporary"title="Permalink to this definition">¶</a></dt>
<dd><p>Creates a temporary directory.</p>
<p>Creates a new unique temporary directory for the user to use as needed.
The guest operating system may clean up the directory after a guest
specific amount of time if <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code> is not set, or the user can
remove the directory when no longer needed.</p>
<p>The new directory name will be created in a guest-specific format using
<codeclass="docutils literal notranslate"><spanclass="pre">prefix</span></code>, a guest generated string and <codeclass="docutils literal notranslate"><spanclass="pre">suffix</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code>.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>prefix</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The prefix to be given to the new temporary directory.</p></li>
<li><p><strong>suffix</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The suffix to be given to the new temporary directory.</p></li>
<li><p><strong>parent_path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The complete path to the directory in which to create the new
directory.
Directory If None a guest-specific default will be used.</p></li>
if <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code> is not a directory. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code> is <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">set</span></code> and does not exist. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<codeclass="sig-name descname"><spanclass="pre">delete</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">recursive</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Directories.delete"title="Permalink to this definition">¶</a></dt>
<dd><p>Deletes a directory in the guest operating system.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the directory to be deleted.</p></li>
<li><p><strong>recursive</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – If true, all files and subdirectories are also deleted. If false,
the directory must be empty for the operation to succeed.
If None, any directory content is not deleted.</p></li>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not a directory. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not found. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> has content and <codeclass="docutils literal notranslate"><spanclass="pre">recursive</span></code> is None.</p>
<codeclass="sig-name descname"><spanclass="pre">move</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">new_path</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Directories.move"title="Permalink to this definition">¶</a></dt>
<dd><p>Renames a directory in the guest.</p>
<p>Renames the directory, or copies and deletes the old contents as
required by the underlying filsystem.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the directory to be moved.</p></li>
<li><p><strong>new_path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to where the directory is moved or its new name.
It cannot be a path to an existing directory or an existing file.</p></li>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not a directory. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">new_path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not found. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if the parent directory of <codeclass="docutils literal notranslate"><spanclass="pre">new_path</span></code> does not exist. The value
of <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will
contain all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.filesystem_client.</span></code><codeclass="sig-name descname"><spanclass="pre">ErrorReason</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">string</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">ErrorReason</span></code> class defines the reasons a file or directory operation
failed. This enumeration was added in vSphere API 7.0.2.0.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>This class represents an enumerated type in the interface language
definition. The class contains class attributes which represent the
values in the current version of the enumerated type. Newer versions of
the enumerated type may contain new values. To use new values of the
enumerated type in communication with a server that supports the newer
version of the API, you instantiate this class. See <aclass="reference internal"href="enumeration.html#enumeration-description"><spanclass="std std-ref">enumerated
type description page</span></a>.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>string</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – String value for the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason"title="com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">ErrorReason</span></code></a> instance.</p>
<codeclass="sig-name descname"><spanclass="pre">DIRECTORY_NOT_EMPTY</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">ErrorReason(string='DIRECTORY_NOT_EMPTY')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason.DIRECTORY_NOT_EMPTY"title="Permalink to this definition">¶</a></dt>
<dd><p>Directory not empty. This class attribute was added in vSphere API 7.0.2.0.</p>
<codeclass="sig-name descname"><spanclass="pre">FILE_NOT_FOUND</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">ErrorReason(string='FILE_NOT_FOUND')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason.FILE_NOT_FOUND"title="Permalink to this definition">¶</a></dt>
<dd><p>The file is not found. This class attribute was added in vSphere API
<codeclass="sig-name descname"><spanclass="pre">FILE_TOO_LARGE</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">ErrorReason(string='FILE_TOO_LARGE')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason.FILE_TOO_LARGE"title="Permalink to this definition">¶</a></dt>
<dd><p>The file is too large. This class attribute was added in vSphere API
<codeclass="sig-name descname"><spanclass="pre">NOT_A_DIRECTORY</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">ErrorReason(string='NOT_A_DIRECTORY')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason.NOT_A_DIRECTORY"title="Permalink to this definition">¶</a></dt>
<dd><p>The argument is not a directory. This class attribute was added in vSphere
<codeclass="sig-name descname"><spanclass="pre">NOT_A_FILE</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">ErrorReason(string='NOT_A_FILE')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason.NOT_A_FILE"title="Permalink to this definition">¶</a></dt>
<dd><p>An argument is not a file. This class attribute was added in vSphere API
<codeclass="sig-name descname"><spanclass="pre">NO_DISK_SPACE</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">ErrorReason(string='NO_DISK_SPACE')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason.NO_DISK_SPACE"title="Permalink to this definition">¶</a></dt>
<dd><p>There is insufficent disk space. This class attribute was added in vSphere
<codeclass="sig-name descname"><spanclass="pre">PATH_TOO_LONG</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">ErrorReason(string='PATH_TOO_LONG')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason.PATH_TOO_LONG"title="Permalink to this definition">¶</a></dt>
<dd><p>The file path is too long. This class attribute was added in vSphere API
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.filesystem_client.</span></code><codeclass="sig-name descname"><spanclass="pre">FileErrorDetails</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">reason</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">file_path</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code> class describes additional error information for
file and directory operations. This class was added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>reason</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason"title="com.vmware.vcenter.vm.guest.filesystem_client.ErrorReason"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">ErrorReason</span></code></a>) – The reason for the error. This attribute was added in vSphere API
7.0.2.0.</p></li>
<li><p><strong>file_path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The file path associated with the error. This attribute was added
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.filesystem_client.</span></code><codeclass="sig-name descname"><spanclass="pre">Files</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">config</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files</span></code> class provides methods to manage the files in the guest
filesystem. This class was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>config</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">FileAttributesInfo</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">last_modified</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">last_accessed</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">symlink_target</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">filesystem_family</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">win_attributes</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">posix_attributes</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesInfo"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.FileAttributesInfo</span></code> class describes the attributes of a file
in a guest operating system. This class was added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>last_modified</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">datetime.datetime</span></code>) – The date and time the file was last modified. This attribute was
added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>last_accessed</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">datetime.datetime</span></code>) – The date and time the file was last accessed. This attribute was
added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>symlink_target</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The target for the file if it’s a symbolic link. This is currently
only set for Posix guest operating systems, but may be supported in
the future on Windows guest operating systems that support symbolic
links. This attribute was added in vSphere API 7.0.2.0.
Set if the file is a symbolic link.</p></li>
<li><p><strong>filesystem_family</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.FilesystemFamily</span></code></a>) – The type of guest filesystem. This attribute was added in vSphere
API 7.0.2.0.</p></li>
<li><p><strong>win_attributes</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.WindowsFileAttributesInfo"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.WindowsFileAttributesInfo"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.WindowsFileAttributesInfo</span></code></a>) – Windows-specific file information. This attribute was added in
vSphere API 7.0.2.0.
This attribute is optional and it is only relevant when the value
of <codeclass="docutils literal notranslate"><spanclass="pre">filesystemFamily</span></code> is <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily.WINDOWS"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily.WINDOWS"><codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Files.FilesystemFamily.WINDOWS</span></code></a>.</p></li>
<li><p><strong>posix_attributes</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.PosixFileAttributesInfo"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.PosixFileAttributesInfo"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.PosixFileAttributesInfo</span></code></a>) – Posix-specific file information. This attribute was added in
vSphere API 7.0.2.0.
This attribute is optional and it is only relevant when the value
of <codeclass="docutils literal notranslate"><spanclass="pre">filesystemFamily</span></code> is <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily.POSIX"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily.POSIX"><codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Files.FilesystemFamily.POSIX</span></code></a>.</p></li>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">FileAttributesUpdateSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">last_modified</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">last_accessed</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">windows</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">posix</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesUpdateSpec"title="Permalink to this definition">¶</a></dt>
<p>File attributes used for updating an existing file with
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.update"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.update"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Files.update()</span></code></a>. This class was added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>last_modified</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">datetime.datetime</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The date and time the file was last modified. This attribute was
added in vSphere API 7.0.2.0.
If None the value will not be changed.</p></li>
<li><p><strong>last_accessed</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">datetime.datetime</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The date and time the file was last accessed. This attribute was
added in vSphere API 7.0.2.0.
If None the value will not be changed.</p></li>
<li><p><strong>windows</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.WindowsFileAttributesUpdateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.WindowsFileAttributesUpdateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.WindowsFileAttributesUpdateSpec</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Windows-specific file update information. This attribute was added
in vSphere API 7.0.2.0.
Set if the guest operating system is Windows.</p></li>
<li><p><strong>posix</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.PosixFileAttributesUpdateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.PosixFileAttributesUpdateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.PosixFileAttributesUpdateSpec</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Posix-specific file update information. This attribute was added in
vSphere API 7.0.2.0.
Set if the guest operating system is Posix.</p></li>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">FilesystemFamily</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">string</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.FilesystemFamily</span></code> class defines the types of guest operating
fllesystem. This enumeration was added in vSphere API 7.0.2.0.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>This class represents an enumerated type in the interface language
definition. The class contains class attributes which represent the
values in the current version of the enumerated type. Newer versions of
the enumerated type may contain new values. To use new values of the
enumerated type in communication with a server that supports the newer
version of the API, you instantiate this class. See <aclass="reference internal"href="enumeration.html#enumeration-description"><spanclass="std std-ref">enumerated
type description page</span></a>.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>string</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – String value for the <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FilesystemFamily</span></code> instance.</p>
<codeclass="sig-name descname"><spanclass="pre">POSIX</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">FilesystemFamily(string='POSIX')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily.POSIX"title="Permalink to this definition">¶</a></dt>
<dd><p>Linux, Solaris, etc. This class attribute was added in vSphere API 7.0.2.0.</p>
<codeclass="sig-name descname"><spanclass="pre">WINDOWS</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">FilesystemFamily(string='WINDOWS')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilesystemFamily.WINDOWS"title="Permalink to this definition">¶</a></dt>
<dd><p>The guest OS is a Windows variant. This class attribute was added in
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">FilterSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">match_pattern</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilterSpec"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.FilterSpec</span></code> class contains information used to filter the
results when listing files (see <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.list"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.list"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Files.list()</span></code></a>). This class was added
in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
<ddclass="field-odd"><p><strong>match_pattern</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The perl-compatible regular expression used to filter the returned
files. This attribute was added in vSphere API 7.0.2.0.
If None the pattern <strong>‘.*’</strong> (match everything) is used.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">Info</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">type</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">size</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">attributes</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Info"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.Info</span></code> class describes a file or directory in the guest
operating system. Returned by <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.get"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.get"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Files.get()</span></code></a>. This class was added in
vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>type</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Type"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.Type"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.Type</span></code></a>) – The type of file. This attribute was added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>size</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – The file size in bytes. This attribute was added in vSphere API
7.0.2.0.</p></li>
<li><p><strong>attributes</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesInfo"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesInfo"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.FileAttributesInfo</span></code></a>) – Attributes of a file. This attribute was added in vSphere API
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">IterationSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">size</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">index</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.IterationSpec"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.IterationSpec</span></code> class contains attributes used to break results
into pages when listing files. See <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.list"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.list"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Files.list()</span></code></a>). This class was
added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>size</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Specifies the maximum number of results to return. This attribute
was added in vSphere API 7.0.2.0.
If None information about at most 50 files will be returned.</p></li>
<li><p><strong>index</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Which result to start the list with. If this value exceeds the
number of results, an empty list will be returned. This attribute
was added in vSphere API 7.0.2.0.
If None, the start of the list of files will be returned.</p></li>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">LastIterationStatus</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">string</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.LastIterationStatus"title="Permalink to this definition">¶</a></dt>
<p>The last status for the iterator. A field of this type is returned as part
of the result and indicates to the caller of the API whether it can
continue to make requests for more data. The last status only reports on
the state of the iteration at the time data was last returned. As a result,
it not does guarantee if the next call will succeed in getting more data or
not. Failures to retrieve results will be returned as Error responses.
These last statuses are only returned when the iterator is operating as
expected. This enumeration was added in vSphere API 7.0.2.0.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>This class represents an enumerated type in the interface language
definition. The class contains class attributes which represent the
values in the current version of the enumerated type. Newer versions of
the enumerated type may contain new values. To use new values of the
enumerated type in communication with a server that supports the newer
version of the API, you instantiate this class. See <aclass="reference internal"href="enumeration.html#enumeration-description"><spanclass="std std-ref">enumerated
type description page</span></a>.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>string</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – String value for the <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">LastIterationStatus</span></code> instance.</p>
<codeclass="sig-name descname"><spanclass="pre">END_OF_DATA</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">LastIterationStatus(string='END_OF_DATA')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.LastIterationStatus.END_OF_DATA"title="Permalink to this definition">¶</a></dt>
<dd><p>Iterator has finished iterating through its inventory. There are currently
no more entities to return and the caller can terminate iteration. If the
iterator returned some data, the marker may be set to allow the iterator to
continue from where it left off when additional data does become available.
This value is used to indicate that all available data has been returned by
the iterator. This class attribute was added in vSphere API 7.0.2.0.</p>
<codeclass="sig-name descname"><spanclass="pre">READY</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">LastIterationStatus(string='READY')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.LastIterationStatus.READY"title="Permalink to this definition">¶</a></dt>
<dd><p>Iterator has more data pending and is ready to provide it. The caller can
request the next page of data at any time. The number of results returned
may be less than the requested size. In other words, the iterator may not
fill the page. The iterator has returned at least 1 result. This class
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">ListResult</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">files</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">total</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">start_index</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">end_index</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">status</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.ListResult"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.ListResult</span></code> class describes the results of a
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.list"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.list"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Files.list()</span></code></a> method. This class was added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>files</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">list</span></code> of <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Summary"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.Summary"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.Summary</span></code></a>) – A list of <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Summary"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.Summary"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.Summary</span></code></a> classes containing information for
all the matching files. This attribute was added in vSphere API
7.0.2.0.</p></li>
<li><p><strong>total</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – The total number of results from the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.list"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.list"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Files.list()</span></code></a>. This is a
hint to the user of the iterator regarding how many items are
available to be retrieved. The total could change if the inventory
of items are being changed. This attribute was added in vSphere API
7.0.2.0.</p></li>
<li><p><strong>start_index</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Positional index into the logical item list of the first item
returned in the list of results. The first item in the logical item
list has an index of 0. This is a hint to the user of the iterator
regarding the logical position in the iteration. For example, this
can be used to display to the user which page of the iteration is
being shown. The total could change if the inventory of items are
being changed. This attribute was added in vSphere API 7.0.2.0.
If None no items were returned.</p></li>
<li><p><strong>end_index</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Positional index into the logical item list of the last item
returned in the list of results. The first item in the logical item
list has an index of 0. This is a hint to the user of the iterator
regarding the logical position in the iteration. For example, this
can be used to display to the user which page of the iteration is
being shown. The total could change if the inventory of items are
being changed. This attribute was added in vSphere API 7.0.2.0.
If None no items were returned.</p></li>
<li><p><strong>status</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.LastIterationStatus"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.LastIterationStatus"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.LastIterationStatus</span></code></a>) – The last status for the iterator that indicates whether any more
results can be expected if the caller continues to make requests
for more data using the iterator. This attribute was added in
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">PosixFileAttributesInfo</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">owner</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">group</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">permissions</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.PosixFileAttributesInfo"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.PosixFileAttributesInfo</span></code> class describes information about
file attributes specific to Posix Guest operating systems. This class was
added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>owner</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – The owner ID. This attribute was added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>group</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – The group ID. This attribute was added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>permissions</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The file permissions in chmod(2) format. This attribute is
presented as octal. This attribute was added in vSphere API
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">PosixFileAttributesUpdateSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">owner_id</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">group_id</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">permissions</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.PosixFileAttributesUpdateSpec"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.PosixFileAttributesUpdateSpec</span></code> class describes attributes that
can be changed for a Posix file. This class was added in vSphere API
7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>owner_id</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The owner ID. This attribute was added in vSphere API 7.0.2.0.
If None the value will not be changed.</p></li>
<li><p><strong>group_id</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The group ID. This attribute was added in vSphere API 7.0.2.0.
If None the value will not be changed.</p></li>
<li><p><strong>permissions</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The file permissions in chmod(2) format. This attribute is
interpreted as octal. This attribute was added in vSphere API
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">Summary</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">filename</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">type</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">size</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Summary"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.Summary</span></code> class describes a file or directory in the guest
operating system returned by a <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.list"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.list"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Files.list()</span></code></a> method. This class was
added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>filename</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The name of the file. This attribute was added in vSphere API
7.0.2.0.</p></li>
<li><p><strong>type</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Type"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.Type"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.Type</span></code></a>) – The type of file. This attribute was added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>size</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – The file size in bytes. This attribute was added in vSphere API
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">Type</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">string</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Type"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.Type</span></code> class defines the valid types of files. This enumeration
was added in vSphere API 7.0.2.0.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>This class represents an enumerated type in the interface language
definition. The class contains class attributes which represent the
values in the current version of the enumerated type. Newer versions of
the enumerated type may contain new values. To use new values of the
enumerated type in communication with a server that supports the newer
version of the API, you instantiate this class. See <aclass="reference internal"href="enumeration.html#enumeration-description"><spanclass="std std-ref">enumerated
type description page</span></a>.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>string</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – String value for the <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Type</span></code> instance.</p>
<codeclass="sig-name descname"><spanclass="pre">DIRECTORY</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">Type(string='DIRECTORY')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Type.DIRECTORY"title="Permalink to this definition">¶</a></dt>
<dd><p>directory. This class attribute was added in vSphere API 7.0.2.0.</p>
<codeclass="sig-name descname"><spanclass="pre">FILE</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">Type(string='FILE')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Type.FILE"title="Permalink to this definition">¶</a></dt>
<dd><p>normal file. This class attribute was added in vSphere API 7.0.2.0.</p>
<codeclass="sig-name descname"><spanclass="pre">SYMLINK</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">Type(string='SYMLINK')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Type.SYMLINK"title="Permalink to this definition">¶</a></dt>
<dd><p>symbolic link. This class attribute was added in vSphere API 7.0.2.0.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">WindowsFileAttributesInfo</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">hidden</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">read_only</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">created</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.WindowsFileAttributesInfo"title="Permalink to this definition">¶</a></dt>
<p>The {\@name WindowsFileAttributesInfo) class describes file attributes
specific to Windows Guest operating systems. This class was added in
vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>hidden</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code>) – The file is hidden. This attribute was added in vSphere API
7.0.2.0.</p></li>
<li><p><strong>read_only</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code>) – The file is read-only. This attribute was added in vSphere API
7.0.2.0.</p></li>
<li><p><strong>created</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">datetime.datetime</span></code>) – The date and time the file was created. This attribute was added in
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">WindowsFileAttributesUpdateSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">hidden</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">read_only</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.WindowsFileAttributesUpdateSpec"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Files.WindowsFileAttributesUpdateSpec</span></code> class describes attributes
that can be changed for a Windows file. This class was added in vSphere API
7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>hidden</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The file is hidden. This attribute was added in vSphere API
7.0.2.0.
If {term unset} the value will not be changed.</p></li>
<li><p><strong>read_only</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The file is read-only. This attribute was added in vSphere API
7.0.2.0.
If {term unset} the value will not be changed.</p></li>
<codeclass="sig-name descname"><spanclass="pre">create_temporary</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">prefix</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">suffix</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">parent_path</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.create_temporary"title="Permalink to this definition">¶</a></dt>
<dd><p>Creates a temporary file.</p>
<p>Creates a new unique temporary file for the user to use as needed. The
user is responsible for removing it when it is no longer needed.</p>
<p>The new file name will be created in a guest-specific format using
<codeclass="docutils literal notranslate"><spanclass="pre">prefix</span></code>, a guest generated string and <codeclass="docutils literal notranslate"><spanclass="pre">suffix</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code>.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>prefix</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The prefix to be given to the new temporary file.</p></li>
<li><p><strong>suffix</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The suffix to be given to the new temporary file.</p></li>
<li><p><strong>parent_path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The complete path to the directory in which to create the file.
Directory to use if specified, otherwise a guest-specific default
if <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code> is <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">set</span></code> and is not a directory. The
value of <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will
contain all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">parent_path</span></code> is <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">set</span></code> and does not exist. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<codeclass="sig-name descname"><spanclass="pre">delete</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.delete"title="Permalink to this definition">¶</a></dt>
<dd><p>Deletes a file in the guest operating system</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the file or symbolic link to be deleted.</p></li>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not a file. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not found. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<codeclass="sig-name descname"><spanclass="pre">get</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.get"title="Permalink to this definition">¶</a></dt>
<dd><p>Returns information about a file or directory in the guest.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the file.</p></li>
<ddclass="field-odd"><p><aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.Info"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.Info"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.Info</span></code></a> object containing information for the file.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not found. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<codeclass="sig-name descname"><spanclass="pre">list</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">iteration</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">filter</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.list"title="Permalink to this definition">¶</a></dt>
<dd><p>Returns information about files and directories in the guest.</p>
<p>Files are returned in operating system-specific (inode) order. If the
directory is modified between queries, missing or duplicate results can
occur.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the directory or file to query.</p></li>
<li><p><strong>iteration</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.IterationSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.IterationSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.IterationSpec</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The specification of a page of results to be retrieved.
If None, the first page will be retrieved.</p></li>
<li><p><strong>filter</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilterSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FilterSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.FilterSpec</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Specification to match files for which information should be
returned.
If None, the behavior is the equivalent to a
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FilterSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FilterSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.FilterSpec</span></code></a> with all attributes None which means all
<ddclass="field-odd"><p>A <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.ListResult"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.ListResult"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.ListResult</span></code></a> object containing information for all
the matching files in <codeclass="docutils literal notranslate"><spanclass="pre">filter</span></code> and the total number of files that
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not found. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<codeclass="sig-name descname"><spanclass="pre">move</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">new_path</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">overwrite</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.move"title="Permalink to this definition">¶</a></dt>
<dd><p>Renames a file in the guest.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the original file or symbolic link to be
moved.</p></li>
<li><p><strong>new_path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the new file. It cannot be a path to an
existing directory.</p></li>
<li><p><strong>overwrite</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – If true, the destination file is overwritten.
If None, the destination file is not overwritten.</p></li>
if the <codeclass="docutils literal notranslate"><spanclass="pre">new_path</span></code> already exists and <codeclass="docutils literal notranslate"><spanclass="pre">overwrite</span></code> is false.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not a file. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">new_path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> does not exist. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if the parent directory of <codeclass="docutils literal notranslate"><spanclass="pre">new_path</span></code> does not exist. The value
of <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will
contain all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<codeclass="sig-name descname"><spanclass="pre">update</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">file_attributes</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.update"title="Permalink to this definition">¶</a></dt>
<dd><p>Changes the file attributes of a specified file or directory inside the
guest.</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete path to the file or directory to be changed in the
guest. If the file points to an symbolic link, then the attributes
of the target file are changed.</p></li>
<li><p><strong>file_attributes</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesUpdateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesUpdateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.FileAttributesUpdateSpec</span></code></a>) – Specifies the different file attributes of the guest file to be
changed. See <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesUpdateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Files.FileAttributesUpdateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Files.FileAttributesUpdateSpec</span></code></a>.</p></li>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not a file. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is too long. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="docutils literal notranslate"><spanclass="pre">path</span></code> is not found. The value of
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will contain
all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.filesystem_client.</span></code><codeclass="sig-name descname"><spanclass="pre">StubFactory</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">stub_config</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.StubFactory"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.filesystem_client.</span></code><codeclass="sig-name descname"><spanclass="pre">Transfers</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">config</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Transfers</span></code> class provides methods to copy files into and out of the
guest file system. This class was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>config</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">CreateSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">path</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">attributes</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.CreateSpec"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec</span></code> class describes the details of a file transfer
operation. This class was added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>path</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – The complete destination path in the guest to transfer the file to
or from the client. It cannot be a path to a directory or a
symbolic link. This attribute was added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>attributes</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.FileCreationAttributes"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.FileCreationAttributes"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.FileCreationAttributes</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Details about the file to be transferred into the guest. This
attribute was added in vSphere API 7.0.2.0.
Must be <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">set</span></code> if the file is being transferred to the guest.
Must not be <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">set</span></code> if the file is being transferred from the
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">FileCreationAttributes</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">size</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">overwrite</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">last_modified</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">last_accessed</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">windows</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">posix</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.FileCreationAttributes"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Transfers.FileCreationAttributes</span></code> class describes file attributes
used when transferring a file into the guest. This class was added in
vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>size</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – The size in bytes of the file to be transferred into the guest.
This attribute was added in vSphere API 7.0.2.0.</p></li>
<li><p><strong>overwrite</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Whether an existing file should be overwritten. This attribute was
added in vSphere API 7.0.2.0.
If None any existing file will not be overwritten.</p></li>
<li><p><strong>last_modified</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">datetime.datetime</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The date and time the file was last modified. This attribute was
added in vSphere API 7.0.2.0.
If None the value will be the time when the file is transferred
into the guest.</p></li>
<li><p><strong>last_accessed</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">datetime.datetime</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The date and time the file was last accessed. This attribute was
added in vSphere API 7.0.2.0.
If None the value will be the time when the file is transferred
into the guest.</p></li>
<li><p><strong>windows</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.WindowsFileAttributesCreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.WindowsFileAttributesCreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.WindowsFileAttributesCreateSpec</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Windows-specific file creation information. This attribute was
added in vSphere API 7.0.2.0.
If None, the behavior is equivalent to a
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.WindowsFileAttributesCreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.WindowsFileAttributesCreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.WindowsFileAttributesCreateSpec</span></code></a> with all
attributes None which means the defaults are used. May only be
<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">set</span></code> if the guest operating system is Windows.</p></li>
<li><p><strong>posix</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.PosixFileAttributesCreateSpec</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Posix-specific file creation information. This attribute was added
in vSphere API 7.0.2.0.
If None, the behavior is equivalent to a
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.PosixFileAttributesCreateSpec</span></code></a> with all
attributes None which means the defaults are used. May only be
<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">set</span></code> if the guest operating system is Posix.</p></li>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">PosixFileAttributesCreateSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">owner_id</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">group_id</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">permissions</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Transfers.PosixFileAttributesCreateSpec</span></code> class describes creation
information about file attributes specific to Posix guest operating
systems. This class was added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>owner_id</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The owner ID. If this property is not specified when passing a
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.PosixFileAttributesCreateSpec</span></code></a> object to
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.create"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.create"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Transfers.create()</span></code></a>, the default value will be the owner Id of
the user who invoked the file transfer operation. This attribute
was added in vSphere API 7.0.2.0.
Defaults to uid of user invoking the operation.</p></li>
<li><p><strong>group_id</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The group ID. If this property is not specified when passing a
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.PosixFileAttributesCreateSpec</span></code></a> object to
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.create"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.create"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Transfers.create()</span></code></a>, the default value will be the group Id of
the user who invoked the file transfer operation. This attribute
was added in vSphere API 7.0.2.0.
Defaults to gid of user invoking the operation.</p></li>
<li><p><strong>permissions</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The file permissions in chmod(2) format. If this property is not
specified when passing a
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.PosixFileAttributesCreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.PosixFileAttributesCreateSpec</span></code></a> object to
<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.create"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.create"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Transfers.create()</span></code></a>, the file will be created with 0644
permissions. This attribute is interpreted as octal. This attribute
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">WindowsFileAttributesCreateSpec</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">hidden</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">read_only</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.WindowsFileAttributesCreateSpec"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Transfers.WindowsFileAttributesCreateSpec</span></code> class describes creation
information about file attributes specific to Windows guest operating
systems. This class was added in vSphere API 7.0.2.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>hidden</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The file is hidden. This attribute was added in vSphere API
7.0.2.0.
If None the file will not be hidden.</p></li>
<li><p><strong>read_only</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">bool</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The file is read-only. This attribute was added in vSphere API
<codeclass="sig-name descname"><spanclass="pre">create</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">credentials</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">spec</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.create"title="Permalink to this definition">¶</a></dt>
<dd><p>Initiates an operation to transfer a file to or from the guest.</p>
<p>If the power state of the Virtual Machine is changed when the file
transfer is in progress, or the Virtual Machine is migrated, then the
transfer operation is aborted.</p>
<p>When transferring a file into the guest and overwriting an existing
file, the old file attributes are not preserved.</p>
<p>In order to ensure a secure connection to the host when transferring a
file using HTTPS, the X.509 certificate for the host must be used to
authenticate the remote end of the connection. The certificate of the
host that the virtual machine is running on can be retrieved using the
following fields: XXX insert link to certificate in Host config XXX</p>
<p>. This method was added in vSphere API 7.0.2.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>vm</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – Virtual Machine to perform the operation on.
The parameter must be an identifier for the resource type:
<li><p><strong>spec</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.Transfers.CreateSpec"title="com.vmware.vcenter.vm.guest.filesystem_client.Transfers.CreateSpec"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec</span></code></a>) – A specification of the type of file transfer and any applicable
<ddclass="field-odd"><p>The URL to which the user has to send an HTTP request. The URL will
become invalid once a successful request is sent. If the file is
being transferred from the guest, an HTTP GET should be used. If
the file is being transferred to the guest, HTTP PUT should be
used.
The URL is valid only for 10 minutes from the time it is generated.
The URL becomes invalid whenever the virtual machine is powered
off, suspended, unregistered or migrated to a new host. The host
part of the URL is returned as <strong>*</strong> if the hostname to be used is
the name of the server to which the call was made. For example, if
the call is made to <strong>esx-svr-1.domain1.com</strong>, and the file is
available for download from
<aclass="reference external"href="https://esx-svr-1.domain1.com/guestFile?id=1&token=1234">https://esx-svr-1.domain1.com/guestFile?id=1&token=1234</a>, the URL
returned may be {\@literal
aHR0cHM6Ly8mIzQyOy9ndWVzdEZpbGU/aWQ9MSZ0b2tlbj0xMjM0}. The client
replaces the asterisk with the server name on which it invoked the
if <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec.path</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">spec</span></code> exists and
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Transfers.FileCreationAttributes.overwrite</span></code> is false when
if <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec.path</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">spec</span></code> is not a file. The
value of <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will
contain all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec.path</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">spec</span></code> is too long. The
value of <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will
contain all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec.path</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">spec</span></code> is not found. The
value of <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vapi.std.errors_client.Error.data</span></code> will
contain all the attributes defined in the <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"title="com.vmware.vcenter.vm.guest.filesystem_client.FileErrorDetails"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">FileErrorDetails</span></code></a>
providing additional information about the failure.</p>
if <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec.path</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">spec</span></code> cannot be
if <codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">Transfers.CreateSpec.path</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">spec</span></code> cannot be copied
because the guest authentication will not allow the operation.</p>
<spanid="com-vmware-vcenter-vm-guest-networking-client-module"></span><h2>com.vmware.vcenter.vm.guest.networking_client module<aclass="headerlink"href="#module-com.vmware.vcenter.vm.guest.networking_client"title="Permalink to this headline">¶</a></h2>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.networking_client.</span></code><codeclass="sig-name descname"><spanclass="pre">Interfaces</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">config</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Interfaces</span></code> class provides methods for retrieving guest operating
system network interface information. This class was added in vSphere API
7.0.0.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>config</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">Info</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">dns_values</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">mac_address</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">dns</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">ip</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">wins_servers</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">nic</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.Info"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Interfaces.Info</span></code> class describes a virtual network adapter
configured in the guest operating system. This class was added in vSphere
API 7.0.0.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>dns_values</strong> (<aclass="reference internal"href="com.vmware.vcenter.vm.html#com.vmware.vcenter.vm.guest_client.DnsAssignedValues"title="com.vmware.vcenter.vm.guest_client.DnsAssignedValues"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">com.vmware.vcenter.vm.guest_client.DnsAssignedValues</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Client DNS values. Data assigned by DNS. This attribute was added
in vSphere API 7.0.0.0.
If None no DNS assigned value exists.</p></li>
<li><p><strong>mac_address</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – MAC address of the adapter. This attribute was added in vSphere API
7.0.0.0.
If None then not supported by the Guest OS.</p></li>
<li><p><strong>dns</strong> (<aclass="reference internal"href="com.vmware.vcenter.vm.html#com.vmware.vcenter.vm.guest_client.DnsConfigInfo"title="com.vmware.vcenter.vm.guest_client.DnsConfigInfo"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">com.vmware.vcenter.vm.guest_client.DnsConfigInfo</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – DNS configuration of the adapter. See
<codeclass="xref py py-attr docutils literal notranslate"><spanclass="pre">com.vmware.vcenter.vm.guest_client.Networking.Info.dns</span></code> for
system wide settings. This attribute was added in vSphere API
7.0.0.0.
If None then not assigned by the Guest OS.</p></li>
<li><p><strong>ip</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpConfigInfo"title="com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpConfigInfo"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Interfaces.IpConfigInfo</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – IP configuration settings of the adapter. This attribute was added
in vSphere API 7.0.0.0.
If None then not supported by the Guest OS.</p></li>
<li><p><strong>wins_servers</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">list</span></code> of <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The IP addresses of any WINS name servers for the adapter. This
attribute was added in vSphere API 7.0.0.0.
If None then not supported by the Guest OS.</p></li>
<li><p><strong>nic</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Link to the corresponding virtual device. This attribute was added
in vSphere API 7.0.0.0.
When clients pass a value of this class as a parameter, the
attribute must be an identifier for the resource type:
<codeclass="docutils literal notranslate"><spanclass="pre">com.vmware.vcenter.vm.hardware.Ethernet</span></code>. When methods return a
value of this class as a return value, the attribute will be an
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">IpAddressInfo</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">ip_address</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">prefix_length</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">origin</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">state</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressInfo"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Interfaces.IpAddressInfo</span></code> class describes a specific IP Address.
This class was added in vSphere API 7.0.0.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>ip_address</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – IPv4 address is specified using dotted decimal notation. For
example, “192.0.2.1”. IPv6 addresses are 128-bit addresses
specified using eight fields of up to four hexadecimal digits. A
colon separates each field (:). For example,
2001:DB8:101::230:6eff:fe04:d9ff. The address can also consist of
the symbol ‘::’ to represent multiple 16-bit groups of contiguous
0’s only once in an address as described in RFC 2373. This
attribute was added in vSphere API 7.0.0.0.</p></li>
<li><p><strong>prefix_length</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – Denotes the length of a generic Internet network address prefix.
Prefix length: the valid range of values is 0-32 for IPv4, and
0-128 for IPv6. A value of n corresponds to an IP address mask that
has n contiguous 1-bits from the most significant bit (MSB), with
all other bits set to 0. A value of zero is valid only if the
calling context defines it. This attribute was added in vSphere API
7.0.0.0.</p></li>
<li><p><strong>origin</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin"title="com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Interfaces.IpAddressOrigin</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – How this address was configured. This attribute was added in
vSphere API 7.0.0.0.
If None the data was not available.</p></li>
<li><p><strong>state</strong> (<aclass="reference internal"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus"title="com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Interfaces.IpAddressStatus</span></code></a>) – The state of this ipAddress. This attribute was added in vSphere
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">IpAddressOrigin</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">string</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Interfaces.IpAddressOrigin</span></code> class specifies how an IP address was
obtained for an interface. See RFC 4293 IpAddressOriginTC. This enumeration
was added in vSphere API 7.0.0.0.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>This class represents an enumerated type in the interface language
definition. The class contains class attributes which represent the
values in the current version of the enumerated type. Newer versions of
the enumerated type may contain new values. To use new values of the
enumerated type in communication with a server that supports the newer
version of the API, you instantiate this class. See <aclass="reference internal"href="enumeration.html#enumeration-description"><spanclass="std std-ref">enumerated
type description page</span></a>.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>string</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – String value for the <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">IpAddressOrigin</span></code> instance.</p>
<codeclass="sig-name descname"><spanclass="pre">DHCP</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressOrigin(string='DHCP')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin.DHCP"title="Permalink to this definition">¶</a></dt>
<dd><p>The address is configured through dhcp. This class attribute was added in
<codeclass="sig-name descname"><spanclass="pre">LINKLAYER</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressOrigin(string='LINKLAYER')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin.LINKLAYER"title="Permalink to this definition">¶</a></dt>
<dd><p>The address is obtained through stateless autoconfiguration (autoconf). See
RFC 4862, IPv6 Stateless Address Autoconfiguration. This class attribute
<codeclass="sig-name descname"><spanclass="pre">MANUAL</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressOrigin(string='MANUAL')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin.MANUAL"title="Permalink to this definition">¶</a></dt>
<dd><p>The address is configured manually. This class attribute was added in
<codeclass="sig-name descname"><spanclass="pre">OTHER</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressOrigin(string='OTHER')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin.OTHER"title="Permalink to this definition">¶</a></dt>
<dd><p>Any other type of address configuration other than the below mentioned ones
will fall under this category. For e.g., automatic address configuration
for the link local address falls under this type. This class attribute was
<codeclass="sig-name descname"><spanclass="pre">RANDOM</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressOrigin(string='RANDOM')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressOrigin.RANDOM"title="Permalink to this definition">¶</a></dt>
<dd><p>The address is chosen by the system at random e.g., an IPv4 address within
169.254/16, or an RFC 3041 privacy address. This class attribute was added
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">IpAddressStatus</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">string</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Interfaces.IpAddressStatus</span></code> class defines the present status of an
address on an interface. See RFC 4293 IpAddressStatusTC. This enumeration
was added in vSphere API 7.0.0.0.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>This class represents an enumerated type in the interface language
definition. The class contains class attributes which represent the
values in the current version of the enumerated type. Newer versions of
the enumerated type may contain new values. To use new values of the
enumerated type in communication with a server that supports the newer
version of the API, you instantiate this class. See <aclass="reference internal"href="enumeration.html#enumeration-description"><spanclass="std std-ref">enumerated
type description page</span></a>.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>string</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – String value for the <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">IpAddressStatus</span></code> instance.</p>
<codeclass="sig-name descname"><spanclass="pre">DEPRECATED</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressStatus(string='DEPRECATED')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus.DEPRECATED"title="Permalink to this definition">¶</a></dt>
<dd><p>Indicates that this is a valid but deprecated address that should no longer
be used as a source address. This class attribute was added in vSphere API
<codeclass="sig-name descname"><spanclass="pre">DUPLICATE</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressStatus(string='DUPLICATE')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus.DUPLICATE"title="Permalink to this definition">¶</a></dt>
<dd><p>Indicates the address has been determined to be non-unique on the link,
this address will not be reachable. This class attribute was added in
<codeclass="sig-name descname"><spanclass="pre">INACCESSIBLE</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressStatus(string='INACCESSIBLE')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus.INACCESSIBLE"title="Permalink to this definition">¶</a></dt>
<dd><p>Indicates that the address is not accessible because interface is not
operational. This class attribute was added in vSphere API 7.0.0.0.</p>
<codeclass="sig-name descname"><spanclass="pre">INVALID</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressStatus(string='INVALID')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus.INVALID"title="Permalink to this definition">¶</a></dt>
<dd><p>Indicates that this isn’t a valid address. This class attribute was added
<codeclass="sig-name descname"><spanclass="pre">PREFERRED</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressStatus(string='PREFERRED')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus.PREFERRED"title="Permalink to this definition">¶</a></dt>
<dd><p>Indicates that this is a valid address. This class attribute was added in
<codeclass="sig-name descname"><spanclass="pre">TENTATIVE</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressStatus(string='TENTATIVE')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus.TENTATIVE"title="Permalink to this definition">¶</a></dt>
<dd><p>Indicates that the uniqueness of the address on the link is presently being
verified. This class attribute was added in vSphere API 7.0.0.0.</p>
<codeclass="sig-name descname"><spanclass="pre">UNKNOWN</span></code><emclass="property"><spanclass="pre">=</span><spanclass="pre">IpAddressStatus(string='UNKNOWN')</span></em><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressStatus.UNKNOWN"title="Permalink to this definition">¶</a></dt>
<dd><p>Indicates that the status cannot be determined. This class attribute was
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">IpConfigInfo</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">ip_addresses</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">dhcp</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpConfigInfo"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Interfaces.IpConfigInfo</span></code> class describes the protocol version
independent address reporting data object for network interfaces. This
class was added in vSphere API 7.0.0.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>ip_addresses</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">list</span></code> of <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressInfo"title="com.vmware.vcenter.vm.guest.networking_client.Interfaces.IpAddressInfo"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">Interfaces.IpAddressInfo</span></code></a>) – IP addresses configured on the interface. This attribute was added
in vSphere API 7.0.0.0.</p></li>
<li><p><strong>dhcp</strong> (<aclass="reference internal"href="com.vmware.vcenter.vm.html#com.vmware.vcenter.vm.guest_client.DhcpConfigInfo"title="com.vmware.vcenter.vm.guest_client.DhcpConfigInfo"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">com.vmware.vcenter.vm.guest_client.DhcpConfigInfo</span></code></a> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Client side DHCP for an interface. This attribute was added in
vSphere API 7.0.0.0.
If None the IP was not configured by DHCP.</p></li>
<codeclass="sig-name descname"><spanclass="pre">list</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.list"title="Permalink to this definition">¶</a></dt>
<dd><p>Returns information about the networking interfaces in the guest
operating system. This method was added in vSphere API 7.0.0.0.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.networking_client.</span></code><codeclass="sig-name descname"><spanclass="pre">Routes</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">config</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Routes"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Routes</span></code> class provides methods for retrieving guest operating system
network routing information. This class was added in vSphere API 7.0.0.0.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>config</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-name descname"><spanclass="pre">Info</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">network</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">prefix_length</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">gateway_address</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">interface_index</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Routes.Info"title="Permalink to this definition">¶</a></dt>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">Routes.Info</span></code> class describes an individual host, network or default
destination network reachable through a gateway. This class was added in
vSphere API 7.0.0.0.</p>
<divclass="admonition tip">
<pclass="admonition-title">Tip</p>
<p>The arguments are used to initialize data attributes with the same
names.</p>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>network</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code>) – IP Address of the destination IP network. IPv4 address is specified
using dotted decimal notation. For example, “192.0.2.1”. IPv6
addresses are 128-bit specified using as eight fields of up to four
hexadecimal digits. A colon separates each field (:). For example,
2001:DB8:101::230:6eff:fe04:d9ff. The address can also consist of
symbol ‘::’ to represent multiple 16-bit groups of contiguous 0’s
only once in an address as described in RFC 2373. This attribute
was added in vSphere API 7.0.0.0.</p></li>
<li><p><strong>prefix_length</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code>) – The prefix length. For IPv4 the value range is 0-32. For IPv6
prefixLength is a decimal value range 0-128. The property
represents the number of contiguous, higher-order bits of the
address that make up the network portion of the IP address. This
attribute was added in vSphere API 7.0.0.0.</p></li>
<li><p><strong>gateway_address</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">str</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – Where to send the packets for this route. Unicast IP Address of the
next hop router. IPv4 address is specified using dotted decimal
notation. For example, “192.0.2.1”. IPv6 addresses are 128-bit
specified using as eight fields of up to four hexadecimal digits. A
colon separates each field (:). For example,
2001:DB8:101::230:6eff:fe04:d9ff. The address can also consist of
symbol ‘::’ to represent multiple 16-bit groups of contiguous 0’s
only once in an address as described in RFC 2373. This attribute
was added in vSphere API 7.0.0.0.
If None no gateway is set for the route.</p></li>
<li><p><strong>interface_index</strong> (<codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">long</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">None</span></code>) – The network interface associated with this route. This is an index
into the result of <aclass="reference internal"href="#com.vmware.vcenter.vm.guest.networking_client.Interfaces.list"title="com.vmware.vcenter.vm.guest.networking_client.Interfaces.list"><codeclass="xref py py-func docutils literal notranslate"><spanclass="pre">Interfaces.list()</span></code></a> The index refers to the
relative position of an element in a <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">list</span></code>. For example, an
index of 0 refers to the first element in the <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">list</span></code> while
an index of 1 refers to the second element. This attribute was
added in vSphere API 7.0.0.0.
If None the route is not associated with a network interface.</p></li>
<codeclass="sig-name descname"><spanclass="pre">list</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">vm</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.Routes.list"title="Permalink to this definition">¶</a></dt>
<dd><p>Returns information about network routing in the guest operating
system. This method was added in vSphere API 7.0.0.0.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">com.vmware.vcenter.vm.guest.networking_client.</span></code><codeclass="sig-name descname"><spanclass="pre">StubFactory</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">stub_config</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#com.vmware.vcenter.vm.guest.networking_client.StubFactory"title="Permalink to this definition">¶</a></dt>
