F5 api接口开发实战（一）

本人从18年下旬，开始从事F5负载均衡的自动化开发工作，主要使用python编程语言，开发的F5功能模块为LTM和GTM。

F5开发简介

1、F5管理模式

F5的管理模式主要有4种（不包含snmp），分别为web页面，tmsh命令行，restful api，以及soap api。这其中，web页面和tmsh命令行大多数F5管理员都用过，也是传统运维模式，而restful api和soap api需要开发第三方程序去调用，有一定使用门槛。这两者的区别为

soap api比较老，数据交换格式为http + xml。接口风格为soap，包含很多一次性拉取全部配置的接口，资源消耗量小，有些地方比rest实用。
restful api比较新，数据交换格式使用http + json。标准restful风格，调用结构清晰，但部分接口华而不实，资源消耗量大，甚至现网配置太多会出现接口调用失败。

本文档将大部分使用restful api进行介绍，对需要使用soap的部分也会做一定介绍。这两种api都有python已封装好的第三方库。

2、关于F5版本和api支持情况

soap：支持v10以及以上所有版本，但v11与v10相比改动较大，其中改动部分soap可能会不支持。
rest：不支持v10，支持v11以上所有版本，v12和v11相比又有比较大的修改，导致部分功能v12和v11的接口形式有变化。

以上2种api都有F5官方资料，全英文，链接如下：https://clouddocs.f5.com/api/

3、使用python的第三方库进行开发

可以使用python的requests包直接与F5进行交互，但F5有对接口进行封装的第三方库，可以避免重复造轮子。本人使用的python版本为3.7.5，restful的第三方库为f5-sdk，soap的第三方库为bigsuds。其中rest的封装库有文档，链接如下：https://f5-sdk.readthedocs.io/en/latest/。

基本使用方式为使用ip地址、用户名、密码进行认证，使用web页面登陆的用户名和密码。

安装第三方库：

pip install f5-sdk

pip install bigsuds

rest接口认证方式：

import f5.bigip

bigipRest = f5.bigip.ManagementRoot('192.168.1.45', 'admin', '123456')

soap认证方式：

import bigsuds

bigipSoap = bigsuds.BIGIP('192.168.1.45', 'admin', '123456')

上述获取到的bigipRest和bigipSoap是一个可执行对象，对其进行各种操作即可控制此F5。

4、 F5接口的rest风格简介

什么是rest风格？百度出来的结果是“表述性状态转移”，是一组架构约束条件和原则，一种接口风格和实现。F5上全部的rest设计原则可以写一大本厚厚的教材，因此在此我不做详细描述，只举例说几个常用的，不求大而全只求日常用到的能了解。

以下几个名词需要理解：

Resource：资源，可以理解为F5上的某个配置项，比如某个pool就是一个Resource，某个vs也是一个Resource。
Collection：集合，Collection是一组Resource的抽象展示，比如某台ltm上全部的pool就是一个Collection。
Subcollection：子集合，Subcollection是在某个Resource下的一种配置项，比如pool下面有members，那么某个pool下的所有members就是一组Subcollection。
Subcollection Resource：子资源，顾名思义，在Subcollection下的资源就是SR，比如某个pool下的某个member。
Organizing Collection：组织集合，这是最大的一层概念，简单理解的话，ltm就是一个OC，gtm又是一个OC，他是一组全部功能的总体实现。
Unnamed Resource：未命名资源，一般是F5上自带的资源项，不可以被删除或者新增，很少用到。

F5上对某个资源进行配置操作时，就是以上述名词的组合定位的，比如

http://192.168.1.1/mgmt/tm/ltm/pool/~Common~mypool/members/~Common~1.1.1.1:80

                  |----|--|---|----|--------------|-------|-------------|

                  |root|OC|OC |Coll| Resource     | SC    |SubColl Resrc|

比如上述url就代表了这台F5 192.168.1.1上的ltm（OC），在pool这个配置大类（Collection）中的这个/Common/mypool（Resource），下面的members中（Subcollection），存在一个/Common/1.1.1.1:80（Subcollection Resource）的配置。这时候通过http的方法（get、post、delete等），就可以对它进行查询/变更/删除等操作了。（Common前后使用~代替/的原因是因为url中用/代表路径分隔，因此只好用~替代了）

上面的表述结构虽然清晰，但还是有点复杂，python的第三方库对其进行了良好的封装。封装后的使用方法更容易理解和使用，将在后面几篇文章中介绍。