mirror of
https://github.com/vmware/vsphere-automation-sdk-python.git
synced 2024-11-22 09:39:58 -05:00
4582 lines
401 KiB
HTML
4582 lines
401 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>metadata Package — vCloud Suite SDK for Python 6.0.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.0.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="vCloud Suite SDK for Python 6.0.0 documentation" href="index.html" />
|
|
<link rel="up" title="vapi Package" href="com.vmware.vapi.html" />
|
|
<link rel="next" title="authentication Package" href="com.vmware.vapi.metadata.authentication.html" />
|
|
<link rel="prev" title="vapi Package" href="com.vmware.vapi.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.vapi.metadata.authentication.html" title="authentication Package"
|
|
accesskey="N">next</a> |</li>
|
|
<li class="right" >
|
|
<a href="com.vmware.vapi.html" title="vapi Package"
|
|
accesskey="P">previous</a> |</li>
|
|
<li><a href="index.html">vCloud Suite SDK for Python 6.0.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="metadata-package">
|
|
<h1>metadata Package<a class="headerlink" href="#metadata-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">metadata</span></tt> Package<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
|
|
<span class="target" id="module-com.vmware.vapi.metadata"></span></div>
|
|
<div class="section" id="module-com.vmware.vapi.metadata.authentication_client">
|
|
<span id="authentication-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">authentication_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.metadata.authentication_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication_client</span></tt> module provides classes
|
|
that expose authentication information for operation elements across all the
|
|
service elements.</p>
|
|
<p>To calculate the effective authentication information for an operation element,
|
|
you should first see if there is an authentication scheme specified for the
|
|
operation element. If it is not specified, then authentication scheme for the
|
|
service element that contains this operation element is used. If it is not
|
|
specified for the service element as well, then the authentication scheme for
|
|
the package element that contains this service element is used.</p>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">AuthenticationInfo</tt><big>(</big><em>scheme_type=None</em>, <em>session_manager=None</em>, <em>scheme=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#AuthenticationInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo" 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">AuthenticationInfo</span></tt> class describes the authentication information.
|
|
Authentication information could be specified for a package element,
|
|
service elenent or an operation element.</p>
|
|
<p>Using the authentication scheme information, a client invoking an API call
|
|
from any class can figure out what kind of credentials are needed for that
|
|
API call.</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>scheme_type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType" title="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType"><tt class="xref py py-class docutils literal"><span class="pre">AuthenticationInfo.SchemeType</span></tt></a>) – The type of the authentication scheme.</li>
|
|
<li><strong>session_manager</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – In a session aware authentication scheme, a session manager is
|
|
required that supports <tt class="docutils literal"><span class="pre">create</span></tt>, <tt class="docutils literal"><span class="pre">delete</span></tt> and <tt class="docutils literal"><span class="pre">keepAlive</span></tt>
|
|
methods. The fully qualified class name of the session manager is
|
|
provided in <tt class="xref py py-attr docutils literal"><span class="pre">AuthenticationInfo.session_manager</span></tt> attribute.
|
|
This class is responsible for handling sessions.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">schemeType</span></tt> is
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType.SESSION_AWARE" title="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType.SESSION_AWARE"><tt class="xref py py-attr docutils literal"><span class="pre">AuthenticationInfo.SchemeType.SESSION_AWARE</span></tt></a>.</li>
|
|
<li><strong>scheme</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>String identifier of the authentication scheme.</p>
|
|
<p>Following are the supported authentication schemes by the
|
|
infrastructure:</p>
|
|
<ul>
|
|
<li>The identifier <tt class="docutils literal"><span class="pre">com.vmware.vapi.std.security.saml_hok_token</span></tt>
|
|
for SAML holder of key token based authentication mechanism.</li>
|
|
<li>The identifier <tt class="docutils literal"><span class="pre">com.vmware.vapi.std.security.bearer_token</span></tt> for
|
|
SAML bearer token based authentication mechanism.</li>
|
|
<li>The identifier <tt class="docutils literal"><span class="pre">com.vmware.vapi.std.security.session_id</span></tt> for
|
|
session based authentication mechanism.</li>
|
|
<li>The identifier <tt class="docutils literal"><span class="pre">com.vmware.vapi.std.security.user_pass</span></tt> for
|
|
username and password based authentication mechanism.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType">
|
|
<em class="property">class </em><tt class="descname">SchemeType</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#AuthenticationInfo.SchemeType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType" 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 <tt class="docutils literal"><span class="pre">AuthenticationInfo.SchemeType</span></tt> class provides class attributes for
|
|
the set of valid authentication scheme types.</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">SchemeType</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType.SESSIONLESS">
|
|
<tt class="descname">SESSIONLESS</tt><em class="property"> = SchemeType(string='SESSIONLESS')</em><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType.SESSIONLESS" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates that the scheme is a session less authentication scheme, the user
|
|
is authenticated on every method. There is no explicit session
|
|
establishment.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType.SESSION_AWARE">
|
|
<tt class="descname">SESSION_AWARE</tt><em class="property"> = SchemeType(string='SESSION_AWARE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo.SchemeType.SESSION_AWARE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates that the scheme is a session aware authentication scheme. It
|
|
requires an explicit login before executing a method and logout when a
|
|
session terminates. A class might choose to have a session aware scheme if
|
|
it wants to associate some state corresponding to the user until the user
|
|
logs out or if it wants to mitigate the cost of authenticating the user on
|
|
every method.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Component">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">Component</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Component"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Component" 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 <tt class="docutils literal"><span class="pre">Component</span></tt> class provides methods to retrieve authentication
|
|
information of a component element.</p>
|
|
<p>A component element is said to contain authentication information if any
|
|
one of package elements contained in it has authentication information.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Component.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.component'</em><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Component.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for component.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Component.fingerprint">
|
|
<tt class="descname">fingerprint</tt><big>(</big><em>component_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Component.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Component.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves the fingerprint computed from the authentication metadata of
|
|
the component element corresponding to <tt class="docutils literal"><span class="pre">component_id</span></tt>.</p>
|
|
<p>The fingerprint provides clients an efficient way to check if the
|
|
metadata for a particular component has been modified on the server.
|
|
The client can do this by comparing the result of this operation with
|
|
the fingerprint returned in the result of <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Component.get" title="com.vmware.vapi.metadata.authentication_client.Component.get"><tt class="xref py py-func docutils literal"><span class="pre">Component.get()</span></tt></a>.</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>component_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the component element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The fingerprint computed from the authentication metadata of the
|
|
component.</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.html#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 component element associated with <tt class="docutils literal"><span class="pre">component_id</span></tt> does not
|
|
have any authentication information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Component.get">
|
|
<tt class="descname">get</tt><big>(</big><em>component_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Component.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Component.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves authentication information about the component element
|
|
corresponding to <tt class="docutils literal"><span class="pre">component_id</span></tt>.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.ComponentData" title="com.vmware.vapi.metadata.authentication_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a> contains the authentication information
|
|
about the component element and it’s fingerprint. It contains
|
|
information about all the package elements that belong to this
|
|
component element.</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>component_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the component element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</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.metadata.authentication_client.ComponentData" title="com.vmware.vapi.metadata.authentication_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.ComponentData" title="com.vmware.vapi.metadata.authentication_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">component_id</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.html#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 component element associated with <tt class="docutils literal"><span class="pre">component_id</span></tt> does not
|
|
have any authentication information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Component.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Component.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Component.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the component elements that have
|
|
authentication information.</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.metadata.authentication_client.Component.list" title="com.vmware.vapi.metadata.authentication_client.Component.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the component elements that have
|
|
authentication information.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.ComponentData">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">ComponentData</tt><big>(</big><em>info=None</em>, <em>fingerprint=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#ComponentData"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.ComponentData" 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">ComponentData</span></tt> class contains the authentication information of the
|
|
component along with its fingerprint.</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>info</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.ComponentInfo" title="com.vmware.vapi.metadata.authentication_client.ComponentInfo"><tt class="xref py py-class docutils literal"><span class="pre">ComponentInfo</span></tt></a>) – Authentication information of the component. This includes
|
|
information about all the modules in the component.</li>
|
|
<li><strong>fingerprint</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Fingerprint of the metadata of the component.</p>
|
|
<p>Authentication information could change when there is an
|
|
infrastructure update. Since the data present in
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">ComponentData.info</span></tt> could be quite large, <tt class="docutils literal"><span class="pre">fingerprint</span></tt>
|
|
provides a convenient way to check if the data for a particular
|
|
component is updated.</p>
|
|
<p>You should store the fingerprint associated with a component. After
|
|
an update, by invoking the <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Component.fingerprint" title="com.vmware.vapi.metadata.authentication_client.Component.fingerprint"><tt class="xref py py-func docutils literal"><span class="pre">Component.fingerprint()</span></tt></a> method,
|
|
you can retrieve the new fingerprint for the component. If the new
|
|
fingerprint and the previously stored fingerprint do not match,
|
|
clients can then use the <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Component.get" title="com.vmware.vapi.metadata.authentication_client.Component.get"><tt class="xref py py-func docutils literal"><span class="pre">Component.get()</span></tt></a> to retrieve the new
|
|
authentication information for the component.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.ComponentInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">ComponentInfo</tt><big>(</big><em>packages=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#ComponentInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.ComponentInfo" 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">ComponentInfo</span></tt> class contains authentication information of a
|
|
component element.</p>
|
|
<p>For an explanation of authentication information contained within component
|
|
elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Component" title="com.vmware.vapi.metadata.authentication_client.Component"><tt class="xref py py-class docutils literal"><span class="pre">Component</span></tt></a>.</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>packages</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.metadata.authentication_client.PackageInfo" title="com.vmware.vapi.metadata.authentication_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a>) – <p>Authentication information of all the package elements. The key in
|
|
the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier of the package element and the
|
|
value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the authentication information for
|
|
the package element.</p>
|
|
<p>For an explanation of authentication information containment within
|
|
package elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Package" title="com.vmware.vapi.metadata.authentication_client.Package"><tt class="xref py py-class docutils literal"><span class="pre">Package</span></tt></a>.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.OperationInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">OperationInfo</tt><big>(</big><em>schemes=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#OperationInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.OperationInfo" 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">OperationInfo</span></tt> class contains authentication information of an
|
|
operation element.</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>schemes</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo" title="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo"><tt class="xref py py-class docutils literal"><span class="pre">AuthenticationInfo</span></tt></a>) – List of authentication schemes used by an operation element. The
|
|
authentication scheme specified on the service element
|
|
corresponding to this operation element is ignored.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Package">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">Package</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Package"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Package" 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 <tt class="docutils literal"><span class="pre">Package</span></tt> class provides methods to retrieve authentication
|
|
information of a package element.</p>
|
|
<p>A package element is said to contain authentication information if there is
|
|
a default authentication assigned to all service elements contained in the
|
|
package element or if one of the service element contained in this package
|
|
element has authentication information.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Package.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.package'</em><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Package.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for package.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Package.get">
|
|
<tt class="descname">get</tt><big>(</big><em>package_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Package.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Package.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves authentication information about the package element
|
|
corresponding to <tt class="docutils literal"><span class="pre">package_id</span></tt>.</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>package_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the package element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</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.metadata.authentication_client.PackageInfo" title="com.vmware.vapi.metadata.authentication_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.PackageInfo" title="com.vmware.vapi.metadata.authentication_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">package_id</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.html#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 package element associated with <tt class="docutils literal"><span class="pre">package_id</span></tt> does not have
|
|
any authentication information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Package.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Package.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Package.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the package elements that have
|
|
authentication information.</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.metadata.authentication_client.Package.list" title="com.vmware.vapi.metadata.authentication_client.Package.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the package elements that have
|
|
authentication information.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.PackageInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">PackageInfo</tt><big>(</big><em>schemes=None</em>, <em>services=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#PackageInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.PackageInfo" 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">PackageInfo</span></tt> class contains authentication information of a package
|
|
element.</p>
|
|
<p>For an explanation of authentication information contained within package
|
|
elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Package" title="com.vmware.vapi.metadata.authentication_client.Package"><tt class="xref py py-class docutils literal"><span class="pre">Package</span></tt></a>.</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>schemes</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo" title="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo"><tt class="xref py py-class docutils literal"><span class="pre">AuthenticationInfo</span></tt></a>) – List of authentication schemes to be used for all the operation
|
|
elements contained in this package element. If a particular service
|
|
or operation element has no explicit authentications defined in the
|
|
authentication defintion file, these authentication schemes are
|
|
used for authenticating the user.</li>
|
|
<li><strong>services</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.metadata.authentication_client.ServiceInfo" title="com.vmware.vapi.metadata.authentication_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a>) – <p>Information about all service elements contained in this package
|
|
element that contain authentication information. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier of the service element and the
|
|
value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the authentication information for
|
|
the service element.</p>
|
|
<p>For an explanation of authentication information containment within
|
|
service elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Service" title="com.vmware.vapi.metadata.authentication_client.Service"><tt class="xref py py-class docutils literal"><span class="pre">Service</span></tt></a>.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Service">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">Service</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_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 <tt class="docutils literal"><span class="pre">Service</span></tt> class provides methods to retrieve authentication
|
|
information of a service element.</p>
|
|
<p>A service element is said to contain authentication information if there is
|
|
a default authentication assigned to all operation elements contained in a
|
|
service element or if one of the operation elements contained in this
|
|
service element has authentication information.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Service.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.service'</em><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Service.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for service.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Service.get">
|
|
<tt class="descname">get</tt><big>(</big><em>service_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Service.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Service.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves authentication information about the service element
|
|
corresponding to <tt class="docutils literal"><span class="pre">service_id</span></tt>.</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>) – Identifier of the service element.
|
|
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.metadata.authentication_client.ServiceInfo" title="com.vmware.vapi.metadata.authentication_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.ServiceInfo" title="com.vmware.vapi.metadata.authentication_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">service_id</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.html#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 element associated with <tt class="docutils literal"><span class="pre">service_id</span></tt> does not have
|
|
any authentication information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Service.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Service.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Service.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the service elements that have
|
|
authentication information.</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.metadata.authentication_client.Service.list" title="com.vmware.vapi.metadata.authentication_client.Service.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the service elements that have
|
|
authentication information.
|
|
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>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.ServiceInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">ServiceInfo</tt><big>(</big><em>schemes=None</em>, <em>operations=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#ServiceInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.ServiceInfo" 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">ServiceInfo</span></tt> class contains authentication information of a service
|
|
element.</p>
|
|
<p>For an explanation of authentication information contained within service
|
|
elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Service" title="com.vmware.vapi.metadata.authentication_client.Service"><tt class="xref py py-class docutils literal"><span class="pre">Service</span></tt></a>.</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>schemes</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.AuthenticationInfo" title="com.vmware.vapi.metadata.authentication_client.AuthenticationInfo"><tt class="xref py py-class docutils literal"><span class="pre">AuthenticationInfo</span></tt></a>) – List of authentication schemes to be used for all the operation
|
|
elements contained in this service element. The authentication
|
|
scheme specified on the package element corresponding to this
|
|
service element is ignored.</li>
|
|
<li><strong>operations</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.metadata.authentication_client.OperationInfo" title="com.vmware.vapi.metadata.authentication_client.OperationInfo"><tt class="xref py py-class docutils literal"><span class="pre">OperationInfo</span></tt></a>) – <p>Information about all operation elements contained in this service
|
|
element that contain authentication information. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier of the operation element and the
|
|
value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the authentication information for
|
|
the operation element.</p>
|
|
<p>For an explanation of containment of authentication information
|
|
within operation elements, see
|
|
<a class="reference internal" href="com.vmware.vapi.metadata.authentication.html#com.vmware.vapi.metadata.authentication.service_client.Operation" title="com.vmware.vapi.metadata.authentication.service_client.Operation"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication.service_client.Operation</span></tt></a>.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier 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 key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.operation</span></tt>.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.authentication_client.</tt><tt class="descname">Source</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source" 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 <tt class="docutils literal"><span class="pre">Source</span></tt> class provides methods to manage the sources of
|
|
authentication metadata information.</p>
|
|
<p>The interface definition language infrastructure provides tools to generate
|
|
various kinds of metadata in JSON format from the interface definition
|
|
files and additional properties files. One of the generated files contains
|
|
authentication information. The generated file can be registered as a
|
|
source of metadata.</p>
|
|
<p>The authentication file contains all the data present in the interface
|
|
definition files. Each authentication file contains data about one
|
|
component element. When a authentication file is added as a source, each
|
|
source contributes only one component element’s metadata.</p>
|
|
<p>Authentication metadata can also be discovered from a remote server that
|
|
supports the authentication metadata classes (see
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.authentication_client" title="com.vmware.vapi.metadata.authentication_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication_client</span></tt></a>). Since multiple
|
|
components can be registered with a single metadata server, when a remote
|
|
server is registered as a source, that source can contribute more than one
|
|
component.</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.metadata.authentication_client.Source.CreateSpec">
|
|
<em class="property">class </em><tt class="descname">CreateSpec</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.CreateSpec"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.CreateSpec" 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">Source.CreateSpec</span></tt> class contains the registration information of a
|
|
authentication source.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – Type of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the metamodel metadata file that has the
|
|
metamodel information about one component element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.FILE" title="com.vmware.vapi.metadata_client.SourceType.FILE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.FILE</span></tt></a>.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information of the remote server. This should be of the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server should contain the classes in
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a> module. It could
|
|
expose metamodel information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.REMOTE" title="com.vmware.vapi.metadata_client.SourceType.REMOTE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.REMOTE</span></tt></a>.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.Info">
|
|
<em class="property">class </em><tt class="descclassname">Source.</tt><tt class="descname">Info</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.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>The <tt class="docutils literal"><span class="pre">Source.Info</span></tt> class contains the metadata source information.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – Type of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the authentication metadata file that has the
|
|
authentication information about one component element. The
|
|
<tt class="docutils literal"><span class="pre">filePath</span></tt> is the path to the file in the server’s filesystem.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information for the remote server. This must be in the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server must support the classes in the
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.authentication_client" title="com.vmware.vapi.metadata.authentication_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication_client</span></tt></a> module. It
|
|
must expose authentication information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.RESOURCE_TYPE">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.metadata.authentication.source'</em><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for metadata source.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.create">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">create</tt><big>(</big><em>source_id</em>, <em>spec</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.create"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.create" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Creates a new metadata source. Once the server validates the
|
|
registration information of the metadata source, the authentication
|
|
metadata is retrieved from the source. This populates elements in all
|
|
the classes defined in
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.authentication_client" title="com.vmware.vapi.metadata.authentication_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication_client</span></tt></a> module.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – metadata source identifier.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication.source</span></tt>.</li>
|
|
<li><strong>spec</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Source.CreateSpec" title="com.vmware.vapi.metadata.authentication_client.Source.CreateSpec"><tt class="xref py py-class docutils literal"><span class="pre">Source.CreateSpec</span></tt></a>) – create specification.</li>
|
|
</ul>
|
|
</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.html#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">com.vmware.vapi.std.errors_client.AlreadyExists</span></tt></a>
|
|
if the metadata source identifier is already registered with the
|
|
infrastructure.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the type of the source specified in null is invalid.</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.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the file specified in null is not a valid JSON file or if the
|
|
format of the authentication metadata in the JSON file is invalid.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the URI specified in null is unreachable or if there is a
|
|
transport protocol or message protocol mismatch between the client
|
|
and the server or if the remote server do not have classes present
|
|
in <a class="reference internal" href="#module-com.vmware.vapi.metadata.authentication_client" title="com.vmware.vapi.metadata.authentication_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication_client</span></tt></a> module.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><p class="first last"><a class="reference internal" href="com.vmware.vapi.std.html#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 file specified in null does not exist.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.delete">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">delete</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.delete"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.delete" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Deletes an existing authentication metadata source from the
|
|
infrastructure.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication.source</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.html#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 metadata source identifier is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.fingerprint">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">fingerprint</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the aggregate fingerprint of metadata from all the metadata
|
|
sources or from a particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is
|
|
specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication.source</span></tt>.
|
|
If unspecified, the fingerprint of all the metadata sources is
|
|
returned.</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Aggregate fingerprint of all the metadata sources or of a
|
|
particular metadata source.</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.get">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">get</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the metadata source corresponding to
|
|
<tt class="docutils literal"><span class="pre">source_id</span></tt>.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication.source</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.metadata.authentication_client.Source.Info" title="com.vmware.vapi.metadata.authentication_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.authentication_client.Source.Info" title="com.vmware.vapi.metadata.authentication_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a> instance that corresponds to <tt class="docutils literal"><span class="pre">source_id</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.list">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers of the metadata sources currently registered
|
|
with the infrastructure.</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.metadata.authentication_client.Source.list" title="com.vmware.vapi.metadata.authentication_client.Source.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for metadata sources currently registered.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication.source</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.authentication_client.Source.reload">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">reload</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/authentication_client.html#Source.reload"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.authentication_client.Source.reload" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Reloads the authentication metadata from all the metadata sources or of
|
|
a particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.authentication.source</span></tt>.
|
|
If unspecified, all the metadata sources are reloaded.</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-com.vmware.vapi.metadata.cli_client">
|
|
<span id="cli-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">cli_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.metadata.cli_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.cli_client</span></tt> module provides classes that expose
|
|
all the information required to display namespace or command help, execute a
|
|
command and display it’s result.</p>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.cli_client.</tt><tt class="descname">Command</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command" 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 <tt class="docutils literal"><span class="pre">Command</span></tt> class provides methods to get information about command
|
|
line interface (CLI) commands.</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.metadata.cli_client.Command.FormatterType">
|
|
<em class="property">class </em><tt class="descname">FormatterType</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.FormatterType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType" 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 <tt class="docutils literal"><span class="pre">Command.FormatterType</span></tt> class defines supported CLI output formatter
|
|
types. See <tt class="xref py py-attr docutils literal"><span class="pre">Command.Info.formatter</span></tt>.</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">FormatterType</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.FormatterType.CSV">
|
|
<tt class="descname">CSV</tt><em class="property"> = FormatterType(string='CSV')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType.CSV" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Displays command output in CSV format.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.FormatterType.HTML">
|
|
<tt class="descname">HTML</tt><em class="property"> = FormatterType(string='HTML')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType.HTML" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Displays command output in HTML format.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.FormatterType.JSON">
|
|
<tt class="descname">JSON</tt><em class="property"> = FormatterType(string='JSON')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType.JSON" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Displays command output in JSON format.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.FormatterType.SIMPLE">
|
|
<tt class="descname">SIMPLE</tt><em class="property"> = FormatterType(string='SIMPLE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType.SIMPLE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Displays command output as it is.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.FormatterType.TABLE">
|
|
<tt class="descname">TABLE</tt><em class="property"> = FormatterType(string='TABLE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType.TABLE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Displays command output in table format.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.FormatterType.XML">
|
|
<tt class="descname">XML</tt><em class="property"> = FormatterType(string='XML')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType.XML" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Displays command output in XML format.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.GenericType">
|
|
<em class="property">class </em><tt class="descclassname">Command.</tt><tt class="descname">GenericType</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.GenericType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.GenericType" 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 <tt class="docutils literal"><span class="pre">Command.GenericType</span></tt> class defines generic types supported by
|
|
<tt class="docutils literal"><span class="pre">Command</span></tt> class. See <tt class="xref py py-attr docutils literal"><span class="pre">Command.OptionInfo.generic</span></tt>.</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">GenericType</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.GenericType.LIST">
|
|
<tt class="descname">LIST</tt><em class="property"> = GenericType(string='LIST')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.GenericType.LIST" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Input parameter is a list.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.GenericType.NONE">
|
|
<tt class="descname">NONE</tt><em class="property"> = GenericType(string='NONE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.GenericType.NONE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Default case.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.GenericType.OPTIONAL">
|
|
<tt class="descname">OPTIONAL</tt><em class="property"> = GenericType(string='OPTIONAL')</em><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.GenericType.OPTIONAL" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Input parameter is an optional.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.Identity">
|
|
<em class="property">class </em><tt class="descclassname">Command.</tt><tt class="descname">Identity</tt><big>(</big><em>path=None</em>, <em>name=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.Identity"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.Identity" 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">Command.Identity</span></tt> class uniquely identifies a command in the CLI
|
|
commands tree.</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>path</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The dot-separated path of the namespace containing the command in
|
|
the CLI command tree.</li>
|
|
<li><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Name of the command.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.Info">
|
|
<em class="property">class </em><tt class="descclassname">Command.</tt><tt class="descname">Info</tt><big>(</big><em>identity=None</em>, <em>description=None</em>, <em>service_id=None</em>, <em>operation_id=None</em>, <em>options=None</em>, <em>formatter=None</em>, <em>output_field_list=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.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>The <tt class="docutils literal"><span class="pre">Command.Info</span></tt> class contains information about a command. It
|
|
includes the identity of the command, a description, information about the
|
|
class and method that implement the command, and CLI-specific information
|
|
for the command.</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>identity</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.Identity" title="com.vmware.vapi.metadata.cli_client.Command.Identity"><tt class="xref py py-class docutils literal"><span class="pre">Command.Identity</span></tt></a>) – Basic command identity.</li>
|
|
<li><strong>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The text description displayed to the user in help output.</li>
|
|
<li><strong>service_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The service identifier that contains the operations for this CLI
|
|
command.
|
|
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.service</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.service</span></tt>.</li>
|
|
<li><strong>operation_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The operation identifier corresponding to this CLI command.
|
|
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.operation</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.operation</span></tt>.</li>
|
|
<li><strong>options</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.OptionInfo" title="com.vmware.vapi.metadata.cli_client.Command.OptionInfo"><tt class="xref py py-class docutils literal"><span class="pre">Command.OptionInfo</span></tt></a>) – The input for this command.</li>
|
|
<li><strong>formatter</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.FormatterType" title="com.vmware.vapi.metadata.cli_client.Command.FormatterType"><tt class="xref py py-class docutils literal"><span class="pre">Command.FormatterType</span></tt></a> or <tt class="docutils literal"><span class="pre">None</span></tt>) – The formatter to use when displaying the output of this command.
|
|
If not present, client can choose a default output formatter.</li>
|
|
<li><strong>output_field_list</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.OutputInfo" title="com.vmware.vapi.metadata.cli_client.Command.OutputInfo"><tt class="xref py py-class docutils literal"><span class="pre">Command.OutputInfo</span></tt></a>) – List of output structure name and output field info.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.OptionInfo">
|
|
<em class="property">class </em><tt class="descclassname">Command.</tt><tt class="descname">OptionInfo</tt><big>(</big><em>long_option=None</em>, <em>short_option=None</em>, <em>field_name=None</em>, <em>description=None</em>, <em>type=None</em>, <em>generic=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.OptionInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.OptionInfo" 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">Command.OptionInfo</span></tt> class describes information about a specific
|
|
input option of a command.</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>long_option</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The long option name of the parameter as used by the user.</li>
|
|
<li><strong>short_option</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>) – The single character value option name.
|
|
If not present, there’s no single character option for the
|
|
parameter.</li>
|
|
<li><strong>field_name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The fully qualified name of the option referred to by the operation
|
|
element in <tt class="xref py py-attr docutils literal"><span class="pre">Command.Info.operation_id</span></tt>.</li>
|
|
<li><strong>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The description of the option to be displayed to the user when they
|
|
request usage information for a CLI command.</li>
|
|
<li><strong>type</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The type of option. This is used to display information about what
|
|
kind of data is expected (string, number, boolean, etc.) for the
|
|
option when they request usage information for a CLI command. For
|
|
class this stores the fully qualified class id.</li>
|
|
<li><strong>generic</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.GenericType" title="com.vmware.vapi.metadata.cli_client.Command.GenericType"><tt class="xref py py-class docutils literal"><span class="pre">Command.GenericType</span></tt></a>) – This is used to tell the user whether the option is required or
|
|
optional, or whether they can specify the option multiple times.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.OutputFieldInfo">
|
|
<em class="property">class </em><tt class="descclassname">Command.</tt><tt class="descname">OutputFieldInfo</tt><big>(</big><em>field_name=None</em>, <em>display_name=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.OutputFieldInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.OutputFieldInfo" 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">Command.OutputFieldInfo</span></tt> class describes the name used by the CLI to
|
|
display a single attribute of a class element in the interface definition
|
|
language.</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>field_name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Name of the attribute.</li>
|
|
<li><strong>display_name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Name used by the CLI to display the attribute.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.OutputInfo">
|
|
<em class="property">class </em><tt class="descclassname">Command.</tt><tt class="descname">OutputInfo</tt><big>(</big><em>structure_id=None</em>, <em>output_fields=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.OutputInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.OutputInfo" 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">Command.OutputInfo</span></tt> class describes the names used by the CLI to
|
|
display the attributes of a class element in the interface definition
|
|
language as well as the order in which the attributes will be displayed.</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>structure_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Name of the class.
|
|
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.structure</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.structure</span></tt>.</li>
|
|
<li><strong>output_fields</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.OutputFieldInfo" title="com.vmware.vapi.metadata.cli_client.Command.OutputFieldInfo"><tt class="xref py py-class docutils literal"><span class="pre">Command.OutputFieldInfo</span></tt></a>) – The order in which the attributes of the class will be displayed by
|
|
the CLI as well as the names used to display the attributes.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.fingerprint">
|
|
<tt class="descclassname">Command.</tt><tt class="descname">fingerprint</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the aggregate fingerprint of all the command metadata from all
|
|
the metadata sources.</p>
|
|
<p>The fingerprint provides clients an efficient way to check if the
|
|
metadata for commands has been modified on the server.</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">Fingerprint of all the command metadata present on the server.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.get">
|
|
<tt class="descclassname">Command.</tt><tt class="descname">get</tt><big>(</big><em>identity</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about a command including information about how
|
|
to execute that command.</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>identity</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.Identity" title="com.vmware.vapi.metadata.cli_client.Command.Identity"><tt class="xref py py-class docutils literal"><span class="pre">Command.Identity</span></tt></a>) – Identifier of the command for which to retreive information.</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.metadata.cli_client.Command.Info" title="com.vmware.vapi.metadata.cli_client.Command.Info"><tt class="xref py py-class docutils literal"><span class="pre">Command.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Information about the command including information about how to
|
|
execute that command.</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.html#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 a command corresponding to <tt class="docutils literal"><span class="pre">identity</span></tt> doesn’t exist.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Command.list">
|
|
<tt class="descclassname">Command.</tt><tt class="descname">list</tt><big>(</big><em>path=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Command.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Command.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers of all commands, or commands in a specific
|
|
namespace.</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>path</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>) – The dot-separated path of the namespace for which command
|
|
identifiers should be returned.
|
|
If None identifiers of all commands registered with the
|
|
infrastructure will be returned.</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.metadata.cli_client.Command.list" title="com.vmware.vapi.metadata.cli_client.Command.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> of <a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Command.Identity" title="com.vmware.vapi.metadata.cli_client.Command.Identity"><tt class="xref py py-class docutils literal"><span class="pre">Command.Identity</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Identifiers of the requested commands.</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.html#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 a namespace corresponding to <tt class="docutils literal"><span class="pre">path</span></tt> doesn’t exist.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Namespace">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.cli_client.</tt><tt class="descname">Namespace</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Namespace"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Namespace" 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 <tt class="docutils literal"><span class="pre">Namespace</span></tt> class provides methods to get information about command
|
|
line interface (CLI) namespaces.</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.metadata.cli_client.Namespace.Identity">
|
|
<em class="property">class </em><tt class="descname">Identity</tt><big>(</big><em>path=None</em>, <em>name=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Namespace.Identity"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Namespace.Identity" 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">Namespace.Identity</span></tt> class uniquely identifies a namespace in the CLI
|
|
namespace tree.</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>path</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The dot-separated path of the namespace containing the namespace in
|
|
the CLI node tree. For top-level namespace this will be empty.</li>
|
|
<li><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The name displayed to the user for this namespace.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Namespace.Info">
|
|
<em class="property">class </em><tt class="descclassname">Namespace.</tt><tt class="descname">Info</tt><big>(</big><em>identity=None</em>, <em>description=None</em>, <em>children=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Namespace.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Namespace.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>The <tt class="docutils literal"><span class="pre">Namespace.Info</span></tt> class contains information about a namespace. It
|
|
includes the identity of the namespace, a description, information children
|
|
namespaces.</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>identity</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Namespace.Identity" title="com.vmware.vapi.metadata.cli_client.Namespace.Identity"><tt class="xref py py-class docutils literal"><span class="pre">Namespace.Identity</span></tt></a>) – Basic namespace identity.</li>
|
|
<li><strong>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The text description displayed to the user in help output.</li>
|
|
<li><strong>children</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Namespace.Identity" title="com.vmware.vapi.metadata.cli_client.Namespace.Identity"><tt class="xref py py-class docutils literal"><span class="pre">Namespace.Identity</span></tt></a>) – The children of this namespace in the tree of CLI namespaces.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Namespace.fingerprint">
|
|
<tt class="descclassname">Namespace.</tt><tt class="descname">fingerprint</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Namespace.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Namespace.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the aggregate fingerprint of all the namespace metadata from
|
|
all the metadata sources.</p>
|
|
<p>The fingerprint provides clients an efficient way to check if the
|
|
metadata for namespaces has been modified on the server.</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">Fingerprint of all the namespace metadata present on the server.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Namespace.get">
|
|
<tt class="descclassname">Namespace.</tt><tt class="descname">get</tt><big>(</big><em>identity</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Namespace.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Namespace.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retreives information about a namespace including information about
|
|
children of that namespace.</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>identity</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Namespace.Identity" title="com.vmware.vapi.metadata.cli_client.Namespace.Identity"><tt class="xref py py-class docutils literal"><span class="pre">Namespace.Identity</span></tt></a>) – Identifier of the namespace for which to retreive information.</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.metadata.cli_client.Namespace.Info" title="com.vmware.vapi.metadata.cli_client.Namespace.Info"><tt class="xref py py-class docutils literal"><span class="pre">Namespace.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Information about the namespace including information about child
|
|
of that namespace.</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.html#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 a namespace corresponding to <tt class="docutils literal"><span class="pre">identity</span></tt> doesn’t exist.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Namespace.list">
|
|
<tt class="descclassname">Namespace.</tt><tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Namespace.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Namespace.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers of all namespaces registered with the
|
|
infrastructure.</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.metadata.cli_client.Namespace.list" title="com.vmware.vapi.metadata.cli_client.Namespace.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> of <a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Namespace.Identity" title="com.vmware.vapi.metadata.cli_client.Namespace.Identity"><tt class="xref py py-class docutils literal"><span class="pre">Namespace.Identity</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">Identifiers of all the namespaces.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.cli_client.</tt><tt class="descname">Source</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source" 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 <tt class="docutils literal"><span class="pre">Source</span></tt> class provides methods to manage the sources of command line
|
|
interface (CLI) metadata information.</p>
|
|
<p>The interface definition language infrastructure provides tools to generate
|
|
various kinds of metadata in JSON format from the interface definition
|
|
files and additional properties files. One of the generated files contains
|
|
CLI information.</p>
|
|
<p>A CLI metadata file contains information about one component element. When
|
|
a CLI metadata file is added as a source, each source contributes only one
|
|
component element’s metadata.</p>
|
|
<p>CLI metadata can also be discovered from a remote server that supports the
|
|
CLI metadata services (see <a class="reference internal" href="#module-com.vmware.vapi.metadata.cli_client" title="com.vmware.vapi.metadata.cli_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.cli_client</span></tt></a>)
|
|
module. Since multiple components can be registered with a single metadata
|
|
server, when a remote server is registered as a source, that source can
|
|
contribute more than one component.</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.metadata.cli_client.Source.CreateSpec">
|
|
<em class="property">class </em><tt class="descname">CreateSpec</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.CreateSpec"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.CreateSpec" 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">Source.CreateSpec</span></tt> class contains the registration information of a
|
|
CLI source.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – Type of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the metamodel metadata file that has the
|
|
metamodel information about one component element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.FILE" title="com.vmware.vapi.metadata_client.SourceType.FILE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.FILE</span></tt></a>.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information of the remote server. This should be of the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server should contain the classes in
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a> module. It could
|
|
expose metamodel information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.REMOTE" title="com.vmware.vapi.metadata_client.SourceType.REMOTE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.REMOTE</span></tt></a>.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source.Info">
|
|
<em class="property">class </em><tt class="descclassname">Source.</tt><tt class="descname">Info</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.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>The <tt class="docutils literal"><span class="pre">Source.Info</span></tt> class contains the metadata source information.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – The type (FILE, REMOTE) of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the CLI metadata file that has the CLI
|
|
information about one component. The <tt class="docutils literal"><span class="pre">filepath</span></tt> is the path to
|
|
the file in the server’s filesystem.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information for the remote server. This should be in the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server must contain the classes in the
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.cli_client" title="com.vmware.vapi.metadata.cli_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.cli_client</span></tt></a> module. It must expose
|
|
CLI information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source.create">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">create</tt><big>(</big><em>source_id</em>, <em>spec</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.create"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.create" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Creates a new metadata source. Once the server validates the
|
|
registration information of the metadata source, the CLI metadata is
|
|
retrieved from the source. This populates elements in all the classes
|
|
defined in <a class="reference internal" href="#module-com.vmware.vapi.metadata.cli_client" title="com.vmware.vapi.metadata.cli_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.cli_client</span></tt></a> module.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – metadata source identifier.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.source</span></tt>.</li>
|
|
<li><strong>spec</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Source.CreateSpec" title="com.vmware.vapi.metadata.cli_client.Source.CreateSpec"><tt class="xref py py-class docutils literal"><span class="pre">Source.CreateSpec</span></tt></a>) – create specification.</li>
|
|
</ul>
|
|
</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.html#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">com.vmware.vapi.std.errors_client.AlreadyExists</span></tt></a>
|
|
If the metadata source identifier is already registered with the
|
|
infrastructure.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
If type of the source specified in null is invalid.</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.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
If the file specified in null is not a valid JSON file or if the
|
|
format of the CLI metadata in the JSON file is invalid.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
If the URI specified in null is unreachable or if there is a
|
|
transport protocol or message protocol mismatch between the client
|
|
and the server or if the remote server do not have classes present
|
|
in <a class="reference internal" href="#module-com.vmware.vapi.metadata.cli_client" title="com.vmware.vapi.metadata.cli_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.cli_client</span></tt></a> module.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><p class="first last"><a class="reference internal" href="com.vmware.vapi.std.html#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 file specified in null does not exist.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source.delete">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">delete</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.delete"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.delete" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Deletes an existing CLI metadata source from the infrastructure.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.source</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.html#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 metadata source identifier is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source.fingerprint">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">fingerprint</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the aggregate fingerprint of metadata from all the metadata
|
|
sources or from a particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is
|
|
specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.source</span></tt>.
|
|
If unspecified, the fingerprint of all the metadata sources is
|
|
returned.</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Aggregate fingerprint of all the metadata sources or of a
|
|
particular metadata source.</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.html#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 metadata source identifier is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source.get">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">get</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the metadata source corresponding to
|
|
<tt class="docutils literal"><span class="pre">source_id</span></tt>.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.source</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.metadata.cli_client.Source.Info" title="com.vmware.vapi.metadata.cli_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.cli_client.Source.Info" title="com.vmware.vapi.metadata.cli_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a> instance that corresponds to <tt class="docutils literal"><span class="pre">source_id</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.html#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 metadata source identifier is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source.list">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers of the metadata sources currently registered
|
|
with the infrastructure.</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.metadata.cli_client.Source.list" title="com.vmware.vapi.metadata.cli_client.Source.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for metadata sources currently registered.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.source</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.cli_client.Source.reload">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">reload</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/cli_client.html#Source.reload"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.cli_client.Source.reload" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Reloads the CLI metadata from all the metadata sources or of a
|
|
particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.source</span></tt>.
|
|
If unspecified, all the metadata sources are reloaded.</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.html#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 metadata source identifier is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-com.vmware.vapi.metadata.metamodel_client">
|
|
<span id="metamodel-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">metamodel_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.metadata.metamodel_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt> module provides classes that
|
|
expose all the information present in the interface definition language (IDL)
|
|
specification.</p>
|
|
<p>Metamodel metadata is organized into an hierarchy of elements. The main
|
|
elements are:</p>
|
|
<ul class="simple">
|
|
<li>Enumeration: An enumeration element that has a list of enumeration value
|
|
elements.</li>
|
|
<li>Constant: A constant element has a name and a value.</li>
|
|
<li>Structure: A structure element can have field elements, constant elements and
|
|
enumeration elements.</li>
|
|
<li>Operation: An operation has a list of parameter elements, result element and
|
|
error elements.</li>
|
|
<li>Service: A service is a collection of operation elements, structure elements,
|
|
enumerated elements and constant elements.</li>
|
|
<li>Package: A package is a collection of service elements, structure elements
|
|
and enumeration elements.</li>
|
|
<li>Component: A component is a collection of package elements.</li>
|
|
</ul>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt> module has classes that
|
|
enables two styles of client applications:</p>
|
|
<ul class="simple">
|
|
<li>A client can retrieve the exact pieces of information it requires using the
|
|
various granularities the API supports (that is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Component" title="com.vmware.vapi.metadata.metamodel_client.Component"><tt class="xref py py-class docutils literal"><span class="pre">Component</span></tt></a>,
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Package" title="com.vmware.vapi.metadata.metamodel_client.Package"><tt class="xref py py-class docutils literal"><span class="pre">Package</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Service" title="com.vmware.vapi.metadata.metamodel_client.Service"><tt class="xref py py-class docutils literal"><span class="pre">Service</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Structure" title="com.vmware.vapi.metadata.metamodel_client.Structure"><tt class="xref py py-class docutils literal"><span class="pre">Structure</span></tt></a>, <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Enumeration" title="com.vmware.vapi.metadata.metamodel_client.Enumeration"><tt class="xref py py-class docutils literal"><span class="pre">Enumeration</span></tt></a>
|
|
and <a class="reference internal" href="com.vmware.vapi.metadata.metamodel.html#com.vmware.vapi.metadata.metamodel.service_client.Operation" title="com.vmware.vapi.metadata.metamodel.service_client.Operation"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel.service_client.Operation</span></tt></a>). In
|
|
this case, it doesn’t cache any information locally and always invokes methods
|
|
to get the metamodel information it requires.</li>
|
|
<li>A client can retrieve all the metamodel information in fewer method
|
|
invocations using the <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Component" title="com.vmware.vapi.metadata.metamodel_client.Component"><tt class="xref py py-class docutils literal"><span class="pre">Component</span></tt></a> class and cache the output locally. It
|
|
can then poll on the fingerprint information exposed by the <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Component" title="com.vmware.vapi.metadata.metamodel_client.Component"><tt class="xref py py-class docutils literal"><span class="pre">Component</span></tt></a>
|
|
class to monitor changes in API definition.</li>
|
|
</ul>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Component">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Component</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Component"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Component" 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 <tt class="docutils literal"><span class="pre">Component</span></tt> class providers methods to retrieve metamodel information
|
|
of a component element.</p>
|
|
<p>A component defines a set of functionality that is deployed together and
|
|
versioned together. For example, all the classes that belong to VMware
|
|
Content Library are part of a single component. A component element
|
|
describes a component. A component element contains one or more package
|
|
elements.</p>
|
|
<blockquote>
|
|
<div>The methods for package elements are provided by class <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Package" title="com.vmware.vapi.metadata.metamodel_client.Package"><tt class="xref py py-class docutils literal"><span class="pre">Package</span></tt></a>.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Component.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.component'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Component.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for component.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Component.fingerprint">
|
|
<tt class="descname">fingerprint</tt><big>(</big><em>component_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Component.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Component.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves the fingerprint computed from the metamodel metadata of the
|
|
component element corresponding to <tt class="docutils literal"><span class="pre">component_id</span></tt>.</p>
|
|
<p>The fingerprint provides clients an efficient way to check if the
|
|
metadata for a particular component element has been modified on the
|
|
server. The client can do this by comparing the result of this
|
|
operation with the fingerprint returned in the result of
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Component.get" title="com.vmware.vapi.metadata.metamodel_client.Component.get"><tt class="xref py py-func docutils literal"><span class="pre">Component.get()</span></tt></a>.</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>component_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the component element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The fingerprint computed from the metamodel metadata of the
|
|
component element.</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.html#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 component element associated with <tt class="docutils literal"><span class="pre">component_id</span></tt> is not
|
|
registered with the infrastructure.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Component.get">
|
|
<tt class="descname">get</tt><big>(</big><em>component_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Component.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Component.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves metamodel information about the component element
|
|
corresponding to <tt class="docutils literal"><span class="pre">component_id</span></tt>.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ComponentData" title="com.vmware.vapi.metadata.metamodel_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a> contains the metamodel information about the
|
|
component and it’s fingerprint. It contains information about all the
|
|
package elements that are contained in this component element.</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>component_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the component element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</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.metadata.metamodel_client.ComponentData" title="com.vmware.vapi.metadata.metamodel_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ComponentData" title="com.vmware.vapi.metadata.metamodel_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">component_id</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.html#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 component element associated with <tt class="docutils literal"><span class="pre">component_id</span></tt> is not
|
|
registered with the infrastructure.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Component.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Component.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Component.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the component elements that are registered
|
|
with the infrastructure.</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.metadata.metamodel_client.Component.list" title="com.vmware.vapi.metadata.metamodel_client.Component.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the component elements that are
|
|
registered with the infrastructure.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ComponentData">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ComponentData</tt><big>(</big><em>info=None</em>, <em>fingerprint=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ComponentData"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ComponentData" 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">ComponentData</span></tt> class contains the metamodel metadata information of
|
|
a component element along with its fingerprint.</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>info</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ComponentInfo" title="com.vmware.vapi.metadata.metamodel_client.ComponentInfo"><tt class="xref py py-class docutils literal"><span class="pre">ComponentInfo</span></tt></a>) – <p>Metamodel information of the component element. This includes
|
|
information about all the package elements contained in this
|
|
component element.</p>
|
|
<p>The metamodel information about a component could be quite large if
|
|
there are a lot of package elements contained in this component.</p>
|
|
</li>
|
|
<li><strong>fingerprint</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Fingerprint of the metamodel metadata of the component component.</p>
|
|
<p>Metamodel information could change when there is an infrastructure
|
|
update and new functionality is added to an existing component.</p>
|
|
<p>Since the data present in <tt class="xref py py-attr docutils literal"><span class="pre">ComponentData.info</span></tt> could be quite
|
|
large, <tt class="docutils literal"><span class="pre">fingerprint</span></tt> provides a convenient way to check if the
|
|
data for a particular component is updated.</p>
|
|
<p>You should store the fingerprint associated with a component. After
|
|
an update, by invoking the <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Component.fingerprint" title="com.vmware.vapi.metadata.metamodel_client.Component.fingerprint"><tt class="xref py py-func docutils literal"><span class="pre">Component.fingerprint()</span></tt></a> method,
|
|
you can retrieve the new fingerprint for the component. If the new
|
|
fingerprint and the previously stored fingerprint do not match,
|
|
clients can use the <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Component.get" title="com.vmware.vapi.metadata.metamodel_client.Component.get"><tt class="xref py py-func docutils literal"><span class="pre">Component.get()</span></tt></a> to retrieve the new
|
|
metamodel information for the component.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ComponentInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ComponentInfo</tt><big>(</big><em>name=None</em>, <em>packages=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ComponentInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ComponentInfo" 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">ComponentInfo</span></tt> class contains metamodel metadata information about a
|
|
component element.</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>) – Dot separated name of the component element. The segments in the
|
|
name reflect the organization of the APIs. The format of each
|
|
segment is lower case with underscores. Each underscore represents
|
|
a word boundary. If there are acronyms in the word, the
|
|
capitalization is preserved. This format makes it easy to translate
|
|
the segment into a different naming convention.</li>
|
|
<li><strong>packages</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.metadata.metamodel_client.PackageInfo" title="com.vmware.vapi.metadata.metamodel_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a>) – Metamodel metadata information of all the package elements
|
|
contained in the component element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is
|
|
the identifier of the package element and the value in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the metamodel information of the package element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata for the component element. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value is
|
|
the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for a component. It can contain HTML
|
|
markup and documentation tags (similar to Javadoc tags). The first
|
|
sentence of the package documentation is a complete sentence that
|
|
identifies the component by name and summarizes the purpose of the
|
|
component.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ConstantInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ConstantInfo</tt><big>(</big><em>type=None</em>, <em>value=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ConstantInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ConstantInfo" 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">ConstantInfo</span></tt> class contains metamodel information of the constant
|
|
elements.</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.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a>) – Type of the constant element.</li>
|
|
<li><strong>value</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue" title="com.vmware.vapi.metadata.metamodel_client.ConstantValue"><tt class="xref py py-class docutils literal"><span class="pre">ConstantValue</span></tt></a>) – Value of the constant element.</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for the constant element. It can
|
|
contain HTML markup and documentation tags (similar to Javadoc
|
|
tags).</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ConstantValue">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ConstantValue</tt><big>(</big><em>category=None</em>, <em>primitive_value=None</em>, <em>list_value=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ConstantValue"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue" 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">ConstantValue</span></tt> class contains the metamodel information of the
|
|
constant element.</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>category</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category" title="com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category"><tt class="xref py py-class docutils literal"><span class="pre">ConstantValue.Category</span></tt></a>) – Category of the type of constant value.</li>
|
|
<li><strong>primitive_value</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue" title="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue"><tt class="xref py py-class docutils literal"><span class="pre">PrimitiveValue</span></tt></a>) – Primitive value of the constant element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">category</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.PRIMITIVE" title="com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.PRIMITIVE"><tt class="xref py py-attr docutils literal"><span class="pre">ConstantValue.Category.PRIMITIVE</span></tt></a>.</li>
|
|
<li><strong>list_value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue" title="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue"><tt class="xref py py-class docutils literal"><span class="pre">PrimitiveValue</span></tt></a>) – List value of the constant element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">category</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.LIST" title="com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.LIST"><tt class="xref py py-attr docutils literal"><span class="pre">ConstantValue.Category.LIST</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category">
|
|
<em class="property">class </em><tt class="descname">Category</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ConstantValue.Category"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category" 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 <tt class="docutils literal"><span class="pre">ConstantValue.Category</span></tt> class defines class attributes for the valid
|
|
kinds of values.</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">Category</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.LIST">
|
|
<tt class="descname">LIST</tt><em class="property"> = Category(string='LIST')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.LIST" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the type of constant value is a list.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.PRIMITIVE">
|
|
<tt class="descname">PRIMITIVE</tt><em class="property"> = Category(string='PRIMITIVE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ConstantValue.Category.PRIMITIVE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the type of constant value is primitive.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementMap">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ElementMap</tt><big>(</big><em>elements=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ElementMap"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementMap" 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">ElementMap</span></tt> class contains the metadata elements.</p>
|
|
<p>One of the sources for metadata is the annotations present in the interface
|
|
definition language. When an annotation is represented in the
|
|
<tt class="docutils literal"><span class="pre">ElementMap</span></tt>, <tt class="docutils literal"><span class="pre">ElementMap</span></tt> describes the data specified in the
|
|
arguments for the annotation.</p>
|
|
<p>For example, in <tt class="docutils literal"><span class="pre">\\@UnionCase(tag="tag",</span> <span class="pre">value="SELECT")</span></tt>, ElementMap
|
|
describes the keyword arguments tag and value.</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>elements</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.metadata.metamodel_client.ElementValue" title="com.vmware.vapi.metadata.metamodel_client.ElementValue"><tt class="xref py py-class docutils literal"><span class="pre">ElementValue</span></tt></a>) – Metamodel information of the metadata elements. The key parameter
|
|
of the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier for the element and the
|
|
value corresponds to the element value.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementValue">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ElementValue</tt><big>(</big><em>type=None</em>, <em>long_value=None</em>, <em>string_value=None</em>, <em>list_value=None</em>, <em>structure_id=None</em>, <em>structure_ids=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ElementValue"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue" 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">ElementValue</span></tt> class describes the value of the metadata element.</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.metadata.metamodel_client.ElementValue.Type" title="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type"><tt class="xref py py-class docutils literal"><span class="pre">ElementValue.Type</span></tt></a>) – Type of the value.</li>
|
|
<li><strong>long_value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">long</span></tt>) – Long value of the metadata element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.LONG" title="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.LONG"><tt class="xref py py-attr docutils literal"><span class="pre">ElementValue.Type.LONG</span></tt></a>.</li>
|
|
<li><strong>string_value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – String value of the metadata element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING" title="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING"><tt class="xref py py-attr docutils literal"><span class="pre">ElementValue.Type.STRING</span></tt></a>.</li>
|
|
<li><strong>list_value</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>) – List of strings value of the metadata element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING_LIST" title="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING_LIST"><tt class="xref py py-attr docutils literal"><span class="pre">ElementValue.Type.STRING_LIST</span></tt></a>.</li>
|
|
<li><strong>structure_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the structure element.
|
|
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.structure</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.structure</span></tt>.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE" title="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE"><tt class="xref py py-attr docutils literal"><span class="pre">ElementValue.Type.STRUCTURE_REFERENCE</span></tt></a>.</li>
|
|
<li><strong>structure_ids</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>) – List of identifiers of the structure elements.
|
|
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.structure</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.structure</span></tt>.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE_LIST" title="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE_LIST"><tt class="xref py py-attr docutils literal"><span class="pre">ElementValue.Type.STRUCTURE_REFERENCE_LIST</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type">
|
|
<em class="property">class </em><tt class="descname">Type</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ElementValue.Type"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type" 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 <tt class="docutils literal"><span class="pre">ElementValue.Type</span></tt> class defines the valid types for values in
|
|
metadata elements.</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 <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.LONG">
|
|
<tt class="descname">LONG</tt><em class="property"> = Type(string='LONG')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.LONG" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the type of the value is a long (64 bit signed integer).</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING">
|
|
<tt class="descname">STRING</tt><em class="property"> = Type(string='STRING')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the type of the value is a string (a variable length sequence of
|
|
characters). The encoding is UTF-8.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING_LIST">
|
|
<tt class="descname">STRING_LIST</tt><em class="property"> = Type(string='STRING_LIST')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRING_LIST" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the type of the value is a list of strings.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE">
|
|
<tt class="descname">STRUCTURE_REFERENCE</tt><em class="property"> = Type(string='STRUCTURE_REFERENCE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the type of the value is an identifier for a structure element.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE_LIST">
|
|
<tt class="descname">STRUCTURE_REFERENCE_LIST</tt><em class="property"> = Type(string='STRUCTURE_REFERENCE_LIST')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ElementValue.Type.STRUCTURE_REFERENCE_LIST" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the type of the value is a list of identifiers for a structure
|
|
element.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Enumeration">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Enumeration</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Enumeration"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Enumeration" 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 <tt class="docutils literal"><span class="pre">Enumeration</span></tt> class provides methods to retrieve metamodel
|
|
information about an enumeration element in the interface definition
|
|
language.</p>
|
|
<blockquote>
|
|
<div>The <tt class="docutils literal"><span class="pre">Enumeration</span></tt> has a list of enumeration value elements.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Enumeration.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.enumeration'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Enumeration.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for enumeration.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Enumeration.get">
|
|
<tt class="descname">get</tt><big>(</big><em>enumeration_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Enumeration.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Enumeration.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the enumeration element corresponding to
|
|
<tt class="docutils literal"><span class="pre">enumeration_id</span></tt>.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.EnumerationInfo" title="com.vmware.vapi.metadata.metamodel_client.EnumerationInfo"><tt class="xref py py-class docutils literal"><span class="pre">EnumerationInfo</span></tt></a> contains the metamodel information about
|
|
the enumeration value element contained in the enumeration element.</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>enumeration_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the enumeration element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</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.metadata.metamodel_client.EnumerationInfo" title="com.vmware.vapi.metadata.metamodel_client.EnumerationInfo"><tt class="xref py py-class docutils literal"><span class="pre">EnumerationInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.EnumerationInfo" title="com.vmware.vapi.metadata.metamodel_client.EnumerationInfo"><tt class="xref py py-class docutils literal"><span class="pre">EnumerationInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">enumeration_id</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.html#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 enumeration element associated with <tt class="docutils literal"><span class="pre">enumeration_id</span></tt> is
|
|
not contained in any of the package elements, service elements and
|
|
structure elements.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Enumeration.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Enumeration.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Enumeration.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the enumeration elements that are contained
|
|
in all the package elements, service elements and structure elements.</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.metadata.metamodel_client.Enumeration.list" title="com.vmware.vapi.metadata.metamodel_client.Enumeration.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the enumeration elements.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.EnumerationInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">EnumerationInfo</tt><big>(</big><em>name=None</em>, <em>values=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#EnumerationInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.EnumerationInfo" 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">EnumerationInfo</span></tt> class contains the metamodel information of an
|
|
enumeration element.</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>) – Dot separated name of the enumeration element. The segments in the
|
|
name reflect the organization of the APIs. The format of each
|
|
segment is lower case with underscores. Each underscore represents
|
|
a word boundary. If there are acronyms in the word, the
|
|
capitalization is preserved. This format makes it easy to translate
|
|
the segment into a different naming convention.</li>
|
|
<li><strong>values</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.EnumerationValueInfo" title="com.vmware.vapi.metadata.metamodel_client.EnumerationValueInfo"><tt class="xref py py-class docutils literal"><span class="pre">EnumerationValueInfo</span></tt></a>) – Metamodel information of all the enumeration value elements
|
|
contained in this enumeration element. The order of the enumeration
|
|
value elements in the list is same as the order in which they are
|
|
defined in the interface definition file.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata elements for an enumeration element. The key in
|
|
the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value
|
|
is the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>English language documentation for an enumeration element. It can
|
|
contain HTML markup and Javadoc tags. The first sentence of the
|
|
enumeration documentation is a complete sentence that identifies
|
|
the enumeration by name and summarizes the purpose of the
|
|
enumeration. The documentation describes the context in which the
|
|
enumeration is used.</p>
|
|
<p>The documentation also contains references to the context in which
|
|
the enumeration is used. But if the enumeration is used in many
|
|
contexts, the references may not be present.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.EnumerationValueInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">EnumerationValueInfo</tt><big>(</big><em>value=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#EnumerationValueInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.EnumerationValueInfo" 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">EnumerationValueInfo</span></tt> class describes the class attribute in the
|
|
class.</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>value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Value in the enumerated type. All the characters in the string are
|
|
capitalized.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Additional metadata for enumeration value in the enumerated type.
|
|
The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element
|
|
and the value is the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for an enumeration value. It can
|
|
contain HTML markup and documentation tags (similar to Javadoc
|
|
tags). The first statement will be a noun or verb phrase that
|
|
describes the purpose of the enumeration value.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ErrorInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ErrorInfo</tt><big>(</big><em>structure_id=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ErrorInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ErrorInfo" 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">ErrorInfo</span></tt> class contains the metadata information about the error
|
|
elements contained in an operation element.</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>structure_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier for the structure element corresponding to the error
|
|
that is being reported by the operation.
|
|
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.structure</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.structure</span></tt>.</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The English language documentation for the service element. It can
|
|
contain HTML markup and Javadoc tags.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.FieldInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">FieldInfo</tt><big>(</big><em>name=None</em>, <em>type=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#FieldInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.FieldInfo" 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">FieldInfo</span></tt> class contains metamodel information of a field element
|
|
contained in a structure element.</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>) – Name of the field element in a canonical format. The format is
|
|
lower case with underscores. Each underscore represents a word
|
|
boundary. If there are acronyms in the word, the capitalization is
|
|
preserved. This format makes it easy to translate the segment into
|
|
a different naming convention.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a>) – Type information.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata elements for the field element. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value is
|
|
the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for the service element. It can
|
|
contain HTML markup and Javadoc tags.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">GenericInstantiation</tt><big>(</big><em>generic_type=None</em>, <em>element_type=None</em>, <em>map_key_type=None</em>, <em>map_value_type=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#GenericInstantiation"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation" 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">GenericInstantiation</span></tt> class describes the type information of a
|
|
typed element when the type is an instantiation of one of the generic types
|
|
provided by the infrastructure.</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>generic_type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType"><tt class="xref py py-class docutils literal"><span class="pre">GenericInstantiation.GenericType</span></tt></a>) – The generic type that is being instantiated.</li>
|
|
<li><strong>element_type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a>) – Type of the element parameter if the generic type instantiation is
|
|
a <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.LIST" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.LIST"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.LIST</span></tt></a>,
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.OPTIONAL" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.OPTIONAL"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.OPTIONAL</span></tt></a> or
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.SET" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.SET"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.SET</span></tt></a>.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">genericType</span></tt> is one of
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.LIST" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.LIST"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.LIST</span></tt></a>,
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.OPTIONAL" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.OPTIONAL"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.OPTIONAL</span></tt></a>, or
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.SET" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.SET"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.SET</span></tt></a>.</li>
|
|
<li><strong>map_key_type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a>) – Type of the key parameter of the map generic type instantiation.
|
|
The map generic type has a key parameter and value parameter. The
|
|
type of the value parameter is described by
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.map_value_type</span></tt>..
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">genericType</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.MAP" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.MAP"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.MAP</span></tt></a>.</li>
|
|
<li><strong>map_value_type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a>) – Type of the value parameter of the map generic type instantiation.
|
|
The map generic type has a key parameter and value parameter. The
|
|
type of the key parameter is described by
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.map_key_type</span></tt>..
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">genericType</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.MAP" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.MAP"><tt class="xref py py-attr docutils literal"><span class="pre">GenericInstantiation.GenericType.MAP</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType">
|
|
<em class="property">class </em><tt class="descname">GenericType</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#GenericInstantiation.GenericType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType" 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 <tt class="docutils literal"><span class="pre">GenericInstantiation.GenericType</span></tt> class provides class attributes
|
|
for each of the generic types provided by the 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">GenericType</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.LIST">
|
|
<tt class="descname">LIST</tt><em class="property"> = GenericType(string='LIST')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.LIST" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the generic type is a list.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.MAP">
|
|
<tt class="descname">MAP</tt><em class="property"> = GenericType(string='MAP')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.MAP" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the generic type is a map.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.OPTIONAL">
|
|
<tt class="descname">OPTIONAL</tt><em class="property"> = GenericType(string='OPTIONAL')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.OPTIONAL" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the generic type is an optional.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.SET">
|
|
<tt class="descname">SET</tt><em class="property"> = GenericType(string='SET')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation.GenericType.SET" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the generic type is a set.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">MetadataIdentifier</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#MetadataIdentifier"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" 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 <tt class="docutils literal"><span class="pre">MetadataIdentifier</span></tt> class provides string constants that can be used
|
|
as identifiers for the metadata elements.</p>
|
|
<p>Most of the types in <a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a>
|
|
package has a metadata field whose type is <tt class="docutils literal"><span class="pre">Map<String,</span> <span class="pre">ElementMap></span></tt>.
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains the identifiers used in the keys of
|
|
the above Map type.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.CANONICAL_NAME">
|
|
<tt class="descname">CANONICAL_NAME</tt><em class="property"> = 'CanonicalName'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.CANONICAL_NAME" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the CanonicalName metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.COMPONENT">
|
|
<tt class="descname">COMPONENT</tt><em class="property"> = 'Component'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.COMPONENT" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Component metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.CREATE">
|
|
<tt class="descname">CREATE</tt><em class="property"> = 'Create'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.CREATE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Create metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.CRUD">
|
|
<tt class="descname">CRUD</tt><em class="property"> = 'Crud'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.CRUD" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Crud metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.HAS_FIELDS_OF">
|
|
<tt class="descname">HAS_FIELDS_OF</tt><em class="property"> = 'HasFieldsOf'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.HAS_FIELDS_OF" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the HasFieldsOf metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.INCLUDABLE">
|
|
<tt class="descname">INCLUDABLE</tt><em class="property"> = 'Includable'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.INCLUDABLE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Includable metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.INCLUDE">
|
|
<tt class="descname">INCLUDE</tt><em class="property"> = 'Include'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.INCLUDE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Include metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.IS_ONE_OF">
|
|
<tt class="descname">IS_ONE_OF</tt><em class="property"> = 'IsOneOf'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.IS_ONE_OF" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the IsOneOf metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.MODEL">
|
|
<tt class="descname">MODEL</tt><em class="property"> = 'Model'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.MODEL" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Model metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.READ">
|
|
<tt class="descname">READ</tt><em class="property"> = 'Read'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.READ" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Read metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.RESOURCE">
|
|
<tt class="descname">RESOURCE</tt><em class="property"> = 'Resource'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.RESOURCE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Resource metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.UNION_CASE">
|
|
<tt class="descname">UNION_CASE</tt><em class="property"> = 'UnionCase'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.UNION_CASE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the UnionCase metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.UNION_TAG">
|
|
<tt class="descname">UNION_TAG</tt><em class="property"> = 'UnionTag'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.UNION_TAG" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the UnionTag metadata.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.UPDATE">
|
|
<tt class="descname">UPDATE</tt><em class="property"> = 'Update'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier.UPDATE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Identifier representing the Update metadata.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.OperationInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">OperationInfo</tt><big>(</big><em>name=None</em>, <em>params=None</em>, <em>output=None</em>, <em>errors=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#OperationInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.OperationInfo" 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">OperationInfo</span></tt> class contains metamodel information of an operation
|
|
element.</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>) – Name of the operation element in a canonical format. The format is
|
|
lower case with underscores. Each underscore represents a word
|
|
boundary. If there are acronyms in the word, the capitalization is
|
|
preserved. This format makes it easy to translate the segment into
|
|
a different naming convention.</li>
|
|
<li><strong>params</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.FieldInfo" title="com.vmware.vapi.metadata.metamodel_client.FieldInfo"><tt class="xref py py-class docutils literal"><span class="pre">FieldInfo</span></tt></a>) – Metamodel information for the parameter elements. The order of the
|
|
parameters elements in the list is same as the order of the
|
|
parameters declared in the interface definition file.</li>
|
|
<li><strong>output</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.OperationResultInfo" title="com.vmware.vapi.metadata.metamodel_client.OperationResultInfo"><tt class="xref py py-class docutils literal"><span class="pre">OperationResultInfo</span></tt></a>) – Metamodel type for the output element.</li>
|
|
<li><strong>errors</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ErrorInfo" title="com.vmware.vapi.metadata.metamodel_client.ErrorInfo"><tt class="xref py py-class docutils literal"><span class="pre">ErrorInfo</span></tt></a>) – List of error elements that might be reported by the operation
|
|
element. If the operation reports the same error for more than one
|
|
reason, the list contains the error element associated with the
|
|
error more than once with different documentation elements.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata elements for the operation element. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value is
|
|
the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for the service element. It can
|
|
contain HTML markup and Javadoc tags.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.OperationResultInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">OperationResultInfo</tt><big>(</big><em>type=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#OperationResultInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.OperationResultInfo" 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">OperationResultInfo</span></tt> class contains the metamodel information of an
|
|
operation result element.</p>
|
|
<p>An operation accepts a list of parameters and returns a result or an error.
|
|
The <tt class="docutils literal"><span class="pre">OperationResultInfo</span></tt> describes the result element of an 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>type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a>) – Type information of the operation result element.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata elements for the service element. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value is
|
|
the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for the operation result element. It
|
|
can contain HTML markup and Javadoc tags.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Package">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Package</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Package"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Package" 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 <tt class="docutils literal"><span class="pre">Package</span></tt> class provides methods to retrieve metamodel information
|
|
about a package element in the interface definition language.</p>
|
|
<p>A package is a logical grouping of services, structures and enumerations. A
|
|
package element describes the package. It contains the service elements,
|
|
structure elements and enumeration elements that are grouped together.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Package.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.package'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Package.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for package.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Package.get">
|
|
<tt class="descname">get</tt><big>(</big><em>package_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Package.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Package.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the package element corresponding to
|
|
<tt class="docutils literal"><span class="pre">packagetId</span></tt>.</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>package_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the package element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</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.metadata.metamodel_client.PackageInfo" title="com.vmware.vapi.metadata.metamodel_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.PackageInfo" title="com.vmware.vapi.metadata.metamodel_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">package_id</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.html#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 package element associated with <tt class="docutils literal"><span class="pre">package_id</span></tt> does not
|
|
exist.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Package.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Package.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Package.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the packages elements that are contained in
|
|
all the registered component elements.</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.metadata.metamodel_client.Package.list" title="com.vmware.vapi.metadata.metamodel_client.Package.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the package elements that are contained
|
|
in all the registered component elements.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.PackageInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">PackageInfo</tt><big>(</big><em>name=None</em>, <em>structures=None</em>, <em>enumerations=None</em>, <em>services=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#PackageInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.PackageInfo" 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">PackageInfo</span></tt> class contains the metamodel information of all the
|
|
service elements, structure elements and enumeration elements contained in
|
|
the package element.</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>) – Dot separated name of the package element. The segments in the name
|
|
reflect the organization of the APIs. The format of each segment is
|
|
lower case with underscores. Each underscore represents a word
|
|
boundary. If there are acronyms in the word, the capitalization is
|
|
preserved. This format makes it easy to translate the segment into
|
|
a different naming convention.</li>
|
|
<li><strong>structures</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.metadata.metamodel_client.StructureInfo" title="com.vmware.vapi.metadata.metamodel_client.StructureInfo"><tt class="xref py py-class docutils literal"><span class="pre">StructureInfo</span></tt></a>) – <p>Metamodel information of all the structure elements contained in
|
|
the package element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier
|
|
of the structure element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the
|
|
metamodel information for the structure element.</p>
|
|
<p>This does not include the structure elements contained in the
|
|
service elements that are contained in this package element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt>.</p>
|
|
</li>
|
|
<li><strong>enumerations</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.metadata.metamodel_client.EnumerationInfo" title="com.vmware.vapi.metadata.metamodel_client.EnumerationInfo"><tt class="xref py py-class docutils literal"><span class="pre">EnumerationInfo</span></tt></a>) – <p>Metamodel information of all the enumeration elements contained in
|
|
the package element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier
|
|
of the enumeration element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is
|
|
the metamodel information for the enumeration element.</p>
|
|
<p>This does not include the enumeration elements that are contained
|
|
in the service elements of this package element or structure
|
|
elements of this package element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>. When methods return a value
|
|
of this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>.</p>
|
|
</li>
|
|
<li><strong>services</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.metadata.metamodel_client.ServiceInfo" title="com.vmware.vapi.metadata.metamodel_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a>) – Metamodel information of all the service elements contained in the
|
|
package element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier of
|
|
the service element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the
|
|
metamodel information for the service element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata elements for the package element. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value is
|
|
the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>English language documentation for a package. It can contain HTML
|
|
markup and Javadoc tags. The first sentence of the package
|
|
documentation is a complete sentence that identifies the package by
|
|
name and summarizes the purpose of the package.</p>
|
|
<p>The primary purpose of a package documentation is to provide
|
|
high-level context that will provide a framework in which the users
|
|
can put the detail about the package contents.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">PrimitiveValue</tt><big>(</big><em>type=None</em>, <em>boolean_value=None</em>, <em>double_value=None</em>, <em>long_value=None</em>, <em>string_value=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#PrimitiveValue"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue" 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">PrimitiveValue</span></tt> class contains value of the constant element.</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.metadata.metamodel_client.PrimitiveValue.Type" title="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type"><tt class="xref py py-class docutils literal"><span class="pre">PrimitiveValue.Type</span></tt></a>) – Type of the constant value.</li>
|
|
<li><strong>boolean_value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">bool</span></tt>) – Boolean value of the constant.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.BOOLEAN" title="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.BOOLEAN"><tt class="xref py py-attr docutils literal"><span class="pre">PrimitiveValue.Type.BOOLEAN</span></tt></a>.</li>
|
|
<li><strong>double_value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">float</span></tt>) – Double value of the constant.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.DOUBLE" title="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.DOUBLE"><tt class="xref py py-attr docutils literal"><span class="pre">PrimitiveValue.Type.DOUBLE</span></tt></a>.</li>
|
|
<li><strong>long_value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">long</span></tt>) – Long value of the constant.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.LONG" title="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.LONG"><tt class="xref py py-attr docutils literal"><span class="pre">PrimitiveValue.Type.LONG</span></tt></a>.</li>
|
|
<li><strong>string_value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – String value of the constant.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.STRING" title="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.STRING"><tt class="xref py py-attr docutils literal"><span class="pre">PrimitiveValue.Type.STRING</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type">
|
|
<em class="property">class </em><tt class="descname">Type</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#PrimitiveValue.Type"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type" 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 <tt class="docutils literal"><span class="pre">PrimitiveValue.Type</span></tt> class defines the valid types for values in
|
|
constant elements.</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 <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.BOOLEAN">
|
|
<tt class="descname">BOOLEAN</tt><em class="property"> = Type(string='BOOLEAN')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.BOOLEAN" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a boolean (true or false).</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.DOUBLE">
|
|
<tt class="descname">DOUBLE</tt><em class="property"> = Type(string='DOUBLE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.DOUBLE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a double (64 bit floating number).</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.LONG">
|
|
<tt class="descname">LONG</tt><em class="property"> = Type(string='LONG')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.LONG" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a long (64 bit signed integer).</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.STRING">
|
|
<tt class="descname">STRING</tt><em class="property"> = Type(string='STRING')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.PrimitiveValue.Type.STRING" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Indicates the value is a string (a variable length sequence of characters).
|
|
The encoding is UTF8.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Resource">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Resource</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Resource"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Resource" 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.metadata.metamodel_client.Resource" title="com.vmware.vapi.metadata.metamodel_client.Resource"><tt class="xref py py-class docutils literal"><span class="pre">Resource</span></tt></a> class provides methods to retrieve information about
|
|
resource types.</p>
|
|
<p>A service is a logical grouping of operations that operate on an entity.
|
|
Each entity is identifier by a namespace (or resource type) and an unique
|
|
identifier.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Resource.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.resource'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Resource.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for resource.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Resource.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Resource.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Resource.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the set of resource types present across all the service
|
|
elements contained in all the package elements.</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 resource types
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.resource</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Service">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Service</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_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 <tt class="docutils literal"><span class="pre">Service</span></tt> class provides methods to retrieve metamodel information
|
|
about a service element in the interface definition language.</p>
|
|
<p>A service is a logical grouping of operations that operate on some entity.
|
|
A service element describes a service. It contains operation elements that
|
|
describe the operations grouped in the service. It also contains structure
|
|
elements and enumeration elements corresponding to the structures and
|
|
enumerations defined in the 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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Service.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.service'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Service.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for service.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Service.get">
|
|
<tt class="descname">get</tt><big>(</big><em>service_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Service.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Service.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the service element corresponding to
|
|
<tt class="docutils literal"><span class="pre">service_id</span></tt>.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ServiceInfo" title="com.vmware.vapi.metadata.metamodel_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a> contains the metamodel information for the
|
|
operation elements, structure elements and enumeration elements
|
|
contained in the service element.</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>) – Identifier of the service element.
|
|
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.metadata.metamodel_client.ServiceInfo" title="com.vmware.vapi.metadata.metamodel_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.ServiceInfo" title="com.vmware.vapi.metadata.metamodel_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">service_id</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.html#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 element associated with <tt class="docutils literal"><span class="pre">service_id</span></tt> is not
|
|
registered with the infrastructure.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Service.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Service.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Service.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the service elements that are currently
|
|
registered with the infrastructure.</p>
|
|
<p>The list of service elements is an aggregate list of all the service
|
|
elements contained in all the package elements.</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.metadata.metamodel_client.Service.list" title="com.vmware.vapi.metadata.metamodel_client.Service.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the service elements that are currently
|
|
registered with the infrastructure.
|
|
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>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.ServiceInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">ServiceInfo</tt><big>(</big><em>name=None</em>, <em>operations=None</em>, <em>structures=None</em>, <em>enumerations=None</em>, <em>constants=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#ServiceInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.ServiceInfo" 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">ServiceInfo</span></tt> class contains the metamodel information of all the
|
|
operation elements, structure elements and enumeration elements containted
|
|
in a service element.</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>) – Dot separated name of the service element. The segments in the name
|
|
reflect the organization of the APIs. The format of each segment is
|
|
lower case with underscores. Each underscore represents a word
|
|
boundary. If there are acronyms in the word, the capitalization is
|
|
preserved. This format makes it easy to translate the segment into
|
|
a different naming convention.</li>
|
|
<li><strong>operations</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.metadata.metamodel_client.OperationInfo" title="com.vmware.vapi.metadata.metamodel_client.OperationInfo"><tt class="xref py py-class docutils literal"><span class="pre">OperationInfo</span></tt></a>) – Metamodel information of all the operation elements contained in
|
|
the service element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier
|
|
of the operation element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the
|
|
metamodel information for the operation element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier 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 key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.operation</span></tt>.</li>
|
|
<li><strong>structures</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.metadata.metamodel_client.StructureInfo" title="com.vmware.vapi.metadata.metamodel_client.StructureInfo"><tt class="xref py py-class docutils literal"><span class="pre">StructureInfo</span></tt></a>) – Metamodel information of all the structure elements contained in
|
|
the service element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier
|
|
of the structure element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the
|
|
metamodel information for the structure element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt>.</li>
|
|
<li><strong>enumerations</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.metadata.metamodel_client.EnumerationInfo" title="com.vmware.vapi.metadata.metamodel_client.EnumerationInfo"><tt class="xref py py-class docutils literal"><span class="pre">EnumerationInfo</span></tt></a>) – Metamodel information of all the enumeration elements contained in
|
|
the service element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier
|
|
of the enumeration element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is
|
|
the metamodel information for the enumeration element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>. When methods return a value
|
|
of this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>.</li>
|
|
<li><strong>constants</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.metadata.metamodel_client.ConstantInfo" title="com.vmware.vapi.metadata.metamodel_client.ConstantInfo"><tt class="xref py py-class docutils literal"><span class="pre">ConstantInfo</span></tt></a>) – Metamodel information of all the constant elements contained in the
|
|
service element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the
|
|
constant element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the
|
|
metamodel information for the contant element.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata elements for the service element. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value is
|
|
the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for the service element. It can
|
|
contain HTML markup and Javadoc tags. The first sentence of the
|
|
service documentation is a complete sentence that identifies the
|
|
service by name and summarizes the purpose of the service. The
|
|
remaining part of the documentation provides a summary of how to
|
|
use the operations defined in the service.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Source</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source" 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 <tt class="docutils literal"><span class="pre">Source</span></tt> class provides methods to manage the sources of metamodel
|
|
metadata information.</p>
|
|
<p>The interface definition language infrastructure provides tools to generate
|
|
various kinds of metadata in JSON format from the interface definition
|
|
files and additional properties files. One of the generated files contains
|
|
metamodel information. The generated file can be registered as a source of
|
|
metadata.</p>
|
|
<p>The metamodel file contains all the data present in the interface
|
|
definition files. Each metamodel file contains data about one component
|
|
element. When a metamodel file is added as a source, each source
|
|
contributes only one component element’s metadata.</p>
|
|
<p>Metamodel metadata can also be discovered from a remote server that
|
|
supports the metamodel metadata classes (see
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a>). Since multiple
|
|
components can be registered with a single metadata server, when a remote
|
|
server is registered as a source, that source can contribute more than one
|
|
component.</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.metadata.metamodel_client.Source.CreateSpec">
|
|
<em class="property">class </em><tt class="descname">CreateSpec</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.CreateSpec"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.CreateSpec" 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">Source.CreateSpec</span></tt> class contains the registration information of a
|
|
metamodel source.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – Type of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the metamodel metadata file that has the
|
|
metamodel information about one component element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.FILE" title="com.vmware.vapi.metadata_client.SourceType.FILE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.FILE</span></tt></a>.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information of the remote server. This should be of the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server should contain the classes in
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a> module. It could
|
|
expose metamodel information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.REMOTE" title="com.vmware.vapi.metadata_client.SourceType.REMOTE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.REMOTE</span></tt></a>.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.Info">
|
|
<em class="property">class </em><tt class="descclassname">Source.</tt><tt class="descname">Info</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.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>The <tt class="docutils literal"><span class="pre">Source.Info</span></tt> class contains the metadata source information.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – Type of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the metamodel metadata file that has the
|
|
metamodel information about one component element. The <tt class="docutils literal"><span class="pre">filePath</span></tt>
|
|
is the path to the file in the server’s filesystem.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information for the remote server. This must be in the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server must support the classes in the
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a> module. It must
|
|
expose metamodel information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.RESOURCE_TYPE">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.metadata.metamodel.source'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for metadata source.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.create">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">create</tt><big>(</big><em>source_id</em>, <em>spec</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.create"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.create" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Creates a new metadata source. Once the server validates the
|
|
registration information of the metadata source, the metamodel metadata
|
|
is retrieved from the source. This populates elements in all the
|
|
classes defined in <a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a>
|
|
module.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – metadata source identifier.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel.source</span></tt>.</li>
|
|
<li><strong>spec</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Source.CreateSpec" title="com.vmware.vapi.metadata.metamodel_client.Source.CreateSpec"><tt class="xref py py-class docutils literal"><span class="pre">Source.CreateSpec</span></tt></a>) – create specification.</li>
|
|
</ul>
|
|
</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.html#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">com.vmware.vapi.std.errors_client.AlreadyExists</span></tt></a>
|
|
if the metadata source identifier is already registered with the
|
|
infrastructure.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the type of the source specified in null is invalid.</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.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the file specified in null is not a valid JSON file or if the
|
|
format of the metamodel metadata in the JSON file is invalid.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the URI specified in null is unreachable or if there is a
|
|
transport protocol or message protocol mismatch between the client
|
|
and the server or if the remote server do not have classes present
|
|
in <a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a> module.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><p class="first last"><a class="reference internal" href="com.vmware.vapi.std.html#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 file specified in null does not exist.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.delete">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">delete</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.delete"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.delete" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Deletes an existing metamodel metadata source from the infrastructure.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel.source</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.fingerprint">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">fingerprint</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the aggregate fingerprint of metadata from all the metadata
|
|
sources or from a particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is
|
|
specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel.source</span></tt>.
|
|
If unspecified, the fingerprint of all the metadata sources is
|
|
returned.</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Aggregate fingerprint of all the metadata sources or of a
|
|
particular metadata source.</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.get">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">get</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the metadata source corresponding to
|
|
<tt class="docutils literal"><span class="pre">source_id</span></tt>.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel.source</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.metadata.metamodel_client.Source.Info" title="com.vmware.vapi.metadata.metamodel_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Source.Info" title="com.vmware.vapi.metadata.metamodel_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a> instance that corresponds to <tt class="docutils literal"><span class="pre">source_id</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.list">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers of the metadata sources currently registered
|
|
with the infrastructure.</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.metadata.metamodel_client.Source.list" title="com.vmware.vapi.metadata.metamodel_client.Source.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for metadata sources currently registered.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel.source</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Source.reload">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">reload</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Source.reload"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Source.reload" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Reloads the metamodel metadata from all the metadata sources or of a
|
|
particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel.source</span></tt>.
|
|
If unspecified, all the metadata sources are reloaded.</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Structure">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Structure</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Structure"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Structure" 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 <tt class="docutils literal"><span class="pre">Structure</span></tt> class providers methods to retrieve metamodel information
|
|
about a structure element in the interface definition language.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Structure.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.structure'</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Structure.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for structure.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Structure.get">
|
|
<tt class="descname">get</tt><big>(</big><em>structure_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Structure.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Structure.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the structure element corresponding to
|
|
<tt class="docutils literal"><span class="pre">structure_id</span></tt>.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.StructureInfo" title="com.vmware.vapi.metadata.metamodel_client.StructureInfo"><tt class="xref py py-class docutils literal"><span class="pre">StructureInfo</span></tt></a> contains the metamodel information about the
|
|
structure element. It contains information about all the field elements
|
|
and enumeration elements contained in this structure element.</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>structure_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the structure element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</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.metadata.metamodel_client.StructureInfo" title="com.vmware.vapi.metadata.metamodel_client.StructureInfo"><tt class="xref py py-class docutils literal"><span class="pre">StructureInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.StructureInfo" title="com.vmware.vapi.metadata.metamodel_client.StructureInfo"><tt class="xref py py-class docutils literal"><span class="pre">StructureInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">structure_id</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.html#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 structure element associated with <tt class="docutils literal"><span class="pre">structure_id</span></tt> is not
|
|
contained in any of the package elements or service elements.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Structure.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Structure.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Structure.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the structure elements that are contained
|
|
in all the package elements and service elements.</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.metadata.metamodel_client.Structure.list" title="com.vmware.vapi.metadata.metamodel_client.Structure.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the structure elements.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.StructureInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">StructureInfo</tt><big>(</big><em>name=None</em>, <em>type=None</em>, <em>enumerations=None</em>, <em>constants=None</em>, <em>fields=None</em>, <em>metadata=None</em>, <em>documentation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#StructureInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.StructureInfo" 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">StructureInfo</span></tt> class contains the metamodel information of all the
|
|
field elements, constant elements and enumeration elements contained in the
|
|
structure element.</p>
|
|
<p>In the interface definition language, API designers have the ability to
|
|
include all the fields from one structure to another structure. This is
|
|
done by using an annotation <tt class="docutils literal"><span class="pre">\\@Include</span></tt> on the structure in which we
|
|
want to add the fields. If this annotation is present, the list of fields
|
|
in the <tt class="docutils literal"><span class="pre">StructureInfo</span></tt> will also contain the fields that are being
|
|
included. The annotation information is also retained in the
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">StructureInfo.metadata</span></tt> element as well.</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>) – Dot separated name of the structure element. The segments in the
|
|
name reflect the organization of the APIs. The format of each
|
|
segment is lower case with underscores. Each underscore represents
|
|
a word boundary. If there are acronyms in the word, the
|
|
capitalization is preserved. This format makes it easy to translate
|
|
the segment into a different naming convention.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type" title="com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type"><tt class="xref py py-class docutils literal"><span class="pre">StructureInfo.Type</span></tt></a>) – Type of the structure.</li>
|
|
<li><strong>enumerations</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.metadata.metamodel_client.EnumerationInfo" title="com.vmware.vapi.metadata.metamodel_client.EnumerationInfo"><tt class="xref py py-class docutils literal"><span class="pre">EnumerationInfo</span></tt></a>) – Metamodel information of all the enumeration elements contained in
|
|
the structure element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the
|
|
identifier of the enumeration element and the value is the
|
|
metamodel information of the enumeration element.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>. When methods return a value
|
|
of this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>.</li>
|
|
<li><strong>constants</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.metadata.metamodel_client.ConstantInfo" title="com.vmware.vapi.metadata.metamodel_client.ConstantInfo"><tt class="xref py py-class docutils literal"><span class="pre">ConstantInfo</span></tt></a>) – Metamodel information of all the constant elements contained in the
|
|
structure element. The key in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the
|
|
constant element and the value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the
|
|
metamodel information for the constant element.</li>
|
|
<li><strong>fields</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.FieldInfo" title="com.vmware.vapi.metadata.metamodel_client.FieldInfo"><tt class="xref py py-class docutils literal"><span class="pre">FieldInfo</span></tt></a>) – Metamodel information of all the field elements. The order of the
|
|
field elements in the list matches the order in which the fields
|
|
are defined in the service.</li>
|
|
<li><strong>metadata</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.metadata.metamodel_client.ElementMap" title="com.vmware.vapi.metadata.metamodel_client.ElementMap"><tt class="xref py py-class docutils literal"><span class="pre">ElementMap</span></tt></a>) – <p>Generic metadata elements for the structure element. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the name of the metadata element and the value is
|
|
the data associated with that metadata element.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier" title="com.vmware.vapi.metadata.metamodel_client.MetadataIdentifier"><tt class="xref py py-class docutils literal"><span class="pre">MetadataIdentifier</span></tt></a> contains possible string values for
|
|
keys in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>.</p>
|
|
</li>
|
|
<li><strong>documentation</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language documentation for a structure element. It can
|
|
contain HTML markup and Javadoc tags. The first sentence of the
|
|
structure documentation is a complete sentence that identifies the
|
|
structure by name and summarizes the purpose of the structure.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type">
|
|
<em class="property">class </em><tt class="descname">Type</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#StructureInfo.Type"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type" 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 <tt class="docutils literal"><span class="pre">StructureInfo.Type</span></tt> class defines the kind of this structure
|
|
element. In the interface definition language, structure element and error
|
|
element have similar characteristics. The difference is that only error
|
|
elements can be used to describe the exceptions of an operation element.</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 <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type" title="com.vmware.vapi.metadata.metamodel_client.Type"><tt class="xref py py-class docutils literal"><span class="pre">Type</span></tt></a> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type.ERROR">
|
|
<tt class="descname">ERROR</tt><em class="property"> = Type(string='ERROR')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type.ERROR" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>If the type is an error element.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type.STRUCTURE">
|
|
<tt class="descname">STRUCTURE</tt><em class="property"> = Type(string='STRUCTURE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.StructureInfo.Type.STRUCTURE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>If the type is a structure element.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">Type</tt><big>(</big><em>category=None</em>, <em>builtin_type=None</em>, <em>user_defined_type=None</em>, <em>generic_instantiation=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Type"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type" 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">Type</span></tt> class describes the type information of a typed element in the
|
|
interface definiton language. The following elements in the metamodel are
|
|
typed:</p>
|
|
<ul class="simple">
|
|
<li>Field element in a structure element. See <tt class="xref py py-attr docutils literal"><span class="pre">StructureInfo.fields</span></tt></li>
|
|
<li>Parameter element in an operation element. See
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">OperationInfo.params</span></tt></li>
|
|
<li>Result element in an operation element. See <tt class="xref py py-attr docutils literal"><span class="pre">OperationInfo.output</span></tt></li>
|
|
</ul>
|
|
<blockquote>
|
|
<div>The type could be one of the three following categories:</div></blockquote>
|
|
<ul class="simple">
|
|
<li>Built-in types: These are types present in the interface definition
|
|
language type system. They are provided by the infrastructure.</li>
|
|
<li>User defined named type: API designers can create custom types and use
|
|
them for the typed elements. These types have a unique identifier.</li>
|
|
<li>Generic type instantiation: The language infrastructure also provides
|
|
generic types such as list, map, set and so on. An instantiation of one of
|
|
these generic types could also be used for the typed elements.</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>category</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category" title="com.vmware.vapi.metadata.metamodel_client.Type.Category"><tt class="xref py py-class docutils literal"><span class="pre">Type.Category</span></tt></a>) – Category of this type.</li>
|
|
<li><strong>builtin_type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType" title="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType"><tt class="xref py py-class docutils literal"><span class="pre">Type.BuiltinType</span></tt></a>) – Category of the built-in type.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">category</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category.BUILTIN" title="com.vmware.vapi.metadata.metamodel_client.Type.Category.BUILTIN"><tt class="xref py py-attr docutils literal"><span class="pre">Type.Category.BUILTIN</span></tt></a>.</li>
|
|
<li><strong>user_defined_type</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.UserDefinedType" title="com.vmware.vapi.metadata.metamodel_client.UserDefinedType"><tt class="xref py py-class docutils literal"><span class="pre">UserDefinedType</span></tt></a>) – Identifier and type of the user defined type.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">category</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category.USER_DEFINED" title="com.vmware.vapi.metadata.metamodel_client.Type.Category.USER_DEFINED"><tt class="xref py py-attr docutils literal"><span class="pre">Type.Category.USER_DEFINED</span></tt></a>.</li>
|
|
<li><strong>generic_instantiation</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.GenericInstantiation" title="com.vmware.vapi.metadata.metamodel_client.GenericInstantiation"><tt class="xref py py-class docutils literal"><span class="pre">GenericInstantiation</span></tt></a>) – Instantiation of one of the generic types available in the
|
|
interface definition language.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">category</span></tt> is <a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category.GENERIC" title="com.vmware.vapi.metadata.metamodel_client.Type.Category.GENERIC"><tt class="xref py py-attr docutils literal"><span class="pre">Type.Category.GENERIC</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType">
|
|
<em class="property">class </em><tt class="descname">BuiltinType</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Type.BuiltinType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType" 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 <tt class="docutils literal"><span class="pre">Type.BuiltinType</span></tt> class provides class attribute for each of the
|
|
built-in types present in the interface definition language type system.</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">BuiltinType</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.ANY_ERROR">
|
|
<tt class="descname">ANY_ERROR</tt><em class="property"> = BuiltinType(string='ANY_ERROR')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.ANY_ERROR" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is an arbitrary exception type. This is used if the value
|
|
of a typed element can be one of any user defined named type which is an
|
|
exception.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.BINARY">
|
|
<tt class="descname">BINARY</tt><em class="property"> = BuiltinType(string='BINARY')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.BINARY" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a binary. The value is a variable-length sequence of
|
|
zero or more bytes.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.BOOLEAN">
|
|
<tt class="descname">BOOLEAN</tt><em class="property"> = BuiltinType(string='BOOLEAN')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.BOOLEAN" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a boolean. The value is true or false.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.DATE_TIME">
|
|
<tt class="descname">DATE_TIME</tt><em class="property"> = BuiltinType(string='DATE_TIME')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.DATE_TIME" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a datetime. The value should be in the UTC timezone
|
|
and the precision is milliseconds.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.DOUBLE">
|
|
<tt class="descname">DOUBLE</tt><em class="property"> = BuiltinType(string='DOUBLE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.DOUBLE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a double. The value is a 64 bit floating point number.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.DYNAMIC_STRUCTURE">
|
|
<tt class="descname">DYNAMIC_STRUCTURE</tt><em class="property"> = BuiltinType(string='DYNAMIC_STRUCTURE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.DYNAMIC_STRUCTURE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a dynamic structure. This is used if the value of a
|
|
typed element can be one of any user defined named type.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.ID">
|
|
<tt class="descname">ID</tt><em class="property"> = BuiltinType(string='ID')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.ID" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is an ID. The value represents an identifier for a
|
|
resource.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.LONG">
|
|
<tt class="descname">LONG</tt><em class="property"> = BuiltinType(string='LONG')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.LONG" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a long. The value is a 64 bit signed integer.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.OPAQUE">
|
|
<tt class="descname">OPAQUE</tt><em class="property"> = BuiltinType(string='OPAQUE')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.OPAQUE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is an opaque. This is used if the value of a typed
|
|
element could be of any type and the actual type will be known only during
|
|
the execution of the API. This is mostly used in infrastructure classes.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.SECRET">
|
|
<tt class="descname">SECRET</tt><em class="property"> = BuiltinType(string='SECRET')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.SECRET" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a secret. The value is a variable-length sequence of
|
|
zero or more unicode characters. The value contains sensitive data that
|
|
should not be printed or displayed anywhere.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.STRING">
|
|
<tt class="descname">STRING</tt><em class="property"> = BuiltinType(string='STRING')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.STRING" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a string. The value is a variable-length sequence of
|
|
zero or more unicode characters.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.URI">
|
|
<tt class="descname">URI</tt><em class="property"> = BuiltinType(string='URI')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.URI" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is an URI. The value follows the IRI specification in RFC
|
|
3987.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.VOID">
|
|
<tt class="descname">VOID</tt><em class="property"> = BuiltinType(string='VOID')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType.VOID" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The built-in type is a void. The value is None.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.Category">
|
|
<em class="property">class </em><tt class="descclassname">Type.</tt><tt class="descname">Category</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#Type.Category"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category" 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 <tt class="docutils literal"><span class="pre">Type.Category</span></tt> class provides class attribute for each category of
|
|
the type.</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">Category</span></tt> instance.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.Category.BUILTIN">
|
|
<tt class="descname">BUILTIN</tt><em class="property"> = Category(string='BUILTIN')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category.BUILTIN" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The type is one of the built-in types specified in
|
|
<a class="reference internal" href="#com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType" title="com.vmware.vapi.metadata.metamodel_client.Type.BuiltinType"><tt class="xref py py-class docutils literal"><span class="pre">Type.BuiltinType</span></tt></a></p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.Category.GENERIC">
|
|
<tt class="descname">GENERIC</tt><em class="property"> = Category(string='GENERIC')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category.GENERIC" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The type is an instantiation of one of the generic types.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.Type.Category.USER_DEFINED">
|
|
<tt class="descname">USER_DEFINED</tt><em class="property"> = Category(string='USER_DEFINED')</em><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.Type.Category.USER_DEFINED" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>The type is one of the user defined named types.</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.metamodel_client.UserDefinedType">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.metamodel_client.</tt><tt class="descname">UserDefinedType</tt><big>(</big><em>resource_type=None</em>, <em>resource_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/metamodel_client.html#UserDefinedType"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.metamodel_client.UserDefinedType" 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">UserDefinedType</span></tt> class contains the metamodel type information of a
|
|
typed element whose type is a user defined named 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>resource_type</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Category of the user defined named type. The named type could be a
|
|
structure element or an enumeration element.
|
|
When clients pass a value of this class as a parameter, the
|
|
attribute must be one of <tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt> or
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>. When methods return a value of
|
|
this class as a return value, the attribute will be one of
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt> or <tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>.</li>
|
|
<li><strong>resource_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the user defined named type.
|
|
When clients pass a value of this class as a parameter, the
|
|
attribute must be an identifier for one of these resource types:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt> or <tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>.
|
|
When methods return a value of this class as a return value, the
|
|
attribute will be an identifier for one of these resource types:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.structure</span></tt> or <tt class="docutils literal"><span class="pre">com.vmware.vapi.enumeration</span></tt>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-com.vmware.vapi.metadata.privilege_client">
|
|
<span id="privilege-client-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">privilege_client</span></tt> Module<a class="headerlink" href="#module-com.vmware.vapi.metadata.privilege_client" title="Permalink to this headline">¶</a></h2>
|
|
<p>The <tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege_client</span></tt> module provides classes that
|
|
expose privilege information for operation elements across all the service
|
|
elements.</p>
|
|
<p>An entity has a unique identifier and a resource type. An entity can either be
|
|
present in one of the parameter elements or if a parameter is a structure
|
|
element, it could also be present in one of the field elements.</p>
|
|
<p>Privileges can be assigned to either operation elements or entities used in the
|
|
operation element. A list of privileges can also be applied on a package
|
|
element. This list of privileges would be used as a default for all the
|
|
operation elements and the entities that do not have any defined privileges.</p>
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Component">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">Component</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Component"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Component" 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 <tt class="docutils literal"><span class="pre">Component</span></tt> class provides methods to retrieve privilege information
|
|
of a component element.</p>
|
|
<p>A component element is said to contain privilege information if any one of
|
|
package elements in it contains privilege information.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Component.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.component'</em><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Component.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for vAPI component.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Component.fingerprint">
|
|
<tt class="descname">fingerprint</tt><big>(</big><em>component_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Component.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Component.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves the fingerprint computed from the privilege metadata of the
|
|
component element corresponding to <tt class="docutils literal"><span class="pre">component_id</span></tt>.</p>
|
|
<p>The fingerprint provides clients an efficient way to check if the
|
|
metadata for a particular component has been modified on the server.
|
|
The client can do this by comparing the result of this operation with
|
|
the fingerprint returned in the result of <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Component.get" title="com.vmware.vapi.metadata.privilege_client.Component.get"><tt class="xref py py-func docutils literal"><span class="pre">Component.get()</span></tt></a>.</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>component_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the component element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The fingerprint computed from the privilege metadata of the
|
|
component.</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.html#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 component element associated with <tt class="docutils literal"><span class="pre">component_id</span></tt> does not
|
|
have any privilege information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Component.get">
|
|
<tt class="descname">get</tt><big>(</big><em>component_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Component.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Component.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves privilege information about the component element
|
|
corresponding to <tt class="docutils literal"><span class="pre">component_id</span></tt>.</p>
|
|
<p>The <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.ComponentData" title="com.vmware.vapi.metadata.privilege_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a> contains the privilege information about the
|
|
component element and its fingerprint. It contains information about
|
|
all the package elements that belong to this component element.</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>component_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the component element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</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.metadata.privilege_client.ComponentData" title="com.vmware.vapi.metadata.privilege_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.ComponentData" title="com.vmware.vapi.metadata.privilege_client.ComponentData"><tt class="xref py py-class docutils literal"><span class="pre">ComponentData</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">component_id</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.html#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 component element associated with <tt class="docutils literal"><span class="pre">component_id</span></tt> does not
|
|
have any privilege information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Component.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Component.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Component.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the component elements that have privilege
|
|
information.</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.metadata.privilege_client.Component.list" title="com.vmware.vapi.metadata.privilege_client.Component.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the component elements that have
|
|
privilege information.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.component</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.ComponentData">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">ComponentData</tt><big>(</big><em>info=None</em>, <em>fingerprint=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#ComponentData"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.ComponentData" 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">ComponentData</span></tt> class contains the privilege information of the
|
|
component along with its fingerprint.</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>info</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.ComponentInfo" title="com.vmware.vapi.metadata.privilege_client.ComponentInfo"><tt class="xref py py-class docutils literal"><span class="pre">ComponentInfo</span></tt></a>) – Privilege information of the component. This includes information
|
|
about all the modules in the component.</li>
|
|
<li><strong>fingerprint</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Fingerprint of the metadata of the component.</p>
|
|
<p>Privilege information could change when there is an infrastructure
|
|
update. Since the data present in <tt class="xref py py-attr docutils literal"><span class="pre">ComponentData.info</span></tt> could
|
|
be quite large, <tt class="docutils literal"><span class="pre">fingerprint</span></tt> provides a convenient way to check
|
|
if the data for a particular component is updated.</p>
|
|
<p>You should store the fingerprint associated with a component. After
|
|
an update, by invoking the <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Component.fingerprint" title="com.vmware.vapi.metadata.privilege_client.Component.fingerprint"><tt class="xref py py-func docutils literal"><span class="pre">Component.fingerprint()</span></tt></a> method,
|
|
you can retrieve the new fingerprint for the component. If the new
|
|
fingerprint and the previously stored fingerprint do not match,
|
|
clients can then use the <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Component.get" title="com.vmware.vapi.metadata.privilege_client.Component.get"><tt class="xref py py-func docutils literal"><span class="pre">Component.get()</span></tt></a> to retrieve the new
|
|
privilege information for the component.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.ComponentInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">ComponentInfo</tt><big>(</big><em>packages=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#ComponentInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.ComponentInfo" 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">ComponentInfo</span></tt> class contains the privilege information of a
|
|
component element.</p>
|
|
<p>For an explanation of privilege information contained within component
|
|
elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Component" title="com.vmware.vapi.metadata.privilege_client.Component"><tt class="xref py py-class docutils literal"><span class="pre">Component</span></tt></a>.</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>packages</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.metadata.privilege_client.PackageInfo" title="com.vmware.vapi.metadata.privilege_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a>) – <p>Privilege information of all the package elements. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier of the package element and the
|
|
value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the privilege information for the
|
|
package element.</p>
|
|
<p>For an explanation of privilege information containment within
|
|
package elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Package" title="com.vmware.vapi.metadata.privilege_client.Package"><tt class="xref py py-class docutils literal"><span class="pre">Package</span></tt></a>.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.OperationInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">OperationInfo</tt><big>(</big><em>privileges=None</em>, <em>privilege_info=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#OperationInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.OperationInfo" 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">OperationInfo</span></tt> class contains privilege information of an operation
|
|
element.</p>
|
|
<p>For an explanation of containment within operation elements, see
|
|
<a class="reference internal" href="com.vmware.vapi.metadata.privilege.html#com.vmware.vapi.metadata.privilege.service_client.Operation" title="com.vmware.vapi.metadata.privilege.service_client.Operation"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.service_client.Operation</span></tt></a>.</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>privileges</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>) – List of all privileges assigned to the operation element.</li>
|
|
<li><strong>privilege_info</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.PrivilegeInfo" title="com.vmware.vapi.metadata.privilege_client.PrivilegeInfo"><tt class="xref py py-class docutils literal"><span class="pre">PrivilegeInfo</span></tt></a>) – Privilege information of all the parameter elements of the
|
|
operation element. For an explanation of containment of privilege
|
|
information within parameter elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.PrivilegeInfo" title="com.vmware.vapi.metadata.privilege_client.PrivilegeInfo"><tt class="xref py py-class docutils literal"><span class="pre">PrivilegeInfo</span></tt></a>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Package">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">Package</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Package"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Package" 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 <tt class="docutils literal"><span class="pre">Package</span></tt> class provides methods to retrieve privilege information of
|
|
a package element.</p>
|
|
<p>A package element is said to contain privilege information if there is a
|
|
default privilege assigned to all service elements contained in the package
|
|
element or if one of the operation elements contained in one of the service
|
|
elements in this package element has privilege information.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Package.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.package'</em><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Package.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for package.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Package.get">
|
|
<tt class="descname">get</tt><big>(</big><em>package_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Package.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Package.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves privilege information about the package element corresponding
|
|
to <tt class="docutils literal"><span class="pre">package_id</span></tt>.</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>package_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the package element.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</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.metadata.privilege_client.PackageInfo" title="com.vmware.vapi.metadata.privilege_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.PackageInfo" title="com.vmware.vapi.metadata.privilege_client.PackageInfo"><tt class="xref py py-class docutils literal"><span class="pre">PackageInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">package_id</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.html#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 package element associated with <tt class="docutils literal"><span class="pre">package_id</span></tt> does not have
|
|
any privilege information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Package.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Package.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Package.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the package elements that have privilege
|
|
information.</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.metadata.privilege_client.Package.list" title="com.vmware.vapi.metadata.privilege_client.Package.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the package elements that have
|
|
privilege information.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.package</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.PackageInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">PackageInfo</tt><big>(</big><em>privileges=None</em>, <em>services=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#PackageInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.PackageInfo" 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">PackageInfo</span></tt> class contains the privilege information of a package
|
|
element.</p>
|
|
<p>For an explanation of privilege information contained within package
|
|
elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Package" title="com.vmware.vapi.metadata.privilege_client.Package"><tt class="xref py py-class docutils literal"><span class="pre">Package</span></tt></a>.</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>privileges</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>) – List of default privileges to be used for all the operations
|
|
present in this package. If a particular operation element has no
|
|
explicit privileges defined in the privilege definition file, these
|
|
privileges are used for enforcing authorization.</li>
|
|
<li><strong>services</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.metadata.privilege_client.ServiceInfo" title="com.vmware.vapi.metadata.privilege_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a>) – Information about all service elements contained in this package
|
|
element that contain privilege information. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier of the service element and the
|
|
value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the privilege information for the
|
|
service element. For an explanation of privilege information
|
|
containment within service elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Service" title="com.vmware.vapi.metadata.privilege_client.Service"><tt class="xref py py-class docutils literal"><span class="pre">Service</span></tt></a>.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier for the resource
|
|
type: <tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>. When methods return a value of
|
|
this class as a return value, the key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.service</span></tt>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.PrivilegeInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">PrivilegeInfo</tt><big>(</big><em>property_path=None</em>, <em>privileges=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#PrivilegeInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.PrivilegeInfo" 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">PrivilegeInfo</span></tt> class contains the privilege information for a
|
|
parameter element in an operation element.</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>property_path</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>The <tt class="docutils literal"><span class="pre">propertyPath</span></tt> points to an entity that is used in the
|
|
operation element. An entity can either be present in one of the
|
|
parameter elements or if a parameter is a structure element, it
|
|
could also be present in one of the field elements.</p>
|
|
<p>If the privilege is assigned to an entity used in the parameter,
|
|
<tt class="docutils literal"><span class="pre">propertyPath</span></tt> will just contain the name of the parameter field.
|
|
If the privilege is assigned to an entity in one of the field
|
|
elements of a parameter element that is a structure element, then
|
|
<tt class="docutils literal"><span class="pre">propertyPath</span></tt> will contain a path to the field element starting
|
|
from the parameter name.</p>
|
|
</li>
|
|
<li><strong>privileges</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>) – List of privileges assigned to the entity that is being referred by
|
|
<tt class="xref py py-attr docutils literal"><span class="pre">PrivilegeInfo.property_path</span></tt>.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Service">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">Service</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Service"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_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 <tt class="docutils literal"><span class="pre">Service</span></tt> class provides methods to retrieve privilege information of
|
|
a service element.</p>
|
|
<p>A service element is said to contain privilege information if one of the
|
|
operation elements contained in this service element has privilege
|
|
information.</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="attribute">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Service.RESOURCE_TYPE">
|
|
<tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.service'</em><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Service.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for service.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Service.get">
|
|
<tt class="descname">get</tt><big>(</big><em>service_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Service.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Service.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves privilege information about the service element corresponding
|
|
to <tt class="docutils literal"><span class="pre">service_id</span></tt>.</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>) – Identifier of the service element.
|
|
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.metadata.privilege_client.ServiceInfo" title="com.vmware.vapi.metadata.privilege_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.ServiceInfo" title="com.vmware.vapi.metadata.privilege_client.ServiceInfo"><tt class="xref py py-class docutils literal"><span class="pre">ServiceInfo</span></tt></a> instance that corresponds to
|
|
<tt class="docutils literal"><span class="pre">service_id</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.html#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 element associated with <tt class="docutils literal"><span class="pre">service_id</span></tt> does not have
|
|
any privilege information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Service.list">
|
|
<tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Service.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Service.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers for the service elements that have privilege
|
|
information.</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.metadata.privilege_client.Service.list" title="com.vmware.vapi.metadata.privilege_client.Service.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for the service elements that have
|
|
privilege information.
|
|
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>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.ServiceInfo">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">ServiceInfo</tt><big>(</big><em>operations=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#ServiceInfo"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.ServiceInfo" 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">ServiceInfo</span></tt> class contains privilege information of a service
|
|
element.</p>
|
|
<p>For an explanation of privilege information contained within service
|
|
elements, see <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Service" title="com.vmware.vapi.metadata.privilege_client.Service"><tt class="xref py py-class docutils literal"><span class="pre">Service</span></tt></a>.</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">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.metadata.privilege_client.OperationInfo" title="com.vmware.vapi.metadata.privilege_client.OperationInfo"><tt class="xref py py-class docutils literal"><span class="pre">OperationInfo</span></tt></a>) – <p>Information about all operation elements contained in this service
|
|
element that contain privilege information. The key in the
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the identifier of the operation element and the
|
|
value in the <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> is the privilege information for the
|
|
operation element.</p>
|
|
<p>For an explanation of containment of privilege information within
|
|
operation elements, see
|
|
<a class="reference internal" href="com.vmware.vapi.metadata.privilege.html#com.vmware.vapi.metadata.privilege.service_client.Operation" title="com.vmware.vapi.metadata.privilege.service_client.Operation"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.service_client.Operation</span></tt></a>.
|
|
When clients pass a value of this class as a parameter, the key in
|
|
the attribute <tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> must be an identifier 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 key in the attribute
|
|
<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> will be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.operation</span></tt>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source">
|
|
<em class="property">class </em><tt class="descclassname">com.vmware.vapi.metadata.privilege_client.</tt><tt class="descname">Source</tt><big>(</big><em>config</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source" 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 <tt class="docutils literal"><span class="pre">Source</span></tt> class provides methods to manage the sources of privilege
|
|
metadata information.</p>
|
|
<p>The interface definition language infrastructure provides tools to generate
|
|
various kinds of metadata in JSON format from the interface definition
|
|
files and additional properties files. One of the generated files contains
|
|
privilege information. The generated file can be registered as a source of
|
|
metadata.</p>
|
|
<p>The privilege file contains all the data present in the interface
|
|
definition files. Each privilege file contains data about one component
|
|
element. When a privilege file is added as a source, each source
|
|
contributes only one component element’s metadata.</p>
|
|
<p>Privilege metadata can also be discovered from a remote server that
|
|
supports the privilege metadata classes (see
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.privilege_client" title="com.vmware.vapi.metadata.privilege_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege_client</span></tt></a>). Since multiple
|
|
components can be registered with a single metadata server, when a remote
|
|
server is registered as a source, that source can contribute more than one
|
|
component.</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.metadata.privilege_client.Source.CreateSpec">
|
|
<em class="property">class </em><tt class="descname">CreateSpec</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.CreateSpec"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.CreateSpec" 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">Source.CreateSpec</span></tt> class contains the registration information of a
|
|
privilege source.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – Type of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the metamodel metadata file that has the
|
|
metamodel information about one component element.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.FILE" title="com.vmware.vapi.metadata_client.SourceType.FILE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.FILE</span></tt></a>.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information of the remote server. This should be of the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server should contain the classes in
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client" title="com.vmware.vapi.metadata.metamodel_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.metamodel_client</span></tt></a> module. It could
|
|
expose metamodel information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is
|
|
<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType.REMOTE" title="com.vmware.vapi.metadata_client.SourceType.REMOTE"><tt class="xref py py-attr docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType.REMOTE</span></tt></a>.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.Info">
|
|
<em class="property">class </em><tt class="descclassname">Source.</tt><tt class="descname">Info</tt><big>(</big><em>description=None</em>, <em>type=None</em>, <em>filepath=None</em>, <em>address=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.Info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.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>The <tt class="docutils literal"><span class="pre">Source.Info</span></tt> class contains the metadata source information.</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>description</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – English language human readable description of the source.</li>
|
|
<li><strong>type</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.metadata_client.SourceType" title="com.vmware.vapi.metadata_client.SourceType"><tt class="xref py py-class docutils literal"><span class="pre">com.vmware.vapi.metadata_client.SourceType</span></tt></a>) – Type of the metadata source.</li>
|
|
<li><strong>filepath</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Absolute file path of the privilege metadata file that has the
|
|
privilege information about one component element. The <tt class="docutils literal"><span class="pre">filePath</span></tt>
|
|
is the path to the file in the server’s filesystem.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</li>
|
|
<li><strong>address</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – <p>Connection information for the remote server. This must be in the
|
|
format http(s)://IP:port/namespace.</p>
|
|
<p>The remote server must support the classes in the
|
|
<a class="reference internal" href="#module-com.vmware.vapi.metadata.privilege_client" title="com.vmware.vapi.metadata.privilege_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege_client</span></tt></a> module. It must
|
|
expose privilege information of one or more components.
|
|
This attribute is optional and it is only relevant when the value
|
|
of <tt class="docutils literal"><span class="pre">type</span></tt> is null.</p>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.RESOURCE_TYPE">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">RESOURCE_TYPE</tt><em class="property"> = 'com.vmware.vapi.metadata.privilege.source'</em><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.RESOURCE_TYPE" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Resource type for metadata source.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.create">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">create</tt><big>(</big><em>source_id</em>, <em>spec</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.create"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.create" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Creates a new metadata source. Once the server validates the
|
|
registration information of the metadata source, the privilege metadata
|
|
is retrieved from the source. This populates elements in all the
|
|
classes defined in <a class="reference internal" href="#module-com.vmware.vapi.metadata.privilege_client" title="com.vmware.vapi.metadata.privilege_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege_client</span></tt></a>
|
|
module.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – metadata source identifier.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.source</span></tt>.</li>
|
|
<li><strong>spec</strong> (<a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Source.CreateSpec" title="com.vmware.vapi.metadata.privilege_client.Source.CreateSpec"><tt class="xref py py-class docutils literal"><span class="pre">Source.CreateSpec</span></tt></a>) – create specification.</li>
|
|
</ul>
|
|
</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.html#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">com.vmware.vapi.std.errors_client.AlreadyExists</span></tt></a>
|
|
if the metadata source identifier is already registered with the
|
|
infrastructure.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the type of the source specified in null is invalid.</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.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the file specified in null is not a valid JSON file or if the
|
|
format of the privilege metadata in the JSON file is invalid.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Raise :</th><td class="field-body"><p class="first"><a class="reference internal" href="com.vmware.vapi.std.html#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">com.vmware.vapi.std.errors_client.InvalidArgument</span></tt></a>
|
|
if the URI specified in null is unreachable or if there is a
|
|
transport protocol or message protocol mismatch between the client
|
|
and the server or if the remote server do not have classes present
|
|
in <a class="reference internal" href="#module-com.vmware.vapi.metadata.privilege_client" title="com.vmware.vapi.metadata.privilege_client"><tt class="xref py py-mod docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege_client</span></tt></a> module.</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Raise :</th><td class="field-body"><p class="first last"><a class="reference internal" href="com.vmware.vapi.std.html#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 file specified in null does not exist.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.delete">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">delete</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.delete"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.delete" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Deletes an existing privilege metadata source from the infrastructure.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.source</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.fingerprint">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">fingerprint</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the aggregate fingerprint of metadata from all the metadata
|
|
sources or from a particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is
|
|
specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.source</span></tt>.
|
|
If unspecified, the fingerprint of all the metadata sources is
|
|
returned.</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">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Aggregate fingerprint of all the metadata sources or of a
|
|
particular metadata source.</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.get">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">get</tt><big>(</big><em>source_id</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.get"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.get" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Retrieves information about the metadata source corresponding to
|
|
<tt class="docutils literal"><span class="pre">source_id</span></tt>.</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>source_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.source</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.metadata.privilege_client.Source.Info" title="com.vmware.vapi.metadata.privilege_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.vapi.metadata.privilege_client.Source.Info" title="com.vmware.vapi.metadata.privilege_client.Source.Info"><tt class="xref py py-class docutils literal"><span class="pre">Source.Info</span></tt></a> instance that corresponds to <tt class="docutils literal"><span class="pre">source_id</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.list">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">list</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.list" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the identifiers of the metadata sources currently registered
|
|
with the infrastructure.</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.metadata.privilege_client.Source.list" title="com.vmware.vapi.metadata.privilege_client.Source.list"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></a> 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">The list of identifiers for metadata sources currently registered.
|
|
The return value will contain identifiers for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.source</span></tt>.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="com.vmware.vapi.metadata.privilege_client.Source.reload">
|
|
<tt class="descclassname">Source.</tt><tt class="descname">reload</tt><big>(</big><em>source_id=None</em><big>)</big><a class="reference internal" href="_modules/com/vmware/vapi/metadata/privilege_client.html#Source.reload"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#com.vmware.vapi.metadata.privilege_client.Source.reload" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Reloads the privilege metadata from all the metadata sources or of a
|
|
particular metadata source if <tt class="docutils literal"><span class="pre">source_id</span></tt> is specified.</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>source_id</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>) – Identifier of the metadata source.
|
|
The parameter must be an identifier for the resource type:
|
|
<tt class="docutils literal"><span class="pre">com.vmware.vapi.metadata.privilege.source</span></tt>.
|
|
If unspecified, all the metadata sources are reloaded.</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.html#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 metadata source associated with <tt class="docutils literal"><span class="pre">source_id</span></tt> is not found.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="subpackages">
|
|
<h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to this headline">¶</a></h2>
|
|
<div class="toctree-wrapper compound">
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="com.vmware.vapi.metadata.authentication.html">authentication Package</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.vapi.metadata.authentication.html#id1"><tt class="docutils literal"><span class="pre">authentication</span></tt> Package</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.vapi.metadata.authentication.html#module-com.vmware.vapi.metadata.authentication.service_client"><tt class="docutils literal"><span class="pre">service_client</span></tt> Module</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="com.vmware.vapi.metadata.metamodel.html">metamodel Package</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.vapi.metadata.metamodel.html#id1"><tt class="docutils literal"><span class="pre">metamodel</span></tt> Package</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.vapi.metadata.metamodel.html#module-com.vmware.vapi.metadata.metamodel.resource_client"><tt class="docutils literal"><span class="pre">resource_client</span></tt> Module</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.vapi.metadata.metamodel.html#module-com.vmware.vapi.metadata.metamodel.service_client"><tt class="docutils literal"><span class="pre">service_client</span></tt> Module</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="com.vmware.vapi.metadata.privilege.html">privilege Package</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.vapi.metadata.privilege.html#id1"><tt class="docutils literal"><span class="pre">privilege</span></tt> Package</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.vapi.metadata.privilege.html#module-com.vmware.vapi.metadata.privilege.service_client"><tt class="docutils literal"><span class="pre">service_client</span></tt> Module</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</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="#">metadata Package</a><ul>
|
|
<li><a class="reference internal" href="#id1"><tt class="docutils literal"><span class="pre">metadata</span></tt> Package</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.metadata.authentication_client"><tt class="docutils literal"><span class="pre">authentication_client</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.metadata.cli_client"><tt class="docutils literal"><span class="pre">cli_client</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.metadata.metamodel_client"><tt class="docutils literal"><span class="pre">metamodel_client</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-com.vmware.vapi.metadata.privilege_client"><tt class="docutils literal"><span class="pre">privilege_client</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#subpackages">Subpackages</a><ul>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>Previous topic</h4>
|
|
<p class="topless"><a href="com.vmware.vapi.html"
|
|
title="previous chapter">vapi Package</a></p>
|
|
<h4>Next topic</h4>
|
|
<p class="topless"><a href="com.vmware.vapi.metadata.authentication.html"
|
|
title="next chapter">authentication Package</a></p>
|
|
<h3>This Page</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="_sources/com.vmware.vapi.metadata.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.vapi.metadata.authentication.html" title="authentication Package"
|
|
>next</a> |</li>
|
|
<li class="right" >
|
|
<a href="com.vmware.vapi.html" title="vapi Package"
|
|
>previous</a> |</li>
|
|
<li><a href="index.html">vCloud Suite SDK for Python 6.0.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> |