首页/数据/NoSQL 速查//api/v2/write 写入接口

/api/v2/write 写入接口

InfluxDB 2.x 用 HTTP 接口写数据:POST /api/v2/write 带 org、bucket 与 precision 参数,Authorization 用 Token;成功返回 204,无返回体。

NoSQL 速查数据更新于 2026-10-12
接口POST /api/v2/write?org=<org>&bucket=<bucket>&precision=ns
请求头Authorization: Token <token>、Content-Type: text/plain; charset=utf-8、Content-Encoding: gzip
返回码204 成功;400 行协议错误;401 鉴权失败;404 bucket 不存在

示例

示例
curl -i -XPOST "http://127.0.0.1:8086/api/v2/write?org=my-org&bucket=my-bucket&precision=s" \
  -H "Authorization: Token $INFLUX_TOKEN" \
  --data-binary 'cpu,host=web-1 usage=0.73 1719792000'

# 批量文件写入(先 gzip 再上传)
gzip -c data.lp | curl -XPOST "http://127.0.0.1:8086/api/v2/write?org=my-org&bucket=my-bucket&precision=ns" \
  -H "Authorization: Token $INFLUX_TOKEN" -H "Content-Encoding: gzip" --data-binary @-
官方客户端与 telegraf 内部都走这个接口;自研采集器直接用 HTTP 时注意复用连接与开启压缩。

易错点

  • precision 与时间戳单位必须匹配,错配会让数据落到完全错误的年份
  • 400 响应体会指出具体行号与错误原因,采集器应记录原文便于修正

数据来源与参考

  • InfluxData Docs: /api/v2/write
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌