Mirrors/vsphere-automation-sdk-python
1
0
Fork 0
mirror of https://github.com/vmware/vsphere-automation-sdk-python.git synced 2024-11-25 02:39:59 -05:00
Code
8380d1fa2e
vsphere-automation-sdk-python/vsphere/7.0.1.0/com.vmware.content.html

2596 lines
234 KiB
HTML
Raw Normal View History

adding vSphere 7.0 U1 artifacts
2020-10-12 01:13:57 -04:00
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>com.vmware.content package &mdash; vSphere Automation SDK for Python. 7.0.1.0 documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script type="text/javascript" id="documentation_options" data-url_root="./" 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/language_data.js"></script>
<script type="text/javascript" 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" alt="Documentation Home"> vSphere Automation SDK for Python.
</a>
<div class="version">
7.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" />
<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="main navigation">
<p class="caption"><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.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="top navigation">
<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="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li><a href="com.html">com package</a> &raquo;</li>
<li><a href="com.vmware.html">com.vmware package</a> &raquo;</li>
<li>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">
<div class="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>
<div class="section" id="subpackages">
<h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to this headline"></a></h2>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="com.vmware.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>
</div>
<div class="section" id="submodules">
<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline"></a></h2>
</div>
<div class="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 id="com.vmware.content.library_client.Item">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">Item</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">config</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 id="com.vmware.content.library_client.Item.DestinationSpec">
<em class="property">class </em><code class="sig-name descname">DestinationSpec</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">subscription</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Item.FindSpec">
<em class="property">class </em><code class="sig-name descname">FindSpec</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">name</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">library_id</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">source_id</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">type</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">cached</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Item.RESOURCE_TYPE">
<code class="sig-name descname">RESOURCE_TYPE</code><em class="property"> = 'com.vmware.content.library.Item'</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 id="com.vmware.content.library_client.Item.copy">
<code class="sig-name descname">copy</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">source_library_item_id</span></em>, <em class="sig-param"><span class="n">destination_create_spec</span></em>, <em class="sig-param"><span class="n">client_token</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Item.create">
<code class="sig-name descname">create</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">create_spec</span></em>, <em class="sig-param"><span class="n">client_token</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Item.delete">
<code class="sig-name descname">delete</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library_item_id</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 id="com.vmware.content.library_client.Item.find">
<code class="sig-name descname">find</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">spec</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 id="com.vmware.content.library_client.Item.get">
<code class="sig-name descname">get</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library_item_id</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 id="com.vmware.content.library_client.Item.list">
<code class="sig-name descname">list</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library_id</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 id="com.vmware.content.library_client.Item.publish">
<code class="sig-name descname">publish</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library_item_id</span></em>, <em class="sig-param"><span class="n">force_sync_content</span></em>, <em class="sig-param"><span class="n">subscriptions</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Item.update">
<code class="sig-name descname">update</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library_item_id</span></em>, <em class="sig-param"><span class="n">update_spec</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 id="com.vmware.content.library_client.ItemModel">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">ItemModel</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">id</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">library_id</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">content_version</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">creation_time</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">description</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">last_modified_time</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">last_sync_time</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">metadata_version</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">name</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">cached</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">size</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">type</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">version</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">source_id</span><span class="o">=</span><span class="default_value">None</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>
</ul>
</dd>
</dl>
</dd></dl>
<dl class="py class">
<dt id="com.vmware.content.library_client.OptimizationInfo">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">OptimizationInfo</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">optimize_remote_publishing</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.PublishInfo">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">PublishInfo</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">authentication_method</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">published</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">publish_url</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">user_name</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">password</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">current_password</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">persist_json_enabled</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.PublishInfo.AuthenticationMethod">
<em class="property">class </em><code class="sig-name descname">AuthenticationMethod</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">string</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 id="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.BASIC">
<code class="sig-name descname">BASIC</code><em class="property"> = AuthenticationMethod(string='BASIC')</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 id="com.vmware.content.library_client.PublishInfo.AuthenticationMethod.NONE">
<code class="sig-name descname">NONE</code><em class="property"> = AuthenticationMethod(string='NONE')</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 id="com.vmware.content.library_client.SourceInfo">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">SourceInfo</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">source_library</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscription</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.StorageBacking">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">StorageBacking</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">type</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">datastore_id</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">storage_uri</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.StorageBacking.Type">
<em class="property">class </em><code class="sig-name descname">Type</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">string</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 id="com.vmware.content.library_client.StorageBacking.Type.DATASTORE">
<code class="sig-name descname">DATASTORE</code><em class="property"> = Type(string='DATASTORE')</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 id="com.vmware.content.library_client.StorageBacking.Type.OTHER">
<code class="sig-name descname">OTHER</code><em class="property"> = Type(string='OTHER')</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 id="com.vmware.content.library_client.StubFactory">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">StubFactory</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">stub_config</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 id="com.vmware.content.library_client.SubscribedItem">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">SubscribedItem</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">config</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 id="com.vmware.content.library_client.SubscribedItem.evict">
<code class="sig-name descname">evict</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library_item_id</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 {\&#64;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 id="com.vmware.content.library_client.SubscribedItem.sync">
<code class="sig-name descname">sync</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library_item_id</span></em>, <em class="sig-param"><span class="n">force_sync_content</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>
</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 {\&#64;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 id="com.vmware.content.library_client.SubscriptionInfo">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">SubscriptionInfo</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">authentication_method</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">automatic_sync_enabled</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">on_demand</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">password</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">ssl_thumbprint</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscription_url</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">user_name</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">source_info</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod">
<em class="property">class </em><code class="sig-name descname">AuthenticationMethod</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">string</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 id="com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod.BASIC">
<code class="sig-name descname">BASIC</code><em class="property"> = AuthenticationMethod(string='BASIC')</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 id="com.vmware.content.library_client.SubscriptionInfo.AuthenticationMethod.NONE">
<code class="sig-name descname">NONE</code><em class="property"> = AuthenticationMethod(string='NONE')</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 id="com.vmware.content.library_client.Subscriptions">
<em class="property">class </em><code class="sig-prename descclassname">com.vmware.content.library_client.</code><code class="sig-name descname">Subscriptions</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">config</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 id="com.vmware.content.library_client.Subscriptions.CreateSpec">
<em class="property">class </em><code class="sig-name descname">CreateSpec</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">subscribed_library</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.CreateSpecNewSubscribedLibrary">
<em class="property">class </em><code class="sig-name descname">CreateSpecNewSubscribedLibrary</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">name</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">description</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">storage_backings</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">automatic_sync_enabled</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">on_demand</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.CreateSpecPlacement">
<em class="property">class </em><code class="sig-name descname">CreateSpecPlacement</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">folder</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">cluster</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">resource_pool</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">host</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">network</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary">
<em class="property">class </em><code class="sig-name descname">CreateSpecSubscribedLibrary</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">target</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">new_subscribed_library</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">location</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">vcenter</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">placement</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target">
<em class="property">class </em><code class="sig-name descname">Target</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">string</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 id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.CREATE_NEW">
<code class="sig-name descname">CREATE_NEW</code><em class="property"> = Target(string='CREATE_NEW')</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 id="com.vmware.content.library_client.Subscriptions.CreateSpecSubscribedLibrary.Target.USE_EXISTING">
<code class="sig-name descname">USE_EXISTING</code><em class="property"> = Target(string='USE_EXISTING')</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 id="com.vmware.content.library_client.Subscriptions.CreateSpecVcenter">
<em class="property">class </em><code class="sig-name descname">CreateSpecVcenter</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">hostname</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">https_port</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.Info">
<em class="property">class </em><code class="sig-name descname">Info</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">subscribed_library</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library_name</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library_location</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library_vcenter</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library_placement</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.Location">
<em class="property">class </em><code class="sig-name descname">Location</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">string</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 id="com.vmware.content.library_client.Subscriptions.Location.LOCAL">
<code class="sig-name descname">LOCAL</code><em class="property"> = Location(string='LOCAL')</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 id="com.vmware.content.library_client.Subscriptions.Location.REMOTE">
<code class="sig-name descname">REMOTE</code><em class="property"> = Location(string='REMOTE')</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 id="com.vmware.content.library_client.Subscriptions.PlacementInfo">
<em class="property">class </em><code class="sig-name descname">PlacementInfo</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">folder</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">cluster</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">resource_pool</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">host</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">network</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.RESOURCE_TYPE">
<code class="sig-name descname">RESOURCE_TYPE</code><em class="property"> = 'com.vmware.content.library.Subscriptions'</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 id="com.vmware.content.library_client.Subscriptions.Summary">
<em class="property">class </em><code class="sig-name descname">Summary</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">subscription</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library_name</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library_vcenter_hostname</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.UpdateSpec">
<em class="property">class </em><code class="sig-name descname">UpdateSpec</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">subscribed_library_vcenter</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">subscribed_library_placement</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.UpdateSpecPlacement">
<em class="property">class </em><code class="sig-name descname">UpdateSpecPlacement</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">folder</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">cluster</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">resource_pool</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">host</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">network</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.UpdateSpecVcenter">
<em class="property">class </em><code class="sig-name descname">UpdateSpecVcenter</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">hostname</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">https_port</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.VcenterInfo">
<em class="property">class </em><code class="sig-name descname">VcenterInfo</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">hostname</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">https_port</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">server_guid</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.create">
<code class="sig-name descname">create</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library</span></em>, <em class="sig-param"><span class="n">spec</span></em>, <em class="sig-param"><span class="n">client_token</span><span class="o">=</span><span class="default_value">None</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 id="com.vmware.content.library_client.Subscriptions.delete">
<code class="sig-name descname">delete</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library</span></em>, <em class="sig-param"><span class="n">subscription</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 id="com.vmware.content.library_client.Subscriptions.get">
<code class="sig-name descname">get</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library</span></em>, <em class="sig-param"><span class="n">subscription</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 id="com.vmware.content.library_client.Subscriptions.list">
<code class="sig-name descname">list</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library</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 id="com.vmware.content.library_client.Subscriptions.update">
<code class="sig-name descname">update</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">library</span></em>, <em class="sig-param"><span class="n">subscription</span></em>, <em class="sig-param"><span class="n">spec</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>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<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"></span></a>
<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"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright 2020, VMware, Inc.
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>
Copy Permalink