/write 1.x 兼容性 API
/write 1.x 兼容性端点使用来自 InfluxDB 1.x /write API 端点的模式将数据写入 InfluxDB Cloud 和 InfluxDB OSS 2.7。使用 POST 请求方法将 line protocol 写入 /write 端点。
POST https://127.0.0.1:8086/write
身份验证
请求正文
在请求正文中包含您的 line protocol。二进制编码 line protocol 以防止意外格式化。以下 示例 使用 curl --data-binary 标志来二进制编码 line protocol。
查询字符串参数
db
（必需）要将数据写入的数据库。这映射到一个 InfluxDB 存储桶。请参阅 数据库和保留策略映射。
rp
要将数据写入的保留策略。这映射到一个 InfluxDB 存储桶。请参阅 数据库和保留策略映射。
precision
Unix 时间戳 在 line protocol 中的精度。默认值为纳秒 (ns)。以下精度可用
ns- 纳秒u或µ- 微秒ms- 毫秒s- 秒m- 分钟h- 小时
写入示例
使用基本身份验证写入数据
curl --request POST https://127.0.0.1:8086/write?db=DATABASE_NAME \
--user "USERNAME:PASSWORD_OR_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
使用令牌身份验证写入数据
curl --request POST https://127.0.0.1:8086/write?db=DATABASE_NAME \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
将数据写入非默认保留策略
curl --request POST "https://127.0.0.1:8086/write?db=DATABASE_NAME&rp=RETENTION_POLICY" \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
写入多行 line protocol
curl --request POST https://127.0.0.1:8086/write?db=DATABASE_NAME \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000
measurement,host=host2 field1=14i,field2=12.7 1577836800000000000
measurement,host=host3 field1=5i,field2=6.8 1577836800000000000"
使用毫秒 Unix 时间戳写入数据
curl --request POST "https://127.0.0.1:8086/write?db=DATABASE_NAME&precision=ms" \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000"
使用 curl 从文件写入数据
curl --request POST https://127.0.0.1:8086/write?db=DATABASE_NAME \
--header "Authorization: Token API_TOKEN" \
--data-binary @path/to/line-protocol.txt
替换以下内容
DATABASE_NAME和RETENTION_POLICY：您要写入的 InfluxDB v2 存储桶的 数据库和保留策略映射 (DBRP)USERNAME：您的 InfluxDB 1.x 用户名PASSWORD_OR_TOKEN：您的 InfluxDB 1.x 密码或 InfluxDB API 令牌API_TOKEN：您的 InfluxDB API 令牌
此页是否对您有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一份子！我们欢迎并鼓励您提供关于 InfluxDB 和此文档的反馈和错误报告。要获得支持，请使用以下资源
拥有年度或支持合同的客户 可以 联系 InfluxData 支持。