DELL IDRAC API接口开发文档翻译及client模块
今天和DELL官网要了一份关于服务器IDRAC 版本7/8 的API开发文档，花了一天的时间，进行了翻译，不一定全部准确，但对于英语不好的人会有所帮助。也不用重复造轮子了。
下载链接：
DELL IDRAC7/8 硬件监控client模块
- 1 #!/opt/python3/bin/python3
- 2 #Author: zhaoyong
- 3 \'\'\'
- 4 本模块用于DELL 服务器IDARC API接口,只用于检测硬件状态，检测硬件包括如下:
- 5 < CPU, 内存， 磁盘， 电源， 风扇， raid卡>
- 6 注意：只支持IDRAC版本7和版本8
- 7 注意：只提取URL：/redfish/v1/Systems/System.Embedded.1 下的信息
- 8 \'\'\'
- 9 import requests, json
- 10
- 11
- 12 class idrac_api(object):
- 13 \'\'\'
- 14 DELL powerEdge服务器IDRAC 7/8 API 硬件监控客户端接口
- 15 \'\'\'
- 16
- 17 def __init__(self, ip, username, passwd):
- 18 self.__ip = ip
- 19 self.__username = username
- 20 self.__passwd = passwd
- 21 # 服务器连接tokin对象
- 22 self.__s_tokin = \'\'
- 23 # 第一次访问提取的元数据，字典格式
- 24 self.__meta_data_dict = \'\'
- 25
- 26 def conn(self):
- 27 \'\'\'
- 28 连接服务器
- 29 :return:
- 30 \'\'\'
- 31 # SSL验证会提示警告，这里进行关闭警告信息的提示
- 32 requests.packages.urllib3.disable_warnings()
- 33 # 初始化一个session连接
- 34 c = requests.Session()
- 35 c.timeout = 60
- 36 # 设置验证信息
- 37 c.auth = (self.__username, self.__passwd)
- 38 # 关闭SSL验证
- 39 c.verify = False
- 40 # 连接IDRAC并进行身份验证和原始数据的提取
- 41 auth_url = \'https://%s/redfish/v1/Systems/System.Embedded.1\' % (self.__ip)
- 42 try:
- 43 conn_status = c.get(auth_url)
- 44 # 如果连接成功，将session对象赋予self.__s_tokin，获取的元数据赋予self.__meta_data_dict,否则报错
- 45 if conn_status.ok:
- 46 self.__s_tokin = c
- 47 self.__meta_data_dict = conn_status.json()
- 48 else:
- 49 err_info = conn_status.raise_for_status()
- 50 # print(\'----->\',err_info)
- 51 return \'服务器: %s IDRAC连接失败，错误信息：%s\' % (self.__ip, err_info)
- 52 except Exception as e:
- 53 return \'服务器: %s IDRAC连接失败，错误信息：%s\' % (self.__ip, e)
- 54
- 55 def memory_status(self):
- 56 \'\'\'
- 57 检测内存
- 58 输出格式：MemorySummary {\'Status\': {\'Health\': \'OK\', \'HealthRollUp\': \'OK\', \'State\': \'Enabled\'}, \'TotalSystemMemoryGiB\': 64.0}
- 59 :return: 返回内存状态
- 60 \'\'\'
- 61 mem_status = self.__meta_data_dict[\'MemorySummary\'][\'Status\'][\'Health\']
- 62 return mem_status
- 63
- 64 def cpu_status(self):
- 65 \'\'\'
- 66 检测CPU
- 67 输出格式：ProcessorSummary {\'Count\': 2, \'Model\': \'Intel(R) Xeon(R) CPU E5-2660 v3 @ 2.60GHz\', \'Status\': {\'Health\': \'OK\', \'HealthRollUp\': \'OK\', \'State\': \'Enabled\'}}
- 68 :return:返回CPU状态
- 69 \'\'\'
- 70 cpu_status = self.__meta_data_dict[\'ProcessorSummary\'][\'Status\'][\'Health\']
- 71 return cpu_status
- 72
- 73 def sn(self):
- 74 \'\'\'
- 75 提取服务的SN，暂时不需要
- 76 :return: 返回SN码
- 77 \'\'\'
- 78 sn_str = self.__meta_data_dict[\'SKU\']
- 79 return sn_str
- 80
- 81 def disk_status(self):
- 82 \'\'\'
- 83 硬盘检测输出：
- 84 SimpleStorage {\'@odata.id\': \'/redfish/v1/Systems/System.Embedded.1/Storage/Controllers\'}
- 85 Status {\'Health\': \'OK\', \'HealthRollUp\': \'OK\', \'State\': \'Enabled\'}
- 86 如果总体检测结果为OK，直接返回默认字典
- 87 否则将详细检查每一个磁盘和raid卡，将有故障的设备名称写入返回的字典
- 88 :return: 返回硬盘和raid卡状态
- 89 \'\'\'
- 90 disk_result= {\'raid_card\':\'OK\',\'pre_disk\':\'OK\'}
- 91 disk_check = self.__meta_data_dict[\'Status\'][\'Health\']
- 92 if disk_check != \'OK\':
- 93 d_url_str = \'https://%s%s\' % (self.__ip, self.__meta_data_dict[\'SimpleStorage\'][\'@odata.id\'])
- 94 member_out = self.__s_tokin.get(d_url_str).json()
- 95 member_url_str = \'https://%s%s\' % (self.__ip, member_out[\'Members\'][0][\'@odata.id\'])
- 96 pre_disk_out = self.__s_tokin.get(member_url_str).json()
- 97 if pre_disk_out[\'Status\'][\'Health\'] != \'OK\':
- 98 disk_result[\'raid_card\'] = pre_disk_out[\'Name\']
- 99 for pd in pre_disk_out[\'Devices\']:
- 100 if pd[\'Status\'][\'Health\'] != \'OK\':
- 101 disk_result[\'pre_disk\'] = pd[\'Name\']
- 102
- 103 return disk_result
- 104
- 105 def power_status(self):
- 106 \'\'\'
- 107 电源检测
- 108 :return: 返回电源状态
- 109 \'\'\'
- 110 pow_status = {}
- 111 power_url_list = self.__meta_data_dict[\'Links\'][\'PoweredBy\']
- 112 for p in power_url_list:
- 113 p_url = \'https://%s%s\' % (self.__ip, p[\'@odata.id\'])
- 114 p_dict = self.__s_tokin.get(p_url).json()
- 115 pow_status[p_dict[\'Name\']] = p_dict[\'Status\'][\'Health\']
- 116 return pow_status
- 117
- 118 def fan_status(self):
- 119 \'\'\'
- 120 风扇检测
- 121 :return:统一返回风扇整体状态
- 122 \'\'\'
- 123 fan_status={\'fan\':\'OK\'}
- 124 fan_all_list = self.__meta_data_dict[\'Links\'][\'CooledBy\']
- 125 for f in fan_all_list:
- 126 f_url_str = \'https://%s%s\' % (self.__ip, f[\'@odata.id\'])
- 127 fan_out = self.__s_tokin.get(f_url_str).json()
- 128 if fan_out[\'Status\'][\'Health\'] != \'OK\':
- 129 fan_status[\'fan\'] = fan_out[\'FanName\']
- 130 return fan_status
- 131 return fan_status
- 132
- 133 def hardware_status(self):
- 134 \'\'\'
- 135 收集所有硬件信息
- 136 :return: 返回json格式数据
- 137 \'\'\'
- 138 out = []
- 139 ck_result = {}
- 140 ck_result[\'cpu\'] = self.cpu_status()
- 141 ck_result[\'memory\'] = self.memory_status()
- 142 ck_result[\'disk\'] = self.disk_status()[\'pre_disk\']
- 143 ck_result[\'raid_card\'] = self.disk_status()[\'raid_card\']
- 144 ck_result[\'power1\'] = self.power_status()[\'PS1 Status\']
- 145 ck_result[\'power2\'] = self.power_status()[\'PS2 Status\']
- 146 ck_result[\'fan\'] = self.fan_status()[\'fan\']
- 147 # 提取故障设备
- 148 for s in ck_result:
- 149 if ck_result[s] != \'OK\':
- 150 out.append(ck_result[s])
- 151 if len(out) == 0:
- 152 out.append(\'OK\')
- 153 # 以字符串返回故障设备，否则返回OK，表示无故障
- 154 return \',\'.join(out)
- 155
- 156 if __name__ == \'__main__\':
- 157 \'\'\'
- 158 运行主程序，测试使用
- 159 \'\'\'
- 160 out = idrac_api(\'IDRAC IP\', \'账号\', \'密码\')
- 161 # 连接服务器
- 162 mess = out.conn()
- 163 # 有错误就打印报错信息并exit
- 164 if mess:
- 165 exit(mess)
- 166 # 以字符串打印检测结果
- 167 result = out.hardware_status()
- 168 print(result)
版权声明：本文为zy6103原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。