跳转到主要内容
计算管理/主机相关接口
POSTHost Related Interfaces起始版本 4.3.12同步需要认证

查询主机的NUMA拓扑信息

查询主机的NUMA拓扑信息

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

路径参数

请求参数

路径参数

  • uuidString必填

    主机UUID

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • errorErrorCode必填

    错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error

    • codeString必填

      错误码号,错误的全局唯一标识,例如SYS.1000, HOST.1001

    • descriptionString必填

      错误的概要描述

    • detailsString必填

      错误的详细信息

    • elaborationString必填

      保留字段,默认为null

    • opaqueLinkedHashMap必填

      保留字段,默认为null

    • causeErrorCode必填

      根错误,引发当前错误的源错误,若无原错误,该字段为null

  • nameString必填

    资源名称

  • uuidString必填

    资源的UUID,唯一标示该资源

  • topologyString必填

    NUMA拓扑信息,详情见topology

    • cpusarray[string]必填

      NUMA node包含的CPUs id列表

    • sizelong必填

      NUMA node总内存大小(单位为B)

    • distancearray[string]必填

      该NUMA node与其他node的距离

    • VMsUuidarray[string]必填

      该NUMA node关联VM的Uuid

    • freelong必填

      NUMA node可用内存大小(单位为B)

请求地址

POST/zstack/v1/hosts/{uuid}/numa

/zstack/v1/hosts/{uuid}/numa

操作 ID

GetHostNUMATopology

永久链接

请求示例

curl -X POST 'http://{host}/zstack/v1/hosts/{uuid}/numa' -H 'Authorization: OAuth {sessionUuid}'

响应示例

200
{ "topology": { "0": { "distance": ["10", "10", "21", "21"], "cpus": ["0", "1", "2", "3", "4", "5", "6", "7"], "VMsUuid": ["f7bae73b9874344b8766dfcdda48ad6e", "f7bae73b9874344b8766dfcdda48ad6e"], "free": 5688.0, "size": 8191.0 }, "1": { "distance": ["10", "10", "21", "21"], "cpus": ["16", "17", "18", "19", "20", "21", "22", "23"], "VMsUuid": ["f7bae73b9874344b8766dfcdda48ad6e", "f7bae73b9874344b8766dfcdda48ad6e"], "free": 5688.0, "size": 8191.0 }, "2": { "distance": ["21", "21", "10", "10"], "cpus": ["8", "9", "10", "11", "12", "13", "14", "15"], "VMsUuid": ["f7bae73b9874344b8766dfcdda48ad6e", "f7bae73b9874344b8766dfcdda48ad6e"], "free": 5688.0, "size": 8191.0 }, "3": { "distance": ["21", "21", "10", "10"], "cpus": ["24", "25", "26", "27", "28", "29", "30", "31"], "VMsUuid": ["f7bae73b9874344b8766dfcdda48ad6e", "f7bae73b9874344b8766dfcdda48ad6e"], "free": 5688.0, "size": 8191.0 } }, "name": "172.20.14.243", "uuid": "7fd86bbe6ca94a8d810aa1d33e29932c" }

变更历史

此 API 暂无变更历史记录。

查看全部变更历史