创建 Bucket

在 UI 中有两个地方可以创建 bucket。

• 从加载数据菜单创建 bucket
• 在数据浏览器中创建 bucket

从加载数据菜单创建 bucket

1. 在左侧导航菜单中，选择 数据 (加载数据) > Buckets。

   加载数据

2. 单击右上角的 创建 Bucket。

3. 输入 Bucket 的 名称 (参见 Bucket 命名限制)。

4. 选择 删除数据 的时间

   • 永不 永远保留数据。
   • 早于 选择特定的保留期限。

5. 单击 创建 以创建 bucket。

在数据浏览器中创建 bucket

1. 在左侧导航菜单中，选择 浏览 (数据浏览器)。

   数据浏览器

2. 在 Flux 构建器的 From 面板中，选择 + 创建 Bucket。

3. 输入 Bucket 的 名称 (参见 Bucket 命名限制)。

4. 选择 删除数据 的时间

   • 永不 永远保留数据。
   • 早于 选择特定的保留期限。

5. 单击 创建 以创建 bucket。

使用 influx bucket create 命令 来创建一个新的 bucket。

在命令中包含以下标志

• -n, --name: Bucket 名称 (参见 Bucket 命名限制)
• -o, --org 或 --org-id: 组织名称或 ID
• -r, --retention: Bucket 保留期限（数据保留时长），单位为以下之一
  • 纳秒 (ns)
  • 微秒 (us 或 µs)
  • 毫秒 (ms)
  • 秒 (s)
  • 分钟 (m)
  • 小时 (h)
  • 天 (d)
  • 周 (w)

# Syntax
influx bucket create \
  --name <bucket-name> \
  --org <org-name> \
  --retention <retention-period-duration>

# Example
influx bucket create \
  --name my-bucket \
  --org my-org \
  --retention 72h

要使用 InfluxDB HTTP API 创建 bucket，请向以下端点发送请求

POST https://localhost:8086/api/v2/buckets

在你的请求中包含以下内容

• 标头
  • Authorization: Token 方案，带有你的 InfluxDB API 令牌
  • Content-type: application/json
• 请求体: 包含以下字段的 JSON 对象
  * 必需
  • * name: Bucket 名称 (参见 Bucket 命名限制)
  • * orgID: InfluxDB 组织 ID
  • description: Bucket 描述
  • retentionRules: 包含单个对象的 JSON 数组，该对象具有以下字段
    • type: expire
    • everySecond: 数据保留秒数 （0 表示永久）
    • shardGroupDuration: 分片组保留秒数 （0 表示永久）

示例

URL 取决于你的 InfluxDB 2.7 实例的版本和位置 (参见 InfluxDB URL)。

INFLUX_TOKEN=YOUR_API_TOKEN
INFLUX_ORG_ID=YOUR_ORG_ID

curl --request POST \
  "http://localhost:8086/api/v2/buckets" \
  --header "Authorization: Token ${INFLUX_TOKEN}" \
  --header "Content-type: application/json" \
  --data '{
    "orgID": "'"${INFLUX_ORG_ID}"'",
    "name": "iot-center",
    "retentionRules": [
      {
        "type": "expire",
        "everySeconds": 86400,
        "shardGroupDurationSeconds": 0
      }
    ]
  }'

有关 InfluxDB API 选项和响应代码 的信息，请参阅 InfluxDB API Buckets 文档。