mirror of
https://github.com/vmware/vsphere-automation-sdk-python.git
synced 2024-11-22 09:39:58 -05:00
2506 lines
249 KiB
HTML
2506 lines
249 KiB
HTML
|
<!DOCTYPE html>
|
|||
|
|
<html class="writer-html5" lang="en" >
|
|||
|
|
<head>
|
|||
|
|
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
|
|||
|
|
|
|||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|||
|
|
<title>com.vmware.content package — vSphere Automation SDK for Python. 8.0.1.0 documentation</title>
|
|||
|
|
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
|||
|
|
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
|
|||
|
|
<!--[if lt IE 9]>
|
|||
|
|
<script src="_static/js/html5shiv.min.js"></script>
|
|||
|
|
<![endif]-->
|
|||
|
|
|
|||
|
|
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
|
|||
|
|
<script src="_static/jquery.js"></script>
|
|||
|
|
<script src="_static/underscore.js"></script>
|
|||
|
|
<script src="_static/doctools.js"></script>
|
|||
|
|
<script src="_static/js/theme.js"></script>
|
|||
|
|
<link rel="index" title="Index" href="genindex.html" />
|
|||
|
|
<link rel="search" title="Search" href="search.html" />
|
|||
|
|
<link rel="next" title="com.vmware.content.library package" href="com.vmware.content.library.html" />
|
|||
|
|
<link rel="prev" title="com.vmware.cis package" href="com.vmware.cis.html" />
|
|||
|
|
</head>
|
|||
|
|
|
|||
|
|
<body class="wy-body-for-nav">
|
|||
|
|
<div class="wy-grid-for-nav">
|
|||
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
|||
|
|
<div class="wy-side-scroll">
|
|||
|
|
<div class="wy-side-nav-search" >
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
<a href="index.html" class="icon icon-home">
|
|||
|
|
vSphere Automation SDK for Python.
|
|||
|
|
</a>
|
|||
|
|
<div class="version">
|
|||
|
|
8.0.1.0
|
|||
|
|
</div>
|
|||
|
|
<div role="search">
|
|||
|
|
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
|
|||
|
|
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
|
|||
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|||
|
|
<input type="hidden" name="area" value="default" />
|
|||
|
|
</form>
|
|||
|
|
</div>
|
|||
|
|
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
|||
|
|
<p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
|
|||
|
|
<ul class="current">
|
|||
|
|
<li class="toctree-l1 current"><a class="reference internal" href="com.html">com package</a><ul class="current">
|
|||
|
|
<li class="toctree-l2 current"><a class="reference internal" href="com.html#subpackages">Subpackages</a><ul class="current">
|
|||
|
|
<li class="toctree-l3 current"><a class="reference internal" href="com.vmware.html">com.vmware package</a><ul class="current">
|
|||
|
|
<li class="toctree-l4 current"><a class="reference internal" href="com.vmware.html#subpackages">Subpackages</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#submodules">Submodules</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#module-com.vmware.appliance_client">com.vmware.appliance_client module</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#module-com.vmware.cis_client">com.vmware.cis_client module</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#module-com.vmware.content_client">com.vmware.content_client module</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#module-com.vmware.oauth2_client">com.vmware.oauth2_client module</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#module-com.vmware.vapi_client">com.vmware.vapi_client module</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#module-com.vmware.vcenter_client">com.vmware.vcenter_client module</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.html#module-com.vmware.vstats_client">com.vmware.vstats_client module</a></li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
<li class="toctree-l1"><a class="reference internal" href="vmware.html">vmware package</a></li>
|
|||
|
|
</ul>
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</nav>
|
|||
|
|
|
|||
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
|
|||
|
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
|||
|
|
<a href="index.html">vSphere Automation SDK for Python.</a>
|
|||
|
|
</nav>
|
|||
|
|
|
|||
|
|
<div class="wy-nav-content">
|
|||
|
|
<div class="rst-content">
|
|||
|
|
<div role="navigation" aria-label="Page navigation">
|
|||
|
|
<ul class="wy-breadcrumbs">
|
|||
|
|
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
|
|||
|
|
<li class="breadcrumb-item"><a href="com.html">com package</a></li>
|
|||
|
|
<li class="breadcrumb-item"><a href="com.vmware.html">com.vmware package</a></li>
|
|||
|
|
<li class="breadcrumb-item active">com.vmware.content package</li>
|
|||
|
|
<li class="wy-breadcrumbs-aside">
|
|||
|
|
<a href="_sources/com.vmware.content.rst.txt" rel="nofollow"> View page source</a>
|
|||
|
|
</li>
|
|||
|
|
</ul>
|
|||
|
|
<hr/>
|
|||
|
|
</div>
|
|||
|
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|||
|
|
<div itemprop="articleBody">
|
|||
|
|
|
|||
|
|
<section id="module-com.vmware.content">
|
|||
|
|
<span id="com-vmware-content-package"></span><h1>com.vmware.content package<a class="headerlink" href="#module-com.vmware.content" title="Permalink to this headline"></a></h1>
|
|||
|
|
<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.content.library.html">com.vmware.content.library package</a><ul>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.content.library.html#subpackages">Subpackages</a><ul>
|
|||
|
|
<li class="toctree-l3"><a class="reference internal" href="com.vmware.content.library.item.html">com.vmware.content.library.item package</a><ul>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.content.library.item.html#submodules">Submodules</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.content.library.item.html#module-com.vmware.content.library.item.downloadsession_client">com.vmware.content.library.item.downloadsession_client module</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.content.library.item.html#module-com.vmware.content.library.item.updatesession_client">com.vmware.content.library.item.updatesession_client module</a></li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.content.library.html#submodules">Submodules</a></li>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.content.library.html#module-com.vmware.content.library.item_client">com.vmware.content.library.item_client module</a></li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
<li class="toctree-l1"><a class="reference internal" href="com.vmware.content.type.html">com.vmware.content.type package</a><ul>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.content.type.html#subpackages">Subpackages</a><ul>
|
|||
|
|
<li class="toctree-l3"><a class="reference internal" href="com.vmware.content.type.ovf.html">com.vmware.content.type.ovf package</a><ul>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.content.type.ovf.html#submodules">Submodules</a></li>
|
|||
|
|
<li class="toctree-l4"><a class="reference internal" href="com.vmware.content.type.ovf.html#module-com.vmware.content.type.ovf.policy_client">com.vmware.content.type.ovf.policy_client module</a></li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.content.type.html#submodules">Submodules</a></li>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="com.vmware.content.type.html#module-com.vmware.content.type.ovf_client">com.vmware.content.type.ovf_client module</a></li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
</ul>
|
|||
|
|
</div>
|
|||
|
|
</section>
|
|||
|
|
<section id="submodules">
|
|||
|
|
<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline"></a></h2>
|
|||
|
|
</section>
|
|||
|
|
<section id="module-com.vmware.content.library_client">
|
|||
|
|
<span id="com-vmware-content-library-client-module"></span><h2>com.vmware.content.library_client module<a class="headerlink" href="#module-com.vmware.content.library_client" title="Permalink to this headline"></a></h2>
|
|||
|
|
<p>The Content Library module provides classes and classes for defining and
|
|||
|
|
managing the library’s items, subscription, publication, and storage.</p>
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">Item</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">config</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.VapiInterface</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Item</span></code> class provides methods for managing library items.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>config</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.DestinationSpec">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">DestinationSpec</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">subscription</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.DestinationSpec" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Item.DestinationSpec</span></code> class contains information required to publish
|
|||
|
|
the library item to a specific subscription. This class was added in
|
|||
|
|
vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>subscription</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the subscription associated with the subscribed
|
|||
|
|
library. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>. When methods return a
|
|||
|
|
value of this class as a return value, the attribute will be an
|
|||
|
|
identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.FindSpec">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">FindSpec</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">library_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">type</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">cached</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.FindSpec" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Item.FindSpec</span></code> class specifies the properties that can be used as a
|
|||
|
|
filter to find library items. When multiple attributes are specified, all
|
|||
|
|
properties of the item must match the specification.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The name of the library item. The name is case-insensitive. See
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.name</span></code>.
|
|||
|
|
If not specified all library item names are searched.</p></li>
|
|||
|
|
<li><p><strong>library_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The identifier of the library containing the item. See
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code>.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>. When methods return a value of this
|
|||
|
|
class as a return value, the attribute will be an identifier for
|
|||
|
|
the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.
|
|||
|
|
If not specified all libraries are searched.</p></li>
|
|||
|
|
<li><p><strong>source_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The identifier of the library item as reported by the publisher.
|
|||
|
|
See <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.source_id</span></code>.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>. When methods return a value of
|
|||
|
|
this class as a return value, the attribute will be an identifier
|
|||
|
|
for the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.
|
|||
|
|
If not specified all library items are searched.</p></li>
|
|||
|
|
<li><p><strong>type</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The type of the library item. The type is case-insensitive. See
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.type</span></code>.
|
|||
|
|
If not specified all types are searched.</p></li>
|
|||
|
|
<li><p><strong>cached</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Whether the item is cached. Possible values are ‘true’ or ‘false’.
|
|||
|
|
See <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.cached</span></code>.
|
|||
|
|
If not specified all library items are searched.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.RESOURCE_TYPE">
|
|||
|
|
<span class="sig-name descname"><span class="pre">RESOURCE_TYPE</span></span><em class="property"> <span class="pre">=</span> <span class="pre">'com.vmware.content.library.Item'</span></em><a class="headerlink" href="#com.vmware.content.library_client.Item.RESOURCE_TYPE" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Resource type for item.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.copy">
|
|||
|
|
<span class="sig-name descname"><span class="pre">copy</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">source_library_item_id</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">destination_create_spec</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">client_token</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.copy" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Copies a library item.</p>
|
|||
|
|
<p>Copying a library item allows a duplicate to be made within the same or
|
|||
|
|
different library. The copy occurs by first creating a new library
|
|||
|
|
item, whose identifier is returned. The content of the library item is
|
|||
|
|
then copied asynchronously. This copy can be tracked as a task.</p>
|
|||
|
|
<p>If the copy fails, Content Library Service will roll back the copy by
|
|||
|
|
deleting any content that was already copied, and removing the new
|
|||
|
|
library item. A failure during rollback may require manual cleanup by
|
|||
|
|
an administrator.</p>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>A library item cannot be copied into a subscribed library.</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<dl class="field-list">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>client_token</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – A unique token generated on the client for each copy request. The
|
|||
|
|
token should be a universally unique identifier (UUID), for
|
|||
|
|
example: <code class="docutils literal notranslate"><span class="pre">b8a2a2e3-2314-43cd-a871-6ede0f429751</span></code>. This token can
|
|||
|
|
be used to guarantee idempotent copy.
|
|||
|
|
If not specified copy is not idempotent.</p></li>
|
|||
|
|
<li><p><strong>source_library_item_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the existing library item from which the content will
|
|||
|
|
be copied.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p></li>
|
|||
|
|
<li><p><strong>destination_create_spec</strong> (<a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a>) – Specification for the new library item to be created.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>The identifier of the new library item into which the content is
|
|||
|
|
being copied.
|
|||
|
|
The return value will be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if the library item with <code class="docutils literal notranslate"><span class="pre">source_library_item_id</span></code> does not exist,
|
|||
|
|
or if the library referenced by the <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code>
|
|||
|
|
property of <code class="docutils literal notranslate"><span class="pre">destination_create_spec</span></code> does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><dl class="simple">
|
|||
|
|
<dt><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a> </dt><dd><p>if one of the following is true for the new library item:</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>name is empty</p></li>
|
|||
|
|
<li><p>name exceeds 80 characters</p></li>
|
|||
|
|
<li><p>description exceeds 2000 characters</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a>
|
|||
|
|
if the <code class="docutils literal notranslate"><span class="pre">client_token</span></code> does not conform to the UUID format.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
if the <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code> property of
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">destination_create_spec</span></code> refers to a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.ResourceInaccessible" title="com.vmware.vapi.std.errors_client.ResourceInaccessible"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.ResourceInaccessible</span></code></a>
|
|||
|
|
if the copy operation failed because the source or destination
|
|||
|
|
library item is not accessible.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
if the content of the source library item specified by
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">source_library_item_id</span></code>, or the content of the target library
|
|||
|
|
specified by the library ID (see <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code>)
|
|||
|
|
property of <code class="docutils literal notranslate"><span class="pre">destination_create_spec</span></code> has been deleted from the
|
|||
|
|
storage backings (see LibraryModel#storageBackings) associated with
|
|||
|
|
it.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code> referenced by
|
|||
|
|
the parameter <code class="docutils literal notranslate"><span class="pre">source_library_item_id</span></code> requires <code class="docutils literal notranslate"><span class="pre">System.Read</span></code>.</p></li>
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
attribute <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.AddLibraryItem</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.create">
|
|||
|
|
<span class="sig-name descname"><span class="pre">create</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">create_spec</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">client_token</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.create" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Creates a new library item.</p>
|
|||
|
|
<p>A new library item is created without any content. After creation,
|
|||
|
|
content can be added through the
|
|||
|
|
<a class="reference internal" href="com.vmware.content.library.html#com.vmware.content.library.item_client.UpdateSession" title="com.vmware.content.library.item_client.UpdateSession"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.content.library.item_client.UpdateSession</span></code></a> and
|
|||
|
|
<a class="reference internal" href="com.vmware.content.library.item.html#com.vmware.content.library.item.updatesession_client.File" title="com.vmware.content.library.item.updatesession_client.File"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.content.library.item.updatesession_client.File</span></code></a>
|
|||
|
|
classes.</p>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>A library item cannot be created in a subscribed library.</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<dl class="field-list">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>client_token</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – A unique token generated on the client for each creation request.
|
|||
|
|
The token should be a universally unique identifier (UUID), for
|
|||
|
|
example: <code class="docutils literal notranslate"><span class="pre">b8a2a2e3-2314-43cd-a871-6ede0f429751</span></code>. This token can
|
|||
|
|
be used to guarantee idempotent creation.
|
|||
|
|
If not specified creation is not idempotent.</p></li>
|
|||
|
|
<li><p><strong>create_spec</strong> (<a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a>) – Specification that defines the properties of the new library item.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>Identifier of the new library item.
|
|||
|
|
The return value will be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if the <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code> property of <code class="docutils literal notranslate"><span class="pre">create_spec</span></code>
|
|||
|
|
refers to a library that does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><dl class="simple">
|
|||
|
|
<dt><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a> </dt><dd><p>if one of the following is true for the new library item:</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>name is empty</p></li>
|
|||
|
|
<li><p>name exceeds 80 characters</p></li>
|
|||
|
|
<li><p>description exceeds 2000 characters</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a>
|
|||
|
|
if the <code class="docutils literal notranslate"><span class="pre">client_token</span></code> does not conform to the UUID format.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
if the <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code> property of <code class="docutils literal notranslate"><span class="pre">create_spec</span></code>
|
|||
|
|
refers to a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
if the content of the library specified by the library ID (see
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code>) property of <code class="docutils literal notranslate"><span class="pre">create_spec</span></code> has been
|
|||
|
|
deleted from the storage backings (see
|
|||
|
|
LibraryModel#storageBackings) associated with it.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.AlreadyExists</span></code></a>
|
|||
|
|
if there is already a library item with same name in the library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
attribute <code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.library_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.AddLibraryItem</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.delete">
|
|||
|
|
<span class="sig-name descname"><span class="pre">delete</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library_item_id</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.delete" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Deletes a library item.</p>
|
|||
|
|
<p>This method will immediately remove the item from the library that owns
|
|||
|
|
it. The content of the item will be asynchronously removed from the
|
|||
|
|
storage backings. The content deletion can be tracked with a task. In
|
|||
|
|
the event that the task fails, an administrator may need to manually
|
|||
|
|
remove the files from the storage backing.</p>
|
|||
|
|
<p>This method cannot be used to delete a library item that is a member of
|
|||
|
|
a subscribed library. Removing an item from a subscribed library
|
|||
|
|
requires deleting the item from the original published local library
|
|||
|
|
and syncing the subscribed library.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>library_item_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the library item to delete.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
if the library item with the given <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> is a member
|
|||
|
|
of a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if the library item with the specified <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> does not
|
|||
|
|
exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
if the library item contains a virtual machine template and a
|
|||
|
|
virtual machine is checked out of the library item.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code> referenced by
|
|||
|
|
the parameter <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.DeleteLibraryItem</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.find">
|
|||
|
|
<span class="sig-name descname"><span class="pre">find</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">spec</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.find" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Returns identifiers of all the visible (as determined by authorization
|
|||
|
|
policy) library items matching the requested <a class="reference internal" href="#com.vmware.content.library_client.Item.FindSpec" title="com.vmware.content.library_client.Item.FindSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Item.FindSpec</span></code></a>.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>spec</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Item.FindSpec" title="com.vmware.content.library_client.Item.FindSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Item.FindSpec</span></code></a>) – Specification describing what properties to filter on.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="#com.vmware.content.library_client.Item.list" title="com.vmware.content.library_client.Item.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of <code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>The <a class="reference internal" href="#com.vmware.content.library_client.Item.list" title="com.vmware.content.library_client.Item.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of identifiers of all the visible library items
|
|||
|
|
matching the given <code class="docutils literal notranslate"><span class="pre">spec</span></code>.
|
|||
|
|
The return value will contain identifiers for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a>
|
|||
|
|
if no properties are specified in the <code class="docutils literal notranslate"><span class="pre">spec</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Method execution requires <code class="docutils literal notranslate"><span class="pre">System.Read</span></code>.</p></li>
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
attribute <code class="xref py py-attr docutils literal notranslate"><span class="pre">Item.FindSpec.library_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">System.Read</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.get">
|
|||
|
|
<span class="sig-name descname"><span class="pre">get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library_item_id</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.get" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Returns the <a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a> with the given identifier.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>library_item_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the library item to return.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>The <a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a> instance with the given <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if no item with the given <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> exists.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code> referenced by
|
|||
|
|
the parameter <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> requires <code class="docutils literal notranslate"><span class="pre">System.Read</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.list">
|
|||
|
|
<span class="sig-name descname"><span class="pre">list</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library_id</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.list" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Returns the identifiers of all items in the given library.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>library_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the library whose items should be returned.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="#com.vmware.content.library_client.Item.list" title="com.vmware.content.library_client.Item.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of <code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>The <a class="reference internal" href="#com.vmware.content.library_client.Item.list" title="com.vmware.content.library_client.Item.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of identifiers of the items in the library
|
|||
|
|
specified by <code class="docutils literal notranslate"><span class="pre">library_id</span></code>.
|
|||
|
|
The return value will contain identifiers for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if the library associated with <code class="docutils literal notranslate"><span class="pre">library_id</span></code> does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
parameter <code class="docutils literal notranslate"><span class="pre">library_id</span></code> requires <code class="docutils literal notranslate"><span class="pre">System.Read</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.publish">
|
|||
|
|
<span class="sig-name descname"><span class="pre">publish</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library_item_id</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_sync_content</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscriptions</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.publish" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Publishes the library item to specified subscriptions of the library.
|
|||
|
|
If no subscriptions are specified, then publishes the library item to
|
|||
|
|
all subscriptions of the library. This method was added in vSphere API
|
|||
|
|
6.7.2.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>library_item_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Library item identifier.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p></li>
|
|||
|
|
<li><p><strong>force_sync_content</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – Whether to synchronize file content as well as metadata. This
|
|||
|
|
parameter applies only if the subscription is on-demand.</p></li>
|
|||
|
|
<li><p><strong>subscriptions</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Item.list" title="com.vmware.content.library_client.Item.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of <a class="reference internal" href="#com.vmware.content.library_client.Item.DestinationSpec" title="com.vmware.content.library_client.Item.DestinationSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Item.DestinationSpec</span></code></a> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The list of subscriptions to publish this library item to.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></code></a>
|
|||
|
|
If the system reports an error while responding to the request.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> does not
|
|||
|
|
exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a>
|
|||
|
|
If one or more arguments in <code class="docutils literal notranslate"><span class="pre">subscriptions</span></code> is not valid.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
If the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> is a member of
|
|||
|
|
a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
If the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> does not
|
|||
|
|
belong to a published library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthenticated</span></code></a>
|
|||
|
|
If the user that requested the method cannot be authenticated.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
If the user that requested the method is not authorized to perform
|
|||
|
|
the method.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code> referenced by
|
|||
|
|
the parameter <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.PublishLibraryItem</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Item.update">
|
|||
|
|
<span class="sig-name descname"><span class="pre">update</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library_item_id</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">update_spec</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Item.update" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Updates the specified properties of a library item.</p>
|
|||
|
|
<p>This is an incremental update to the library item. Attributes that are
|
|||
|
|
None in the update specification are left unchanged.</p>
|
|||
|
|
<p>This method cannot update a library item that is a member of a
|
|||
|
|
subscribed library. Those items must be updated in the source published
|
|||
|
|
library and synchronized to the subscribed library.</p>
|
|||
|
|
<dl class="field-list">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>library_item_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the library item to update.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p></li>
|
|||
|
|
<li><p><strong>update_spec</strong> (<a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a>) – Specification of the properties to set.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> does not
|
|||
|
|
exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
if the library item corresponding to <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> is a
|
|||
|
|
member of a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><dl class="simple">
|
|||
|
|
<dt><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a> </dt><dd><p>if one of the following is true for the <code class="docutils literal notranslate"><span class="pre">update_spec</span></code>:</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>name is empty</p></li>
|
|||
|
|
<li><p>name exceeds 80 characters</p></li>
|
|||
|
|
<li><p>description exceeds 2000 characters</p></li>
|
|||
|
|
<li><p>version is not equal to the current version of the library item</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
if the library item belongs to a published library with JSON
|
|||
|
|
persistence enabled (see <code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.persist_json_enabled</span></code>)
|
|||
|
|
and the content of the library item specified by
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> has been deleted from the storage backings (see
|
|||
|
|
LibraryModel#storageBackings) associated with it.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.AlreadyExists</span></code></a>
|
|||
|
|
if there is already a library item with same name in the library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code> referenced by
|
|||
|
|
the parameter <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.UpdateLibraryItem</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.ItemModel">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">ItemModel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">library_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">content_version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">creation_time</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">description</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">last_modified_time</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">last_sync_time</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">metadata_version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">cached</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">size</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">type</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">security_compliance</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">certificate_verification_info</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.ItemModel" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">ItemModel</span></code> class represents a library item that has been stored in a
|
|||
|
|
library.</p>
|
|||
|
|
<p>A <code class="docutils literal notranslate"><span class="pre">ItemModel</span></code> represents a single logical unit to be managed within a
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LibraryModel" title="com.vmware.content_client.LibraryModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.content_client.LibraryModel</span></code></a>. Items contain the actual
|
|||
|
|
content of a library, and their placement within a library determines
|
|||
|
|
policies that affect that content such as publishing.</p>
|
|||
|
|
<p>A library item can have a specified type, indicated with the
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.type</span></code> attribute. This property is associated with a
|
|||
|
|
Content Library Service plugin that supports specific types and provides
|
|||
|
|
additional services. The types available in a specific Content Library
|
|||
|
|
Service can be queried using the <a class="reference internal" href="com.vmware.html#com.vmware.content_client.Type" title="com.vmware.content_client.Type"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.content_client.Type</span></code></a>
|
|||
|
|
class. Items of an unknown or unspecified type are treated generically.
|
|||
|
|
Because subscribed library catalogs are synchronized as is, subscribing to
|
|||
|
|
a remote Content Library Service effectively gives you a library with the
|
|||
|
|
functionality of the remote service’s type adapter plugins, even if they
|
|||
|
|
are not installed locally.</p>
|
|||
|
|
<p>Items can be managed using the <a class="reference internal" href="#com.vmware.content.library_client.Item" title="com.vmware.content.library_client.Item"><code class="xref py py-class docutils literal notranslate"><span class="pre">Item</span></code></a> class and, for items in
|
|||
|
|
subscribed libraries, the <a class="reference internal" href="#com.vmware.content.library_client.SubscribedItem" title="com.vmware.content.library_client.SubscribedItem"><code class="xref py py-class docutils literal notranslate"><span class="pre">SubscribedItem</span></code></a> class.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – A unique identifier for this library item.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>. When methods return a value of
|
|||
|
|
this class as a return value, the attribute will be an identifier
|
|||
|
|
for the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will not
|
|||
|
|
be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods.
|
|||
|
|
It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>library_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LibraryModel" title="com.vmware.content_client.LibraryModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.content_client.LibraryModel</span></code></a> to which this item
|
|||
|
|
belongs.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>. When methods return a value of this
|
|||
|
|
class as a return value, the attribute will be an identifier for
|
|||
|
|
the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>content_version</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The latest version of the file content list of this library item.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.item.Version</span></code>. When methods return a
|
|||
|
|
value of this class as a return value, the attribute will be an
|
|||
|
|
identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.item.Version</span></code>.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>creation_time</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">datetime.datetime</span></code>) – The date and time when this library item was created.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>description</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – A human-readable description for this library item.
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. Leaving it
|
|||
|
|
None during creation will result in an empty string value. It will
|
|||
|
|
always be present in the result of a <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> method. It
|
|||
|
|
is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method. Leaving it None during
|
|||
|
|
update indicates that the description remains unchanged.</p></li>
|
|||
|
|
<li><p><strong>last_modified_time</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">datetime.datetime</span></code>) – <p>The date and time when the metadata for this library item was last
|
|||
|
|
changed.</p>
|
|||
|
|
<p>This attribute is affected by changes to the properties or file
|
|||
|
|
content of this item. It is not modified by changes to the tags of
|
|||
|
|
the item, or by changes to the library which owns this item.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>last_sync_time</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">datetime.datetime</span></code>) – <p>The date and time when this library item was last synchronized.</p>
|
|||
|
|
<p>This attribute is updated every time a synchronization is triggered
|
|||
|
|
on the library item, including when a synchronization is triggered
|
|||
|
|
on the library to which this item belongs. The value is None for a
|
|||
|
|
library item that belongs to a local library.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It is
|
|||
|
|
optional in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods. It
|
|||
|
|
is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>metadata_version</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>A version number for the metadata of this library item.</p>
|
|||
|
|
<p>This value is incremented with each change to the metadata of this
|
|||
|
|
item. Changes to name, description, and so on will increment this
|
|||
|
|
value. The value is not incremented by changes to the content or
|
|||
|
|
tags of the item or the library which owns it.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>A human-readable name for this library item.</p>
|
|||
|
|
<p>The name may not be None or an empty string. The name does not have
|
|||
|
|
to be unique, even within the same library.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>cached</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – The status that indicates whether the library item is on disk or
|
|||
|
|
not. The library item is cached when all its files are on disk.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>size</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">long</span></code>) – The library item size, in bytes. The size is the sum of the size
|
|||
|
|
used on the storage backing for all the files in the item. When the
|
|||
|
|
library item is not cached, the size is 0.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It is
|
|||
|
|
optional in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods. It
|
|||
|
|
is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>type</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>An optional type identifier which indicates the type adapter plugin
|
|||
|
|
to use.</p>
|
|||
|
|
<p>This attribute may be set to a non-empty string value that
|
|||
|
|
corresponds to an identifier supported by a type adapter plugin
|
|||
|
|
present in the Content Library Service. A type adapter plugin, if
|
|||
|
|
present for the specified type, can provide additional information
|
|||
|
|
and services around the item content. A type adapter can guide the
|
|||
|
|
upload process by creating file entries that are in need of being
|
|||
|
|
uploaded to complete an item.</p>
|
|||
|
|
<p>The types and plugins supported by the Content Library Service can
|
|||
|
|
be queried using the <a class="reference internal" href="com.vmware.html#com.vmware.content_client.Type" title="com.vmware.content_client.Type"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.content_client.Type</span></code></a> class.
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> and <code class="docutils literal notranslate"><span class="pre">update</span></code>
|
|||
|
|
methods. During creation, if the type is left unspecified, or if
|
|||
|
|
the type is specified but does not have a corresponding type
|
|||
|
|
support plugin, then the type of the library item is considered to
|
|||
|
|
be generic and all data is treated as generic files. During update,
|
|||
|
|
if the type is not specified, then it is not updated.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>version</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>A version number that is updated on metadata changes. This value is
|
|||
|
|
used to validate update requests to provide optimistic concurrency
|
|||
|
|
of changes.</p>
|
|||
|
|
<p>This value represents a number that is incremented every time
|
|||
|
|
library item properties, such as name or description, are changed.
|
|||
|
|
It is not incremented by changes to the file content of the library
|
|||
|
|
item, including adding or removing files. It is also not affected
|
|||
|
|
by tagging the library item.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the result of a <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> method. It
|
|||
|
|
is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method. Leaving it None during
|
|||
|
|
update indicates that you do not need to detect concurrent updates.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>source_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the <a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a> to which this item is
|
|||
|
|
synchronized to if the item belongs to a subscribed library. The
|
|||
|
|
value is None for a library item that belongs to a local library.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>. When methods return a value of
|
|||
|
|
this class as a return value, the attribute will be an identifier
|
|||
|
|
for the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It is
|
|||
|
|
optional in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods. It
|
|||
|
|
is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>security_compliance</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – Shows the security compliance of <a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a>. This attribute
|
|||
|
|
was added in vSphere API 7.0.3.0.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> and <code class="docutils literal notranslate"><span class="pre">update</span></code>
|
|||
|
|
methods. It will be present in the result of a <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
method.</p></li>
|
|||
|
|
<li><p><strong>certificate_verification_info</strong> (<a class="reference internal" href="com.vmware.content.library.html#com.vmware.content.library.item_client.CertificateVerificationInfo" title="com.vmware.content.library.item_client.CertificateVerificationInfo"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.content.library.item_client.CertificateVerificationInfo</span></code></a> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Certificate verification status and <a class="reference internal" href="#com.vmware.content.library_client.ItemModel" title="com.vmware.content.library_client.ItemModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">ItemModel</span></code></a>’s signing
|
|||
|
|
certificate . Currently, this field is available only in following
|
|||
|
|
cases 1. This item belongs to a secure content library 2. The item
|
|||
|
|
is of type ovf. This attribute was added in vSphere API 7.0.3.0.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> and <code class="docutils literal notranslate"><span class="pre">update</span></code>
|
|||
|
|
methods. It may be present in the result of a <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
method.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.OptimizationInfo">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">OptimizationInfo</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">optimize_remote_publishing</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.OptimizationInfo" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">OptimizationInfo</span></code> class defines different optimizations and
|
|||
|
|
optimization parameters applied to particular library.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>optimize_remote_publishing</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – <p>If set to <code class="docutils literal notranslate"><span class="pre">true</span></code> then library would be optimized for remote
|
|||
|
|
publishing.</p>
|
|||
|
|
<p>Turn it on if remote publishing is dominant use case for this
|
|||
|
|
library. Remote publishing means here that publisher and
|
|||
|
|
subscribers are not the part of the same <code class="docutils literal notranslate"><span class="pre">Vcenter</span></code> SSO domain.</p>
|
|||
|
|
<p>Any optimizations could be done as result of turning on this
|
|||
|
|
optimization during library creation. For example, library content
|
|||
|
|
could be stored in different format but optimizations are not
|
|||
|
|
limited to just storage format.</p>
|
|||
|
|
<p>Note, that value of this toggle could be set only during creation
|
|||
|
|
of the library and you would need to migrate your library in case
|
|||
|
|
you need to change this value (optimize the library for different
|
|||
|
|
use case).
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. If not
|
|||
|
|
specified for the <code class="docutils literal notranslate"><span class="pre">create</span></code>, the default is for the library to not
|
|||
|
|
be optmized for specific use case. It is not used for the
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.PublishInfo">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">PublishInfo</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">authentication_method</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">published</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">publish_url</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">user_name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">current_password</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">persist_json_enabled</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.PublishInfo" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">PublishInfo</span></code> class defines how a local library is published publicly
|
|||
|
|
for synchronization to other libraries.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>authentication_method</strong> (<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod"><code class="xref py py-class docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod</span></code></a>) – Indicates how a subscribed library should authenticate (BASIC,
|
|||
|
|
NONE) to the published library endpoint.
|
|||
|
|
This attribute is required for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.create" title="com.vmware.content_client.LocalLibrary.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.create()</span></code></a> method. It is
|
|||
|
|
optional for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.update" title="com.vmware.content_client.LocalLibrary.update"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.update()</span></code></a> operation,
|
|||
|
|
and if None the value will not be changed. When the existing
|
|||
|
|
authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.BASIC</span></code></a> and authentication
|
|||
|
|
is being turned off by updating this attribute to
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.NONE</span></code></a>, then the
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.current_password</span></code> attribute is required. This
|
|||
|
|
attribute will always be present in the results of the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.get" title="com.vmware.content_client.LocalLibrary.get"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.get()</span></code></a> method.</p></li>
|
|||
|
|
<li><p><strong>published</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – Whether the local library is published.
|
|||
|
|
This attribute is required for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.create" title="com.vmware.content_client.LocalLibrary.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.create()</span></code></a> method. It is
|
|||
|
|
optional for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.update" title="com.vmware.content_client.LocalLibrary.update"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.update()</span></code></a> operation,
|
|||
|
|
and if None the value will not be changed. When the existing
|
|||
|
|
authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.BASIC</span></code></a> and the local
|
|||
|
|
library is published, the <code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.current_password</span></code>
|
|||
|
|
attribute is required before turning off publishing. This attribute
|
|||
|
|
will always be present in the results of the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.get" title="com.vmware.content_client.LocalLibrary.get"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.get()</span></code></a> method.</p></li>
|
|||
|
|
<li><p><strong>publish_url</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>The URL to which the library metadata is published by the Content
|
|||
|
|
Library Service.</p>
|
|||
|
|
<p>This value can be used to set the
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">SubscriptionInfo.subscription_url</span></code> property when creating a
|
|||
|
|
subscribed library.
|
|||
|
|
This attribute is not used for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>user_name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The username to require for authentication.
|
|||
|
|
This attribute is optional for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.create" title="com.vmware.content_client.LocalLibrary.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.create()</span></code></a> and
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.update" title="com.vmware.content_client.LocalLibrary.update"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.update()</span></code></a> methods. When
|
|||
|
|
the authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.NONE</span></code></a>, the username can be
|
|||
|
|
left None. When the authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.BASIC</span></code></a>, the username is
|
|||
|
|
ignored in the current release. It defaults to “vcsp”. It is
|
|||
|
|
preferable to leave this None. If specified, it must be set to
|
|||
|
|
“vcsp”.</p></li>
|
|||
|
|
<li><p><strong>password</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The new password to require for authentication.
|
|||
|
|
This attribute is optional for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.create" title="com.vmware.content_client.LocalLibrary.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.create()</span></code></a> method. When
|
|||
|
|
the authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.NONE</span></code></a>, the password can be
|
|||
|
|
left None. When the authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.BASIC</span></code></a>, the password should
|
|||
|
|
be a non-empty string. This attribute is optional for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.update" title="com.vmware.content_client.LocalLibrary.update"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.update()</span></code></a> method.
|
|||
|
|
Leaving it None during update indicates that the password is not
|
|||
|
|
changed. When the password is changed, the
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.current_password</span></code> attribute is required. This
|
|||
|
|
attribute is not used for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.get" title="com.vmware.content_client.LocalLibrary.get"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.get()</span></code></a> method.</p></li>
|
|||
|
|
<li><p><strong>current_password</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The current password to verify. This attribute is available
|
|||
|
|
starting in vSphere 6.7.
|
|||
|
|
This attribute is unused for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.create" title="com.vmware.content_client.LocalLibrary.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.create()</span></code></a> method. This
|
|||
|
|
attribute is optional for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.update" title="com.vmware.content_client.LocalLibrary.update"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.update()</span></code></a> method. When
|
|||
|
|
the existing authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.NONE</span></code></a>, the current password
|
|||
|
|
can be left None. When the existing authentication method is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC" title="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC"><code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod.BASIC</span></code></a>, the current
|
|||
|
|
password is verified before applying the new
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.password</span></code>, turning off authentication, or
|
|||
|
|
unpublishing the library. This attribute is not used for the
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.LocalLibrary.get" title="com.vmware.content_client.LocalLibrary.get"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.LocalLibrary.get()</span></code></a> method.</p></li>
|
|||
|
|
<li><p><strong>persist_json_enabled</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – <p>Whether library and library item metadata are persisted in the
|
|||
|
|
storage backing as JSON files. This flag only applies if the local
|
|||
|
|
library is published.</p>
|
|||
|
|
<p>Enabling JSON persistence allows you to synchronize a subscribed
|
|||
|
|
library manually instead of over HTTP. You copy the local library
|
|||
|
|
content and metadata to another storage backing manually and then
|
|||
|
|
create a subscribed library referencing the location of the library
|
|||
|
|
JSON file in the <code class="xref py py-attr docutils literal notranslate"><span class="pre">SubscriptionInfo.subscription_url</span></code>. When
|
|||
|
|
the subscribed library’s storage backing matches the subscription
|
|||
|
|
URL, files do not need to be copied to the subscribed library.</p>
|
|||
|
|
<p>For a library backed by a datastore, the library JSON file will be
|
|||
|
|
stored at the path contentlib-{library_id}/lib.json on the
|
|||
|
|
datastore.</p>
|
|||
|
|
<p>For a library backed by a remote file system, the library JSON file
|
|||
|
|
will be stored at {library_id}/lib.json in the remote file system
|
|||
|
|
path.
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.PublishInfo.AuthenticationMethod">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">AuthenticationMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">string</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.enum.Enum</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">PublishInfo.AuthenticationMethod</span></code> class indicates how a subscribed
|
|||
|
|
library should authenticate to the published library endpoint.</p>
|
|||
|
|
<div class="admonition note">
|
|||
|
|
<p class="admonition-title">Note</p>
|
|||
|
|
<p>This class represents an enumerated type in the interface language
|
|||
|
|
definition. The class contains class attributes which represent the
|
|||
|
|
values in the current version of the enumerated type. Newer versions of
|
|||
|
|
the enumerated type may contain new values. To use new values of the
|
|||
|
|
enumerated type in communication with a server that supports the newer
|
|||
|
|
version of the API, you instantiate this class. See <a class="reference internal" href="enumeration.html#enumeration-description"><span class="std std-ref">enumerated
|
|||
|
|
type description page</span></a>.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>string</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – String value for the <code class="xref py py-class docutils literal notranslate"><span class="pre">AuthenticationMethod</span></code> instance.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC">
|
|||
|
|
<span class="sig-name descname"><span class="pre">BASIC</span></span><em class="property"> <span class="pre">=</span> <span class="pre">AuthenticationMethod(string='BASIC')</span></em><a class="headerlink" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Require HTTP Basic authentication matching a specified username and
|
|||
|
|
password.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE">
|
|||
|
|
<span class="sig-name descname"><span class="pre">NONE</span></span><em class="property"> <span class="pre">=</span> <span class="pre">AuthenticationMethod(string='NONE')</span></em><a class="headerlink" href="#com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Require no authentication.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SourceInfo">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">SourceInfo</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">source_library</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscription</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.SourceInfo" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">SourceInfo</span></code> class contains information about the source published
|
|||
|
|
library of a subscribed library. This class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>source_library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the published library. This attribute was added in
|
|||
|
|
vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>. When methods return a value of this
|
|||
|
|
class as a return value, the attribute will be an identifier for
|
|||
|
|
the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>subscription</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the subscription associated with the subscribed
|
|||
|
|
library. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>. When methods return a
|
|||
|
|
value of this class as a return value, the attribute will be an
|
|||
|
|
identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.StorageBacking">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">StorageBacking</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">type</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">datastore_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">storage_uri</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.StorageBacking" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">StorageBacking</span></code> class defines a storage location where content in a
|
|||
|
|
library will be stored. The storage location can either be a Datastore or
|
|||
|
|
Other type.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>type</strong> (<a class="reference internal" href="#com.vmware.content.library_client.StorageBacking.Type" title="com.vmware.content.library_client.StorageBacking.Type"><code class="xref py py-class docutils literal notranslate"><span class="pre">StorageBacking.Type</span></code></a>) – Type (DATASTORE, OTHER) of <a class="reference internal" href="#com.vmware.content.library_client.StorageBacking" title="com.vmware.content.library_client.StorageBacking"><code class="xref py py-class docutils literal notranslate"><span class="pre">StorageBacking</span></code></a>.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is not used for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>datastore_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the datastore used to store the content in the
|
|||
|
|
library.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Datastore</span></code>. When methods return a value of this class as a
|
|||
|
|
return value, the attribute will be an identifier for the resource
|
|||
|
|
type: <code class="docutils literal notranslate"><span class="pre">Datastore</span></code>.
|
|||
|
|
This attribute is optional and it is only relevant when the value
|
|||
|
|
of <code class="docutils literal notranslate"><span class="pre">type</span></code> is <a class="reference internal" href="#com.vmware.content.library_client.StorageBacking.Type.DATASTORE" title="com.vmware.content.library_client.StorageBacking.Type.DATASTORE"><code class="xref py py-attr docutils literal notranslate"><span class="pre">StorageBacking.Type.DATASTORE</span></code></a>.</p></li>
|
|||
|
|
<li><p><strong>storage_uri</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>URI identifying the location used to store the content in the
|
|||
|
|
library.</p>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>The following URI formats are supported:</p>
|
|||
|
|
<p>vSphere 6.5</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<ul>
|
|||
|
|
<li><p><a class="reference external" href="nfs://server/path?version=4">nfs://server/path?version=4</a> (for vCenter Server Appliance only) -
|
|||
|
|
Specifies an NFS Version 4 server.</p></li>
|
|||
|
|
<li><p><a class="reference external" href="nfs://server/path">nfs://server/path</a> (for vCenter Server Appliance only) - Specifies
|
|||
|
|
an NFS Version 3 server. The <a class="reference external" href="nfs://server:/path">nfs://server:/path</a> format is also
|
|||
|
|
supported.</p></li>
|
|||
|
|
<li><p><a class="reference external" href="smb://server/path">smb://server/path</a> - Specifies an SMB server or Windows share.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>vSphere 6.0 Update 1</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<ul>
|
|||
|
|
<li><p><a class="reference external" href="nfs://server:/path">nfs://server:/path</a> (for vCenter Server Appliance only)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="file://unc-server/path">file://unc-server/path</a> (for vCenter Server for Windows only)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="file:///mount/point">file:///mount/point</a> (for vCenter Server Appliance only) - Local
|
|||
|
|
file URIs are supported only when the path is a local mount point
|
|||
|
|
for an NFS file system. Use of file URIs is strongly discouraged.
|
|||
|
|
Instead, use an NFS URI to specify the remote file system.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>vSphere 6.0</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<ul>
|
|||
|
|
<li><p><a class="reference external" href="nfs://server:/path">nfs://server:/path</a> (for vCenter Server Appliance only)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="file://unc-server/path">file://unc-server/path</a> (for vCenter Server for Windows only)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="file:///path">file:///path</a> - Local file URIs are supported but strongly
|
|||
|
|
discouraged because it may interfere with the performance of
|
|||
|
|
vCenter Server.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p>This attribute is optional and it is only relevant when the value
|
|||
|
|
of <code class="docutils literal notranslate"><span class="pre">type</span></code> is <a class="reference internal" href="#com.vmware.content.library_client.StorageBacking.Type.OTHER" title="com.vmware.content.library_client.StorageBacking.Type.OTHER"><code class="xref py py-attr docutils literal notranslate"><span class="pre">StorageBacking.Type.OTHER</span></code></a>.</p>
|
|||
|
|
</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.StorageBacking.Type">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">Type</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">string</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.StorageBacking.Type" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.enum.Enum</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">StorageBacking.Type</span></code> class specifies the type of the
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.StorageBacking" title="com.vmware.content.library_client.StorageBacking"><code class="xref py py-class docutils literal notranslate"><span class="pre">StorageBacking</span></code></a>.</p>
|
|||
|
|
<div class="admonition note">
|
|||
|
|
<p class="admonition-title">Note</p>
|
|||
|
|
<p>This class represents an enumerated type in the interface language
|
|||
|
|
definition. The class contains class attributes which represent the
|
|||
|
|
values in the current version of the enumerated type. Newer versions of
|
|||
|
|
the enumerated type may contain new values. To use new values of the
|
|||
|
|
enumerated type in communication with a server that supports the newer
|
|||
|
|
version of the API, you instantiate this class. See <a class="reference internal" href="enumeration.html#enumeration-description"><span class="std std-ref">enumerated
|
|||
|
|
type description page</span></a>.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>string</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – String value for the <code class="xref py py-class docutils literal notranslate"><span class="pre">Type</span></code> instance.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.StorageBacking.Type.DATASTORE">
|
|||
|
|
<span class="sig-name descname"><span class="pre">DATASTORE</span></span><em class="property"> <span class="pre">=</span> <span class="pre">Type(string='DATASTORE')</span></em><a class="headerlink" href="#com.vmware.content.library_client.StorageBacking.Type.DATASTORE" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>The content of the library will be stored on a datastore.</p>
|
|||
|
|
<p>These are vCenter Server managed datastores, and are logical containers
|
|||
|
|
that hide specifics of each storage device. Depending on the type of
|
|||
|
|
storage you use, datastores can be backed by the following file system
|
|||
|
|
formats:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Virtual Machine File System (VMFS)</p></li>
|
|||
|
|
<li><p>Network File System (NFS)</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.StorageBacking.Type.OTHER">
|
|||
|
|
<span class="sig-name descname"><span class="pre">OTHER</span></span><em class="property"> <span class="pre">=</span> <span class="pre">Type(string='OTHER')</span></em><a class="headerlink" href="#com.vmware.content.library_client.StorageBacking.Type.OTHER" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>The content of the library will be stored on a remote file system.</p>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>Supports the following remote file systems:</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>NFS (on vCenter Server Appliance)</p></li>
|
|||
|
|
<li><p>SMB (on vCenter Server Appliance and vCenter Server for Windows)</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.StubFactory">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">StubFactory</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">stub_config</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.StubFactory" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.StubFactoryBase</span></code></p>
|
|||
|
|
<p>Initialize StubFactoryBase</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>stub_config</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Stub config instance</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SubscribedItem">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">SubscribedItem</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">config</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.SubscribedItem" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.VapiInterface</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">SubscribedItem</span></code> class manages the unique features of library items
|
|||
|
|
that are members of a subscribed library.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>config</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SubscribedItem.evict">
|
|||
|
|
<span class="sig-name descname"><span class="pre">evict</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library_item_id</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.SubscribedItem.evict" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Evicts the cached content of a library item in a subscribed library.</p>
|
|||
|
|
<p>This method allows the cached content of a library item to be removed
|
|||
|
|
to free up storage capacity. This method will only work when a library
|
|||
|
|
item is synchronized on-demand. When a library is not synchronized
|
|||
|
|
on-demand, it always attempts to keep its cache up-to-date with the
|
|||
|
|
published source. Evicting the library item will set
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.cached</span></code> to false.</p>
|
|||
|
|
<dl class="field-list">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>library_item_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the library item whose content should be evicted.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> does not
|
|||
|
|
exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
if the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> is not a
|
|||
|
|
member of a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementConfiguration" title="com.vmware.vapi.std.errors_client.InvalidElementConfiguration"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementConfiguration</span></code></a>
|
|||
|
|
if the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> is a member of
|
|||
|
|
a subscribed library that does not synchronize on-demand.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
if the content of the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code>
|
|||
|
|
has been deleted from the storage backings (see
|
|||
|
|
LibraryModel#storageBackings) associated with it.</p>
|
|||
|
|
<p>For instance, this {\@term error) is reported on evicting a
|
|||
|
|
library item in an on-demand subscribed library that was restored
|
|||
|
|
from backup, and the library item was deleted after backup, thus
|
|||
|
|
resulting in its content being deleted from the associated storage
|
|||
|
|
backings. In this scenario, the metadata of the library item is
|
|||
|
|
present on a restore, while its content has been deleted.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code> referenced by
|
|||
|
|
the parameter <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.EvictLibraryItem</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SubscribedItem.sync">
|
|||
|
|
<span class="sig-name descname"><span class="pre">sync</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library_item_id</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_sync_content</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sync_optional_files</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.SubscribedItem.sync" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Forces the synchronization of an individual library item in a
|
|||
|
|
subscribed library.</p>
|
|||
|
|
<p>Synchronizing an individual item will update that item’s metadata from
|
|||
|
|
the remote source. If the source library item on the remote library has
|
|||
|
|
been deleted, this method will delete the library item from the
|
|||
|
|
subscribed library as well.</p>
|
|||
|
|
<p>The default behavior of the synchronization is determined by the
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.SubscriptionInfo" title="com.vmware.content.library_client.SubscriptionInfo"><code class="xref py py-class docutils literal notranslate"><span class="pre">SubscriptionInfo</span></code></a> of the library which owns the library item.</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>If <code class="xref py py-attr docutils literal notranslate"><span class="pre">SubscriptionInfo.on_demand</span></code> is true, then the file content
|
|||
|
|
is not synchronized by default. In this case, only the library item
|
|||
|
|
metadata is synchronized. The file content may still be forcefully
|
|||
|
|
synchronized by passing true for the <code class="docutils literal notranslate"><span class="pre">force_sync_content</span></code> parameter.</p></li>
|
|||
|
|
<li><p>If <code class="xref py py-attr docutils literal notranslate"><span class="pre">SubscriptionInfo.on_demand</span></code> is false, then this call will
|
|||
|
|
always synchronize the file content. The <code class="docutils literal notranslate"><span class="pre">force_sync_content</span></code>
|
|||
|
|
parameter is ignored when the subscription is not on-demand.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p>When the file content has been synchronized, the
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">ItemModel.cached</span></code> attribute will be true.</p>
|
|||
|
|
<p>This method will return immediately and create an asynchronous task to
|
|||
|
|
perform the synchronization.</p>
|
|||
|
|
<dl class="field-list">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>library_item_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the library item to synchronize.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code>.</p></li>
|
|||
|
|
<li><p><strong>force_sync_content</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – Whether to synchronize file content as well as metadata. This
|
|||
|
|
parameter applies only if the subscription is on-demand.</p></li>
|
|||
|
|
<li><p><strong>sync_optional_files</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Whether to synchronize optional files. This parameter applies to
|
|||
|
|
both types of subscriptions on-demand as well as sync-immediately.
|
|||
|
|
This parameter was added in vSphere API 7.0.3.0.
|
|||
|
|
This parameter is optional because it was added in a newer version
|
|||
|
|
than its parent node.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
if the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> could not be
|
|||
|
|
found.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
if the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> is not a
|
|||
|
|
member of a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
if the content of the library item specified by <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code>
|
|||
|
|
has been deleted from the storage backings (see
|
|||
|
|
LibraryModel#storageBackings) associated with it.</p>
|
|||
|
|
<p>For instance, this {\@term error) is reported on synchronizing a
|
|||
|
|
library item in a subscribed library that was restored from backup,
|
|||
|
|
and the library item was deleted after backup, thus resulting in
|
|||
|
|
its content being deleted from the associated storage backings. In
|
|||
|
|
this scenario, the metadata of the library item is present on a
|
|||
|
|
restore, while its content has been deleted.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Item</span></code> referenced by
|
|||
|
|
the parameter <code class="docutils literal notranslate"><span class="pre">library_item_id</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.SyncLibraryItem</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SubscriptionInfo">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">SubscriptionInfo</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">authentication_method</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">automatic_sync_enabled</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">on_demand</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ssl_thumbprint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscription_url</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">user_name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source_info</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.SubscriptionInfo" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">SubscriptionInfo</span></code> class defines the subscription behavior for a
|
|||
|
|
subscribed library.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>authentication_method</strong> (<a class="reference internal" href="#com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod" title="com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod"><code class="xref py py-class docutils literal notranslate"><span class="pre">SubscriptionInfo.AuthenticationMethod</span></code></a>) – Indicate how the subscribed library should authenticate (BASIC,
|
|||
|
|
NONE) with the published library endpoint.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>automatic_sync_enabled</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – Whether the library should participate in automatic library
|
|||
|
|
synchronization. In order for automatic synchronization to happen,
|
|||
|
|
the global
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">com.vmware.content_client.ConfigurationModel.automatic_sync_enabled</span></code>
|
|||
|
|
option must also be true. The subscription is still active even
|
|||
|
|
when automatic synchronization is turned off, but synchronization
|
|||
|
|
is only activated with an explicit call to
|
|||
|
|
<a class="reference internal" href="com.vmware.html#com.vmware.content_client.SubscribedLibrary.sync" title="com.vmware.content_client.SubscribedLibrary.sync"><code class="xref py py-func docutils literal notranslate"><span class="pre">com.vmware.content_client.SubscribedLibrary.sync()</span></code></a> or
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.SubscribedItem.sync" title="com.vmware.content.library_client.SubscribedItem.sync"><code class="xref py py-func docutils literal notranslate"><span class="pre">SubscribedItem.sync()</span></code></a>. In other words, manual synchronization
|
|||
|
|
is still available even when automatic synchronization is disabled.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
<li><p><strong>on_demand</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – <p>Indicates whether a library item’s content will be synchronized
|
|||
|
|
only on demand.</p>
|
|||
|
|
<p>If this is set to <code class="docutils literal notranslate"><span class="pre">true</span></code>, then the library item’s metadata will
|
|||
|
|
be synchronized but the item’s content (its files) will not be
|
|||
|
|
synchronized. The Content Library Service will synchronize the
|
|||
|
|
content upon request only. This can cause the first use of the
|
|||
|
|
content to have a noticeable delay.</p>
|
|||
|
|
<p>Items without synchronized content can be forcefully synchronized
|
|||
|
|
in advance using the <a class="reference internal" href="#com.vmware.content.library_client.SubscribedItem.sync" title="com.vmware.content.library_client.SubscribedItem.sync"><code class="xref py py-func docutils literal notranslate"><span class="pre">SubscribedItem.sync()</span></code></a> call with
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">forceSyncContent</span></code> set to true. Once content has been
|
|||
|
|
synchronized, the content can removed with the
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.SubscribedItem.evict" title="com.vmware.content.library_client.SubscribedItem.evict"><code class="xref py py-func docutils literal notranslate"><span class="pre">SubscribedItem.evict()</span></code></a> call.</p>
|
|||
|
|
<p>If this value is set to <code class="docutils literal notranslate"><span class="pre">false</span></code>, all content will be synchronized
|
|||
|
|
in advance.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>password</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>The password to use when authenticating.</p>
|
|||
|
|
<p>The password must be set when using a password-based authentication
|
|||
|
|
method; empty strings are not allowed.
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will not
|
|||
|
|
be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods.
|
|||
|
|
It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>ssl_thumbprint</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>An optional SHA-1 hash of the SSL certificate for the remote
|
|||
|
|
endpoint.</p>
|
|||
|
|
<p>If this value is defined the SSL certificate will be verified by
|
|||
|
|
comparing it to the SSL thumbprint. The SSL certificate must verify
|
|||
|
|
against the thumbprint. When specified, the standard certificate
|
|||
|
|
chain validation behavior is not used. The certificate chain is
|
|||
|
|
validated normally if this value is None.
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will not
|
|||
|
|
be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods.
|
|||
|
|
It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>subscription_url</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>The URL of the endpoint where the metadata for the remotely
|
|||
|
|
published library is being served.</p>
|
|||
|
|
<p>This URL can be the <code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.publish_url</span></code> of the
|
|||
|
|
published library (for example, <a class="reference external" href="https://server/path/lib.json">https://server/path/lib.json</a>).</p>
|
|||
|
|
<p>If the source content comes from a published library with
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.persist_json_enabled</span></code>, the subscription URL can
|
|||
|
|
be a URL pointing to the library JSON file on a datastore or remote
|
|||
|
|
file system. The supported formats are:</p>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>vSphere 6.5</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<ul>
|
|||
|
|
<li><p>ds:///vmfs/volumes/{uuid}/mylibrary/lib.json (for datastore)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="nfs://server/path/mylibrary/lib.json">nfs://server/path/mylibrary/lib.json</a> (for NFSv3 server on vCenter
|
|||
|
|
Server Appliance)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="nfs://server/path/mylibrary/lib.json?version=4">nfs://server/path/mylibrary/lib.json?version=4</a> (for NFSv4 server
|
|||
|
|
on vCenter Server Appliance)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="smb://server/path/mylibrary/lib.json">smb://server/path/mylibrary/lib.json</a> (for SMB server)</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<blockquote>
|
|||
|
|
<div><p>vSphere 6.0</p>
|
|||
|
|
</div></blockquote>
|
|||
|
|
<ul>
|
|||
|
|
<li><p><a class="reference external" href="file://server/mylibrary/lib.json">file://server/mylibrary/lib.json</a> (for UNC server on vCenter
|
|||
|
|
Server for Windows)</p></li>
|
|||
|
|
<li><p><a class="reference external" href="file:///path/mylibrary/lib.json">file:///path/mylibrary/lib.json</a> (for local file system)</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p>When you specify a DS subscription URL, the datastore must be on
|
|||
|
|
the same vCenter Server as the subscribed library. When you specify
|
|||
|
|
an NFS or SMB subscription URL, the
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">StorageBacking.storage_uri</span></code> of the subscribed library must
|
|||
|
|
be on the same remote file server and should share a common parent
|
|||
|
|
path with the subscription URL.
|
|||
|
|
This attribute must be provided for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It will
|
|||
|
|
always be present in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code>
|
|||
|
|
methods. It is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>user_name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – <p>The username to use when authenticating.</p>
|
|||
|
|
<p>The username must be set when using a password-based authentication
|
|||
|
|
method. Empty strings are allowed for usernames.
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It is
|
|||
|
|
optional in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods. It
|
|||
|
|
is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>source_info</strong> (<a class="reference internal" href="#com.vmware.content.library_client.SourceInfo" title="com.vmware.content.library_client.SourceInfo"><code class="xref py py-class docutils literal notranslate"><span class="pre">SourceInfo</span></code></a>) – Information about the source published library. This attribute will
|
|||
|
|
be set for a subscribed library which is associated with a
|
|||
|
|
subscription of the published library. This attribute was added in
|
|||
|
|
vSphere API 6.7.2.
|
|||
|
|
This attribute is optional for the <code class="docutils literal notranslate"><span class="pre">create</span></code> method. It is
|
|||
|
|
optional in the return value of the <code class="docutils literal notranslate"><span class="pre">get</span></code> or <code class="docutils literal notranslate"><span class="pre">list</span></code> methods. It
|
|||
|
|
is optional for the <code class="docutils literal notranslate"><span class="pre">update</span></code> method.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">AuthenticationMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">string</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.enum.Enum</span></code></p>
|
|||
|
|
<p>Indicate how the subscribed library should authenticate with the published
|
|||
|
|
library endpoint.</p>
|
|||
|
|
<div class="admonition note">
|
|||
|
|
<p class="admonition-title">Note</p>
|
|||
|
|
<p>This class represents an enumerated type in the interface language
|
|||
|
|
definition. The class contains class attributes which represent the
|
|||
|
|
values in the current version of the enumerated type. Newer versions of
|
|||
|
|
the enumerated type may contain new values. To use new values of the
|
|||
|
|
enumerated type in communication with a server that supports the newer
|
|||
|
|
version of the API, you instantiate this class. See <a class="reference internal" href="enumeration.html#enumeration-description"><span class="std std-ref">enumerated
|
|||
|
|
type description page</span></a>.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>string</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – String value for the <code class="xref py py-class docutils literal notranslate"><span class="pre">AuthenticationMethod</span></code> instance.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod.BASIC">
|
|||
|
|
<span class="sig-name descname"><span class="pre">BASIC</span></span><em class="property"> <span class="pre">=</span> <span class="pre">AuthenticationMethod(string='BASIC')</span></em><a class="headerlink" href="#com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod.BASIC" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Require HTTP Basic authentication matching a specified username and
|
|||
|
|
password.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod.NONE">
|
|||
|
|
<span class="sig-name descname"><span class="pre">NONE</span></span><em class="property"> <span class="pre">=</span> <span class="pre">AuthenticationMethod(string='NONE')</span></em><a class="headerlink" href="#com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod.NONE" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Require no authentication.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">com.vmware.content.library_client.</span></span><span class="sig-name descname"><span class="pre">Subscriptions</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">config</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.VapiInterface</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions</span></code> class provides methods for managing the subscription
|
|||
|
|
information of the subscribers of a published library. This class was added
|
|||
|
|
in vSphere API 6.7.2.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>config</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) – Configuration to be used for creating the stub.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpec">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">CreateSpec</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">subscribed_library</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpec" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.CreateSpec</span></code> class defines the information required to
|
|||
|
|
create a new subscription of the published library. This class was added in
|
|||
|
|
vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>subscribed_library</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary" title="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecSubscribedLibrary</span></code></a>) – Specification for the subscribed library to be associated with the
|
|||
|
|
subscription. This attribute was added in vSphere API 6.7.2.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpecNewSubscribedLibrary">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">CreateSpecNewSubscribedLibrary</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">description</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">storage_backings</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">automatic_sync_enabled</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">on_demand</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpecNewSubscribedLibrary" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecNewSubscribedLibrary</span></code> class defines the
|
|||
|
|
information required to create a new subscribed library. This class was
|
|||
|
|
added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Name of the subscribed library. This attribute was added in vSphere
|
|||
|
|
API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>description</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Description of the subscribed library. This attribute was added in
|
|||
|
|
vSphere API 6.7.2.
|
|||
|
|
If None, the description will be an empty string.</p></li>
|
|||
|
|
<li><p><strong>storage_backings</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="#com.vmware.content.library_client.StorageBacking" title="com.vmware.content.library_client.StorageBacking"><code class="xref py py-class docutils literal notranslate"><span class="pre">StorageBacking</span></code></a>) – <p>The list of default storage backings for this library.</p>
|
|||
|
|
<p>The list must contain exactly one storage backing. Multiple default
|
|||
|
|
storage locations are not currently supported but may become
|
|||
|
|
supported in future releases.. This attribute was added in vSphere
|
|||
|
|
API 6.7.2.</p>
|
|||
|
|
</p></li>
|
|||
|
|
<li><p><strong>automatic_sync_enabled</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – Specifies whether the library should participate in automatic
|
|||
|
|
library synchronization. This attribute was added in vSphere API
|
|||
|
|
6.7.2.</p></li>
|
|||
|
|
<li><p><strong>on_demand</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) – Specifies whether a library item’s content will be synchronized
|
|||
|
|
only on demand. This attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpecPlacement">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">CreateSpecPlacement</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">folder</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">cluster</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">resource_pool</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">host</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">network</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpecPlacement" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecPlacement</span></code> class defines the placement
|
|||
|
|
information for the subscribed library’s virtual machine template library
|
|||
|
|
items. Storage location of the virtual machine template items is defined by
|
|||
|
|
the subscribed library’s storage backing. This placement information needs
|
|||
|
|
to be compatible with the subscribed library’s storage backing. The
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecPlacement</span></code> class is only applicable for the
|
|||
|
|
virtual machine template library items of the subscribed library. This
|
|||
|
|
class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>folder</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Virtual machine folder into which the virtual machine template
|
|||
|
|
should be placed. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Folder:VCenter</span></code>. When methods return a value of this class as a
|
|||
|
|
return value, the attribute will be an identifier for the resource
|
|||
|
|
type: <code class="docutils literal notranslate"><span class="pre">Folder:VCenter</span></code>.
|
|||
|
|
This attribute is currently required. In future, if this is None,
|
|||
|
|
the system will attempt to choose a suitable folder for the virtual
|
|||
|
|
machine template; if a folder cannot be chosen, publishing a
|
|||
|
|
virtual machine template item will fail.</p></li>
|
|||
|
|
<li><p><strong>cluster</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Cluster onto which the virtual machine template should be placed.
|
|||
|
|
If <code class="docutils literal notranslate"><span class="pre">cluster</span></code> and <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> are both specified,
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> must belong to <code class="docutils literal notranslate"><span class="pre">cluster</span></code>. If <code class="docutils literal notranslate"><span class="pre">cluster</span></code> and
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">host</span></code> are both specified, <code class="docutils literal notranslate"><span class="pre">host</span></code> must be a member of
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">cluster</span></code>. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ClusterComputeResource:VCenter</span></code>. When methods return a value of
|
|||
|
|
this class as a return value, the attribute will be an identifier
|
|||
|
|
for the resource type: <code class="docutils literal notranslate"><span class="pre">ClusterComputeResource:VCenter</span></code>.
|
|||
|
|
If <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> or <code class="docutils literal notranslate"><span class="pre">host</span></code> is specified, it is recommended
|
|||
|
|
that this attribute be None.</p></li>
|
|||
|
|
<li><p><strong>resource_pool</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Resource pool into which the virtual machine template should be
|
|||
|
|
placed. If <code class="docutils literal notranslate"><span class="pre">host</span></code> and <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> are both specified,
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> must belong to <code class="docutils literal notranslate"><span class="pre">host</span></code>. If <code class="docutils literal notranslate"><span class="pre">cluster</span></code> and
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> are both specified, <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> must belong
|
|||
|
|
to <code class="docutils literal notranslate"><span class="pre">cluster</span></code>. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ResourcePool:VCenter</span></code>. When methods return a value of this class
|
|||
|
|
as a return value, the attribute will be an identifier for the
|
|||
|
|
resource type: <code class="docutils literal notranslate"><span class="pre">ResourcePool:VCenter</span></code>.
|
|||
|
|
This attribute is currently required. In future, if this is None,
|
|||
|
|
the system will attempt to choose a suitable resource pool for the
|
|||
|
|
virtual machine template; if a resource pool cannot be chosen,
|
|||
|
|
publish of virtual machine template item will fail.</p></li>
|
|||
|
|
<li><p><strong>host</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Host onto which the virtual machine template should be placed. If
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">host</span></code> and <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> are both specified, <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code>
|
|||
|
|
must belong to <code class="docutils literal notranslate"><span class="pre">host</span></code>. If <code class="docutils literal notranslate"><span class="pre">host</span></code> and <code class="docutils literal notranslate"><span class="pre">cluster</span></code> are both
|
|||
|
|
specified, <code class="docutils literal notranslate"><span class="pre">host</span></code> must be a member of <code class="docutils literal notranslate"><span class="pre">cluster</span></code>. This attribute
|
|||
|
|
was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">HostSystem:VCenter</span></code>. When methods return a value of this class
|
|||
|
|
as a return value, the attribute will be an identifier for the
|
|||
|
|
resource type: <code class="docutils literal notranslate"><span class="pre">HostSystem:VCenter</span></code>.
|
|||
|
|
If this is None, the system will attempt to choose a suitable host
|
|||
|
|
for the virtual machine template; if a host cannot be chosen,
|
|||
|
|
publishing the virtual machine template item will fail.</p></li>
|
|||
|
|
<li><p><strong>network</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Network that backs the virtual Ethernet adapters in the virtual
|
|||
|
|
machine template. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Network:VCenter</span></code>. When methods return a value of this class as a
|
|||
|
|
return value, the attribute will be an identifier for the resource
|
|||
|
|
type: <code class="docutils literal notranslate"><span class="pre">Network:VCenter</span></code>.
|
|||
|
|
If None, the virtual Ethernet adapters will not be backed by a
|
|||
|
|
network.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">CreateSpecSubscribedLibrary</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">target</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">new_subscribed_library</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">location</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">vcenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">placement</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecSubscribedLibrary</span></code> class defines the
|
|||
|
|
subscribed library information used to create the subscription. This class
|
|||
|
|
was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>target</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target" title="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecSubscribedLibrary.Target</span></code></a>) – Specifies whether the target subscribed library should be newly
|
|||
|
|
created or an existing subscribed library should be used. This
|
|||
|
|
attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>new_subscribed_library</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpecNewSubscribedLibrary" title="com.vmware.content.library_client.Subscriptions.CreateSpecNewSubscribedLibrary"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecNewSubscribedLibrary</span></code></a>) – Specification for creating a new subscribed library associated with
|
|||
|
|
the subscription. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
This attribute is optional and it is only relevant when the value
|
|||
|
|
of <code class="docutils literal notranslate"><span class="pre">target</span></code> is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.CREATE_NEW" title="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.CREATE_NEW"><code class="xref py py-attr docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecSubscribedLibrary.Target.CREATE_NEW</span></code></a>.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the existing subscribed library to associate with the
|
|||
|
|
subscription. Only the subscribed libraries for which
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">SubscriptionInfo.subscription_url</span></code> property is set to the
|
|||
|
|
<code class="xref py py-attr docutils literal notranslate"><span class="pre">PublishInfo.publish_url</span></code> of the published library can be
|
|||
|
|
associated with the subscription. This attribute was added in
|
|||
|
|
vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>. When methods return a value of this
|
|||
|
|
class as a return value, the attribute will be an identifier for
|
|||
|
|
the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.
|
|||
|
|
This attribute is optional and it is only relevant when the value
|
|||
|
|
of <code class="docutils literal notranslate"><span class="pre">target</span></code> is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.USE_EXISTING" title="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.USE_EXISTING"><code class="xref py py-attr docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecSubscribedLibrary.Target.USE_EXISTING</span></code></a>.</p></li>
|
|||
|
|
<li><p><strong>location</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.Location" title="com.vmware.content.library_client.Subscriptions.Location"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.Location</span></code></a>) – Location of the subscribed library relative to the published
|
|||
|
|
library. This attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>vcenter</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpecVcenter" title="com.vmware.content.library_client.Subscriptions.CreateSpecVcenter"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecVcenter</span></code></a>) – Specification for the subscribed library’s vCenter Server instance.
|
|||
|
|
This attribute was added in vSphere API 6.7.2.
|
|||
|
|
This attribute is optional and it is only relevant when the value
|
|||
|
|
of <code class="docutils literal notranslate"><span class="pre">location</span></code> is <a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.Location.REMOTE" title="com.vmware.content.library_client.Subscriptions.Location.REMOTE"><code class="xref py py-attr docutils literal notranslate"><span class="pre">Subscriptions.Location.REMOTE</span></code></a>.</p></li>
|
|||
|
|
<li><p><strong>placement</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpecPlacement" title="com.vmware.content.library_client.Subscriptions.CreateSpecPlacement"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecPlacement</span></code></a> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Placement specification for the virtual machine template library
|
|||
|
|
items on the subscribed library. This attribute was added in
|
|||
|
|
vSphere API 6.7.2.
|
|||
|
|
This attribute is currently required. In future, if this is None,
|
|||
|
|
the system will attempt to choose a suitable placement
|
|||
|
|
specification for the virtual machine template items; if a
|
|||
|
|
placement specification cannot be chosen, publish of virtual
|
|||
|
|
machine template items will fail.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">Target</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">string</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.enum.Enum</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecSubscribedLibrary.Target</span></code> class defines the
|
|||
|
|
options related to the target subscribed library which will be associated
|
|||
|
|
with the subscription. This enumeration was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition note">
|
|||
|
|
<p class="admonition-title">Note</p>
|
|||
|
|
<p>This class represents an enumerated type in the interface language
|
|||
|
|
definition. The class contains class attributes which represent the
|
|||
|
|
values in the current version of the enumerated type. Newer versions of
|
|||
|
|
the enumerated type may contain new values. To use new values of the
|
|||
|
|
enumerated type in communication with a server that supports the newer
|
|||
|
|
version of the API, you instantiate this class. See <a class="reference internal" href="enumeration.html#enumeration-description"><span class="std std-ref">enumerated
|
|||
|
|
type description page</span></a>.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>string</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – String value for the <code class="xref py py-class docutils literal notranslate"><span class="pre">Target</span></code> instance.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.CREATE_NEW">
|
|||
|
|
<span class="sig-name descname"><span class="pre">CREATE_NEW</span></span><em class="property"> <span class="pre">=</span> <span class="pre">Target(string='CREATE_NEW')</span></em><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.CREATE_NEW" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Create a new subscribed library. This class attribute was added in vSphere
|
|||
|
|
API 6.7.2.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.USE_EXISTING">
|
|||
|
|
<span class="sig-name descname"><span class="pre">USE_EXISTING</span></span><em class="property"> <span class="pre">=</span> <span class="pre">Target(string='USE_EXISTING')</span></em><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.USE_EXISTING" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Use the specified existing subscribed library. This class attribute was
|
|||
|
|
added in vSphere API 6.7.2.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.CreateSpecVcenter">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">CreateSpecVcenter</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">hostname</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">https_port</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.CreateSpecVcenter" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.CreateSpecVcenter</span></code> class defines information about the
|
|||
|
|
vCenter Server instance where the subscribed library associated with the
|
|||
|
|
subscription exists or will be created. This class was added in vSphere API
|
|||
|
|
6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>hostname</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The hostname of the subscribed library’s vCenter Server. This
|
|||
|
|
attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>https_port</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">long</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The HTTPS port of the vCenter Server instance where the subscribed
|
|||
|
|
library exists. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
If None, port 443 will be used.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.Info">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">Info</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">subscribed_library</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library_name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library_location</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library_vcenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library_placement</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.Info" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.Info</span></code> class contains information about the
|
|||
|
|
subscription. This class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>subscribed_library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the subscribed library associated with the
|
|||
|
|
subscription. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>. When methods return a value of this
|
|||
|
|
class as a return value, the attribute will be an identifier for
|
|||
|
|
the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library_name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Name of the subscribed library associated with the subscription.
|
|||
|
|
This attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library_location</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.Location" title="com.vmware.content.library_client.Subscriptions.Location"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.Location</span></code></a>) – Location of the subscribed library relative to the published
|
|||
|
|
library. This attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library_vcenter</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.VcenterInfo" title="com.vmware.content.library_client.Subscriptions.VcenterInfo"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.VcenterInfo</span></code></a>) – Information about the vCenter Server instance where the subscribed
|
|||
|
|
library exists. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
This attribute is optional and it is only relevant when the value
|
|||
|
|
of <code class="docutils literal notranslate"><span class="pre">subscribedLibraryLocation</span></code> is
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.Location.REMOTE" title="com.vmware.content.library_client.Subscriptions.Location.REMOTE"><code class="xref py py-attr docutils literal notranslate"><span class="pre">Subscriptions.Location.REMOTE</span></code></a>.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library_placement</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.PlacementInfo" title="com.vmware.content.library_client.Subscriptions.PlacementInfo"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.PlacementInfo</span></code></a>) – Placement information about the subscribed library’s virtual
|
|||
|
|
machine template items. This attribute was added in vSphere API
|
|||
|
|
6.7.2.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.Location">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">Location</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">string</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.Location" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.enum.Enum</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.Location</span></code> class defines the location of subscribed
|
|||
|
|
library relative to the published library. This enumeration was added in
|
|||
|
|
vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition note">
|
|||
|
|
<p class="admonition-title">Note</p>
|
|||
|
|
<p>This class represents an enumerated type in the interface language
|
|||
|
|
definition. The class contains class attributes which represent the
|
|||
|
|
values in the current version of the enumerated type. Newer versions of
|
|||
|
|
the enumerated type may contain new values. To use new values of the
|
|||
|
|
enumerated type in communication with a server that supports the newer
|
|||
|
|
version of the API, you instantiate this class. See <a class="reference internal" href="enumeration.html#enumeration-description"><span class="std std-ref">enumerated
|
|||
|
|
type description page</span></a>.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>string</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – String value for the <code class="xref py py-class docutils literal notranslate"><span class="pre">Location</span></code> instance.</p>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.Location.LOCAL">
|
|||
|
|
<span class="sig-name descname"><span class="pre">LOCAL</span></span><em class="property"> <span class="pre">=</span> <span class="pre">Location(string='LOCAL')</span></em><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.Location.LOCAL" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>The subscribed library belongs to the same vCenter instance as the
|
|||
|
|
published library. This class attribute was added in vSphere API 6.7.2.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.Location.REMOTE">
|
|||
|
|
<span class="sig-name descname"><span class="pre">REMOTE</span></span><em class="property"> <span class="pre">=</span> <span class="pre">Location(string='REMOTE')</span></em><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.Location.REMOTE" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>The subscribed library belongs to a different vCenter instance than the
|
|||
|
|
published library. This class attribute was added in vSphere API 6.7.2.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.PlacementInfo">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">PlacementInfo</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">folder</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">cluster</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">resource_pool</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">host</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">network</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.PlacementInfo" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.PlacementInfo</span></code> class contains the placement
|
|||
|
|
information for the subscribed library’s virtual machine template library
|
|||
|
|
items. The <code class="docutils literal notranslate"><span class="pre">Subscriptions.PlacementInfo</span></code> class is only applicable for the
|
|||
|
|
virtual machine template library items of the subscribed library. This
|
|||
|
|
class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>folder</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Virtual machine folder into which the virtual machine template
|
|||
|
|
should be placed. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Folder:VCenter</span></code>. When methods return a value of this class as a
|
|||
|
|
return value, the attribute will be an identifier for the resource
|
|||
|
|
type: <code class="docutils literal notranslate"><span class="pre">Folder:VCenter</span></code>.
|
|||
|
|
The attribute will be None if the subscribed library associated
|
|||
|
|
with the subscription does not have a virtual machine folder.</p></li>
|
|||
|
|
<li><p><strong>cluster</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Cluster onto which the virtual machine template should be placed.
|
|||
|
|
This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ClusterComputeResource:VCenter</span></code>. When methods return a value of
|
|||
|
|
this class as a return value, the attribute will be an identifier
|
|||
|
|
for the resource type: <code class="docutils literal notranslate"><span class="pre">ClusterComputeResource:VCenter</span></code>.
|
|||
|
|
The attribute will be None if the subscribed library associated
|
|||
|
|
with the subscription does not have a cluster.</p></li>
|
|||
|
|
<li><p><strong>resource_pool</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Resource pool into which the virtual machine template should be
|
|||
|
|
placed. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ResourcePool:VCenter</span></code>. When methods return a value of this class
|
|||
|
|
as a return value, the attribute will be an identifier for the
|
|||
|
|
resource type: <code class="docutils literal notranslate"><span class="pre">ResourcePool:VCenter</span></code>.
|
|||
|
|
The attribute will be None if the subscribed library associated
|
|||
|
|
with the subscription does not have a resource pool.</p></li>
|
|||
|
|
<li><p><strong>host</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Host onto which the virtual machine template should be placed. If
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">host</span></code> and <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> are both specified, <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code>
|
|||
|
|
must belong to <code class="docutils literal notranslate"><span class="pre">host</span></code>. If <code class="docutils literal notranslate"><span class="pre">host</span></code> and <code class="docutils literal notranslate"><span class="pre">cluster</span></code> are both
|
|||
|
|
specified, <code class="docutils literal notranslate"><span class="pre">host</span></code> must be a member of <code class="docutils literal notranslate"><span class="pre">cluster</span></code>. This attribute
|
|||
|
|
was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">HostSystem:VCenter</span></code>. When methods return a value of this class
|
|||
|
|
as a return value, the attribute will be an identifier for the
|
|||
|
|
resource type: <code class="docutils literal notranslate"><span class="pre">HostSystem:VCenter</span></code>.
|
|||
|
|
The attribute will be None if the subscribed library associated
|
|||
|
|
with the subscription does not have a host.</p></li>
|
|||
|
|
<li><p><strong>network</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Network that backs the virtual Ethernet adapters in the virtual
|
|||
|
|
machine template. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Network:VCenter</span></code>. When methods return a value of this class as a
|
|||
|
|
return value, the attribute will be an identifier for the resource
|
|||
|
|
type: <code class="docutils literal notranslate"><span class="pre">Network:VCenter</span></code>.
|
|||
|
|
The attribute will be None if the subscribed library associated
|
|||
|
|
with the subscription does not have a network.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py attribute">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.RESOURCE_TYPE">
|
|||
|
|
<span class="sig-name descname"><span class="pre">RESOURCE_TYPE</span></span><em class="property"> <span class="pre">=</span> <span class="pre">'com.vmware.content.library.Subscriptions'</span></em><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.RESOURCE_TYPE" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Resource type for Subscription resource. This class attribute was added in
|
|||
|
|
vSphere API 6.7.2.</p>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.Summary">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">Summary</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">subscription</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library_name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library_vcenter_hostname</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.Summary" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.Summary</span></code> class contains commonly used information
|
|||
|
|
about the subscription. This class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>subscription</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the subscription. This attribute was added in vSphere
|
|||
|
|
API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>. When methods return a
|
|||
|
|
value of this class as a return value, the attribute will be an
|
|||
|
|
identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the subscribed library. This attribute was added in
|
|||
|
|
vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>. When methods return a value of this
|
|||
|
|
class as a return value, the attribute will be an identifier for
|
|||
|
|
the resource type: <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library_name</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Name of the subscribed library. This attribute was added in vSphere
|
|||
|
|
API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library_vcenter_hostname</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Hostname of the vCenter instance where the subscribed library
|
|||
|
|
exists. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
This attribute is unset if the subscribed library is on the same
|
|||
|
|
vCenter Server instance as the published library.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.UpdateSpec">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">UpdateSpec</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">subscribed_library_vcenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscribed_library_placement</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.UpdateSpec" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpec</span></code> class defines information required to
|
|||
|
|
update the subscription. This class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>subscribed_library_vcenter</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.UpdateSpecVcenter" title="com.vmware.content.library_client.Subscriptions.UpdateSpecVcenter"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpecVcenter</span></code></a> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Specification for the subscribed library’s vCenter Server instance.
|
|||
|
|
This attribute was added in vSphere API 6.7.2.
|
|||
|
|
If None, the value is unchanged.</p></li>
|
|||
|
|
<li><p><strong>subscribed_library_placement</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.UpdateSpecPlacement" title="com.vmware.content.library_client.Subscriptions.UpdateSpecPlacement"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpecPlacement</span></code></a> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Placement specification for the virtual machine template items of
|
|||
|
|
the subscribed library. Updating this information will only affect
|
|||
|
|
new or updated items, existing items will not be moved. The entire
|
|||
|
|
placement configuration of the subscribed library will replaced by
|
|||
|
|
the new specification. This attribute was added in vSphere API
|
|||
|
|
6.7.2.
|
|||
|
|
If None, the placement configuration of the subscribed library will
|
|||
|
|
be unchanged.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.UpdateSpecPlacement">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">UpdateSpecPlacement</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">folder</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">cluster</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">resource_pool</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">host</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">network</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.UpdateSpecPlacement" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpecPlacement</span></code> class defines the placement
|
|||
|
|
information for the subscribed library’s virtual machine template library
|
|||
|
|
items. Storage location of the virtual machine template items is defined by
|
|||
|
|
the subscribed library’s storage backing. This placement information needs
|
|||
|
|
to be compatible with the subscribed library’s storage backing. The
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpecPlacement</span></code> class is only applicable for the
|
|||
|
|
newly published virtual machine template library items of the subscribed
|
|||
|
|
library. Existing items will not be moved. This class was added in vSphere
|
|||
|
|
API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>folder</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Virtual machine folder into which the virtual machine template
|
|||
|
|
should be placed. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Folder:VCenter</span></code>. When methods return a value of this class as a
|
|||
|
|
return value, the attribute will be an identifier for the resource
|
|||
|
|
type: <code class="docutils literal notranslate"><span class="pre">Folder:VCenter</span></code>.
|
|||
|
|
This attribute is currently required. In future, if this is None,
|
|||
|
|
the system will attempt to choose a suitable folder for the virtual
|
|||
|
|
machine template; if a folder cannot be chosen, publishing a
|
|||
|
|
virtual machine template item will fail.</p></li>
|
|||
|
|
<li><p><strong>cluster</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Cluster onto which the virtual machine template should be placed.
|
|||
|
|
If <code class="docutils literal notranslate"><span class="pre">cluster</span></code> and <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> are both specified,
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> must belong to <code class="docutils literal notranslate"><span class="pre">cluster</span></code>. If <code class="docutils literal notranslate"><span class="pre">cluster</span></code> and
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">host</span></code> are both specified, <code class="docutils literal notranslate"><span class="pre">host</span></code> must be a member of
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">cluster</span></code>. If <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> or <code class="docutils literal notranslate"><span class="pre">host</span></code> is specified, it is
|
|||
|
|
recommended that this attribute be None. This attribute was added
|
|||
|
|
in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ClusterComputeResource:VCenter</span></code>. When methods return a value of
|
|||
|
|
this class as a return value, the attribute will be an identifier
|
|||
|
|
for the resource type: <code class="docutils literal notranslate"><span class="pre">ClusterComputeResource:VCenter</span></code>.
|
|||
|
|
If <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> or <code class="docutils literal notranslate"><span class="pre">host</span></code> is specified, it is recommended
|
|||
|
|
that this attribute be None.</p></li>
|
|||
|
|
<li><p><strong>resource_pool</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Resource pool into which the virtual machine template should be
|
|||
|
|
placed. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ResourcePool:VCenter</span></code>. When methods return a value of this class
|
|||
|
|
as a return value, the attribute will be an identifier for the
|
|||
|
|
resource type: <code class="docutils literal notranslate"><span class="pre">ResourcePool:VCenter</span></code>.
|
|||
|
|
This attribute is currently required. In future, if this is None,
|
|||
|
|
the system will attempt to choose a suitable resource pool for the
|
|||
|
|
virtual machine template; if a resource pool cannot be chosen,
|
|||
|
|
publish of virtual machine template item will fail.</p></li>
|
|||
|
|
<li><p><strong>host</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Host onto which the virtual machine template should be placed. If
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">host</span></code> and <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code> are both specified, <code class="docutils literal notranslate"><span class="pre">resourcePool</span></code>
|
|||
|
|
must belong to <code class="docutils literal notranslate"><span class="pre">host</span></code>. If <code class="docutils literal notranslate"><span class="pre">host</span></code> and <code class="docutils literal notranslate"><span class="pre">cluster</span></code> are both
|
|||
|
|
specified, <code class="docutils literal notranslate"><span class="pre">host</span></code> must be a member of <code class="docutils literal notranslate"><span class="pre">cluster</span></code>. This attribute
|
|||
|
|
was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">HostSystem:VCenter</span></code>. When methods return a value of this class
|
|||
|
|
as a return value, the attribute will be an identifier for the
|
|||
|
|
resource type: <code class="docutils literal notranslate"><span class="pre">HostSystem:VCenter</span></code>.
|
|||
|
|
If this is None, the system will attempt to choose a suitable host
|
|||
|
|
for the virtual machine template; if a host cannot be chosen,
|
|||
|
|
publishing the virtual machine template item will fail.</p></li>
|
|||
|
|
<li><p><strong>network</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – Network that backs the virtual Ethernet adapters in the virtual
|
|||
|
|
machine template. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
When clients pass a value of this class as a parameter, the
|
|||
|
|
attribute must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">Network:VCenter</span></code>. When methods return a value of this class as a
|
|||
|
|
return value, the attribute will be an identifier for the resource
|
|||
|
|
type: <code class="docutils literal notranslate"><span class="pre">Network:VCenter</span></code>.
|
|||
|
|
If None, newly published virtual machine template library items
|
|||
|
|
will not be backed by a network.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.UpdateSpecVcenter">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">UpdateSpecVcenter</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">hostname</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">https_port</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.UpdateSpecVcenter" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpecVcenter</span></code> class defines information about the
|
|||
|
|
vCenter Server instance where the subscribed library associated with the
|
|||
|
|
subscription exists. The <code class="docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpecVcenter</span></code> class is only
|
|||
|
|
applicable to subscribed library which exists on remote vCenter Server
|
|||
|
|
instance. This class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>hostname</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The hostname of the subscribed library’s vCenter Server. This
|
|||
|
|
attribute was added in vSphere API 6.7.2.
|
|||
|
|
If None, the value is unchanged.</p></li>
|
|||
|
|
<li><p><strong>https_port</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">long</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The HTTPS port of the vCenter Server instance where the subscribed
|
|||
|
|
library exists. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
If None, the value is unchanged.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py class">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.VcenterInfo">
|
|||
|
|
<em class="property"><span class="pre">class</span> </em><span class="sig-name descname"><span class="pre">VcenterInfo</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">hostname</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">https_port</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">server_guid</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.VcenterInfo" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.struct.VapiStruct</span></code></p>
|
|||
|
|
<p>The <code class="docutils literal notranslate"><span class="pre">Subscriptions.VcenterInfo</span></code> class contains information about the
|
|||
|
|
vCenter Server instance where the subscribed library associated with the
|
|||
|
|
subscription exists. This class was added in vSphere API 6.7.2.</p>
|
|||
|
|
<div class="admonition tip">
|
|||
|
|
<p class="admonition-title">Tip</p>
|
|||
|
|
<p>The arguments are used to initialize data attributes with the same
|
|||
|
|
names.</p>
|
|||
|
|
</div>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>hostname</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Hostname of the vCenter Server instance where the subscribed
|
|||
|
|
library exists. This attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
<li><p><strong>https_port</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">long</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – The HTTPS port of the vCenter Server instance where the subscribed
|
|||
|
|
library exists. This attribute was added in vSphere API 6.7.2.
|
|||
|
|
If None, port 443 will be used.</p></li>
|
|||
|
|
<li><p><strong>server_guid</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The unique identifier of the vCenter Server where the subscribed
|
|||
|
|
library exists. This attribute was added in vSphere API 6.7.2.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.create">
|
|||
|
|
<span class="sig-name descname"><span class="pre">create</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spec</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">client_token</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.create" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Creates a subscription of the published library. This method was added
|
|||
|
|
in vSphere API 6.7.2.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>client_token</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) – A unique token generated on the client for each creation request.
|
|||
|
|
The token should be a universally unique identifier (UUID), for
|
|||
|
|
example: <code class="docutils literal notranslate"><span class="pre">b8a2a2e3-2314-43cd-a871-6ede0f429751</span></code>. This token can
|
|||
|
|
be used to guarantee idempotent creation.
|
|||
|
|
If not specified, creation is not idempotent.</p></li>
|
|||
|
|
<li><p><strong>library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the published library.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p></li>
|
|||
|
|
<li><p><strong>spec</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpec" title="com.vmware.content.library_client.Subscriptions.CreateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.CreateSpec</span></code></a>) – Specification for the subscription.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>Subscription identifier.
|
|||
|
|
The return value will be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.AlreadyExists</span></code></a>
|
|||
|
|
If a subscription of the published library to the specified
|
|||
|
|
subscribed library already exists. This is only applicable when
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">subscribedLibrary#subscribedLibrary</span></code> is specified.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></code></a>
|
|||
|
|
If the system reports an error while responding to the request.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the subscribed library specified by
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">subscribedLibrary#subscribedLibrary</span></code> does not exist at the
|
|||
|
|
vCenter instance specified by <code class="docutils literal notranslate"><span class="pre">subscribedLibrary#vcenter</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.ResourceInaccessible" title="com.vmware.vapi.std.errors_client.ResourceInaccessible"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.ResourceInaccessible</span></code></a>
|
|||
|
|
If the vCenter instance specified by <code class="docutils literal notranslate"><span class="pre">subscribedLibrary#vcenter</span></code>
|
|||
|
|
cannot be contacted or found.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a>
|
|||
|
|
If <a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.CreateSpec" title="com.vmware.content.library_client.Subscriptions.CreateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.CreateSpec</span></code></a> contains invalid arguments.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is not a published library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthenticated</span></code></a>
|
|||
|
|
If the user that requested the method cannot be authenticated.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
If the user that requested the method is not authorized to perform
|
|||
|
|
the method.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
parameter <code class="docutils literal notranslate"><span class="pre">library</span></code> requires <code class="docutils literal notranslate"><span class="pre">ContentLibrary.AddSubscription</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.delete">
|
|||
|
|
<span class="sig-name descname"><span class="pre">delete</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscription</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.delete" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Deletes the specified subscription of the published library. The
|
|||
|
|
subscribed library associated with the subscription will not be
|
|||
|
|
deleted. This method was added in vSphere API 6.7.2.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the published library.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p></li>
|
|||
|
|
<li><p><strong>subscription</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Subscription identifier.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></code></a>
|
|||
|
|
If the system reports an error while responding to the request.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is not a published library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the subscription specified by <code class="docutils literal notranslate"><span class="pre">subscription</span></code> does not exist
|
|||
|
|
for the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthenticated</span></code></a>
|
|||
|
|
If the user that requested the method cannot be authenticated.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
If the user that requested the method is not authorized to perform
|
|||
|
|
the method.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
parameter <code class="docutils literal notranslate"><span class="pre">library</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.DeleteSubscription</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.get">
|
|||
|
|
<span class="sig-name descname"><span class="pre">get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscription</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.get" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Returns information about the specified subscription of the published
|
|||
|
|
library. This method was added in vSphere API 6.7.2.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the published library.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p></li>
|
|||
|
|
<li><p><strong>subscription</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the subscription.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.Info" title="com.vmware.content.library_client.Subscriptions.Info"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.Info</span></code></a></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>Information about the subscription.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></code></a>
|
|||
|
|
If the system reports an error while responding to the request.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a>
|
|||
|
|
If the <code class="docutils literal notranslate"><span class="pre">subscription</span></code> is not valid.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is not a published library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthenticated</span></code></a>
|
|||
|
|
If the user that requested the method cannot be authenticated.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
If the user that requested the method is not authorized to perform
|
|||
|
|
the method.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
parameter <code class="docutils literal notranslate"><span class="pre">library</span></code> requires <code class="docutils literal notranslate"><span class="pre">System.Read</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.list">
|
|||
|
|
<span class="sig-name descname"><span class="pre">list</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.list" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Lists the subscriptions of the published library. This method was added
|
|||
|
|
in vSphere API 6.7.2.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><p><strong>library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the published library.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Return type</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.list" title="com.vmware.content.library_client.Subscriptions.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of <a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.Summary" title="com.vmware.content.library_client.Subscriptions.Summary"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.Summary</span></code></a></p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Returns</dt>
|
|||
|
|
<dd class="field-odd"><p>List of commonly used information about subscriptions of the
|
|||
|
|
published library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></code></a>
|
|||
|
|
If the system reports an error while responding to the request.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is not a published library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthenticated</span></code></a>
|
|||
|
|
If the user that requested the method cannot be authenticated.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
If the user that requested the method is not authorized to perform
|
|||
|
|
the method.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
parameter <code class="docutils literal notranslate"><span class="pre">library</span></code> requires <code class="docutils literal notranslate"><span class="pre">System.Read</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
<dl class="py method">
|
|||
|
|
<dt class="sig sig-object py" id="com.vmware.content.library_client.Subscriptions.update">
|
|||
|
|
<span class="sig-name descname"><span class="pre">update</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">library</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subscription</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spec</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.content.library_client.Subscriptions.update" title="Permalink to this definition"></a></dt>
|
|||
|
|
<dd><p>Updates the specified subscription of the published library.</p>
|
|||
|
|
<p>This is an incremental update to the subscription. Except for the
|
|||
|
|
<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.UpdateSpecPlacement" title="com.vmware.content.library_client.Subscriptions.UpdateSpecPlacement"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpecPlacement</span></code></a> class, attributes that are
|
|||
|
|
None in the update specification will be left unchanged. If
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">spec#subscribedLibraryPlacement</span></code> is specified, all attributes of the
|
|||
|
|
current subscribed library placement will be replaced by this
|
|||
|
|
placement.. This method was added in vSphere API 6.7.2.</p>
|
|||
|
|
<dl class="field-list simple">
|
|||
|
|
<dt class="field-odd">Parameters</dt>
|
|||
|
|
<dd class="field-odd"><ul class="simple">
|
|||
|
|
<li><p><strong>library</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – Identifier of the published library.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code>.</p></li>
|
|||
|
|
<li><p><strong>subscription</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – subscription identifier.
|
|||
|
|
The parameter must be an identifier for the resource type:
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">com.vmware.content.library.Subscriptions</span></code>.</p></li>
|
|||
|
|
<li><p><strong>spec</strong> (<a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.UpdateSpec" title="com.vmware.content.library_client.Subscriptions.UpdateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpec</span></code></a>) – Specification of the new property values to set on the
|
|||
|
|
subscription.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Error" title="com.vmware.vapi.std.errors_client.Error"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Error</span></code></a>
|
|||
|
|
If the system reports an error while responding to the request.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> does not exist.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code></a>
|
|||
|
|
If the subscription specified by <code class="docutils literal notranslate"><span class="pre">subscription</span></code> does not exist
|
|||
|
|
for the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code>.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.ResourceInaccessible" title="com.vmware.vapi.std.errors_client.ResourceInaccessible"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.ResourceInaccessible</span></code></a>
|
|||
|
|
If the subscribed library cannot be contacted or found.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><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"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code></a>
|
|||
|
|
If <a class="reference internal" href="#com.vmware.content.library_client.Subscriptions.UpdateSpec" title="com.vmware.content.library_client.Subscriptions.UpdateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Subscriptions.UpdateSpec</span></code></a> contains invalid arguments.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.InvalidElementType" title="com.vmware.vapi.std.errors_client.InvalidElementType"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidElementType</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is a subscribed library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.NotAllowedInCurrentState" title="com.vmware.vapi.std.errors_client.NotAllowedInCurrentState"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotAllowedInCurrentState</span></code></a>
|
|||
|
|
If the library specified by <code class="docutils literal notranslate"><span class="pre">library</span></code> is not a published library.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthenticated" title="com.vmware.vapi.std.errors_client.Unauthenticated"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthenticated</span></code></a>
|
|||
|
|
If the user that requested the method cannot be authenticated.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-even">Raise</dt>
|
|||
|
|
<dd class="field-even"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
If the user that requested the method is not authorized to perform
|
|||
|
|
the method.</p>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="field-odd">Raise</dt>
|
|||
|
|
<dd class="field-odd"><p><a class="reference internal" href="com.vmware.vapi.std.html#com.vmware.vapi.std.errors_client.Unauthorized" title="com.vmware.vapi.std.errors_client.Unauthorized"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code></a>
|
|||
|
|
if you do not have all of the privileges described as follows:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>The resource <code class="docutils literal notranslate"><span class="pre">com.vmware.content.Library</span></code> referenced by the
|
|||
|
|
parameter <code class="docutils literal notranslate"><span class="pre">library</span></code> requires
|
|||
|
|
<code class="docutils literal notranslate"><span class="pre">ContentLibrary.UpdateSubscription</span></code>.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</dd></dl>
|
|||
|
|
|
|||
|
|
</section>
|
|||
|
|
</section>
|
|||
|
|
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
|
|||
|
|
<a href="com.vmware.cis.html" class="btn btn-neutral float-left" title="com.vmware.cis package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
|||
|
|
<a href="com.vmware.content.library.html" class="btn btn-neutral float-right" title="com.vmware.content.library package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
<hr/>
|
|||
|
|
|
|||
|
|
<div role="contentinfo">
|
|||
|
|
<p>© Copyright 2023, VMware, Inc..</p>
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
|
|||
|
|
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
|
|||
|
|
provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|||
|
|
|
|||
|
|
|
|||
|
|
</footer>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</section>
|
|||
|
|
</div>
|
|||
|
|
<script>
|
|||
|
|
jQuery(function () {
|
|||
|
|
SphinxRtdTheme.Navigation.enable(true);
|
|||
|
|
});
|
|||
|
|
</script>
|
|||
|
|
|
|||
|
|
</body>
|
|||
|
|
</html>
|