它的私有云python客户端
pyvss的Python项目详细描述
python客户端到its私有云api
文档
包文档现在可以在docs获得。
安装
安装pyvss的最快方法是使用pip:
pip install pyvss
如果您安装了pyvss并希望升级到最新版本,则可以运行:
pip install --upgrade pyvss
这将安装pyvss以及所有依赖项。
你也可以download the tarball。一旦您的工作站上有了py-vss
目录结构,您就可以运行:
cd <path_to_py-vss>
python setup.py install
macos
您可以直接使用pip
来安装pyvss。运行pip --version
查看您的版本
macos已经包含python和pip
。
pip --version
If you don't have
pip
installed, first download and install Python 3.7 for Mac from the downloads page of Python.org. Download and run thepip
installation script provided by the Python Packaging Authority.
curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user
- 使用
pip
安装pyvss。
pip install pyvss --upgrade --user
- 验证pyvss是否已正确安装。
pip freeze | grep pyvss
Linux
您可以直接使用pip
来安装pyvss。运行pip --version
查看您的版本
Linux已经包含了python和pip
。
pip --version
If you don't have
pip
installed, first download and install Python 3.5 for Linux from the downloads page of Python.org or using your preferred package manager. Download and run thepip
installation script provided by the Python Packaging Authority.
curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user
- 使用
pip
安装pyvss。
pip install pyvss --upgrade --user
- 验证pyvss是否已正确安装。
pip freeze | grep pyvss
窗口
从“开始”菜单打开命令提示符。
使用以下命令验证python和
pip
是否都已正确安装。
C:\Windows\System32> python --version Python 3.7.1 C:\Windows\System32> pip --version pip 18.1 from c:\program files\python37\lib\site-packages\pip (python 3.7)
- 使用pip安装pyvss cli。
C:\Windows\System32> pip install pyvss
- 验证pyvss是否已正确安装。
C:\Windows\System32> pip freeze | findstr pyvss
码头工人
有关更多信息,请参阅Docker部分。
使用
创建VssManager
的实例,通过的私有云api访问令牌
您的全部设置为开始调用包含的任何自描述性方法:
frompyvss.managerimportVssManagervss=VssManager(tk='api_token')# list vmsvms=vss.get_vms()# list foldersfolders=vss.get_folders()# networksnetworks=vss.get_networks()# domainsdomains=vss.get_domains()# power cycle vmvss.power_cycle_vm(uuid='<uuid>')# create vmreq=vss.create_vm(os='ubuntu64Guest',built='os_install',description='Testing python wrapper',folder='group-v6736',bill_dept='EIS',disks=[100,100])uuid=vss.wait_for_request(req['_links']['request'],'vm_uuid','Processed')# creating multiple vmsreqs=vss.create_vms(count=3,name='python',os='ubuntu64Guest',bill_dept='EIS',description='Testing multiple deployment from python wrapper',folder='group-v6736',built='os_install')uuids=[vss.wait_for_request(r['_links']['request'],'vm_uuid','Processed')forrinreqs]# power on recently created vmsforuuidinuuids:vss.power_on_vm(uuid)# create snapshotreq=vss.create_vm_snapshot(uuid='5012abcb-a9f3-e112-c1ea-de2fa9dab90a',desc='Snapshot description',date_time='2016-08-04 15:30',valid=1)snap_id=vss.wait_for_request(req['_links']['request'],'snap_id','Processed')# revert to snapshotreq=vss.revert_vm_snapshot(uuid,snap_id)
另一种方法是从VssManager
类中生成一个令牌,这可以完成
通过设置以下环境变量
exportVSS_API_USER='username'exportVSS_API_USER_PASS='username_password'
然后,从VssManager
调用get_token
方法,如下所示:
frompyvss.managerimportVssManagervss=VssManager()vss.get_token()
获取帮助
我们使用gitlab问题来跟踪bug、增强和功能请求。 如果你发现了一个bug,请open a new issue。
版本控制
api版本是基于Semantic Versioning标记的。中提供的版本 tags section。
贡献
有关我们的行为准则和 将代码提交到存储库。