InfluxDB v2 OSS 文档 提交 API 问题

InfluxDB v1 HTTP API,用于 InfluxDB v2 OSS

v1 兼容性 HTTP API 提供了使用 InfluxDB v1 端点在 InfluxDB v2 bucket 中写入和查询数据的兼容性。InfluxDB 1.x 兼容性 /write/query 端点可与 InfluxDB 1.x 客户端库和 Grafana 等第三方集成一起使用。

本文档从 InfluxDB OpenAPI 规范生成。

身份验证

InfluxDB 1.x API 要求对所有请求进行身份验证。InfluxDB Cloud 使用 InfluxDB API 令牌来验证请求。

有关更多信息,请参阅以下内容

令牌身份验证

使用令牌身份验证方案向 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=

查询

使用 InfluxDB v1 HTTP API 进行查询

查询参数
db
必需
string

要查询的 Bucket。

p
string

用户令牌。

q
string

定义要运行的 influxql 查询。

rp
string

保留策略名称。

u
string

用户名。

标头参数
Accept
string
默认值: application/json
枚举: "application/json" "application/csv" "text/csv" "application/x-msgpack"

指定应如何在响应中编码查询结果。注意: 使用 application/csv,查询结果包含 epoch 时间戳而不是 RFC3339 时间戳。

Accept-Encoding
string
默认值: identity
枚举: "gzip" "identity"

Accept-Encoding 请求 HTTP 标头声明客户端能够理解的内容编码,通常是一种压缩算法。

Content-Type
string
值: "application/vnd.influxql"
Zap-Trace-Span
string
示例: trace_id,1,span_id,1,baggage,[object Object]

OpenTracing span 上下文

请求正文模式:text/plain

要执行的 InfluxQL 查询。

string

响应

响应示例

内容类型
没有示例

写入

以 V1 兼容格式将时间序列数据写入 InfluxDB

查询参数
db
必需
string

要写入的 Bucket。如果不存在,InfluxDB 将创建一个具有默认 3 天保留策略的 bucket。

p
string

用户令牌。

precision
string

写入精度。

rp
string

保留策略名称。

u
string

用户名。

标头参数
Content-Encoding
string
默认值: identity
枚举: "gzip" "identity"

如果存在,则其值向数据库指示压缩已应用于行协议正文。

Zap-Trace-Span
string
示例: trace_id,1,span_id,1,baggage,[object Object]

OpenTracing span 上下文

请求正文模式:text/plain

行协议正文

string

响应

响应示例

内容类型
application/json
{
  • "code": "internal error",
  • "message": "string",
  • "op": "string",
  • "err": "string",
  • "line": 0
}