InfluxDB v1 HTTP API 为在 InfluxDB 3 集群数据库中写入和查询数据提供 v1 兼容性。
InfluxDB 1.x 的 /write
和 /query
端点可与 InfluxDB 1.x 客户端库和第三方集成(如 Grafana 等)一起使用。
本文档从 InfluxDB OpenAPI 规范 生成。
使用 令牌身份验证 方案向 InfluxDB API 进行身份验证。
在您的 API 请求中,发送 Authorization
标头。对于标头值,请提供单词 Token
,后跟一个空格和 InfluxDB API 令牌。单词 Token
区分大小写。
Authorization: Token YOUR_INFLUX_TOKEN
有关示例和更多信息,请参阅以下内容
安全方案类型 | API 密钥 |
---|---|
标头参数名称 | Authorization |
对于支持用户名和密码的 InfluxDB 1.x 约定(不支持 Authorization: Token
方案)的客户端,请使用 HTTP 基本身份验证 方案
有关示例和更多信息,请参阅如何使用用户名和密码进行身份验证。
安全方案类型 | HTTP |
---|---|
HTTP 授权方案 | basic |
将 查询字符串身份验证 方案与 InfluxDB 1.x API 参数一起使用,以通过查询字符串提供凭据。
有关示例和更多信息,请参阅如何使用用户名和密码进行身份验证。
安全方案类型 | API 密钥 |
---|---|
查询参数名称 | u=&p= |
db 必需 | 字符串 要查询的存储桶。 |
p | 字符串 用户令牌。 |
q | 字符串 定义要运行的 influxql 查询。 |
rp | 字符串 保留策略名称。 |
u | 字符串 用户名。 |
Accept | 字符串 默认值: application/json 枚举: "application/json" "application/csv" "text/csv" "application/x-msgpack" 指定应如何在响应中编码查询结果。 注意: 对于 |
Accept-Encoding | 字符串 默认值: identity 枚举: "gzip" "identity" Accept-Encoding 请求 HTTP 标头声明客户端能够理解的内容编码,通常是压缩算法。 |
Content-Type | 字符串 值: "application/vnd.influxql" |
Zap-Trace-Span | 字符串 示例: trace_id,1,span_id,1,baggage,[object Object] OpenTracing span 上下文 |
要执行的 InfluxQL 查询。
db 必需 | 字符串 要写入的存储桶。如果不存在,InfluxDB 将创建一个具有默认 3 天保留策略的存储桶。 |
p | 字符串 用户令牌。 |
precision | 字符串 写入精度。 |
rp | 字符串 保留策略名称。 |
u | 字符串 用户名。 |
Content-Encoding | 字符串 默认值: identity 枚举: "gzip" "identity" 如果存在,则其值向数据库指示压缩已应用于行协议正文。 |
Zap-Trace-Span | 字符串 示例: trace_id,1,span_id,1,baggage,[object Object] OpenTracing span 上下文 |
行协议正文
{- "code": "internal error",
- "message": "string",
- "op": "string",
- "err": "string",
- "line": 0
}