/write 1.x 兼容性 API
/write 1.x 兼容性端点使用 InfluxDB 1.x /write API 端点的模式将数据写入 InfluxDB Cloud 和 InfluxDB OSS 2.7。使用 POST 请求方法将 行协议 写入 /write 端点。
POST http://localhost:8086/write
身份验证
使用以下身份验证方法之一
- 令牌身份验证
- 使用用户名和密码的基本身份验证
- 使用用户名和密码的查询字符串身份验证
有关更多信息，请参阅 身份验证。
请求体
在请求体中包含您的行协议。二进制编码行协议以防止意外格式化。下面的示例使用 curl --data-binary 标志对行协议进行二进制编码。
查询字符串参数
u
（可选）用于验证请求的 1.x 用户名。请参阅查询字符串身份验证。
p
（可选）用于验证请求的 1.x 密码。请参阅查询字符串身份验证。
db
（必需）要将数据写入的数据库。这映射到 InfluxDB 存储桶。请参阅数据库和保留策略映射。
rp
要将数据写入的保留策略。这映射到 InfluxDB 存储桶。请参阅数据库和保留策略映射。
precision
行协议中Unix 时间戳的精度。默认值为纳秒 (ns)。以下精度可用
ns- 纳秒u或µ- 微秒ms- 毫秒s- 秒m- 分钟h- 小时
写入示例
使用基本身份验证写入数据
curl --request POST http://localhost:8086/write?db=DATABASE_NAME \
--user "USERNAME:PASSWORD_OR_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
使用令牌身份验证写入数据
curl --request POST http://localhost:8086/write?db=DATABASE_NAME \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
将数据写入非默认保留策略
curl --request POST "http://localhost:8086/write?db=DATABASE_NAME&rp=RETENTION_POLICY" \
--header "Authorization: Token API_TOKEN" \
--data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"
写入多行行协议
curl --request POST http://localhost: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 "http://localhost: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 http://localhost: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 支持。