使用InfluxDB 2.0 API和Postman入门

导航至

无论您使用的是InfluxDB Cloud还是InfluxDB OSS,InfluxDB API都提供了一种简单的方式来与您的InfluxDB实例进行交互。InfluxDB v2.0 API提供了一种统一的方法来查询、写入数据以及评估InfluxDB实例的健康状况。今天,我们想分享一个Postman项目,帮助您轻松使用API。Postman是一个“用于构建和使用API的平台”。

导入Postman项目和设置

为了使用Postman项目,您需要首先 创建一个Postman账号。接下来,您需要创建一个新的工作区或导入InfluxDB API v2.0 Postman项目到默认工作区,“我的工作区”。今天,我们只需将项目导入到“我的工作区”。

Importing the InfluxDB API v2.0 Postman project through the Postman UI

通过Postman UI导入InfluxDB API v2.0 Postman项目

确保您在适当的工作区中,通过观察右上角的工作区名称。在您的用户名旁边,点击导入以导入InfluxDB API v2.0 Postman项目。复制并粘贴InfluxDB v2.0 API Postman项目的URL,然后点击继续

The InfluxDB API v2.0

InfluxDB API v2.0

现在您可以看到一系列API调用,从基本的请求,如写入和查询InfluxDB,到为个别任务分配标签。为了发送请求,我们首先需要为此项目配置变量。导航到集合名称“InfluxDB_API_2.0”下的变量选项卡。

List of API calls from basic requests

虽然您可以通过API完全管理InfluxDB,但您可能还是希望先使用InfluxDB UI或CLI创建一些基本资源。要开始,您需要创建以下资源及其关联的ID

桶ID可以在InfluxDB UI的“”页面中轻松找到。您也可以在创建桶后使用CLI或API来收集该信息。

The Bucket ID under the Buckets page

组织和组织ID可以在InfluxDB UI的“关于我”页面中轻松找到。

Org and Org ID on the About Me page

最后,您还需要与您的云或OSS账户关联的URL。您可以通过登录InfluxDB UI查看URL,或查看完整的InfluxDB Cloud地区列表来找到URL。对于OSS账户,您的InfluxDB OSS URL默认应该是https://127.0.0.1:8086/

接下来,您需要将收集中的变量替换为您的值。初始值在您与他人共享收集时共享。当前值将覆盖初始值,并用于防止将敏感值与团队的其他成员共享。点击持久化全部以使初始值与当前值匹配。点击重置全部则相反。

InfluxDB_API_2.0 variables

提交请求

添加完您的变量后,您可以点击提交来发送请求。在下面的示例中,我们使用Write Example请求将以下行协议写入请求体中的“mybucket”桶。您可以通过悬停在变量上验证您的变量是否被正确继承。204状态码表示我们的写入操作成功。

Write Example request

关于使用InfluxDB API v2 Postman收集来入门InfluxDB API v2的最终思考

希望这篇InfluxDB技术技巧文章能激发您利用InfluxDB v2 API管理和使用您的InfluxDB实例。如果您正在创建物联网应用程序或出于其他原因使用API,请向我们寻求帮助并分享您的经历!在评论区域、我们的社区网站或我们的Slack频道中分享您的想法、担忧或问题。我们非常乐意收到您的反馈并帮助您解决遇到的问题!