pagerduty的rest api的python客户端库
pygerduty-py3的Python项目详细描述
比重
pagerduty的v1 rest api的python库。
这个库目前正在发展,在这个时候不能总是保证向后兼容。
安装
您可以使用pip install pygerduty安装。
如果要从源安装,则python setup.py install。
要求
pygerduty是根据>;=python 2.5进行测试的
simplejson对于python2.5是必需的
文件
pygerduty是pagerduty的api的一个薄包装。你需要介绍一下 为了PagerDuty Documentation 要传递的所有可用参数和响应的所有可用属性。
资源可用的主要方法有list、show、create、update和 删除。并非所有资源都具有上述所有方法的终结点。再一次, 请参阅PagerDuty Documentation以 查看所有可用的终结点。
顶级资源将通过pagerduty对象和嵌套 从其父资源返回的容器上可用的资源。
示例
实例化客户端:
import pygerduty pager = pygerduty.PagerDuty("foobar", "SOMEAPIKEY123456")
列出资源:
for schedule in pager.schedules.list(): print schedule.id, schedule.name # PX7F8S3 Primary # PJ48C0S Tertiary # PCJ94SK Secondary
按ID获取资源:
schedule = pager.schedules.show("PX7F8S3")
创建资源:
user = next(pager.users.list(query="gary", limit=1)) override = schedule.overrides.create( start="2012-12-16", end="2012-12-17", user_id=user.id)
删除资源:
schedule.overrides.delete(override.id)
更新资源:
pagerduty.users.update(user.id, name="Gary Example")
通过事件确认组:
me = next(pager.users.list(query="me@you.com", limit=1)) for incident in pagerduty.incidents.list(status='triggered'): incident.acknowledge(requester_id=me.id)