mirror of
https://github.com/vmware/vsphere-automation-sdk-python.git
synced 2024-11-25 10:50:00 -05:00
1487 lines
110 KiB
HTML
1487 lines
110 KiB
HTML
|
||
|
||
<!DOCTYPE html>
|
||
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
|
||
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
|
||
<head>
|
||
<meta charset="utf-8">
|
||
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
||
<title>com.vmware.cis package — vSphere Automation SDK for Python 6.7.0 documentation</title>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
|
||
|
||
|
||
|
||
|
||
|
||
<link rel="index" title="Index"
|
||
href="genindex.html"/>
|
||
<link rel="search" title="Search" href="search.html"/>
|
||
<link rel="top" title="vSphere Automation SDK for Python 6.7.0 documentation" href="index.html"/>
|
||
<link rel="up" title="com.vmware package" href="com.vmware.html"/>
|
||
<link rel="next" title="com.vmware.content package" href="com.vmware.content.html"/>
|
||
<link rel="prev" title="com.vmware.appliance.system package" href="com.vmware.appliance.system.html"/>
|
||
|
||
|
||
<script src="_static/js/modernizr.min.js"></script>
|
||
|
||
</head>
|
||
|
||
<body class="wy-body-for-nav" role="document">
|
||
|
||
|
||
<div class="wy-grid-for-nav">
|
||
|
||
|
||
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
||
<div class="wy-side-scroll">
|
||
<div class="wy-side-nav-search">
|
||
|
||
|
||
|
||
<a href="index.html" class="icon icon-home"> vSphere Automation SDK for Python
|
||
|
||
|
||
|
||
</a>
|
||
|
||
|
||
|
||
|
||
<div class="version">
|
||
6.7.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.vcenter_client">com.vmware.vcenter_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" role="navigation" 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">Docs</a> »</li>
|
||
|
||
<li><a href="com.html">com package</a> »</li>
|
||
|
||
<li><a href="com.vmware.html">com.vmware package</a> »</li>
|
||
|
||
<li>com.vmware.cis package</li>
|
||
|
||
|
||
<li class="wy-breadcrumbs-aside">
|
||
|
||
|
||
<a href="_sources/com.vmware.cis.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.cis">
|
||
<span id="com-vmware-cis-package"></span><h1>com.vmware.cis package<a class="headerlink" href="#module-com.vmware.cis" title="Permalink to this headline">¶</a></h1>
|
||
<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.cis.tagging_client">
|
||
<span id="com-vmware-cis-tagging-client-module"></span><h2>com.vmware.cis.tagging_client module<a class="headerlink" href="#module-com.vmware.cis.tagging_client" title="Permalink to this headline">¶</a></h2>
|
||
<p>The <code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging_client</span></code> component provides methods and classes to
|
||
attach metadata, by means of tags, to vSphere objects to make these objects
|
||
more sortable and searchable. You can use it to create, manage, and enumerate
|
||
tags and their categories (the group a tag belongs to). You can also query the
|
||
attached tags and attached objects.</p>
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.Category">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.tagging_client.</code><code class="descname">Category</code><span class="sig-paren">(</span><em>config</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category" 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">Category</span></code> class provides methods to create, read, update, delete,
|
||
and enumerate categories.</p>
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.Category.CreateSpec">
|
||
<em class="property">class </em><code class="descname">CreateSpec</code><span class="sig-paren">(</span><em>name=None</em>, <em>description=None</em>, <em>cardinality=None</em>, <em>associable_types=None</em>, <em>category_id=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.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">Category.CreateSpec</span></code> class is used to create a category.</p>
|
||
<p>Use the <a class="reference internal" href="#com.vmware.cis.tagging_client.Category.create" title="com.vmware.cis.tagging_client.Category.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">Category.create()</span></code></a> method to create a category defined by the
|
||
create specification.</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.Category.UpdateSpec">
|
||
<em class="property">class </em><code class="descname">UpdateSpec</code><span class="sig-paren">(</span><em>name=None</em>, <em>description=None</em>, <em>cardinality=None</em>, <em>associable_types=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.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">Category.UpdateSpec</span></code> class describes the updates to be made to an
|
||
existing category.</p>
|
||
<p>Use the <a class="reference internal" href="#com.vmware.cis.tagging_client.Category.update" title="com.vmware.cis.tagging_client.Category.update"><code class="xref py py-func docutils literal notranslate"><span class="pre">Category.update()</span></code></a> method to modify a category. When you call
|
||
the method, specify the category identifier. You obtain the category
|
||
identifier when you call the <a class="reference internal" href="#com.vmware.cis.tagging_client.Category.create" title="com.vmware.cis.tagging_client.Category.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">Category.create()</span></code></a> method. You can also
|
||
retrieve an identifier by using the <a class="reference internal" href="#com.vmware.cis.tagging_client.Category.list" title="com.vmware.cis.tagging_client.Category.list"><code class="xref py py-func docutils literal notranslate"><span class="pre">Category.list()</span></code></a> method.</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.add_to_used_by">
|
||
<code class="descname">add_to_used_by</code><span class="sig-paren">(</span><em>category_id</em>, <em>used_by_entity</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.add_to_used_by" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Adds the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> to the <code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code>
|
||
subscribers <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code> for the specified category. If the
|
||
<code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> is already in the <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>, then this becomes an
|
||
idempotent no-op. To invoke this method, you need the modify
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code> privilege on the category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>category_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input category.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</li>
|
||
<li><strong>used_by_entity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The name of the user to be added to the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code> <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for the given <code class="docutils literal notranslate"><span class="pre">category_id</span></code> does not exist in the
|
||
system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to add an entity to the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code> field.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.create">
|
||
<code class="descname">create</code><span class="sig-paren">(</span><em>create_spec</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.create" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Creates a category. To invoke this method, you need the create category
|
||
privilege.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>create_spec</strong> (<a class="reference internal" href="#com.vmware.cis.tagging_client.Category.CreateSpec" title="com.vmware.cis.tagging_client.Category.CreateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Category.CreateSpec</span></code></a>) – Specification for the new category to be created.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The identifier of the created category.
|
||
The return value will be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.AlreadyExists</span></code>
|
||
if the <code class="xref py py-attr docutils literal notranslate"><span class="pre">Category.CreateSpec.name</span></code> provided in the
|
||
<code class="docutils literal notranslate"><span class="pre">create_spec</span></code> is the name of an already existing category.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code>
|
||
if any of the information in the <code class="docutils literal notranslate"><span class="pre">create_spec</span></code> is invalid.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to create a category.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.delete">
|
||
<code class="descname">delete</code><span class="sig-paren">(</span><em>category_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.delete" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Deletes an existing category. To invoke this method, you need the
|
||
delete privilege on the category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>category_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of category to be deleted.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for the given <code class="docutils literal notranslate"><span class="pre">category_id</span></code> does not exist in the
|
||
system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to delete the category.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.get">
|
||
<code class="descname">get</code><span class="sig-paren">(</span><em>category_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.get" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Fetches the category information for the given category identifier. In
|
||
order to view the category information, you need the read privilege on
|
||
the category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>category_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input category.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.cis.tagging_client.CategoryModel" title="com.vmware.cis.tagging_client.CategoryModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">CategoryModel</span></code></a></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.cis.tagging_client.CategoryModel" title="com.vmware.cis.tagging_client.CategoryModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">CategoryModel</span></code></a> that corresponds to <code class="docutils literal notranslate"><span class="pre">category_id</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for the given <code class="docutils literal notranslate"><span class="pre">category_id</span></code> does not exist in the
|
||
system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to read the category.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.list">
|
||
<code class="descname">list</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.list" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Enumerates the categories in the system. To invoke this method, you
|
||
need the read privilege on the individual categories. The <a class="reference internal" href="#com.vmware.cis.tagging_client.Category.list" title="com.vmware.cis.tagging_client.Category.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a>
|
||
will only contain those categories for which you have read privileges.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.cis.tagging_client.Category.list" title="com.vmware.cis.tagging_client.Category.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></td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.cis.tagging_client.Category.list" title="com.vmware.cis.tagging_client.Category.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of resource identifiers for the categories in the
|
||
system.
|
||
The return value will contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.list_used_categories">
|
||
<code class="descname">list_used_categories</code><span class="sig-paren">(</span><em>used_by_entity</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.list_used_categories" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Enumerates all categories for which the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> is part of
|
||
the <code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code> subscribers <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>. To invoke
|
||
this method, you need the read privilege on the individual categories.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>used_by_entity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The field on which the results will be filtered.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.cis.tagging_client.Category.list" title="com.vmware.cis.tagging_client.Category.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></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.cis.tagging_client.Category.list" title="com.vmware.cis.tagging_client.Category.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of resource identifiers for the categories in the
|
||
system that are used by <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code>.
|
||
The return value will contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.remove_from_used_by">
|
||
<code class="descname">remove_from_used_by</code><span class="sig-paren">(</span><em>category_id</em>, <em>used_by_entity</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.remove_from_used_by" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Removes the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> from the <code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code>
|
||
subscribers <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>. If the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> is not using this
|
||
category, then this becomes a no-op. To invoke this method, you need
|
||
the modify <code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code> privilege on the category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>category_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input category.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</li>
|
||
<li><strong>used_by_entity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The name of the user to be removed from the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code> <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for the given <code class="docutils literal notranslate"><span class="pre">category_id</span></code> does not exist in the
|
||
system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to remove an entity from the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.used_by</span></code> field.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.revoke_propagating_permissions">
|
||
<code class="descname">revoke_propagating_permissions</code><span class="sig-paren">(</span><em>category_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.revoke_propagating_permissions" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Revokes all propagating permissions on the given category. You should
|
||
then attach a direct permission with tagging privileges on the given
|
||
category. To invoke this method, you need category related privileges
|
||
(direct or propagating) on the concerned category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>category_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input category.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for the given <code class="docutils literal notranslate"><span class="pre">category_id</span></code> does not exist in the
|
||
system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to revoke propagating permissions
|
||
on the category.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Category.update">
|
||
<code class="descname">update</code><span class="sig-paren">(</span><em>category_id</em>, <em>update_spec</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Category.update" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Updates an existing category. To invoke this method, you need the edit
|
||
privilege on the category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>category_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the category to be updated.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</li>
|
||
<li><strong>update_spec</strong> (<a class="reference internal" href="#com.vmware.cis.tagging_client.Category.UpdateSpec" title="com.vmware.cis.tagging_client.Category.UpdateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Category.UpdateSpec</span></code></a>) – Specification to update the category.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.AlreadyExists</span></code>
|
||
if the <code class="xref py py-attr docutils literal notranslate"><span class="pre">Category.UpdateSpec.name</span></code> provided in the
|
||
<code class="docutils literal notranslate"><span class="pre">update_spec</span></code> is the name of an already existing category.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code>
|
||
if any of the information in the <code class="docutils literal notranslate"><span class="pre">update_spec</span></code> is invalid.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for the given <code class="docutils literal notranslate"><span class="pre">category_id</span></code> does not exist in the
|
||
system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to update the category.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.CategoryModel">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.tagging_client.</code><code class="descname">CategoryModel</code><span class="sig-paren">(</span><em>id=None</em>, <em>name=None</em>, <em>description=None</em>, <em>cardinality=None</em>, <em>associable_types=None</em>, <em>used_by=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.CategoryModel" 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">CategoryModel</span></code> class defines a category that is used to group one or
|
||
more tags.</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.CategoryModel.Cardinality">
|
||
<em class="property">class </em><code class="descname">Cardinality</code><span class="sig-paren">(</span><em>string</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.CategoryModel.Cardinality" 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">CategoryModel.Cardinality</span></code> class defines the number of tags in a
|
||
category that can be assigned to an object.</p>
|
||
<div class="admonition note">
|
||
<p class="first admonition-title">Note</p>
|
||
<p class="last">This class represents an enumerated type in the interface language
|
||
definition. The class contains class attributes which represent the
|
||
values in the current version of the enumerated type. Newer versions of
|
||
the enumerated type may contain new values. To use new values of the
|
||
enumerated type in communication with a server that supports the newer
|
||
version of the API, you instantiate this class. See <a class="reference internal" href="enumeration.html#enumeration-description"><span class="std std-ref">enumerated
|
||
type description page</span></a>.</p>
|
||
</div>
|
||
<dl class="attribute">
|
||
<dt id="com.vmware.cis.tagging_client.CategoryModel.Cardinality.MULTIPLE">
|
||
<code class="descname">MULTIPLE</code><em class="property"> = Cardinality(string='MULTIPLE')</em><a class="headerlink" href="#com.vmware.cis.tagging_client.CategoryModel.Cardinality.MULTIPLE" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>An object can be assigned several of the tags in this category. For
|
||
example, if a category is “Server”, then different tags of this category
|
||
would be “AppServer”, “DatabaseServer” and so on. In this case a VM object
|
||
can be assigned more than one of the above tags and hence the cardinality
|
||
of the associated category here is multiple.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="attribute">
|
||
<dt id="com.vmware.cis.tagging_client.CategoryModel.Cardinality.SINGLE">
|
||
<code class="descname">SINGLE</code><em class="property"> = Cardinality(string='SINGLE')</em><a class="headerlink" href="#com.vmware.cis.tagging_client.CategoryModel.Cardinality.SINGLE" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>An object can only be assigned one of the tags in this category. For
|
||
example, if a category is “Operating System”, then different tags of this
|
||
category would be “Windows”, “Linux”, and so on. In this case a VM object
|
||
can be assigned only one of these tags and hence the cardinality of the
|
||
associated category here is single.</p>
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.StubFactory">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.tagging_client.</code><code class="descname">StubFactory</code><span class="sig-paren">(</span><em>stub_config</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_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>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.Tag">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.tagging_client.</code><code class="descname">Tag</code><span class="sig-paren">(</span><em>config</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag" 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">Tag</span></code> class provides methods to create, read, update, delete, and
|
||
enumerate tags.</p>
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.CreateSpec">
|
||
<em class="property">class </em><code class="descname">CreateSpec</code><span class="sig-paren">(</span><em>name=None</em>, <em>description=None</em>, <em>category_id=None</em>, <em>tag_id=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.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">Tag.CreateSpec</span></code> class describes a tag.</p>
|
||
<p>Use the <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.create" title="com.vmware.cis.tagging_client.Tag.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">Tag.create()</span></code></a> method to create a tag defined by the create
|
||
specification.</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.UpdateSpec">
|
||
<em class="property">class </em><code class="descname">UpdateSpec</code><span class="sig-paren">(</span><em>name=None</em>, <em>description=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.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">Tag.UpdateSpec</span></code> class describes the updates to be made to an
|
||
existing tag.</p>
|
||
<p>Use the <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.update" title="com.vmware.cis.tagging_client.Tag.update"><code class="xref py py-func docutils literal notranslate"><span class="pre">Tag.update()</span></code></a> method to modify a tag. When you call the
|
||
method, you specify the tag identifier. You obtain the tag identifier when
|
||
you call the <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.create" title="com.vmware.cis.tagging_client.Tag.create"><code class="xref py py-func docutils literal notranslate"><span class="pre">Tag.create()</span></code></a> method. You can also retrieve an identifier
|
||
by using the <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.list"><code class="xref py py-func docutils literal notranslate"><span class="pre">Tag.list()</span></code></a> method.</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.add_to_used_by">
|
||
<code class="descname">add_to_used_by</code><span class="sig-paren">(</span><em>tag_id</em>, <em>used_by_entity</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.add_to_used_by" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Adds the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> to the <code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code> subscribers
|
||
<code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>. If the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> is already in the <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>,
|
||
then this becomes a no-op. To invoke this method, you need the modify
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code> privilege on the tag.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
<li><strong>used_by_entity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The name of the user to be added to the <code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code>
|
||
<code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to add an entity to the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code> field.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.create">
|
||
<code class="descname">create</code><span class="sig-paren">(</span><em>create_spec</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.create" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Creates a tag. To invoke this method, you need the create tag privilege
|
||
on the input category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>create_spec</strong> (<a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.CreateSpec" title="com.vmware.cis.tagging_client.Tag.CreateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Tag.CreateSpec</span></code></a>) – Specification for the new tag to be created.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The identifier of the created tag.
|
||
The return value will be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.AlreadyExists</span></code>
|
||
if the <code class="xref py py-attr docutils literal notranslate"><span class="pre">Tag.CreateSpec.name</span></code> provided in the <code class="docutils literal notranslate"><span class="pre">create_spec</span></code>
|
||
is the name of an already existing tag in the input category.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code>
|
||
if any of the input information in the <code class="docutils literal notranslate"><span class="pre">create_spec</span></code> is invalid.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for in the given <code class="docutils literal notranslate"><span class="pre">create_spec</span></code> does not exist in
|
||
the system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to create tag.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.delete">
|
||
<code class="descname">delete</code><span class="sig-paren">(</span><em>tag_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.delete" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Deletes an existing tag. To invoke this method, you need the delete
|
||
privilege on the tag.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to delete the tag.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.get">
|
||
<code class="descname">get</code><span class="sig-paren">(</span><em>tag_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.get" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Fetches the tag information for the given tag identifier. To invoke
|
||
this method, you need the read privilege on the tag in order to view
|
||
the tag info.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.cis.tagging_client.TagModel" title="com.vmware.cis.tagging_client.TagModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagModel</span></code></a></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.cis.tagging_client.TagModel" title="com.vmware.cis.tagging_client.TagModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagModel</span></code></a> that corresponds to <code class="docutils literal notranslate"><span class="pre">tag_id</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if the user does not have the privilege to read the tag.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.list">
|
||
<code class="descname">list</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.list" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Enumerates the tags in the system. To invoke this method, you need read
|
||
privilege on the individual tags. The <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> will only contain
|
||
tags for which you have read privileges.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.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></td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of resource identifiers for the tags in the
|
||
system.
|
||
The return value will contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.list_tags_for_category">
|
||
<code class="descname">list_tags_for_category</code><span class="sig-paren">(</span><em>category_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.list_tags_for_category" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Enumerates all tags for the given category. To invoke this method, you
|
||
need the read privilege on the given category and the individual tags
|
||
in that category.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>category_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input category.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Category</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.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></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of resource identifiers for the tags in the given
|
||
input category.
|
||
The return value will contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the category for the given <code class="docutils literal notranslate"><span class="pre">category_id</span></code> does not exist in the
|
||
system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to read the category.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.list_used_tags">
|
||
<code class="descname">list_used_tags</code><span class="sig-paren">(</span><em>used_by_entity</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.list_used_tags" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Enumerates all tags for which the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> is part of the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code> subscribers <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>. To invoke this
|
||
method, you need the read privilege on the individual tags.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>used_by_entity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The field on which the results will be filtered.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.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></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.list" title="com.vmware.cis.tagging_client.Tag.list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> of resource identifiers for the tags in the
|
||
system that are used by <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code>.
|
||
The return value will contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.remove_from_used_by">
|
||
<code class="descname">remove_from_used_by</code><span class="sig-paren">(</span><em>tag_id</em>, <em>used_by_entity</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.remove_from_used_by" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Removes the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> from the <code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code>
|
||
subscribers set. If the <code class="docutils literal notranslate"><span class="pre">used_by_entity</span></code> is not using this tag, then
|
||
this becomes a no-op. To invoke this method, you need modify
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code> privilege on the tag.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
<li><strong>used_by_entity</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The name of the user to be removed from the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code> <code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code>.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to remove an entity from the
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagModel.used_by</span></code> field.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.revoke_propagating_permissions">
|
||
<code class="descname">revoke_propagating_permissions</code><span class="sig-paren">(</span><em>tag_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.revoke_propagating_permissions" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Revokes all propagating permissions on the given tag. You should then
|
||
attach a direct permission with tagging privileges on the given tag. To
|
||
invoke this method, you need tag related privileges (direct or
|
||
propagating) on the concerned tag.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to revoke propagating permissions
|
||
on the tag.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.Tag.update">
|
||
<code class="descname">update</code><span class="sig-paren">(</span><em>tag_id</em>, <em>update_spec</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.Tag.update" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Updates an existing tag. To invoke this method, you need the edit
|
||
privilege on the tag.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
<li><strong>update_spec</strong> (<a class="reference internal" href="#com.vmware.cis.tagging_client.Tag.UpdateSpec" title="com.vmware.cis.tagging_client.Tag.UpdateSpec"><code class="xref py py-class docutils literal notranslate"><span class="pre">Tag.UpdateSpec</span></code></a>) – Specification to update the tag.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.AlreadyExists</span></code>
|
||
if the <code class="xref py py-attr docutils literal notranslate"><span class="pre">Tag.UpdateSpec.name</span></code> provided in the <code class="docutils literal notranslate"><span class="pre">update_spec</span></code>
|
||
is the name of an already existing tag in the same category.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code>
|
||
if any of the input information in the <code class="docutils literal notranslate"><span class="pre">update_spec</span></code> is invalid.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to update the tag.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.tagging_client.</code><code class="descname">TagAssociation</code><span class="sig-paren">(</span><em>config</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation" 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">TagAssociation</span></code> class provides methods to attach, detach, and query
|
||
tags.</p>
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.BatchResult">
|
||
<em class="property">class </em><code class="descname">BatchResult</code><span class="sig-paren">(</span><em>success=None</em>, <em>error_messages=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.BatchResult" 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">TagAssociation.BatchResult</span></code> class describes the result of performing
|
||
the same method on several tags or objects in a single invocation. This
|
||
class was added in vSphere API 6.5</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.ObjectToTags">
|
||
<em class="property">class </em><code class="descname">ObjectToTags</code><span class="sig-paren">(</span><em>object_id=None</em>, <em>tag_ids=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.ObjectToTags" 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">TagAssociation.ObjectToTags</span></code> class describes an object and its
|
||
related tags. Use the <a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.list_attached_tags_on_objects" title="com.vmware.cis.tagging_client.TagAssociation.list_attached_tags_on_objects"><code class="xref py py-func docutils literal notranslate"><span class="pre">TagAssociation.list_attached_tags_on_objects()</span></code></a>
|
||
method to retrieve a <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> with each element containing an object
|
||
and the tags attached to it. This class was added in vSphere API 6.5</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.TagToObjects">
|
||
<em class="property">class </em><code class="descname">TagToObjects</code><span class="sig-paren">(</span><em>tag_id=None</em>, <em>object_ids=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.TagToObjects" 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">TagAssociation.TagToObjects</span></code> class describes a tag and its related
|
||
objects. Use the <a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.list_attached_objects_on_tags" title="com.vmware.cis.tagging_client.TagAssociation.list_attached_objects_on_tags"><code class="xref py py-func docutils literal notranslate"><span class="pre">TagAssociation.list_attached_objects_on_tags()</span></code></a>
|
||
method to retrieve a <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> with each element containing a tag and
|
||
the objects to which it is attached. This class was added in vSphere API
|
||
6.5</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.attach">
|
||
<code class="descname">attach</code><span class="sig-paren">(</span><em>tag_id</em>, <em>object_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.attach" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Attaches the given tag to the input object. The tag needs to meet the
|
||
cardinality (<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.cardinality</span></code>) and associability
|
||
(<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.associable_types</span></code>) criteria in order to be
|
||
eligible for attachment. If the tag is already attached to the object,
|
||
then this method is a no-op and an error will not be thrown. To invoke
|
||
this method, you need the attach tag privilege on the tag and the read
|
||
privilege on the object.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
<li><strong>object_id</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifier of the input object.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.InvalidArgument</span></code>
|
||
if the input tag is not eligible to be attached to this object or
|
||
if the <code class="docutils literal notranslate"><span class="pre">object_id</span></code> is not valid.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to attach the tag or do not have
|
||
the privilege to read the object.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.attach_multiple_tags_to_object">
|
||
<code class="descname">attach_multiple_tags_to_object</code><span class="sig-paren">(</span><em>object_id</em>, <em>tag_ids</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.attach_multiple_tags_to_object" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Attaches the given tags to the input object. If a tag is already
|
||
attached to the object, then the individual method is a no-op and an
|
||
error will not be added to
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>. To invoke this
|
||
method, you need the read privilege on the object and the attach tag
|
||
privilege on each tag. This method was added in vSphere API 6.5</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>object_id</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifier of the input object.</li>
|
||
<li><strong>tag_ids</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifiers of the input tags.
|
||
The parameter must contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.BatchResult" title="com.vmware.cis.tagging_client.TagAssociation.BatchResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.BatchResult</span></code></a></p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The outcome of the batch method and the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of error
|
||
messages (<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>)
|
||
describing attachment failures.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to read the object.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.attach_tag_to_multiple_objects">
|
||
<code class="descname">attach_tag_to_multiple_objects</code><span class="sig-paren">(</span><em>tag_id</em>, <em>object_ids</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.attach_tag_to_multiple_objects" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Attaches the given tag to the input objects. If a tag is already
|
||
attached to the object, then the individual method is a no-op and an
|
||
error will not be added to
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>. To invoke this
|
||
method, you need the attach tag privilege on the tag and the read
|
||
privilege on each object. This method was added in vSphere API 6.5</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
<li><strong>object_ids</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifiers of the input objects.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.BatchResult" title="com.vmware.cis.tagging_client.TagAssociation.BatchResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.BatchResult</span></code></a></p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The outcome of the batch method and the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of error
|
||
messages (<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>)
|
||
describing attachment failures.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the attach tag privilege on the tag.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.detach">
|
||
<code class="descname">detach</code><span class="sig-paren">(</span><em>tag_id</em>, <em>object_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.detach" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Detaches the tag from the given object. If the tag is already removed
|
||
from the object, then this method is a no-op and an error will not be
|
||
thrown. To invoke this method, you need the attach tag privilege on the
|
||
tag and the read privilege on the object.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
<li><strong>object_id</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifier of the input object.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to detach the tag or do not have
|
||
the privilege to read the given object.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.detach_multiple_tags_from_object">
|
||
<code class="descname">detach_multiple_tags_from_object</code><span class="sig-paren">(</span><em>object_id</em>, <em>tag_ids</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.detach_multiple_tags_from_object" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Detaches the given tags from the input object. If a tag is already
|
||
removed from the object, then the individual method is a no-op and an
|
||
error will not be added to
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>. To invoke this
|
||
method, you need the read privilege on the object and the attach tag
|
||
privilege each tag. This method was added in vSphere API 6.5</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>object_id</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifier of the input object.</li>
|
||
<li><strong>tag_ids</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifiers of the input tags.
|
||
The parameter must contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.BatchResult" title="com.vmware.cis.tagging_client.TagAssociation.BatchResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.BatchResult</span></code></a></p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The outcome of the batch method and the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of error
|
||
messages (<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>)
|
||
describing detachment failures.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to read the object.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.detach_tag_from_multiple_objects">
|
||
<code class="descname">detach_tag_from_multiple_objects</code><span class="sig-paren">(</span><em>tag_id</em>, <em>object_ids</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.detach_tag_from_multiple_objects" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Detaches the given tag from the input objects. If a tag is already
|
||
removed from the object, then the individual method is a no-op and an
|
||
error will not be added to
|
||
<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>. To invoke this
|
||
method, you need the attach tag privilege on the tag and the read
|
||
privilege on each object. This method was added in vSphere API 6.5</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
||
<li><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</li>
|
||
<li><strong>object_ids</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifiers of the input objects.</li>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.BatchResult" title="com.vmware.cis.tagging_client.TagAssociation.BatchResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.BatchResult</span></code></a></p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first">The outcome of the batch method and the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of error
|
||
messages (<code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.BatchResult.error_messages</span></code>)
|
||
describing detachment failures.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given tag does not exist in the system.</p>
|
||
</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><p class="first last"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the attach tag privilege on the tag.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.list_attachable_tags">
|
||
<code class="descname">list_attachable_tags</code><span class="sig-paren">(</span><em>object_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.list_attachable_tags" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Fetches the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of attachable tags for the given object,
|
||
omitting the tags that have already been attached. Criteria for
|
||
attachability is calculated based on tagging cardinality
|
||
(<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.cardinality</span></code>) and associability
|
||
(<code class="xref py py-attr docutils literal notranslate"><span class="pre">CategoryModel.associable_types</span></code>) constructs. To invoke this
|
||
method, you need the read privilege on the input object. The
|
||
<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> will only contain those tags for which you have read
|
||
privileges.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>object_id</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifier of the input object.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of tag identifiers that are eligible to be
|
||
attached to the given object.
|
||
The return value will contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to read the object.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.list_attached_objects">
|
||
<code class="descname">list_attached_objects</code><span class="sig-paren">(</span><em>tag_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.list_attached_objects" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Fetches the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of attached objects for the given tag. To
|
||
invoke this method, you need the read privilege on the input tag. Only
|
||
those objects for which you have the read privilege will be returned.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>tag_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifier of the input tag.
|
||
The parameter must be an identifier for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of attached object identifiers.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.NotFound</span></code>
|
||
if the tag for the given <code class="docutils literal notranslate"><span class="pre">tag_id</span></code> does not exist in the system.</td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to read the tag.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.list_attached_objects_on_tags">
|
||
<code class="descname">list_attached_objects_on_tags</code><span class="sig-paren">(</span><em>tag_ids</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.list_attached_objects_on_tags" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Fetches the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.TagToObjects" title="com.vmware.cis.tagging_client.TagAssociation.TagToObjects"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.TagToObjects</span></code></a>
|
||
describing the input tag identifiers and the objects they are attached
|
||
to. To invoke this method, you need the read privilege on each input
|
||
tag. The <code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.TagToObjects.object_ids</span></code> will only
|
||
contain those objects for which you have the read privilege. This
|
||
method was added in vSphere API 6.5</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>tag_ids</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) – The identifiers of the input tags.
|
||
The parameter must contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.TagToObjects" title="com.vmware.cis.tagging_client.TagAssociation.TagToObjects"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.TagToObjects</span></code></a></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of the tag identifiers to all object identifiers
|
||
that each tag is attached to.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.list_attached_tags">
|
||
<code class="descname">list_attached_tags</code><span class="sig-paren">(</span><em>object_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.list_attached_tags" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Fetches the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of tags attached to the given object. To
|
||
invoke this method, you need the read privilege on the input object.
|
||
The <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> will only contain those tags for which you have the
|
||
read privileges.</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>object_id</strong> (<a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifier of the input object.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of all tag identifiers that correspond to the
|
||
tags attached to the given object.
|
||
The return value will contain identifiers for the resource type:
|
||
<code class="docutils literal notranslate"><span class="pre">com.vmware.cis.tagging.Tag</span></code>.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Raise:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std.errors_client.Unauthorized</span></code>
|
||
if you do not have the privilege to read the object.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="com.vmware.cis.tagging_client.TagAssociation.list_attached_tags_on_objects">
|
||
<code class="descname">list_attached_tags_on_objects</code><span class="sig-paren">(</span><em>object_ids</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagAssociation.list_attached_tags_on_objects" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Fetches the <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.ObjectToTags" title="com.vmware.cis.tagging_client.TagAssociation.ObjectToTags"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.ObjectToTags</span></code></a>
|
||
describing the input object identifiers and the tags attached to each
|
||
object. To invoke this method, you need the read privilege on each
|
||
input object. The <code class="xref py py-attr docutils literal notranslate"><span class="pre">TagAssociation.ObjectToTags.tag_ids</span></code> will only
|
||
contain those tags for which you have the read privilege. This method
|
||
was added in vSphere API 6.5</p>
|
||
<table class="docutils field-list" frame="void" rules="none">
|
||
<col class="field-name" />
|
||
<col class="field-body" />
|
||
<tbody valign="top">
|
||
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>object_ids</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="com.vmware.vapi.html#com.vmware.vapi.std_client.DynamicID" title="com.vmware.vapi.std_client.DynamicID"><code class="xref py py-class docutils literal notranslate"><span class="pre">com.vmware.vapi.std_client.DynamicID</span></code></a>) – The identifiers of the input objects.</td>
|
||
</tr>
|
||
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of <a class="reference internal" href="#com.vmware.cis.tagging_client.TagAssociation.ObjectToTags" title="com.vmware.cis.tagging_client.TagAssociation.ObjectToTags"><code class="xref py py-class docutils literal notranslate"><span class="pre">TagAssociation.ObjectToTags</span></code></a></td>
|
||
</tr>
|
||
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code> of the object identifiers to all tag identifiers
|
||
that are attached to that object.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.tagging_client.TagModel">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.tagging_client.</code><code class="descname">TagModel</code><span class="sig-paren">(</span><em>id=None</em>, <em>category_id=None</em>, <em>name=None</em>, <em>description=None</em>, <em>used_by=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.tagging_client.TagModel" 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">TagModel</span></code> class defines a tag that can be attached to vSphere
|
||
objects.</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
</div>
|
||
<div class="section" id="module-com.vmware.cis.task_client">
|
||
<span id="com-vmware-cis-task-client-module"></span><h2>com.vmware.cis.task_client module<a class="headerlink" href="#module-com.vmware.cis.task_client" title="Permalink to this headline">¶</a></h2>
|
||
<p>The <code class="docutils literal notranslate"><span class="pre">com.vmware.cis.task_client</span></code> module provides classes and classes used for
|
||
managing tasks.</p>
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.task_client.CommonInfo">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.task_client.</code><code class="descname">CommonInfo</code><span class="sig-paren">(</span><em>description=None</em>, <em>service=None</em>, <em>operation=None</em>, <em>parent=None</em>, <em>target=None</em>, <em>status=None</em>, <em>cancelable=None</em>, <em>error=None</em>, <em>start_time=None</em>, <em>end_time=None</em>, <em>user=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.task_client.CommonInfo" 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">CommonInfo</span></code> class contains information common to all tasks. This
|
||
class was added in vSphere API 6.7</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.task_client.Info">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.task_client.</code><code class="descname">Info</code><span class="sig-paren">(</span><em>progress=None</em>, <em>result=None</em>, <em>description=None</em>, <em>service=None</em>, <em>operation=None</em>, <em>parent=None</em>, <em>target=None</em>, <em>status=None</em>, <em>cancelable=None</em>, <em>error=None</em>, <em>start_time=None</em>, <em>end_time=None</em>, <em>user=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.task_client.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">Info</span></code> class contains information about a task. This class was added
|
||
in vSphere API 6.7</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.task_client.Progress">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.task_client.</code><code class="descname">Progress</code><span class="sig-paren">(</span><em>total=None</em>, <em>completed=None</em>, <em>message=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.task_client.Progress" 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">Progress</span></code> class contains information describe the progress of an
|
||
operation. This class was added in vSphere API 6.7</p>
|
||
<div class="admonition tip">
|
||
<p class="first admonition-title">Tip</p>
|
||
<p class="last">The arguments are used to initialize data attributes with the same
|
||
names.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.task_client.Status">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.task_client.</code><code class="descname">Status</code><span class="sig-paren">(</span><em>string</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.task_client.Status" 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">Status</span></code> class defines the status values that can be reported for an
|
||
operation. This enumeration was added in vSphere API 6.7</p>
|
||
<div class="admonition note">
|
||
<p class="first admonition-title">Note</p>
|
||
<p class="last">This class represents an enumerated type in the interface language
|
||
definition. The class contains class attributes which represent the
|
||
values in the current version of the enumerated type. Newer versions of
|
||
the enumerated type may contain new values. To use new values of the
|
||
enumerated type in communication with a server that supports the newer
|
||
version of the API, you instantiate this class. See <a class="reference internal" href="enumeration.html#enumeration-description"><span class="std std-ref">enumerated
|
||
type description page</span></a>.</p>
|
||
</div>
|
||
<dl class="attribute">
|
||
<dt id="com.vmware.cis.task_client.Status.BLOCKED">
|
||
<code class="descname">BLOCKED</code><em class="property"> = Status(string='BLOCKED')</em><a class="headerlink" href="#com.vmware.cis.task_client.Status.BLOCKED" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>The operation is blocked. This class attribute was added in vSphere API 6.7</p>
|
||
</dd></dl>
|
||
|
||
<dl class="attribute">
|
||
<dt id="com.vmware.cis.task_client.Status.FAILED">
|
||
<code class="descname">FAILED</code><em class="property"> = Status(string='FAILED')</em><a class="headerlink" href="#com.vmware.cis.task_client.Status.FAILED" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>The operation failed. This class attribute was added in vSphere API 6.7</p>
|
||
</dd></dl>
|
||
|
||
<dl class="attribute">
|
||
<dt id="com.vmware.cis.task_client.Status.PENDING">
|
||
<code class="descname">PENDING</code><em class="property"> = Status(string='PENDING')</em><a class="headerlink" href="#com.vmware.cis.task_client.Status.PENDING" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>The operation is in pending state. This class attribute was added in
|
||
vSphere API 6.7</p>
|
||
</dd></dl>
|
||
|
||
<dl class="attribute">
|
||
<dt id="com.vmware.cis.task_client.Status.RUNNING">
|
||
<code class="descname">RUNNING</code><em class="property"> = Status(string='RUNNING')</em><a class="headerlink" href="#com.vmware.cis.task_client.Status.RUNNING" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>The operation is in progress. This class attribute was added in vSphere API
|
||
6.7</p>
|
||
</dd></dl>
|
||
|
||
<dl class="attribute">
|
||
<dt id="com.vmware.cis.task_client.Status.SUCCEEDED">
|
||
<code class="descname">SUCCEEDED</code><em class="property"> = Status(string='SUCCEEDED')</em><a class="headerlink" href="#com.vmware.cis.task_client.Status.SUCCEEDED" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>The operation completed successfully. This class attribute was added in
|
||
vSphere API 6.7</p>
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
<dl class="class">
|
||
<dt id="com.vmware.cis.task_client.StubFactory">
|
||
<em class="property">class </em><code class="descclassname">com.vmware.cis.task_client.</code><code class="descname">StubFactory</code><span class="sig-paren">(</span><em>stub_config</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.cis.task_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>
|
||
</dd></dl>
|
||
|
||
</div>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="articleComments">
|
||
|
||
</div>
|
||
</div>
|
||
<footer>
|
||
|
||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||
|
||
<a href="com.vmware.content.html" class="btn btn-neutral float-right" title="com.vmware.content package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
|
||
|
||
|
||
<a href="com.vmware.appliance.system.html" class="btn btn-neutral" title="com.vmware.appliance.system package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
||
|
||
</div>
|
||
|
||
|
||
<hr/>
|
||
|
||
<div role="contentinfo">
|
||
<p>
|
||
© Copyright 2018, VMware, Inc..
|
||
|
||
</p>
|
||
</div>
|
||
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/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">
|
||
var DOCUMENTATION_OPTIONS = {
|
||
URL_ROOT:'./',
|
||
VERSION:'6.7.0',
|
||
COLLAPSE_INDEX:false,
|
||
FILE_SUFFIX:'.html',
|
||
HAS_SOURCE: true,
|
||
SOURCELINK_SUFFIX: '.txt'
|
||
};
|
||
</script>
|
||
<script type="text/javascript" src="_static/jquery.js"></script>
|
||
<script type="text/javascript" src="_static/underscore.js"></script>
|
||
<script type="text/javascript" src="_static/doctools.js"></script>
|
||
|
||
|
||
|
||
|
||
|
||
<script type="text/javascript" src="_static/js/theme.js"></script>
|
||
|
||
|
||
|
||
|
||
<script type="text/javascript">
|
||
jQuery(function () {
|
||
SphinxRtdTheme.StickyNav.enable();
|
||
});
|
||
</script>
|
||
|
||
|
||
</body>
|
||
</html> |