InfluxDB 3 集群版 文档 提交 API 问题

InfluxDB 3 集群版 的 InfluxDB v1 HTTP API

许可证: MIT

InfluxDB v1 HTTP API 为在 InfluxDB 3 集群数据库中写入和查询数据提供 v1 兼容性。

InfluxDB 1.x 的 /write/query 端点可与 InfluxDB 1.x 客户端库和第三方集成(如 Grafana 等)一起使用。

本文档从 InfluxDB OpenAPI 规范 生成。

InfluxDB 3 集群版 的 InfluxDB /api/v2 API

身份验证

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
必需
字符串

要查询的存储桶。

p
字符串

用户令牌。

q
字符串

定义要运行的 influxql 查询。

rp
字符串

保留策略名称。

u
字符串

用户名。

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

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

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 上下文

请求正文架构: text/plain

要执行的 InfluxQL 查询。

字符串

响应

响应示例

内容类型
无示例

写入

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

查询参数
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 上下文

请求正文架构: text/plain

行协议正文

字符串

响应

响应示例

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