设置 InfluxDB

1 / 5

在您开始本教程时，请做以下几点，以确保您所需的一切都已就位。

(可选) 下载、安装和配置 influx CLI。
influx 命令行工具提供了一种简单的方法来从命令行与 InfluxDB 进行交互。有关详细的安装和设置说明，请参见使用 influx CLI。

创建一个全访问API令牌。

使用 InfluxDB UI、influx CLI 或 InfluxDB API 创建一个全访问令牌。

InfluxDB 用户界面 influx 命令行工具 InfluxDB API

Visit cloud2.influxdata.com in a browser to log in and access the InfluxDB UI.
Navigate to Load Data > API Tokens using the left navigation bar.
Click + Generate API token and select All Access API Token.
Enter a description for the API token and click Save.
Copy the generated token and store it for safe keeping.

如果您还没有，请下载、安装并配置 influx CLI。
使用influx auth create命令创建一个全访问令牌。
提供以下内容:
- --all-access 标志
- --host 标志与您的 InfluxDB 区域 URL
- -o, --org 或 --org-id 标志与您的 InfluxDB 组织名称或 ID
- -t, --token 标志与您的操作员令牌
```
influx auth create \
  --all-access \
  --host http://cloud2.influxdata.com \
  --org <YOUR_INFLUXDB_ORG_NAME> \
  --token <YOUR_INFLUXDB_OPERATOR_TOKEN>
```
复制生成的令牌并将其安全存储。

使用 POST 请求方法向 InfluxDB API /api/v2/authorizations 端点发送请求。

POST http://cloud2.influxdata.com/api/v2/authorizations

请在您的请求中包含以下内容：

请求头:
- 授权: 令牌 <INFLUX_OPERATOR_TOKEN>
- 内容类型: application/json
请求体: JSON主体具有以下属性:
- 状态: "active"
- 描述: API令牌描述
- orgID: InfluxDB组织ID
- 权限: 对象数组，每个对象表示对InfluxDB资源类型或特定资源的权限。每个权限包含以下属性:
  - 操作: “read”或“write”
  - 资源: JSON对象，表示要授予权限的InfluxDB资源。每个资源至少包含以下属性:
    - orgID: InfluxDB组织ID
    - 类型: 资源类型。 有关InfluxDB资源类型的相关信息，请使用 /api/v2/resources端点.

以下示例使用cURL和InfluxDB API生成一个全访问令牌：

export INFLUX_HOST=http://cloud2.influxdata.com
export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID>
export INFLUX_TOKEN=<YOUR_INFLUXDB_OPERATOR_TOKEN>

curl --request POST \
"$INFLUX_HOST/api/v2/authorizations" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --header "Content-Type: text/plain; charset=utf-8" \
  --data '{
    "status": "active",
    "description": "All access token for get started tutorial",
    "orgID": "'"$INFLUX_ORG_ID"'",
    "permissions": [
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}}
    ]
  }
'

响应体包含一个具有以下属性的JSON对象：

id: API令牌ID
令牌: API 令牌 (重要)
status: 令牌状态
描述: 令牌描述
orgID: 与该令牌关联的InfluxDB组织ID
org: 与令牌相关联的InfluxDB组织名称
userID: 与该令牌关联的用户 ID
user: 与该令牌关联的用户名
permissions: 组织资源的权限列表

复制生成的 token 并安全存储。

我们建议使用密码管理器或秘密存储库来安全地存储敏感令牌。

配置认证凭据.
在您进行此教程时，与 InfluxDB Cloud 的交互需要您的 InfluxDB 主机、组织名称或 ID 和您的 API 令牌。根据您使用的客户端与 InfluxDB 交互，有不同的方法来提供这些凭据。
配置您的令牌时，请使用您创建的 All-Access token。
InfluxDB 用户界面 influx 命令行工具 InfluxDB API
在通过InfluxDB UI 管理 InfluxDB 时，身份验证凭据会自动提供，这些凭据与您登录的用户相关联。
有三种方式可以向 influx CLI 提供身份验证凭据：
CLI 连接配置 (推荐)
该 influx 命令行界面允许您指定连接配置预设，便于您存储并快速切换多个 InfluxDB 连接凭据。使用 influx config create 命令创建一个新的 CLI 连接配置。包含以下标志：
-n, --config-name: 连接配置名称。这个示例使用 get-started.
-u, --host-url: InfluxDB区域URL.
-o, --org: InfluxDB 组织名称。
-t, --token: InfluxDB API 令牌。
influx config create \ --config-name get-started \ --host-url http://cloud2.influxdata.com \ --org <YOUR_INFLUXDB_ORG_NAME> \ --token <YOUR_INFLUXDB_API_TOKEN>
有关CLI连接配置的更多信息，请参阅安装和使用 influx CLI.
环境变量
该 influx CLI 检查特定的环境变量，如果存在，使用这些环境变量填充身份验证凭据。在您的命令行会话中设置以下环境变量：
INFLUX_HOST: InfluxDB 区域 URL.
INFLUX_ORG: InfluxDB 组织名称。
INFLUX_ORG_ID: InfluxDB 组织 ID.
INFLUX_TOKEN: InfluxDB API 令牌。
export INFLUX_HOST=http://cloud2.influxdata.com export INFLUX_ORG=<YOUR_INFLUXDB_ORG_NAME> export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID> export INFLUX_TOKEN=<YOUR_INFLUXDB_API_TOKEN>
命令标志
使用以下 influx CLI 标志为命令提供所需的凭证：
--host: InfluxDB 区域 URL.
-o、--org 或 --org-id：InfluxDB 组织名称或 ID。
-t, --token: InfluxDB API 令牌。
本快速入门教程中的所有 influx CLI 示例假设您的 InfluxDB 主机、组织和令牌是通过活动 influx CLI 配置或环境变量提供的。
使用InfluxDB API时，请以以下方式提供所需的连接凭据：
- InfluxDB主机: 您的 InfluxDB Cloud 区域 URL.
- InfluxDB API 令牌: 包含一个 Authorization 头，该头使用 Bearer 或 Token 方案和您的 InfluxDB API 令牌。例如：
  Authorization: Bearer 0xxx0o0XxXxx00Xxxx000xXXxoo0==.
- InfluxDB 组织名称或 ID: 根据使用的 API 端点，将其作为 URL 路径、查询字符串或请求体的一部分传递。
本教程中的所有API示例均使用cURL从命令行执行。要为示例cURL命令提供所有必要的凭据，请在命令行会话中设置以下环境变量。
```
export INFLUX_HOST=http://cloud2.influxdata.com
export INFLUX_ORG=<YOUR_INFLUXDB_ORG_NAME>
export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID>
export INFLUX_TOKEN=<YOUR_INFLUXDB_API_TOKEN>
```
创建一个桶。
使用InfluxDB UI、influx CLI或InfluxDB API创建一个新桶。
InfluxDB 用户界面 influx 命令行工具 InfluxDB API
1. Visit cloud2.influxdata.com in a browser to log in and access the InfluxDB UI.
2. Navigate to Load Data > Buckets using the left navigation bar.
3. Click + Create bucket.
4. Provide a bucket name (get-started) and select Never to create a bucket with an infinite retention period.
5. Click Create.
1. 如果您还没有，请下载、安装并配置 influx CLI。
2. 使用influx bucket create命令创建一个新存储桶。
  提供以下内容:
  - -n, --name 标志与桶的名称。
  - 连接和认证凭据
  influx bucket create --name get-started
要使用InfluxDB HTTP API创建一个桶，请使用POST请求方法向InfluxDB API /api/v2/buckets端点发送请求。
```
POST http://cloud2.influxdata.com/api/v2/buckets
```
请在您的请求中包含以下内容：
- Headers:
  - Authorization: Token INFLUX_TOKEN
  - Content-Type: application/json
- 请求正文: JSON 对象，具有以下属性:
  - org: InfluxDB 组织名称
  - name: 桶名称
  - retentionRules: 定义桶的保留期限的保留规则对象列表。每个保留规则对象具有以下属性:
    type: "expire"
    everySeconds: 保留期持续时间，以秒为单位。 0 表示保留期是无限的。
```
export INFLUX_HOST=http://cloud2.influxdata.com
export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID>
export INFLUX_TOKEN=<YOUR_INFLUXDB_API_TOKEN>

curl --request POST \
"$INFLUX_HOST/api/v2/buckets" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "orgID": "'"$INFLUX_ORG_ID"'",
    "name": "get-started",
    "retentionRules": [
      {
        "type": "expire",
        "everySeconds": 0
      }
    ]
  }'
```

Get started Write data

设置 InfluxDB

Flux的未来

InfluxDB 3 开源版本现已公开Alpha测试

设置 InfluxDB

相关

选择您的 InfluxDB Cloud 区域

AWS

谷歌云平台

微软 Azure

感谢您的反馈!

Flux的未来

InfluxDB 3 开源版本现已公开Alpha测试

由TSM驱动的InfluxDB Cloud