HTTP API参考
使用以下指导方针的Grafana OnCall API。
身份验证
要进行授权,请使用授权标题:
#使用shell,你可以通过正确的头与每个请求卷曲“api_endpoint_here”——头“授权:“api_key_here”
Grafana OnCall使用API键来允许访问API。您可以在OnCall ->设置页面请求一个新的OnCall API密钥。
API密钥是特定于用户和Grafana堆栈的。如果您想切换到不同的堆栈配置,请请求不同的API密钥。
分页
列表端点(如列表集成或列表警报组)返回多个对象。
OnCall API以页的形式返回它们。注意,页面大小可能不同。
参数 | 意义 |
---|---|
数 |
项目总数。它可以是0 如果请求没有返回任何数据。 |
下一个 |
一个到下一页的链接。它可以是零 如果下一页不包含任何数据。 |
以前的 |
到上一页的链接。它可以是零 如果上一页不包含任何数据。 |
结果 |
数据列表。可以[] 如果请求没有返回任何数据。 |
速度限制
Grafana OnCall提供了速率限制,以确保警报组通知将被交付到您的Slack工作空间,即使某些集成产生了大量的警报。
监视集成速率限制
速率限制响应HTTP状态:429
范围 | 量 | 时间框架 |
---|---|---|
来自每个集成的警报 | 300 | 5分钟 |
来自整个团队的警报 | 500 | 5分钟 |
API速率限制
您可以根据平台状态降低或增加速率限制。
范围 | 量 | 时间框架 |
---|---|---|
每个API键的API请求 | 300 | 5分钟 |