cubefs/docs-zh/source/dev-guide/admin-api/master/datanode.md
zhumingze 4f0935dccb docs(docs): Modify the docs according to v3.5.2
Signed-off-by: zhumingze <zhumingze@oppo.com>
2025-08-11 17:21:20 +08:00

5.4 KiB
Executable File
Raw Permalink Blame History

数据节点管理

新增

curl -v "http://192.168.0.11:17010/dataNode/add?addr=192.168.0.33:17310&zoneName=default"

在对应区域上添加新的数据节点

参数列表

参数 类型 描述
addr string 数据节点和master的交互地址
zoneName string 指定区域如果为空则默认值为default

查询

curl -v "http://10.196.59.198:17010/dataNode/get?addr=10.196.59.201:17310"  | python -m json.tool

显示数据节点的详情,包括数据节点的地址、总的容量、已使用空间等等。

参数列表

参数 类型 描述
addr string 数据节点和master的交互地址

响应示例

{
    "TotalWeight": 39666212700160,
    "UsedWeight": 2438143586304,
    "AvailableSpace": 37228069113856,
    "ID": 2,
    "Zone": "zone1",
    "Addr": "10.196.59.201:17310",
    "ReportTime": "2018-12-06T10:56:38.881784447+08:00",
    "IsActive": true
    "UsageRatio": 0.06146650815226848,
    "SelectTimes": 5,
    "Carry": 1.0655859145960367,
    "DataPartitionReports": {},
    "DataPartitionCount": 21,
    "NodeSetID": 3,
    "PersistenceDataPartitions": {},
    "BadDisks": {}
}

下线节点

curl -v "http://192.168.0.11:17010/dataNode/decommission?addr=192.168.0.33:17310&weight=2"

从集群中下线某个数据节点, 该数据节点上的所有数据分片都会被异步的迁移到集群中其它可用的数据节点

参数列表

参数 类型 描述
addr string 数据节点和master的交互地址
weight int 下线权重默认是2

获取磁盘信息

curl -v "http://192.168.0.11:17320/disks"

获取磁盘信息,包括磁盘路径,空间使用情况,磁盘状态等。

获取节点分区信息

curl -v "http://192.168.0.11:17320/partitions"

获取磁盘信息包括分区ID分区大小和状态等。

磁盘下线

curl -v "http://192.168.0.11:17010/disk/decommission?addr=192.168.0.12:17310&disk=/home/service/var/data1&weight=2"

参数列表

参数 类型 描述
addr string 要下线的磁盘的节点地址
disk string 故障磁盘
count int 每次下线个数默认0代表全部下线
diskDisable bool 是否禁用磁盘即禁止在下线的磁盘上新建dp默认为true
decommissionType int 下线类型默认0,代表手动下线1表示自动下线
weight int 下线权重默认是2

迁移

curl -v "http://10.196.59.198:17010/dataNode/migrate?srcAddr=src&targetAddr=dst&count=3"

从源数据节点迁移指定个数数据分区至目标数据节点。

参数列表

参数 类型 描述
srcAddr string 迁出数据节点地址
targetAddr string 迁入数据节点地址
count int 迁移数据分区的个数非必填默认50个

设置磁盘下线控制速度

curl -v "http://192.168.0.11:17320/admin/updateDecommissionLimit?decommissionLimit=10"

参数列表

参数 类型 描述
decommissionLimit int 并发下线的dp个数

::: tip 提示 v3.2.1新增接口 :::

查询磁盘下线控制速度

curl -v "http://192.168.0.11:17320/admin/queryDecommissionLimit"

::: tip 提示 v3.2.1新增接口 :::

查询磁盘下线进度

curl -v "http://192.168.0.11:17320/disk/queryDecommissionProgress?addr=192.168.0.12:17310&disk=/home/service/var/data1"

参数列表

参数 类型 描述
addr string 下线磁盘的节点地址
disk string 下线磁盘地址

::: tip 提示 v3.2.1新增接口 :::

查询节点下线进度

curl -v "http://192.168.0.11:17010/dataNode/queryDecommissionProgress?addr=192.168.0.33:17310"

参数列表

参数 类型 描述
addr string 数据节点和master的交互地址

::: tip 提示 v3.2.1新增接口 :::

取消磁盘下线

curl -v "http://192.168.0.11:17320/disk/pauseDecommission?addr=192.168.0.12:17310&disk=/home/service/var/data1"

参数列表

参数 类型 描述
addr string 下线磁盘的节点地址
disk string 下线磁盘地址

::: tip 提示 v3.4.0新增接口 :::

取消节点下线

curl -v "http://192.168.0.11:17010/dataNode/cancelDecommission?addr=192.168.0.33:17310"

参数列表

参数 类型 描述
addr string 数据节点地址

::: tip 提示 v3.2.1新增接口 :::

查询所有下线磁盘

curl -v "http://192.168.0.11:17010/disk/queryAllDecommissionDisk"

::: tip 提示 v3.4.0新增接口 :::