裸金属云硬盘Targets

裸金属云硬盘Targets列表

功能介绍

获取裸金属云硬盘Targets列表

URI

GET /v1/volume/targets

请求消息

参数	参数类型	是否必选	描述
node	string	否	按裸金属节点过滤
fields	array	否	按指定字段过滤
detail	boolean	否	是否显示详细信息
limit	integer	否	分页大小
marker	string	否	每页最后一条数据的ID
sort_dir	string	否	排序方向，升序或降序，默认升序
sort_key	string	否	排序键值

响应消息

参数	参数类型	描述
targets	array	云硬盘Target信息列表
uuid	string	云硬盘Target UUID
volume_type	string	云硬盘Target类型
properties	object	云硬盘硬件信息
boot_index	string	云硬盘Target启动序号
volume_id	string	云硬盘UUID
extra	object	云硬盘Target元数据信息
node_uuid	string	云硬盘Target所属裸金属节点UUID
links	array	链接信息
next	string	请求下一组云硬盘Target的URL，当使用limit请求参数时返回

请求示例

无

正常响应示例

{
  "targets": [
    {
      "boot_index": 0,
      "created_at": "2016-08-18T22:28:48.643434+11:11",
      "extra": {},
      "links": [
        {
          "href": "http://127.0.0.1:6385/v1/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
          "rel": "self"
        },
        {
          "href": "http://127.0.0.1:6385/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
          "rel": "bookmark"
        }
      ],
      "node_uuid": "6d85703a-565d-469a-96ce-30b6de53079d",
      "properties": {},
      "updated_at": null,
      "uuid": "bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "volume_id": "04452bed-5367-4202-8bf5-de4335ac56d2",
      "volume_type": "iscsi"
    }
  ]
}

正常响应代码

200

错误码

无

创建裸金属云硬盘Target

功能介绍

创建裸金属云硬盘Target

URI

POST /v1/volume/targets

请求消息

参数	参数类型	是否必选	描述
node_uuid	string	是	裸金属节点UUID
volume_type	string	是	云硬盘Target类型
properties	object	否	云硬盘硬件信息
boot_index	string	是	云硬盘Target启动序号
volume_id	string	是	云硬盘UUID
extra	object	否	云硬盘Target元数据信息
uuid	string	否	云硬盘Target UUID

响应消息

参数	参数类型	描述
uuid	string	云硬盘Target UUID
volume_type	string	云硬盘Target类型
properties	object	云硬盘硬件信息
boot_index	string	云硬盘Target启动序号
volume_id	string	云硬盘UUID
extra	object	云硬盘Target元数据信息
node_uuid	string	云硬盘Target所属裸金属节点UUID
links	array	链接信息

请求示例

{
    "node_uuid": "6d85703a-565d-469a-96ce-30b6de53079d",
    "volume_type": "iscsi",
    "boot_index": 0,
    "volume_id": "04452bed-5367-4202-8bf5-de4335ac56d2"
}

正常响应示例

{
  "boot_index": 0,
  "created_at": "2016-08-18T22:28:48.643434+11:11",
  "extra": {},
  "links": [
    {
      "href": "http://127.0.0.1:6385/v1/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "rel": "self"
    },
    {
      "href": "http://127.0.0.1:6385/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "rel": "bookmark"
    }
  ],
  "node_uuid": "6d85703a-565d-469a-96ce-30b6de53079d",
  "properties": {},
  "updated_at": null,
  "uuid": "bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
  "volume_id": "04452bed-5367-4202-8bf5-de4335ac56d2",
  "volume_type": "iscsi"
}

正常响应代码

201

错误码

无

裸金属云硬盘Target详情

功能介绍

获取裸金属云硬盘Target详情信息

URI

GET /v1/volume/targets/{volume_target_id}

请求消息

参数	参数类型	是否必选	描述
volume_target_id	string	否	裸金属云硬盘Target UUID
fields	array	否	按指定字段过滤

响应消息

参数	参数类型	描述
uuid	string	云硬盘Target UUID
volume_type	string	云硬盘Target类型
properties	object	云硬盘硬件信息
boot_index	string	云硬盘Target启动序号
volume_id	string	云硬盘UUID
extra	object	云硬盘Target元数据信息
node_uuid	string	云硬盘Target所属裸金属节点UUID
links	array	链接信息

请求示例

无

正常响应示例

{
  "boot_index": 0,
  "created_at": "2016-08-18T22:28:48.643434+11:11",
  "extra": {},
  "links": [
    {
      "href": "http://127.0.0.1:6385/v1/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "rel": "self"
    },
    {
      "href": "http://127.0.0.1:6385/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "rel": "bookmark"
    }
  ],
  "node_uuid": "6d85703a-565d-469a-96ce-30b6de53079d",
  "properties": {},
  "updated_at": null,
  "uuid": "bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
  "volume_id": "04452bed-5367-4202-8bf5-de4335ac56d2",
  "volume_type": "iscsi"
}

正常响应代码

200

错误码

无

更新裸金属云硬盘Target

功能介绍

更新裸金属云硬盘Target信息

URI

PATCH /v1/volume/targets/{volume_target_id}

请求消息

参数	参数类型	是否必选	描述
volume_target_id	string	是	裸金属云硬盘Target UUID

响应消息

参数	参数类型	描述
uuid	string	云硬盘Target UUID
volume_type	string	云硬盘Target类型
properties	object	云硬盘硬件信息
boot_index	string	云硬盘Target启动序号
volume_id	string	云硬盘UUID
extra	object	云硬盘Target元数据信息
node_uuid	string	云硬盘Target所属裸金属节点UUID
links	array	链接信息

请求示例

[
   {
      "path" : "/volume_id",
      "value" : "7211f7d3-3f32-4efc-b64e-9b8e92e64a8e",
      "op" : "replace"
   }
]

正常响应示例

{
  "boot_index": 0,
  "created_at": "2016-08-18T22:28:48.643434+11:11",
  "extra": {},
  "links": [
    {
      "href": "http://127.0.0.1:6385/v1/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "rel": "self"
    },
    {
      "href": "http://127.0.0.1:6385/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "rel": "bookmark"
    }
  ],
  "node_uuid": "6d85703a-565d-469a-96ce-30b6de53079d",
  "properties": {},
  "updated_at": "2016-08-18T22:28:49.653974+00:00",
  "uuid": "bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
  "volume_id": "7211f7d3-3f32-4efc-b64e-9b8e92e64a8e",
  "volume_type": "iscsi"
}

正常响应代码

200

错误码

无

删除裸金属云硬盘Target

功能介绍

删除裸金属云硬盘Target

请求消息

参数	参数类型	是否必选	描述
volume_target_id	string	是	裸金属云硬盘Target UUID

响应消息

无

请求示例

无

正常响应示例

无

正常响应代码

204

错误码

无

裸金属节点的云硬盘Target列表

功能介绍

获取裸金属节点的云硬盘Target列表

URI

GET /v1/nodes/{node_ident}/volume/targets

请求消息

参数	参数类型	是否必选	描述
node_ident	string	是	裸金属节点UUID或名称
fields	array	否	按指定字段过滤
limit	integer	否	分页大小
marker	string	否	每页最后一条数据的ID
sort_dir	string	否	排序方向，升序或降序，默认升序
sort_key	string	否	排序键值

响应消息

参数	参数类型	描述
targets	array	云硬盘Target信息列表
uuid	string	云硬盘Target UUID
volume_type	string	云硬盘Target类型
properties	object	云硬盘硬件信息
boot_index	string	云硬盘Target启动序号
volume_id	string	云硬盘UUID
extra	object	云硬盘Target元数据信息
node_uuid	string	云硬盘Target所属裸金属节点UUID
links	array	链接信息
next	string	请求下一组云硬盘Target的URL，当使用limit请求参数时返回

请求示例

无

正常响应示例

{
  "targets": [
    {
      "boot_index": 0,
      "links": [
        {
          "href": "http://127.0.0.1:6385/v1/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
          "rel": "self"
        },
        {
          "href": "http://127.0.0.1:6385/volume/targets/bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
          "rel": "bookmark"
        }
      ],
      "node_uuid": "6d85703a-565d-469a-96ce-30b6de53079d",
      "uuid": "bd4d008c-7d31-463d-abf9-6c23d9d55f7f",
      "volume_id": "7211f7d3-3f32-4efc-b64e-9b8e92e64a8e",
      "volume_type": "iscsi"
    }
  ]
}

正常响应代码

200

错误码

无