Adding new bindings and samples for vSphere 7.0

Signed-Off-By: Anusha Hegde <[email protected]>

Author: anusha94

README.md

@@ -21,11 +21,11 @@ samples require the vSphere Management SDK packages (pyVmomi) to be installed on
 The samples have been developed to work with python 2.7.x and 3.3+
 
 ## Supported OnPrem vCenter Releases
-vCenter 6.0, 6.5 and 6.7. 
+vCenter 6.0, 6.5, 6.7 and 7.0. 
 Certain APIs and samples that are introduced in 6.5 release, such as vCenter, Virtual Machine and Appliance Management. Please refer to the notes in each sample for detailed compatibility information. 
 
 ## Supported NSX-T Releases
-NSX-T 2.2, 2.3, 2.5, VMC 1.7
+NSX-T 2.2, 2.3, 3.0 and VMC 1.7, 1.8, 1.9
 
 ## VMware Cloud on AWS Support
 The VMware Cloud on AWS API and samples are currently available as a preview and are subject to change in the future.
@@ -47,7 +47,7 @@ Be sure to upgrade to the latest pip and setuptools.
 
 ```cmd
 pip install --upgrade pip setuptools
-pip install --upgrade git+https://github.com/vmware/vsphere-automation-sdk-python.git
+pip install --upgrade git+https://gitlab.eng.vmware.com/vapi-sdk/vsphere-automation-sdk-python.git
 ```
 
 **NOTE:** The SDK also requires OpenSSL 1.0.1+ if you want to connect to vSphere 6.5+ in order to support TLS1.1 & 1.2
@@ -214,16 +214,17 @@ $ python samples/vsphere/vcenter/vm/list_vms.py -v
 ### vSphere API Documentation
 
 * [VMware Cloud on AWS vSphere (latest version)](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/cloud/index.html)
-* [vSphere 6.7.1 (latest)](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.7.1/)
-* Previous releases:    [6.7.0](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.7.0)    [6.6.1](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.6.1)       [6.5](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.5)    [6.0](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.0) 
+* [vSphere 7.0 (latest)](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/7.0.0.1/)
+* Previous releases:    [6.7.0](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.7.0)    [6.6.1](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.6.1)       [6.5](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.5)    [6.0](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.0)      [6.7.1](https://vmware.github.io/vsphere-automation-sdk-python/vsphere/6.7.1/)
 
 ### VMware Cloud on AWS API Documentation
 
 * [VMware Cloud on AWS Console API](https://vmware.github.io/vsphere-automation-sdk-python/vmc/index.html)
 * [VMware Cloud on AWS Disaster Recovery as a Service (DRaaS) API](https://vmware.github.io/vsphere-automation-sdk-python/vmc-draas/index.html)
 
-### NSX API Documentation
 
+### NSX API Documentation
+* [NSX-T Data Center](https://docs.vmware.com/en/VMware-NSX-T-Data-Center/index.html)
 * [NSX Manager APIs](https://vmware.github.io/vsphere-automation-sdk-python/nsx/nsx/index.html) - API for managing NSX-T cluster and transport nodes for on-prem customers
 * [NSX Policy](https://vmware.github.io/vsphere-automation-sdk-python/nsx/nsx_policy/index.html) - primary API for managing logical networks for on-prem customers
 * [NSX VMC Policy](https://vmware.github.io/vsphere-automation-sdk-python/nsx/nsx_vmc_policy/index.html) - primary API for managing logical networks for VMC customers
@@ -240,8 +241,7 @@ Common issues you may run into while installing the sdk and running samples are
 Board members are volunteers from the SDK community and VMware staff members, board members are not held responsible for any issues which may occur from running of samples from this repository.
 
 Members:
-* Tianhao He (VMware)
-* Pavan Bidkar (VMware)
+* Anusha Hegde (VMware)
 
 ## VMware Resources
 

lib/vapi-client-bindings/index.html

@@ -1 +1 @@
-<a href='vapi_client_bindings-3.2.0-py2.py3-none-any.whl'>vapi_client_bindings-3.2.0-py2.py3-none-any.whl</a><br />
+<a href='vapi_client_bindings-3.3.0-py2.py3-none-any.whl'>vapi_client_bindings-3.3.0-py2.py3-none-any.whl</a><br />

lib/vapi-client-bindings/vapi_client_bindings-3.3.0-py2.py3-none-any.whl

@@ -1 +1 @@
-<a href='vapi_common_client-2.14.0-py2.py3-none-any.whl'>vapi_common_client-2.14.0-py2.py3-none-any.whl</a><br />
+<a href='vapi_common_client-2.15.0-py2.py3-none-any.whl'>vapi_common_client-2.15.0-py2.py3-none-any.whl</a><br />

lib/vapi-common-client/index.html

@@ -1 +1 @@
-<a href='vapi_runtime-2.14.0-py2.py3-none-any.whl'>vapi_runtime-2.14.0-py2.py3-none-any.whl</a><br />
+<a href='vapi_runtime-2.15.0-py2.py3-none-any.whl'>vapi_runtime-2.15.0-py2.py3-none-any.whl</a><br />

lib/vapi-common-client/vapi_common_client-2.15.0-py2.py3-none-any.whl

@@ -0,0 +1,66 @@
+This directory contains samples for the Discovery and Plan APIs. Discovery and Plan is a new feature for the VCSA. VMware Discovery and Plan solution consists of vSphere, vSAN, esx, drivers frimware, 2nd party products (NSX, VRA, ETC) and 3rd party products. Though it's a tightly integrated software stack, it's complex process to patch software for Clusters, including ESXi hosts and vCenter.
+
+For more information, please review the official release notes.
+
+Discovery and Plan having the followings APIs:
+    * Discovery: Provides the user options to choose from, to add VMware products manually
+    * Report: To download the report generated by the interop, precheck, etc operations.
+	* Update client: Listing all available updates and upgrades for the products installed in the user( at the Moment we only do it for ESX and vCenter). Later on the user can select one of the patches available and can plan an actual patch or upgrade for the selected version.
+
+Overview of the directory code samples:
+
+    * discovery_sample.py - running a simple workflow to discover the products . It's having below APIs.
+	GET https://{server}/lcm/rest/vcenter/lcm/discovery/product-catalog
+	GET https://{server}/lcm/rest/vcenter/lcm/discovery/associated-products
+	POST https://{server}/lcm/rest/vcenter/lcm/discovery/associated-products. Create spec as below.
+	CreateSpec {
+       /**
+        * The name of the product.
+        */
+        String productName;
+
+       /**
+        * Current product version.
+        */
+        String version;
+
+       /**
+        * The list of hostname/IPs of the instances of the VMware products
+        * deployed in the customer environment.
+        */
+        Optional<List<String>> deployments;
+    }
+	GET https://{server}/lcm/rest/vcenter/lcm/discovery/associated-products/{product-id}
+	PATCH https://{server}/lcm/rest/vcenter/lcm/discovery/associated-products/{product-id}. Update spec as below.
+	UpdateSpec {
+        /**
+         * The list of hostname/IPs of the instances of the VMware products
+         * deployed in the customer environment.
+         */
+        Optional<List<String>> deployments;
+
+    }
+	DELETE https://{server}/lcm/rest/vcenter/lcm/discovery/associated-products/{product-id}
+    * lcm_sample.py - running a simple workflow to download report.
+    GET https://{server}/lcm/rest/vcenter/lcm/reports/{report}
+    * update_sample.py - running a simple workflow to find updates and upgrades
+	GET https://{server}/lcm/rest/vcenter/lcm/update/pending
+	GET https://{server}/lcm/rest/vcenter/lcm/update/pending/{version}
+	POST https://{server}/rest/vcenter/lcm/update/pending/{version}/pre-upgrade-checks
+
+To view the available command-line options:
+
+     $ python discovery_sample.py --help
+     $ python lcm_sample.py --help
+	 $ python update_sample.py --help
+
+Running the samples:
+
+    $ python discovery_sample.py --server <vCenter Server IP> --username <username> --password <password> --skipverification
+    $ python lcm_sample.py --server <vCenter Server IP> --username <username> --password <password> --skipverification
+    $ python update_sample.py --server <vCenter Server IP> --username <username> --password <password> --skipverification
+
+
+Testbed Requirement:
+
+    * 1 vCenter Server appliance version 7.0 or above are supported.

lib/vapi-runtime/index.html

@@ -0,0 +1,26 @@
+"""
+* *******************************************************
+* Copyright VMware, Inc. 2019. All Rights Reserved.
+* SPDX-License-Identifier: MIT
+* *******************************************************
+*
+* DISCLAIMER. THIS PROGRAM IS PROVIDED TO YOU "AS IS" WITHOUT
+* WARRANTIES OR CONDITIONS OF ANY KIND, WHETHER ORAL OR WRITTEN,
+* EXPRESS OR IMPLIED. THE AUTHOR SPECIFICALLY DISCLAIMS ANY IMPLIED
+* WARRANTIES OR CONDITIONS OF MERCHANTABILITY, SATISFACTORY QUALITY,
+* NON-INFRINGEMENT AND FITNESS FOR A PARTICULAR PURPOSE.
+"""
+
+
+__author__ = 'VMware, Inc.'
+__copyright__ = 'Copyright 2019 VMware, Inc. All rights reserved.'
+
+
+# Required to distribute different parts of this
+# package as multiple distribution
+try:
+    import pkg_resources
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    from pkgutil import extend_path
+    __path__ = extend_path(__path__, __name__)  # @ReservedAssignment