挂载硬盘到挂载点

POST/zstack/v1/host/mount-block-device

Request

cURL

curl --request POST \
  --url '/v1/host/mount-block-device' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "status": "ok",
  "method": "POST",
  "path": "/v1/host/mount-block-device"
}

Headers

Authorization: OAuth the-session-uuid

Body

{
  "params": {
    "username": "username",
    "password": "password",
    "sshPort": 22,
    "hostName": "192.168.1.1",
    "path": "/dev/vdb",
    "mountPoint": "/root/data",
    "filesystemType": "xfs"
  },
  "systemTags": [],
  "userTags": []
}

上述示例中systemTags、userTags字段可以省略。列出是为了表示body中可以包含这两个字段。

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X POST -d '{"params":{"username":"username","password":"password","sshPort":22,"hostName":"192.168.1.1","path":"/dev/vdb","mountPoint":"/root/data","filesystemType":"xfs"}}' \
http://localhost:8080/zstack/v1/host/mount-block-device

参数列表

名字	类型	位置	描述	可选值	起始版本
username	String	body(包含在`params`结构中)	主机名		4.3.0
password (可选)	String	body(包含在`params`结构中)	主机密码		4.3.0
sshPort	Integer	body(包含在`params`结构中)	主机端口		4.3.0
hostName	String	body(包含在`params`结构中)	主机IP		4.3.0
path	String	body(包含在`params`结构中)	硬盘绝对路径(例如：`/dev/vdb`)		4.3.0
mountPoint	String	body(包含在`params`结构中)	挂载点		4.3.0
filesystemType (可选)	String	body(包含在`params`结构中)	文件系统类型	ext4 xfs	4.3.0
systemTags (可选)	List	body	系统标签		4.3.0
userTags (可选)	List	body	用户标签		4.3.0

API返回

该API成功时返回一个空的JSON结构{}，出错时返回的JSON结构包含一个error字段，例如：

{
  "error": {
    "code": "SYS.1001",
    "description": "A message or a operation timeout",
    "details": "Create VM on KVM timeout after 300s"
  }
}

SDK示例

Java SDK

MountBlockDeviceAction action = new MountBlockDeviceAction();
action.username = "username";
action.password = "password";
action.sshPort = 22;
action.hostName = "192.168.1.1";
action.path = "/dev/vdb";
action.mountPoint = "/root/data";
action.filesystemType = "xfs";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
MountBlockDeviceAction.Result res = action.call();

Python SDK

action = MountBlockDeviceAction()
action.username = "username"
action.password = "password"
action.sshPort = 22
action.hostName = "192.168.1.1"
action.path = "/dev/vdb"
action.mountPoint = "/root/data"
action.filesystemType = "xfs"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
res = action.call()