1
0
mirror of https://github.com/vmware/vsphere-automation-sdk-python.git synced 2024-11-26 11:19:59 -05:00
vsphere-automation-sdk-python/nsx/vmc_app/com.vmware.html
Gordon Good 9505b5a261 Upgrade NSX docs to M5P2 (nsx version 2.3.0.0.2.11053635)
Signed-off-by: Gordon Good <ggood@vmware.com>
2019-01-25 15:19:42 -08:00

417 lines
20 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!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 package &mdash; NSX-T Policy SDK 2.3.0.0.2 documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="com.vmware.nsx_vmc_app package" href="com.vmware.nsx_vmc_app.html" />
<link rel="prev" title="com package" href="com.html" />
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="index.html" class="icon icon-home"> NSX-T Policy SDK
</a>
<div class="version">
2.3.0.0.2
</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="current reference internal" href="#">com.vmware package</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#subpackages">Subpackages</a></li>
<li class="toctree-l4"><a class="reference internal" href="#submodules">Submodules</a></li>
<li class="toctree-l4"><a class="reference internal" href="#module-com.vmware.nsx_vmc_app_client">com.vmware.nsx_vmc_app_client module</a></li>
<li class="toctree-l4"><a class="reference internal" href="#module-com.vmware.nsx_vmc_app_client_for_vmc">com.vmware.nsx_vmc_app_client_for_vmc module</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">NSX-T Policy SDK</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> &raquo;</li>
<li><a href="com.html">com package</a> &raquo;</li>
<li>com.vmware package</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/com.vmware.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">
<span id="com-vmware-package"></span><h1>com.vmware package<a class="headerlink" href="#module-com.vmware" title="Permalink to this headline"></a></h1>
<div class="section" id="subpackages">
<h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to this headline"></a></h2>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="com.vmware.nsx_vmc_app.html">com.vmware.nsx_vmc_app package</a><ul>
<li class="toctree-l2"><a class="reference internal" href="com.vmware.nsx_vmc_app.html#subpackages">Subpackages</a><ul>
<li class="toctree-l3"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.html">com.vmware.nsx_vmc_app.infra package</a><ul>
<li class="toctree-l4"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.html#subpackages">Subpackages</a><ul>
<li class="toctree-l5"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.direct_connect.html">com.vmware.nsx_vmc_app.infra.direct_connect package</a><ul>
<li class="toctree-l6"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.direct_connect.html#submodules">Submodules</a></li>
<li class="toctree-l6"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.direct_connect.html#module-com.vmware.nsx_vmc_app.infra.direct_connect.routes_client">com.vmware.nsx_vmc_app.infra.direct_connect.routes_client module</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.html#submodules">Submodules</a></li>
<li class="toctree-l4"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.html#module-com.vmware.nsx_vmc_app.infra.direct_connect_client">com.vmware.nsx_vmc_app.infra.direct_connect_client module</a></li>
<li class="toctree-l4"><a class="reference internal" href="com.vmware.nsx_vmc_app.infra.html#module-com.vmware.nsx_vmc_app.infra.linked_vpcs_client">com.vmware.nsx_vmc_app.infra.linked_vpcs_client module</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="com.vmware.nsx_vmc_app.html#submodules">Submodules</a></li>
<li class="toctree-l2"><a class="reference internal" href="com.vmware.nsx_vmc_app.html#module-com.vmware.nsx_vmc_app.infra_client">com.vmware.nsx_vmc_app.infra_client module</a></li>
<li class="toctree-l2"><a class="reference internal" href="com.vmware.nsx_vmc_app.html#module-com.vmware.nsx_vmc_app.model_client">com.vmware.nsx_vmc_app.model_client module</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="section" id="submodules">
<h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this headline"></a></h2>
</div>
<div class="section" id="module-com.vmware.nsx_vmc_app_client">
<span id="com-vmware-nsx-vmc-app-client-module"></span><h2>com.vmware.nsx_vmc_app_client module<a class="headerlink" href="#module-com.vmware.nsx_vmc_app_client" title="Permalink to this headline"></a></h2>
<dl class="class">
<dt id="com.vmware.nsx_vmc_app_client.StubFactory">
<em class="property">class </em><code class="descclassname">com.vmware.nsx_vmc_app_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.nsx_vmc_app_client.StubFactory" title="Permalink to this definition"></a></dt>
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.StubFactoryBase</span></code></p>
<p>Initialize StubFactoryBase</p>
<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>stub_config</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.bindings.stub.StubConfiguration</span></code>) Stub config instance</td>
</tr>
</tbody>
</table>
</dd></dl>
</div>
<div class="section" id="module-com.vmware.nsx_vmc_app_client_for_vmc">
<span id="com-vmware-nsx-vmc-app-client-for-vmc-module"></span><h2>com.vmware.nsx_vmc_app_client_for_vmc module<a class="headerlink" href="#module-com.vmware.nsx_vmc_app_client_for_vmc" title="Permalink to this headline"></a></h2>
<p>Convenience methods to get API clients for NSX APIs in VMC</p>
<dl class="class">
<dt id="com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter">
<em class="property">class </em><code class="descclassname">com.vmware.nsx_vmc_app_client_for_vmc.</code><code class="descname">CSPSecurityContextFilter</code><span class="sig-paren">(</span><em>session</em>, <em>refresh_token</em>, <em>refresh_url</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter" title="Permalink to this definition"></a></dt>
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.security.client.security_context_filter.SecurityContextFilter</span></code></p>
<p>CSP Security Context filter in API Provider chain adds the security
context based on a refresh token to the execution context passed in.</p>
<p>Initialize SecurityContextFilter</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 last simple">
<li><strong>session</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">requests.Session</span></code>) Requests Session object to use for making HTTP calls</li>
<li><strong>refresh_token</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) Refresh token to use for obtaining an access
token</li>
<li><strong>refresh_url</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) URL that allows exchanging a refresh token for an
access token</li>
</ul>
</td>
</tr>
</tbody>
</table>
<dl class="method">
<dt id="com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter.get_max_retries">
<code class="descname">get_max_retries</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter.get_max_retries" title="Permalink to this definition"></a></dt>
<dd><p>Get the max number of retries</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"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></td>
</tr>
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">Number of retries</td>
</tr>
</tbody>
</table>
</dd></dl>
<dl class="method">
<dt id="com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter.get_security_context">
<code class="descname">get_security_context</code><span class="sig-paren">(</span><em>on_error</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter.get_security_context" title="Permalink to this definition"></a></dt>
<dd><p>Retrieve security context. If this method is called after an error
occured, then a new access token is obtained using the refresh
token and a new security context is created.</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>on_error</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code>) Whether this method is called after getting an error</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">vmware.vapi.core.SecurityContext</span></code></td>
</tr>
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Security context</td>
</tr>
</tbody>
</table>
</dd></dl>
<dl class="method">
<dt id="com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter.should_retry">
<code class="descname">should_retry</code><span class="sig-paren">(</span><em>error_value</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.nsx_vmc_app_client_for_vmc.CSPSecurityContextFilter.should_retry" title="Permalink to this definition"></a></dt>
<dd><p>Returns whether the request should be retried or not based on the error
specified.</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>error_value</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.data.value.ErrorValue</span></code>) Method error</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">bool</span></code></td>
</tr>
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Returns True if request should be retried in case the error is
either Unauthenticated or Unauthorized else False</td>
</tr>
</tbody>
</table>
</dd></dl>
</dd></dl>
<dl class="class">
<dt id="com.vmware.nsx_vmc_app_client_for_vmc.VmcNsxClient">
<em class="property">class </em><code class="descclassname">com.vmware.nsx_vmc_app_client_for_vmc.</code><code class="descname">VmcNsxClient</code><span class="sig-paren">(</span><em>stub_factory_class</em>, <em>session</em>, <em>refresh_token</em>, <em>vmc_url</em>, <em>csp_url</em>, <em>org_id</em>, <em>sddc_id</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.nsx_vmc_app_client_for_vmc.VmcNsxClient" 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.ApiClient</span></code></p>
<p>Client class that providess access to stubs for all the services in the
VMC NSX API</p>
<p>Initialize VmcClient by creating a stub factory instance using a CSP
Security context filter added to the filter chain of the connector</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 last simple">
<li><strong>stub_factory_class</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">type</span></code>) Which stub factory class to use</li>
<li><strong>session</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">requests.Session</span></code>) Requests HTTP session instance</li>
<li><strong>refresh_token</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) Refresh token obtained from CSP</li>
<li><strong>vmc_url</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) URL of the VMC service</li>
<li><strong>csp_url</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) URL of the CSP service</li>
<li><strong>org_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) ID of the VMC organization</li>
<li><strong>sddc_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) ID of the VMC Software-Defined Data Center (SDDC)</li>
</ul>
</td>
</tr>
</tbody>
</table>
</dd></dl>
<dl class="function">
<dt id="com.vmware.nsx_vmc_app_client_for_vmc.create_nsx_vmc_app_client_for_vmc">
<code class="descclassname">com.vmware.nsx_vmc_app_client_for_vmc.</code><code class="descname">create_nsx_vmc_app_client_for_vmc</code><span class="sig-paren">(</span><em>refresh_token</em>, <em>org_id</em>, <em>sddc_id</em>, <em>session=None</em><span class="sig-paren">)</span><a class="headerlink" href="#com.vmware.nsx_vmc_app_client_for_vmc.create_nsx_vmc_app_client_for_vmc" title="Permalink to this definition"></a></dt>
<dd><p>Helper method to create an instance of the VMC NSX VMC app API client</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>refresh_token</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) Refresh token obtained from CSP</li>
<li><strong>org_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) ID of the VMC organization</li>
<li><strong>sddc_id</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code>) ID of the VMC Software-Defined Data Center (SDDC)</li>
<li><strong>session</strong> (<code class="xref py py-class docutils literal notranslate"><span class="pre">requests.Session</span></code> or <code class="docutils literal notranslate"><span class="pre">None</span></code>) Requests HTTP session instance. If not specified, then one
is automatically created and used</li>
</ul>
</td>
</tr>
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><code class="xref py py-class docutils literal notranslate"><span class="pre">vmware.vapi.vmc.client.VmcNsxClient</span></code></p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">VMC NSX Client instance</p>
</td>
</tr>
</tbody>
</table>
</dd></dl>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="com.vmware.nsx_vmc_app.html" class="btn btn-neutral float-right" title="com.vmware.nsx_vmc_app package" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="com.html" class="btn btn-neutral" title="com package" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright 2018, VMware, Inc.
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></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.Navigation.enable(true);
});
</script>
</body>
</html>