mirror of
https://github.com/vmware/vsphere-automation-sdk-python.git
synced 2024-11-22 01:39:58 -05:00
2438 lines
197 KiB
HTML
2438 lines
197 KiB
HTML
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
<title>std Package — vSphere Automation SDK for Python 6.5.0 documentation</title>
|
|
|
|
<link rel="stylesheet" href="_static/vapitheme.css" type="text/css" />
|
|
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT: '',
|
|
VERSION: '6.5.0',
|
|
COLLAPSE_INDEX: false,
|
|
FILE_SUFFIX: '.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</script>
|
|
<script type="text/javascript" src="_static/jquery.js"></script>
|
|
<script type="text/javascript" src="_static/underscore.js"></script>
|
|
<script type="text/javascript" src="_static/doctools.js"></script>
|
|
<link rel="top" title="vSphere Automation SDK for Python 6.5.0 documentation" href="index.html" />
|
|
<link rel="up" title="vapi Package" href="com.vmware.vapi.html" />
|
|
<link rel="next" title="vcenter Package" href="com.vmware.vcenter.html" />
|
|
<link rel="prev" title="routing Package" href="com.vmware.vapi.metadata.routing.html" />
|
|
</head>
|
|
<body>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="genindex.html" title="General Index"
|
|
accesskey="I">index</a></li>
|
|
<li class="right" >
|
|
<a href="py-modindex.html" title="Python Module Index"
|
|
>modules</a> |</li>
|
|
<li class="right" >
|
|
<a href="com.vmware.vcenter.html" title="vcenter Package"
|
|
accesskey="N">next</a> |</li>
|
|
<li class="right" >
|
|
<a href="com.vmware.vapi.metadata.routing.html" title="routing Package"
|
|
accesskey="P">previous</a> |</li>
|
|
<li><a href="index.html">vSphere Automation SDK for Python 6.5.0 documentation</a> »</li>
|
|
<li><a href="com.html" >com Package</a> »</li>
|
|
<li><a href="com.vmware.html" >vmware Package</a> »</li>
|
|
<li><a href="com.vmware.vapi.html" accesskey="U">vapi Package</a> »</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body">
|
|
|
|
<div class="section" id="std-package">
|
|
<h1>std Package<a class="headerlink" href="#std-package" title="Permalink to this headline">¶</a></h1>
|
|
<div class="section" id="id1">
|
|
<h2><tt class="xref py py-mod docutils literal"><span class="pre">std</span></tt> Package<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
|
|
<span class="target" id="module-com.vmware.vapi.std"></span></div>
|
|
<div class="section" id="module-com.vmware.vapi.std.activation_client">
|
|
<span id="activation-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">activation_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.std.activation_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.std.activation_client</span></tt> module provides classes that
|
|
TODO.</p>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.activation_client.ActivationManager">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.activation_client.</tt><tt class="descname">ActivationManager</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/activation_client.html#ActivationManager"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.activation_client.ActivationManager" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.VapiInterface" title="vmware.vapi.bindings.stub.VapiInterface"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.VapiInterface</span></tt></a></p>
|
|
<p><strong>WARNING:</strong> Use only as a sample. The API is experimental and subject to
|
|
change in future versions.</p>
|
|
<blockquote>
|
|
<div><p>Activation tracking/management service.</p>
|
|
<p>An activation describes a method invocation in the runtime.</p>
|
|
</div></blockquote>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>config</strong> (<a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.StubConfiguration" title="vmware.vapi.bindings.stub.StubConfiguration"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></tt></a>) – Configuration to be used for creating the stub.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.std.activation_client.ActivationManager.cancel">
|
|
<tt class="descname">cancel</tt><big>(</big><em>activation_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/activation_client.html#ActivationManager.cancel"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.activation_client.ActivationManager.cancel" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Asks for cancellation of a running activation. Whether or not the
|
|
cancellation request will have any effect depends on the implementation
|
|
of the method that has to be canceled.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>activation_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – activation identifier</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></tt></a>
|
|
there is no activation with the specified id</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-com.vmware.vapi.std.errors_client">
|
|
<span id="errors-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">errors_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.std.errors_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.std.errors_client</span></tt> module provides the standard
|
|
exceptions that can be included in the list of exceptions in the specification
|
|
of methods to indicate that the method might report those exceptions. It also
|
|
provides some classes intended to be used as payload to provide additional
|
|
information about those exceptions.</p>
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.AlreadyExists">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">AlreadyExists</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#AlreadyExists"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.AlreadyExists" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">AlreadyExists</span></tt> exception indicates that an attempt was made to
|
|
create an entity but the entity already exists. Typically the entity has a
|
|
name or identifier that is required to be unique in some context, but there
|
|
is already an entity with that name or identifier in that context.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to create a new tag category when a tag category with the
|
|
specified name already exists.</li>
|
|
<li>Trying to create a new tag in tag category when a tag with the specified
|
|
name already exists the tag category.</li>
|
|
<li>Trying to create a LUN with a specific UUID on a node (for replication
|
|
purposes) when a LUN with that UUID already exists on the node.</li>
|
|
<li>Trying to create a file in a directory or move or copy a file to a
|
|
directory when a file with that name already exists in the directory.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.AlreadyInDesiredState">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">AlreadyInDesiredState</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#AlreadyInDesiredState"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.AlreadyInDesiredState" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">AlreadyInDesiredState</span></tt> exception indicates that an attempt to change
|
|
the state of a resource or service had no effect because the resource or
|
|
service is already in the desired state.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to power on a virtual machine that is already powered on.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.errors_client.ArgumentLocations">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">ArgumentLocations</tt><big>(</big><em>primary=None</em>, <em>secondary=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#ArgumentLocations"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">ArgumentLocations</span></tt> class describes which part(s) of the input to the
|
|
method caused the exception.</p>
|
|
<p>Some types of exceptions are caused by the value of one of the inputs to
|
|
the method, possibly due to an interaction with other inputs to the method.
|
|
This class is intended to be used as the payload to identify those inputs
|
|
when the method reports exceptions like <a class="reference internal" href="#com.vmware.vapi.std.errors_client.InvalidArgument" title="com.vmware.vapi.std.errors_client.InvalidArgument"><tt class="xref py py-class docutils literal"><span class="pre">InvalidArgument</span></tt></a> or
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">NotFound</span></tt></a>. See <tt class="xref py py-attr docutils literal"><span class="pre">Error.data</span></tt>.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>primary</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – String describing the location of the input that triggered the
|
|
exception.</li>
|
|
<li><strong>secondary</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> (possibly empty) of strings describing the locations
|
|
of other inputs that caused the the primary input to trigger the
|
|
exception.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.Canceled">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">Canceled</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#Canceled"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.Canceled" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">Canceled</span></tt> exception indicates that the method canceled itself in
|
|
response to an explicit request to do so. Methods being “canceled” for
|
|
other reasons (for example the client connection was closed, a time out
|
|
occured, or due to excessive resource consumption) should not report this
|
|
exception.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A user is monitoring the progress of the method in a GUI and sees that it
|
|
is likely to take longer than he is willing to wait and clicks the cancel
|
|
button.</li>
|
|
<li>A user invokes the method using a command-line tool and decides that she
|
|
didn’t really want to invoke that method, and presses CTRL-c.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The client’s connection to the server was closed. Reporting an exception
|
|
is pointless since the client will not receive the error response because
|
|
the connection has been closed.</li>
|
|
<li>The request is taking longer than some amount of time. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TimedOut" title="com.vmware.vapi.std.errors_client.TimedOut"><tt class="xref py py-class docutils literal"><span class="pre">TimedOut</span></tt></a> exception would be reported if the time was specified as
|
|
part of the input or is documented in the API contract.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.ConcurrentChange">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">ConcurrentChange</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#ConcurrentChange"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.ConcurrentChange" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">ConcurrentChange</span></tt> exception indicates that a data structure, entity,
|
|
or resource has been modified since some earlier point in time. Typically
|
|
this happens when the client is doing the <em>write</em> portion of a
|
|
read-modify-write sequence and indicates that it wants the server to notify
|
|
it if the data in the server has changed after it did the <em>read</em>, so that
|
|
it can avoid overwriting that change inadvertantly.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.Error">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">Error</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#Error"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.Error" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.error.VapiError" title="vmware.vapi.bindings.error.VapiError"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.error.VapiError</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">Error</span></tt> exception describes theattributes common to all standard
|
|
exceptions.</p>
|
|
<blockquote>
|
|
<div>This exception serves two purposes:</div></blockquote>
|
|
<ol class="arabic simple">
|
|
<li>It is the exception that clients in many programming languages can catch
|
|
to handle all standard exceptions. Typically those clients will display one
|
|
or more of the localizable messages from <tt class="xref py py-attr docutils literal"><span class="pre">Error.messages</span></tt> to a human.</li>
|
|
<li>It is the exception that methods can report when they need to report
|
|
some exception, but the exception doesn’t fit into any other standard
|
|
exception, and in fact the only reasonable way for a client to react to the
|
|
exception is to display the message(s) to a human.</li>
|
|
</ol>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.FeatureInUse">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">FeatureInUse</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#FeatureInUse"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.FeatureInUse" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">FeatureInUse</span></tt> exception indicates that an action cannot be completed
|
|
because a feature is in use.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to disable snapshots on a virtual machine which has a snapshot.</li>
|
|
<li>Trying to downgrade a license that has licensed features that are in use.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.errors_client.FileLocations">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">FileLocations</tt><big>(</big><em>primary=None</em>, <em>secondary=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#FileLocations"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.FileLocations" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">FileLocations</span></tt> class identifies the file(s) that caused the method
|
|
to report the exception.</p>
|
|
<p>Some types of exceptions are caused by a problem with one or more files.
|
|
This class is intended to be used as the payload to identify those files
|
|
when the method reports exceptions like <a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">NotFound</span></tt></a>. See
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">Error.data</span></tt>.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>primary</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – String identifying the file that triggered the exception.</li>
|
|
<li><strong>secondary</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> (possibly empty) of strings identifying other files
|
|
that caused the primary file to trigger the exception.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.InternalServerError">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">InternalServerError</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#InternalServerError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.InternalServerError" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">InternalServerError</span></tt> exception indicates that the server encounters
|
|
an unexpected condition that prevented it from fulfilling the request.</p>
|
|
<p>This exception is reported by the API infrastructure, so it could occur in
|
|
response to the invocation of any method.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The method returns a value whose type doesn’t match the type type the
|
|
method says it should return.</li>
|
|
<li>The method reports an exception that is not included in the list of
|
|
exceptions the method says that it can report.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.InvalidArgument">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">InvalidArgument</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#InvalidArgument"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.InvalidArgument" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">InvalidArgument</span></tt> exception indicates that the values received for
|
|
one or more parameters are not acceptable.</p>
|
|
<p>This exception is reported by the API infrastructure, so it could occur in
|
|
response to the invocation of any method. It may also be reported as the
|
|
result of method-specific validation.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A parameter has a value that is not of the expected type.</li>
|
|
<li>A parameter has a value that is not in the required range.</li>
|
|
<li>A parameter has a value that is not one of the specifically allowed
|
|
strings.</li>
|
|
<li>One attribute of a class is the tag for a tagged union, and has a
|
|
specific value but another attribute of the class that is required to be
|
|
specified when the tag has that value is not specified, or another
|
|
attribute of the class that is required to be unspecified when the tag has
|
|
that value is specified.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to create a new tag in tag category when a tag with the specified
|
|
name already exists the tag category. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.AlreadyExists" title="com.vmware.vapi.std.errors_client.AlreadyExists"><tt class="xref py py-class docutils literal"><span class="pre">AlreadyExists</span></tt></a> exception
|
|
would be used instead.</li>
|
|
<li>Invoke the method to retrieve information about a virtual machine,
|
|
passing an id that does not identify an existing virtual machine. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">NotFound</span></tt></a> exception would be used instead.</li>
|
|
<li>Attempt to put a virtual machine into a folder that can only contain
|
|
hosts. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><tt class="xref py py-class docutils literal"><span class="pre">InvalidElementType</span></tt></a> exception would be used instead.</li>
|
|
<li>Attempt to attach a SCSI virtual disk to an IDE port. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><tt class="xref py py-class docutils literal"><span class="pre">InvalidElementType</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.InvalidElementConfiguration">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">InvalidElementConfiguration</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#InvalidElementConfiguration"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.InvalidElementConfiguration" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">InvalidElementConfiguration</span></tt> exception indicates that an attempt to
|
|
modify the configuration of an element or a group containing the element
|
|
failed due to the configuraton of the element. A typical case is when the
|
|
method is am attempt to change the group membership of the element fails,
|
|
in which case a configuration change on the element may allow the group
|
|
membership change to succeed.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Attempt to move a host with a fault tolerant virtual machine out of a
|
|
cluster (i.e. make the host a standalone host).</li>
|
|
<li>Attempt to remove a host from a DRS cluster without putting the host into
|
|
maintenance mode.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.InvalidElementType">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">InvalidElementType</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#InvalidElementType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.InvalidElementType" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">InvalidElementType</span></tt> exception indicates that the server was unable
|
|
to fulfil the request because an element of a specific type cannot be a
|
|
member of particular group.</p>
|
|
<p>This exception could be reported, for example, if an attempt is made to put
|
|
an element into the wrong type of container.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Attempt to put a virtual machine into a folder that can only contain
|
|
hosts.</li>
|
|
<li>Attempt to attach a SCSI virtual disk to an IDE port.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A parameter has a value that is not of the expected type. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.InvalidArgument" title="com.vmware.vapi.std.errors_client.InvalidArgument"><tt class="xref py py-class docutils literal"><span class="pre">InvalidArgument</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.InvalidRequest">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">InvalidRequest</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#InvalidRequest"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.InvalidRequest" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">InvalidRequest</span></tt> exception indicates that the request is malformed in
|
|
such a way that the server is unable to process it.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The XML in a SOAP request is not well-formed so the server cannot parse
|
|
the request.</li>
|
|
<li>The XML in a SOAP request is well-formed but does not match the structure
|
|
required by the SOAP specification.</li>
|
|
<li>A JSON-RPC request is not valid JSON.</li>
|
|
<li>The JSON sent in a JSON-RPC request is not a valid JSON-RPC Request
|
|
object.</li>
|
|
<li>The Request object from a JSON-RPC request does not match the structure
|
|
required by the API infrastructure.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The parameter has a value that is not with the required range. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.InvalidArgument" title="com.vmware.vapi.std.errors_client.InvalidArgument"><tt class="xref py py-class docutils literal"><span class="pre">InvalidArgument</span></tt></a> exception would be used instead.</li>
|
|
<li>The name of the method specified in the request doesn’t not match any
|
|
known method. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">NotFound</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<p>Some transport protocols (for example JSON-RPC) include their own mechanism
|
|
for reporting these kinds of errors, and the API infrastructure for a
|
|
programming language may expose the errors using a language specific
|
|
mechanism, so this exception might not be used.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">NotAllowedInCurrentState</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#NotAllowedInCurrentState"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">NotAllowedInCurrentState</span></tt> exception indicates that the requested
|
|
method is not allowed with a resource or service in its current state. This
|
|
could be because the method is performing a configuration change that is
|
|
not allowed in the current state or because method itself is not allowed in
|
|
the current state.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to add a virtual device that cannot be hot plugged to a running
|
|
virtual machine.</li>
|
|
<li>Trying to upgrade the virtual hardware version for a suspended virtual
|
|
machine.</li>
|
|
<li>Trying to power off, reset, or suspend a virtual machine that is not
|
|
powered on.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to power off a virtual machine that is in the process of being
|
|
powered on. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ResourceBusy" title="com.vmware.vapi.std.errors_client.ResourceBusy"><tt class="xref py py-class docutils literal"><span class="pre">ResourceBusy</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.NotFound">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">NotFound</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#NotFound"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.NotFound" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">NotFound</span></tt> exception indicates that a specified element could not be
|
|
found.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Invoke the method to retrieve information about a virtual machine,
|
|
passing an id that does not identify an existing virtual machine.</li>
|
|
<li>Invoke the method to modify the configuration of a virtual nic, passing
|
|
an id that does not identify an existing virtual nic in the specified
|
|
virtual machine.</li>
|
|
<li>Invoke the method to remove a vswitch, passing an id that does not
|
|
identify an existing vswitch.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.OperationNotFound">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">OperationNotFound</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#OperationNotFound"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.OperationNotFound" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">OperationNotFound</span></tt> exception indicates that the method specified in
|
|
the request could not be found.</p>
|
|
<p>Every API request specifies a service identifier and an operation
|
|
identifier along with the parameters. If the API infrastructure is unable
|
|
to find the requested class or method it reports this exception.</p>
|
|
<p>This exception can be reported by the API infrastructure for any method,
|
|
but it is specific to the API infrastructure, and should never be reported
|
|
by the implementation of any method.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A client provides an invalid service or operation identifier when
|
|
invoking the method using a dynamic interface (for example REST).</li>
|
|
<li>A client invokes the method from a class, but that class has not been
|
|
installed.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A client invokes a task scheduling method, but provides an invalid
|
|
service identifier or operation identifier. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">NotFound</span></tt></a> exception
|
|
would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.ResourceBusy">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">ResourceBusy</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#ResourceBusy"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.ResourceBusy" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">ResourceBusy</span></tt> exception indicates that the method could not be
|
|
completed because a resource it needs is busy.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to power off a virtual machine that is in the process of being
|
|
powered on.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to remove a VMFS datastore when there is a virtual machine
|
|
registered on any host attached to the datastore. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ResourceInUse" title="com.vmware.vapi.std.errors_client.ResourceInUse"><tt class="xref py py-class docutils literal"><span class="pre">ResourceInUse</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.ResourceInUse">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">ResourceInUse</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#ResourceInUse"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.ResourceInUse" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">ResourceInUse</span></tt> exception indicates that the method could not be
|
|
completed because a resource is in use.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to remove a VMFS datastore when the is a virtual machine
|
|
registered on any host attached to the datastore.</li>
|
|
<li>Trying to add a virtual switch if the physical network adapter being
|
|
bridged is already in use.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to power off a virtual machine that is in the process of being
|
|
powered on. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ResourceBusy" title="com.vmware.vapi.std.errors_client.ResourceBusy"><tt class="xref py py-class docutils literal"><span class="pre">ResourceBusy</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.ResourceInaccessible">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">ResourceInaccessible</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#ResourceInaccessible"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.ResourceInaccessible" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">ResourceInaccessible</span></tt> exception indicates that the method could not
|
|
be completed because an entity is not accessible.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Attempt to invoke some method on a virtual machine when the virtual
|
|
machine’s configuration file is not accessible (for example due to a
|
|
storage APD condition).</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Attempt to invoke some method when the server is too busy. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ServiceUnavailable" title="com.vmware.vapi.std.errors_client.ServiceUnavailable"><tt class="xref py py-class docutils literal"><span class="pre">ServiceUnavailable</span></tt></a> exception would be used instead.</li>
|
|
<li>Attempt to invoke some method when the server is undergoing maintenance.
|
|
The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ServiceUnavailable" title="com.vmware.vapi.std.errors_client.ServiceUnavailable"><tt class="xref py py-class docutils literal"><span class="pre">ServiceUnavailable</span></tt></a> exception would be used instead.</li>
|
|
<li>Some method fails to contact VMware Tools running inside the virtual
|
|
machine. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ServiceUnavailable" title="com.vmware.vapi.std.errors_client.ServiceUnavailable"><tt class="xref py py-class docutils literal"><span class="pre">ServiceUnavailable</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.ServiceUnavailable">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">ServiceUnavailable</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#ServiceUnavailable"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.ServiceUnavailable" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">ServiceUnavailable</span></tt> exception indicates that the class is
|
|
unavailable.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Attempt to invoke a method when the server is too busy.</li>
|
|
<li>Attempt to invoke a method when the server is undergoing maintenance.</li>
|
|
<li>An method fails to contact VMware Tools running inside the virtual
|
|
machine.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A client provides an invalid service or operation identifier when
|
|
invoking the method using a dynamic interface (for example REST). The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.OperationNotFound" title="com.vmware.vapi.std.errors_client.OperationNotFound"><tt class="xref py py-class docutils literal"><span class="pre">OperationNotFound</span></tt></a> exception would be used instead.</li>
|
|
<li>A client invokes the method from the class, but that class has not been
|
|
installed. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.OperationNotFound" title="com.vmware.vapi.std.errors_client.OperationNotFound"><tt class="xref py py-class docutils literal"><span class="pre">OperationNotFound</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.TimedOut">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">TimedOut</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#TimedOut"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.TimedOut" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">TimedOut</span></tt> exception indicates that the method did not complete
|
|
within the allowed amount of time. The allowed amount of time might be:</p>
|
|
<ul class="simple">
|
|
<li>provided by the client as an input parameter.</li>
|
|
<li>a fixed limit of the class implementation that is a documented part of
|
|
the contract of the class.</li>
|
|
<li>a configurable limit used by the implementation of the class.</li>
|
|
<li>a dynamic limit computed by the implementation of the class.</li>
|
|
</ul>
|
|
<p>The method may or may not complete after the <tt class="docutils literal"><span class="pre">TimedOut</span></tt> exception was
|
|
reported.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The method was unable to complete within the timeout duration specified
|
|
by a parameter of the method.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A server implementation that puts requests into a queue before
|
|
dispatching them might delete a request from the queue if it doesn’t get
|
|
dispatched within <em>n</em> minutes. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ServiceUnavailable" title="com.vmware.vapi.std.errors_client.ServiceUnavailable"><tt class="xref py py-class docutils literal"><span class="pre">ServiceUnavailable</span></tt></a> exception
|
|
would be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.errors_client.TransientIndication">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">TransientIndication</tt><big>(</big><em>is_transient=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#TransientIndication"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">TransientIndication</span></tt> class indicates whether or not the exception is
|
|
transient.</p>
|
|
<p>Some types of exceptions are transient in certain situtations and not
|
|
transient in other situtations. This exception payload can be used to
|
|
indicate to clients whether a particular exception is transient. See
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">Error.data</span></tt>.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>is_transient</strong> (<tt class="xref py py-class docutils literal"><span class="pre">bool</span></tt>) – Indicates that the exception this class is attached to is
|
|
transient.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.UnableToAllocateResource">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">UnableToAllocateResource</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#UnableToAllocateResource"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.UnableToAllocateResource" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">UnableToAllocateResource</span></tt> exception indicates that the method failed
|
|
because it was unable to allocate or acquire a required resource.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to power on a virtual machine when there are not enough licenses
|
|
to do so.</li>
|
|
<li>Trying to power on a virtual machine that would violate a resource usage
|
|
policy.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to power off a virtual machine that is in the process of being
|
|
powered on. A <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ResourceBusy" title="com.vmware.vapi.std.errors_client.ResourceBusy"><tt class="xref py py-class docutils literal"><span class="pre">ResourceBusy</span></tt></a> exception would be used instead.</li>
|
|
<li>Trying to remove a VMFS datastore when the is a virtual machine
|
|
registered on any host attached to the datastore. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ResourceInUse" title="com.vmware.vapi.std.errors_client.ResourceInUse"><tt class="xref py py-class docutils literal"><span class="pre">ResourceInUse</span></tt></a> exception would be used instead.</li>
|
|
<li>Trying to add a virtual switch if the physical network adapter being
|
|
bridged is already in use. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ResourceInUse" title="com.vmware.vapi.std.errors_client.ResourceInUse"><tt class="xref py py-class docutils literal"><span class="pre">ResourceInUse</span></tt></a> exception would be
|
|
used instead.</li>
|
|
<li>Attempt to invoke some method on a virtual machine when the virtual
|
|
machine’s configuration file is not accessible (for example due to a
|
|
storage APD condition). The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.ResourceInaccessible" title="com.vmware.vapi.std.errors_client.ResourceInaccessible"><tt class="xref py py-class docutils literal"><span class="pre">ResourceInaccessible</span></tt></a> exception would
|
|
be used instead.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.Unauthenticated">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">Unauthenticated</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#Unauthenticated"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.Unauthenticated" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">Unauthenticated</span></tt> exception indicates that the method requires
|
|
authentication and the user is not authenticated.</p>
|
|
<p>API requests may include a security context containing user credentials.
|
|
For example, the user credentials could be a SAML token, a user name and
|
|
password, or the session identifier for a previously established session.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The SAML token in the request’s security context has expired.</li>
|
|
<li>The user name and password in the request’s security context are invalid.</li>
|
|
<li>The session identifier in the request’s security context identifies a
|
|
session that has expired.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The user is authenticated but isn’t authorized to perform the requested
|
|
method. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><tt class="xref py py-class docutils literal"><span class="pre">Unauthorized</span></tt></a> exception would be used instead.</li>
|
|
</ul>
|
|
<p>For security reasons, the <tt class="xref py py-attr docutils literal"><span class="pre">Error.data</span></tt> attribute in this exception is
|
|
None, and the <tt class="xref py py-attr docutils literal"><span class="pre">Error.messages</span></tt> attribute in this exception does not
|
|
disclose which part of the security context is correct or incorrect. For
|
|
example the messages would not disclose whether a username or a password is
|
|
valid or invalid, but only that a combination of username and password is
|
|
invalid.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.Unauthorized">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">Unauthorized</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#Unauthorized"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.Unauthorized" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">Unauthorized</span></tt> exception indicates that the user is not authorized to
|
|
perform the method.</p>
|
|
<p>API requests may include a security context containing user credentials.
|
|
For example, the user credentials could be a SAML token, a user name and
|
|
password, or the session identifier for a previously established session.
|
|
Invoking the method may require that the user identified by those
|
|
credentials has particular privileges on the method or on one or more
|
|
resource identifiers passed to the method.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The method requires that the user have one or more privileges on the
|
|
method, but the user identified by the credentials in the security context
|
|
does not have the required privileges.</li>
|
|
<li>The method requires that the user have one or more privileges on a
|
|
resource identifier passed to the method, but the user identified by the
|
|
credentials in the security context does not have the required privileges.</li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>Counterexamples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>The SAML token in the request’s security context has expired. A
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><tt class="xref py py-class docutils literal"><span class="pre">Unauthenticated</span></tt></a> exception would be used instead.</li>
|
|
<li>The user name and password in the request’s security context are invalid.
|
|
The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><tt class="xref py py-class docutils literal"><span class="pre">Unauthenticated</span></tt></a> exception would be used instead.</li>
|
|
<li>The session identifier in the request’s security context identifies a
|
|
session that has expired. The <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><tt class="xref py py-class docutils literal"><span class="pre">Unauthenticated</span></tt></a> exception would be
|
|
used instead.</li>
|
|
</ul>
|
|
<p>For security reasons, the <tt class="xref py py-attr docutils literal"><span class="pre">Error.data</span></tt> attribute in this exception is
|
|
None, and the <tt class="xref py py-attr docutils literal"><span class="pre">Error.messages</span></tt> attribute in this exception does not
|
|
disclose why the user is not authorized to perform the method. For example
|
|
the messages would not disclose which privilege the user did not have or
|
|
which resource identifier the user did not have the required privilege to
|
|
access. The API documentation should indicate what privileges are required.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.UnexpectedInput">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">UnexpectedInput</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#UnexpectedInput"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.UnexpectedInput" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">UnexpectedInput</span></tt> exception indicates that the request contained a
|
|
parameter or attribute whose name is not known by the server.</p>
|
|
<p>Every method expects parameters with known names. Some of those parameters
|
|
may be (or contain) classes, and the method expects those classes to
|
|
contain attributes with known names. If the method receives parameters or
|
|
attributes with names that is does not expect, this exception may be
|
|
reported.</p>
|
|
<p>This exception can be reported by the API infrastructure for any method,
|
|
but it is specific to the API infrastructure, and should never be reported
|
|
by the implementation of any method.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>A client using stubs generated from the interface specification for
|
|
version2 of a class invokes the method passing one or more parameters that
|
|
were added in version2, but they are communicating with a server that only
|
|
supports version1 of the class.</li>
|
|
<li>A client provides an unexpected parameter or attribute name when invoking
|
|
the method using a dynamic interface (for example REST).</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="exception">
|
|
<dt id="com.vmware.vapi.std.errors_client.Unsupported">
|
|
<em class="property">exception </em><tt class="descclassname">com.vmware.vapi.std.errors_client.</tt><tt class="descname">Unsupported</tt><big>(</big><em>messages=None</em>, <em>data=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/errors_client.html#Unsupported"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.errors_client.Unsupported" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></tt></a></p>
|
|
<p>The <tt class="docutils literal"><span class="pre">Unsupported</span></tt> exception indicates that the method is not supported by
|
|
the class.</p>
|
|
<blockquote>
|
|
<div>Examples:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Trying to hot-plug a CPU when the current configuration of the VM does
|
|
not support hot-plugging of CPUs.</li>
|
|
<li>Trying to change the memory size to a value that is not within the
|
|
acceptable guest memory bounds supported by the virtual machine’s host.</li>
|
|
</ul>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>messages</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.LocalizableMessage" title="com.vmware.vapi.std_client.LocalizableMessage"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.LocalizableMessage</span></tt></a>) – <p>Stack of one or more localizable messages for human exception
|
|
consumers.</p>
|
|
<p>The message at the top of the stack (first in the list) describes
|
|
the exception from the perspective of the method the client
|
|
invoked. Each subsequent message in the stack describes the “cause”
|
|
of the prior message.</p>
|
|
</li>
|
|
<li><strong>data</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – <p>Data to facilitate clients responding to the method reporting a
|
|
standard exception to indicating that it was unable to complete
|
|
successfully.</p>
|
|
<p>Methods may provide data that clients can use when responding to
|
|
exceptions. Since the data that clients need may be specific to the
|
|
context of the method reporting the exception, different methods
|
|
that report the same exception may provide different data in the
|
|
exception. The documentation for each each method will describe
|
|
what, if any, data it provides for each exception it reports. The
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.ArgumentLocations" title="com.vmware.vapi.std.errors_client.ArgumentLocations"><tt class="xref py py-class docutils literal"><span class="pre">ArgumentLocations</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.std.errors_client.FileLocations" title="com.vmware.vapi.std.errors_client.FileLocations"><tt class="xref py py-class docutils literal"><span class="pre">FileLocations</span></tt></a>, and
|
|
<a class="reference internal" href="#com.vmware.vapi.std.errors_client.TransientIndication" title="com.vmware.vapi.std.errors_client.TransientIndication"><tt class="xref py py-class docutils literal"><span class="pre">TransientIndication</span></tt></a> classes are intended as possible
|
|
values for this attribute.
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></tt></a> may also be useful as
|
|
a value for this attribute (although that is not its primary
|
|
purpose). Some classes may provide their own specific classes for
|
|
use as the value of this attribute when reporting exceptions from
|
|
their methods.
|
|
Some methods will not set this attribute when reporting exceptions.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-com.vmware.vapi.std.interposition_client">
|
|
<span id="interposition-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">interposition_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.std.interposition_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.std.interposition_client</span></tt> module provides classes that
|
|
TODO.</p>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.interposition_client.InvocationRequest">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.interposition_client.</tt><tt class="descname">InvocationRequest</tt><big>(</big><em>service_id=None</em>, <em>operation_id=None</em>, <em>operation_input=None</em>, <em>user=None</em>, <em>groups=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/interposition_client.html#InvocationRequest"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.interposition_client.InvocationRequest" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>Information about an interposed request for operation invocation. All
|
|
interposers would receive an instance of this structure as an input
|
|
parameter.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>service_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Fully qualified name of the service which contains the interposed
|
|
operation. In canonical format. For example org.example.hello.</li>
|
|
<li><strong>operation_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Name of the interposed operation. In canonical format. For example
|
|
say_hello.</li>
|
|
<li><strong>operation_input</strong> (<tt class="xref py py-class docutils literal"><span class="pre">DataValue</span></tt>) – Input of the interposed operation.</li>
|
|
<li><strong>user</strong> (<a class="reference internal" href="#com.vmware.vapi.std.interposition_client.SecurityPrincipal" title="com.vmware.vapi.std.interposition_client.SecurityPrincipal"><tt class="xref py py-class docutils literal"><span class="pre">SecurityPrincipal</span></tt></a> or <tt class="docutils literal"><span class="pre">None</span></tt>) – User which started the interposed operation.
|
|
There could be no authentication information. For example when
|
|
methods are invoked anonymously.</li>
|
|
<li><strong>groups</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.std.interposition_client.SecurityPrincipal" title="com.vmware.vapi.std.interposition_client.SecurityPrincipal"><tt class="xref py py-class docutils literal"><span class="pre">SecurityPrincipal</span></tt></a>) – Groups of the user who started the interposed operation. Would be
|
|
empty if there is no authentication information.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.interposition_client.InvocationResult">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.interposition_client.</tt><tt class="descname">InvocationResult</tt><big>(</big><em>result_type=None</em>, <em>output=None</em>, <em>error=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/interposition_client.html#InvocationResult"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.interposition_client.InvocationResult" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>Information about the result from an interposed operation invocation. All
|
|
POST interposers will receive an instance of this structure.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>result_type</strong> (<a class="reference internal" href="#com.vmware.vapi.std.interposition_client.InvocationResult.ResultType" title="com.vmware.vapi.std.interposition_client.InvocationResult.ResultType"><tt class="xref py py-class docutils literal"><span class="pre">InvocationResult.ResultType</span></tt></a>) – Type of the invocation result.</li>
|
|
<li><strong>output</strong> (<tt class="xref py py-class docutils literal"><span class="pre">DataValue</span></tt>) – Normal result value.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">resultType</span></tt> is
|
|
<a class="reference internal" href="#com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.NORMAL_RESULT" title="com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.NORMAL_RESULT"><tt class="xref py py-attr docutils literal"><span class="pre">InvocationResult.ResultType.NORMAL_RESULT</span></tt></a>.</li>
|
|
<li><strong>error</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.struct.VapiStruct</span></tt>) – Error result value.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">resultType</span></tt> is
|
|
<a class="reference internal" href="#com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.ERROR_RESULT" title="com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.ERROR_RESULT"><tt class="xref py py-attr docutils literal"><span class="pre">InvocationResult.ResultType.ERROR_RESULT</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.interposition_client.InvocationResult.ResultType">
|
|
<em class="property">class </em><tt class="descname">ResultType</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/interposition_client.html#InvocationResult.ResultType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.interposition_client.InvocationResult.ResultType" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.enum.Enum" title="vmware.vapi.bindings.enum.Enum"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.enum.Enum</span></tt></a></p>
|
|
<p>Type of the invocation result.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">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 <a class="reference internal" href="custom/rst/enumeration.html#enumeration-description"><em>enumerated
|
|
type description page</em></a>.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>string</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – String value for the <tt class="xref py py-class docutils literal"><span class="pre">ResultType</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.ERROR_RESULT">
|
|
<tt class="descname">ERROR_RESULT</tt><em class="property"> = ResultType(string=u'ERROR_RESULT')</em><a class="headerlink" href="#com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.ERROR_RESULT" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Error invocation result.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.NORMAL_RESULT">
|
|
<tt class="descname">NORMAL_RESULT</tt><em class="property"> = ResultType(string=u'NORMAL_RESULT')</em><a class="headerlink" href="#com.vmware.vapi.std.interposition_client.InvocationResult.ResultType.NORMAL_RESULT" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Normal invocation result.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.interposition_client.SecurityPrincipal">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.interposition_client.</tt><tt class="descname">SecurityPrincipal</tt><big>(</big><em>name=None</em>, <em>domain=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/interposition_client.html#SecurityPrincipal"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.interposition_client.SecurityPrincipal" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>VMODL equivalent of com.vmware.vapi.security.PrincipalId.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Principal name.</li>
|
|
<li><strong>domain</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt> or <tt class="docutils literal"><span class="pre">None</span></tt>) – Principal domain.
|
|
Domain is optional in <tt class="docutils literal"><span class="pre">com.vmware.vapi.security.PrincipalId</span></tt></li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-com.vmware.vapi.std.introspection_client">
|
|
<span id="introspection-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">introspection_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.std.introspection_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <a class="reference internal" href="#module-com.vmware.vapi.std.introspection_client" title="com.vmware.vapi.std.introspection_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.std.introspection_client</span></tt></a> module provides classes
|
|
that expose basic information about the vAPI classes registered with a vAPI
|
|
provider.</p>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.introspection_client.</tt><tt class="descname">Operation</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Operation"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.VapiInterface" title="vmware.vapi.bindings.stub.VapiInterface"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.VapiInterface</span></tt></a></p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation" title="com.vmware.vapi.std.introspection_client.Operation"><tt class="xref py py-class docutils literal"><span class="pre">Operation</span></tt></a> service provides operations to retrieve information
|
|
about the operations present in a vAPI service.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>config</strong> (<a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.StubConfiguration" title="vmware.vapi.bindings.stub.StubConfiguration"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></tt></a>) – Configuration to be used for creating the stub.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition">
|
|
<em class="property">class </em><tt class="descname">DataDefinition</tt><big>(</big><em>type=None</em>, <em>element_definition=None</em>, <em>name=None</em>, <em>fields=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Operation.DataDefinition"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a> structure describes a vAPI data type.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>type</strong> (<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition.DataType</span></tt></a>) – Data type of the value.</li>
|
|
<li><strong>element_definition</strong> (<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a>) – Contains the element definition for generic data types like List
|
|
and Optional.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is one of
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.OPTIONAL" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.OPTIONAL"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.OPTIONAL</span></tt></a> or
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.LIST" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.LIST"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.LIST</span></tt></a>.</li>
|
|
<li><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Fully qualified name of the structure.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is one of
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.STRUCTURE</span></tt></a>,
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE_REF" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE_REF"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.STRUCTURE_REF</span></tt></a>, or
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.ERROR</span></tt></a>.</li>
|
|
<li><strong>fields</strong> (<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt> and <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a>) – Fields of the structure type. The key of the map is the canonical
|
|
name of the field and the value is the
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a> for the field. The order of the
|
|
structure fields defined in IDL is not maintained by the
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation" title="com.vmware.vapi.std.introspection_client.Operation"><tt class="xref py py-class docutils literal"><span class="pre">Operation</span></tt></a> service.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is one of
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.STRUCTURE</span></tt></a> or
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.ERROR</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType">
|
|
<em class="property">class </em><tt class="descname">DataType</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Operation.DataDefinition.DataType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.enum.Enum" title="vmware.vapi.bindings.enum.Enum"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.enum.Enum</span></tt></a></p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition.DataType</span></tt></a> enumeration provides values
|
|
representing the data types supported by the vAPI infrastructure.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">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 <a class="reference internal" href="custom/rst/enumeration.html#enumeration-description"><em>enumerated
|
|
type description page</em></a>.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>string</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – String value for the <tt class="xref py py-class docutils literal"><span class="pre">DataType</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ANY_ERROR">
|
|
<tt class="descname">ANY_ERROR</tt><em class="property"> = DataType(string=u'ANY_ERROR')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ANY_ERROR" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is arbitrary error type. This means, any data of type
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.ERROR</span></tt></a> can be used.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.BINARY">
|
|
<tt class="descname">BINARY</tt><em class="property"> = DataType(string=u'BINARY')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.BINARY" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a binary type.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.BOOLEAN">
|
|
<tt class="descname">BOOLEAN</tt><em class="property"> = DataType(string=u'BOOLEAN')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.BOOLEAN" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a boolean type. The possible values are True and
|
|
False equivalent of the language used to invoke this operation.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.DOUBLE">
|
|
<tt class="descname">DOUBLE</tt><em class="property"> = DataType(string=u'DOUBLE')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.DOUBLE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a double type. It is a 64 bit floating point number.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.DYNAMIC_STRUCTURE">
|
|
<tt class="descname">DYNAMIC_STRUCTURE</tt><em class="property"> = DataType(string=u'DYNAMIC_STRUCTURE')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.DYNAMIC_STRUCTURE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a dynamic structure. This means, any data of type
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.STRUCTURE</span></tt></a> can be used.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR">
|
|
<tt class="descname">ERROR</tt><em class="property"> = DataType(string=u'ERROR')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a specific error type.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.LIST">
|
|
<tt class="descname">LIST</tt><em class="property"> = DataType(string=u'LIST')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.LIST" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a list data type. Any value of this type can have
|
|
zero or more elements in the list.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.LONG">
|
|
<tt class="descname">LONG</tt><em class="property"> = DataType(string=u'LONG')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.LONG" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a long data type. It is a 64 bit signed integer
|
|
number.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.OPAQUE">
|
|
<tt class="descname">OPAQUE</tt><em class="property"> = DataType(string=u'OPAQUE')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.OPAQUE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is an opaque type. This means, data of any
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition.DataType</span></tt></a> can be used.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.OPTIONAL">
|
|
<tt class="descname">OPTIONAL</tt><em class="property"> = DataType(string=u'OPTIONAL')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.OPTIONAL" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is an optional data type. Any value of this type can be
|
|
null.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.SECRET">
|
|
<tt class="descname">SECRET</tt><em class="property"> = DataType(string=u'SECRET')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.SECRET" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a secret data type. This is used for sensitive
|
|
information. The server will not log any data of this type and if possible
|
|
wipe the data from the memory after usage.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRING">
|
|
<tt class="descname">STRING</tt><em class="property"> = DataType(string=u'STRING')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRING" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a string data type. This is a unicode string.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE">
|
|
<tt class="descname">STRUCTURE</tt><em class="property"> = DataType(string=u'STRUCTURE')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a structure data type. A structure has string
|
|
identifier and a set of fields with corresponding values.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE_REF">
|
|
<tt class="descname">STRUCTURE_REF</tt><em class="property"> = DataType(string=u'STRUCTURE_REF')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE_REF" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a structure reference. This is used to break
|
|
circular dependencies in the type references. This just has a string
|
|
identifier of the structure. Clients have to maintain a list of structures
|
|
already visited and use that to resolve this reference.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.VOID">
|
|
<tt class="descname">VOID</tt><em class="property"> = DataType(string=u'VOID')</em><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.VOID" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a void data type.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.Info">
|
|
<em class="property">class </em><tt class="descclassname">Operation.</tt><tt class="descname">Info</tt><big>(</big><em>input_definition=None</em>, <em>output_definition=None</em>, <em>error_definitions=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Operation.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.Info" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>Information about a vAPI operation.</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>input_definition</strong> (<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a>) – <p><a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a> describing the operation input.</p>
|
|
<p>The <tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.type</span></tt> of this field will be
|
|
<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.STRUCTURE"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.STRUCTURE</span></tt></a>. The keys of
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.fields</span></tt> are the names of the
|
|
operation parameters, and the values of
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.fields</span></tt> describe the type of the
|
|
operation parameters.</p>
|
|
</li>
|
|
<li><strong>output_definition</strong> (<a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a>) – <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a> describing the operation output.</li>
|
|
<li><strong>error_definitions</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a>) – <p>List of <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition"><tt class="xref py py-class docutils literal"><span class="pre">Operation.DataDefinition</span></tt></a> describing the errors
|
|
that the operation might report.</p>
|
|
<p>The <tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.type</span></tt> of every element in this
|
|
list will be <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR" title="com.vmware.vapi.std.introspection_client.Operation.DataDefinition.DataType.ERROR"><tt class="xref py py-attr docutils literal"><span class="pre">Operation.DataDefinition.DataType.ERROR</span></tt></a>.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.get">
|
|
<tt class="descclassname">Operation.</tt><tt class="descname">get</tt><big>(</big><em>service_id</em>, <em>operation_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Operation.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.Info" title="com.vmware.vapi.std.introspection_client.Operation.Info"><tt class="xref py py-class docutils literal"><span class="pre">Operation.Info</span></tt></a> for a given vAPI operation.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>service_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – service identifier.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>.</li>
|
|
<li><strong>operation_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – operation identifier.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.operation</span></tt>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.Info" title="com.vmware.vapi.std.introspection_client.Operation.Info"><tt class="xref py py-class docutils literal"><span class="pre">Operation.Info</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first"><a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Operation.Info" title="com.vmware.vapi.std.introspection_client.Operation.Info"><tt class="xref py py-class docutils literal"><span class="pre">Operation.Info</span></tt></a> for a given vAPI operation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></tt></a>
|
|
If the operation identifier does not exist.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first last"><a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></tt></a>
|
|
If the service identifier does not exist.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Operation.list">
|
|
<tt class="descclassname">Operation.</tt><tt class="descname">list</tt><big>(</big><em>service_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Operation.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Operation.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the set of operation identifiers for a given vAPI service.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>service_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – service identifier.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>.</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">set</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">set of operation identifiers for a given vAPI service.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.operation</span></tt>.</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></tt></a>
|
|
If the service identifier does not exist.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Provider">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.introspection_client.</tt><tt class="descname">Provider</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Provider"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Provider" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.VapiInterface" title="vmware.vapi.bindings.stub.VapiInterface"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.VapiInterface</span></tt></a></p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Provider" title="com.vmware.vapi.std.introspection_client.Provider"><tt class="xref py py-class docutils literal"><span class="pre">Provider</span></tt></a> service provides operations to retrieve information
|
|
about a vAPI Provider. A provider is a container that exposes one or more
|
|
vAPI services.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>config</strong> (<a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.StubConfiguration" title="vmware.vapi.bindings.stub.StubConfiguration"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></tt></a>) – Configuration to be used for creating the stub.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Provider.Info">
|
|
<em class="property">class </em><tt class="descname">Info</tt><big>(</big><em>id=None</em>, <em>checksum=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Provider.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Provider.Info" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>Information about a vAPI provider</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the provider
|
|
When clients pass a value of this class as a parameter, the
|
|
attribute must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.provider</span></tt>. When methods return a value of this
|
|
class as a return value, the attribute will be an identifier for
|
|
the resource type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.provider</span></tt>.</li>
|
|
<li><strong>checksum</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Checksum of the information present in the provider.</p>
|
|
<p>Clients can use this information to check if the service
|
|
information has changed. When a new service is added or removed
|
|
(or) one of the existing service information is modified, the value
|
|
of the checksum changes.</p>
|
|
<blockquote>
|
|
<div>The information used to calculate the checksum includes:</div></blockquote>
|
|
<ul>
|
|
<li>service identifiers</li>
|
|
<li>operation identifiers inside the service</li>
|
|
<li>input, output and error definitions of an operation</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Provider.get">
|
|
<tt class="descclassname">Provider.</tt><tt class="descname">get</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Provider.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Provider.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns a <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Provider.Info" title="com.vmware.vapi.std.introspection_client.Provider.Info"><tt class="xref py py-class docutils literal"><span class="pre">Provider.Info</span></tt></a> describing the vAPI provider on which
|
|
the operation is invoked</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Provider.Info" title="com.vmware.vapi.std.introspection_client.Provider.Info"><tt class="xref py py-class docutils literal"><span class="pre">Provider.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Provider.Info" title="com.vmware.vapi.std.introspection_client.Provider.Info"><tt class="xref py py-class docutils literal"><span class="pre">Provider.Info</span></tt></a> describing the vAPI provider on which the
|
|
operation is invoked</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Service">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.std.introspection_client.</tt><tt class="descname">Service</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Service" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.VapiInterface" title="vmware.vapi.bindings.stub.VapiInterface"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.VapiInterface</span></tt></a></p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Service" title="com.vmware.vapi.std.introspection_client.Service"><tt class="xref py py-class docutils literal"><span class="pre">Service</span></tt></a> service provides operations to retrieve information
|
|
about the services exposed by a vAPI provider. A provider is a container
|
|
that exposes one or more vAPI services.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>config</strong> (<a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.stub.StubConfiguration" title="vmware.vapi.bindings.stub.StubConfiguration"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></tt></a>) – Configuration to be used for creating the stub.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Service.Info">
|
|
<em class="property">class </em><tt class="descname">Info</tt><big>(</big><em>operations=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Service.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Service.Info" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="vmware.vapi.bindings.html#vmware.vapi.bindings.struct.VapiStruct" title="vmware.vapi.bindings.struct.VapiStruct"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></tt></a></p>
|
|
<p>Information about a vAPI service</p>
|
|
<div class="admonition tip">
|
|
<p class="first admonition-title">Tip</p>
|
|
<p class="last">The arguments are used to initialize data attributes with the same
|
|
names.</p>
|
|
</div>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>operations</strong> (<tt class="xref py py-class docutils literal"><span class="pre">set</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Set of identifiers of operations present in the service
|
|
When clients pass a value of this class as a parameter, the
|
|
attribute must contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.operation</span></tt>. When methods return a value of this
|
|
class as a return value, the attribute will contain identifiers for
|
|
the resource type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.operation</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Service.get">
|
|
<tt class="descclassname">Service.</tt><tt class="descname">get</tt><big>(</big><em>id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Service.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Service.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the <a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Service.Info" title="com.vmware.vapi.std.introspection_client.Service.Info"><tt class="xref py py-class docutils literal"><span class="pre">Service.Info</span></tt></a> for the specified service</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – service identifier
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>.</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Service.Info" title="com.vmware.vapi.std.introspection_client.Service.Info"><tt class="xref py py-class docutils literal"><span class="pre">Service.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><a class="reference internal" href="#com.vmware.vapi.std.introspection_client.Service.Info" title="com.vmware.vapi.std.introspection_client.Service.Info"><tt class="xref py py-class docutils literal"><span class="pre">Service.Info</span></tt></a> for the specified service</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><a class="reference internal" href="#com.vmware.vapi.std.errors_client.NotFound" title="com.vmware.vapi.std.errors_client.NotFound"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></tt></a>
|
|
If the service identifier does not exist</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.std.introspection_client.Service.list">
|
|
<tt class="descclassname">Service.</tt><tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/std/introspection_client.html#Service.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.std.introspection_client.Service.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the set of service identifiers.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">set</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">set of service identifiers
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sphinxsidebar">
|
|
<div class="sphinxsidebarwrapper">
|
|
<h3><a href="index.html">Table Of Contents</a></h3>
|
|
<ul>
|
|
<li><a class="reference internal" href="#">std Package</a><ul>
|
|
<li><a class="reference internal" href="#id1"><tt class="docutils literal"><span class="pre">std</span></tt> Package</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.std.activation_client"><tt class="docutils literal"><span class="pre">activation_client</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.std.errors_client"><tt class="docutils literal"><span class="pre">errors_client</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.std.interposition_client"><tt class="docutils literal"><span class="pre">interposition_client</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.std.introspection_client"><tt class="docutils literal"><span class="pre">introspection_client</span></tt> Module</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>Previous topic</h4>
|
|
<p class="topless"><a href="com.vmware.vapi.metadata.routing.html"
|
|
title="previous chapter">routing Package</a></p>
|
|
<h4>Next topic</h4>
|
|
<p class="topless"><a href="com.vmware.vcenter.html"
|
|
title="next chapter">vcenter Package</a></p>
|
|
<h3>This Page</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="_sources/com.vmware.vapi.std.txt"
|
|
rel="nofollow">Show Source</a></li>
|
|
</ul>
|
|
<div id="searchbox" style="display: none">
|
|
<h3>Quick search</h3>
|
|
<form class="search" action="search.html" method="get">
|
|
<input type="text" name="q" />
|
|
<input type="submit" value="Go" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
<p class="searchtip" style="font-size: 90%">
|
|
Enter search terms or a module, class or function name.
|
|
</p>
|
|
</div>
|
|
<script type="text/javascript">$('#searchbox').show(0);</script>
|
|
</div>
|
|
</div>
|
|
<div class="clearer"></div>
|
|
</div>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="genindex.html" title="General Index"
|
|
>index</a></li>
|
|
<li class="right" >
|
|
<a href="py-modindex.html" title="Python Module Index"
|
|
>modules</a> |</li>
|
|
<li class="right" >
|
|
<a href="com.vmware.vcenter.html" title="vcenter Package"
|
|
>next</a> |</li>
|
|
<li class="right" >
|
|
<a href="com.vmware.vapi.metadata.routing.html" title="routing Package"
|
|
>previous</a> |</li>
|
|
<li><a href="index.html">vSphere Automation SDK for Python 6.5.0 documentation</a> »</li>
|
|
<li><a href="com.html" >com Package</a> »</li>
|
|
<li><a href="com.vmware.html" >vmware Package</a> »</li>
|
|
<li><a href="com.vmware.vapi.html" >vapi Package</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="footer">
|
|
© Copyright 2014, VMware, Inc..
|
|
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
|
|
</div>
|
|
</body>
|
|
</html> |