使用InfluxDB 2.0 API和Postman入门
作者:Anais Dotis-Georgiou / 产品,用例,开发者
2021年12月6日
导航至
无论您使用的是InfluxDB Cloud还是InfluxDB OSS,InfluxDB API都提供了一种简单的方式来与您的InfluxDB实例进行交互。InfluxDB v2.0 API提供了一种统一的方法来查询、写入数据以及评估InfluxDB实例的健康状况。今天,我们想分享一个Postman项目,帮助您轻松使用API。Postman是一个“用于构建和使用API的平台”。
导入Postman项目和设置
为了使用Postman项目,您需要首先 创建一个Postman账号。接下来,您需要创建一个新的工作区或导入InfluxDB API v2.0 Postman项目到默认工作区,“我的工作区”。今天,我们只需将项目导入到“我的工作区”。
确保您在适当的工作区中,通过观察右上角的工作区名称。在您的用户名旁边,点击导入以导入InfluxDB API v2.0 Postman项目。复制并粘贴InfluxDB v2.0 API Postman项目的URL,然后点击继续。
现在您可以看到一系列API调用,从基本的请求,如写入和查询InfluxDB,到为个别任务分配标签。为了发送请求,我们首先需要为此项目配置变量。导航到集合名称“InfluxDB_API_2.0”下的变量选项卡。
虽然您可以通过API完全管理InfluxDB,但您可能还是希望先使用InfluxDB UI或CLI创建一些基本资源。要开始,您需要创建以下资源及其关联的ID
桶ID可以在InfluxDB UI的“桶”页面中轻松找到。您也可以在创建桶后使用CLI或API来收集该信息。
组织和组织ID可以在InfluxDB UI的“关于我”页面中轻松找到。
最后,您还需要与您的云或OSS账户关联的URL。您可以通过登录InfluxDB UI查看URL,或查看完整的InfluxDB Cloud地区列表来找到URL。对于OSS账户,您的InfluxDB OSS URL默认应该是https://127.0.0.1:8086/。
接下来,您需要将收集中的变量替换为您的值。初始值在您与他人共享收集时共享。当前值将覆盖初始值,并用于防止将敏感值与团队的其他成员共享。点击持久化全部以使初始值与当前值匹配。点击重置全部则相反。
提交请求
添加完您的变量后,您可以点击提交来发送请求。在下面的示例中,我们使用Write Example请求将以下行协议写入请求体中的“mybucket”桶。您可以通过悬停在变量上验证您的变量是否被正确继承。204状态码表示我们的写入操作成功。
关于使用InfluxDB API v2 Postman收集来入门InfluxDB API v2的最终思考
希望这篇InfluxDB技术技巧文章能激发您利用InfluxDB v2 API管理和使用您的InfluxDB实例。如果您正在创建物联网应用程序或出于其他原因使用API,请向我们寻求帮助并分享您的经历!在评论区域、我们的社区网站或我们的Slack频道中分享您的想法、担忧或问题。我们非常乐意收到您的反馈并帮助您解决遇到的问题!