zhmcclient 0.24.0

z hmc client—用于ibmzhmcweb服务api的纯python客户机库

概述

zhmcclient包是一个客户端库 用纯python编写，与硬件的web服务api交互 IBM Z或LinuxONE计算机的管理控制台（hmc）。目标 这个包是为了使hmc web服务api易于用于python 程序员。

hmc web服务api是任何外部工具的访问点。 管理ibm z或linuxone平台。它支持 各种平台资源的生命周期和配置，如分区， CPU、内存、虚拟交换机、I/O适配器等。

zhmcclient包封装了hmc web支持的两个协议 服务API:

• 在客户端驱动的请求/响应样式的操作上使用https。 这些操作大部分是同步完成的，但有些是长时间运行的任务 异步完成。
• jms（java消息传递服务），用于从hmc向客户端发送通知。 这可用于通知系统中的更改，或关于 使用rest开始的异步任务的完成。

安装

快捷方式：

$ pip install zhmcclient

有关详细信息，请参见文档中的Installation section。

快速启动

下面的示例代码列出了由hmc管理的计算机（cpc）：

#!/usr/bin/env pythonimportzhmcclientimportrequests.packages.urllib3requests.packages.urllib3.disable_warnings()# Set these variables for your environment:hmc_host="<IP address or hostname of the HMC>"hmc_userid="<userid on that HMC>"hmc_password="<password of that HMC userid>"session=zhmcclient.Session(hmc_host,hmc_userid,hmc_password)client=zhmcclient.Client(session)cpcs=client.cpcs.list()forcpcincpcs:print(cpc)

运行脚本时可能的输出：

Cpc(name=P000S67B, object-uri=/api/cpcs/fa1f2466-12df-311a-804c-4ed2cc1d6564, status=service-required)

文档

zhmcclient文档位于rtd上：

• Documentation for latest version on Pypi
• Documentation for master branch in Git repo

zhmc cli

在zhmcclient包的0.18.0版本之前，它包含zhmc cli。 从zhmcclient版本0.18.0开始，zhmc cli已从此位置移动 投射到新的zhmccli project。

如果您的项目使用zhmc cli，并且您正在升级zhmcclient 从0.18.0之前的包到0.18.0或更高版本，您的项目将需要添加 对其依赖项的zhmccli package。

贡献

有关如何对此项目作出贡献的信息，请参见 Development section在文档中。

许可证

zhmcclient包是根据Apache 2.0 License授权的。