# 查询资源池单个节点详情 - ShowPoolNode #### 功能介绍 查询资源池中的单个节点接口用于获取指定资源池内单个节点的详细信息。该接口适用于以下场景：当用户需要了解节点资源分配、详细信息时，可通过此接口获取节点的类型、状态、配置参数及关联服务等信息。使用该接口的前提条件是目标资源池已存在且用户具备查看权限，同时需提供有效的资源池标识符作为输入参数。接口调用后，系统将返回资源池中单个节点数据；若资源池不存在、用户权限不足或输入参数无效，接口将返回对应的错误信息（如404未找到资源池或403权限拒绝）。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ShowPoolNode)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v2/{project_id}/pools/{pool_name}/nodes/{node_name} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** ：用户项目ID，获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：1 - 64字符，字母、数字和中划线。 **取值范围**：不涉及。 **默认取值**：不涉及。 | | pool_name | 是 | String | **参数解释**：资源池的ID，取值自资源池详情的metadata.name字段。 **约束限制**：只能以小写字母开头，数字、中划线组成，不能以中划线结尾，且长度为36-63个字符。 **取值范围**：不涉及。 **默认取值**：不涉及。 | | node_name | 是 | String | **参数解释**：节点名称。取值节点详情的metadata.name字段。 **约束限制** ：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | apiVersion | String | **参数解释**：资源的API版本。 **取值范围**：可选值如下： - v2：当前资源版本为v2。 | | kind | String | **参数解释**：资源的类型。 **取值范围**：可选值如下： - Node：节点。 | | metadata | [NodeMetadata] object | **参数解释**：节点资源的元信息。 | | spec | [NodeSpec] object | **参数解释**：节点资源的规格信息。 | | status | [NodeStatus] object | **参数解释**：节点资源的状态信息。 | 表3NodeMetadata | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**：节点名称。 **取值范围**：不涉及。 | | creationTimestamp | String | **参数解释**：创建时间。 **取值范围**：不涉及。 | | labels | [NodeLabels] object | **参数解释**：节点上的标签信息。 | | annotations | [NodeVOAnnotations] object | **参数解释**：节点annotations信息。 | 表4NodeLabels | 参数 | 参数类型 | 描述 | |:---|:---|:---| | os.modelarts.node/cluster | String | **参数解释**：节点所在的集群名称。 **取值范围**：不涉及。 | | os.modelarts.node/elastic.quota | String | **参数解释**：节点绑定的逻辑池。 **取值范围**：不涉及。 | | os.modelarts.node/nodepool | String | **参数解释**：节点所在的节点池id。 **取值范围**：不涉及。 | | os.modelarts.node/batch.uid | String | **参数解释**：批量创建批次标识。 **取值范围**：不涉及。 | | os.modelarts.node/batch.name | String | **参数解释**：批量创建批次名称。 **取值范围**：不涉及。 | | os.modelarts.node/batch.type | String | **参数解释**：批量创建批次类型。 **取值范围**：可选值如下： - hyperinstance：超节点。 | | os.modelarts.node/batch.count | String | **参数解释**：批量创建的节点个数。 **取值范围**：不涉及。 | | os.modelarts.node/spod.id | String | **参数解释**：HPS超节点ID。该值相同的节点，A5代表在同一框内，A3代表在同一个超节点内。 **取值范围**：不涉及。 | | os.modelarts/resource.id | String | **参数解释**：节点的资源id。 **取值范围**：不涉及。 | | os.modelarts/tenant.domain.id | String | **参数解释**：节点的租户id，记录节点创建在哪个租户账号下。 **取值范围**：不涉及。 | | os.modelarts/tenant.project.id | String | **参数解释**：节点的项目id，记录节点创建在租户账号下哪个项目中。 **取值范围**：不涉及。 | | os.modelarts/billing.status | String | **参数解释**：节点计费状态。 **取值范围**：可选值如下： - 0：正常状态。 - 1：冻结状态。 - 2：删除状态或者终止状态。 | | os.modelarts.node/volcano.scheduler.cabinet-exclusive | String | **参数解释**：标识该节点是否被整柜作业独占。当被某个整柜作业独占时，该标签存在，标签的值为独占的训练作业ID。 **取值范围**：不涉及。 | | cce.kubectl.kubernetes.io/cabinet | String | **参数解释**：节点所在tor交换机ip。多个tor交换机ip之间以中划线-分隔。 **取值范围**：不涉及。 | | os.modelarts.node/underlying.instance.id | String | **参数解释**：节点底层资源的实例ID，如超节点的ECS实例ID。 **取值范围**：不涉及。 | | os.modelarts.node/ha.redundant.enabled | String | **参数解释**：节点是否启用高可用冗余。 **取值范围**： - true：开启 - false：未开启 | | os.modelarts.node/nodepoolname | String | **参数解释**：节点所在的节点池名称,最小长度为2，最大长度为50的小写字母、中划线-、数字组成，由小写字母开头，不能 以-，-default结尾。 **取值范围**：不涉及。 | 表5NodeVOAnnotations | 参数 | 参数类型 | 描述 | |:---|:---|:---| | os.modelarts/npu-topology-placement | String | **参数解释**：NPU卡的资源使用拓扑信息，长度为16的二进制编码，右起第一位编码代表卡1。其中，1表示占用，0表示空闲。例如，16卡的机型中卡1和卡15被占用，值为0100000000000001；8卡的机型中卡1和卡7被占用，返回值为0000000001000001。 **取值范围**：不涉及。 | 表6NodeSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | flavor | String | **参数解释**：节点资源规格ID。 **取值范围**：不涉及。 | | os | [Os] object | **参数解释**：操作系统镜像信息。 | | hostNetwork | [NodeNetwork] object | **参数解释**：节点网络信息。 | | rootVolume | [VolumeVO] object | **参数解释**：系统盘信息。 | | dataVolumes | Array of [VolumeVO] objects | **参数解释**：数据盘信息。 | | extendParams | [ResourceExtendParams] object | **参数解释**：自定义配置。 | 表7Os | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**：操作系统名称和版本，如EulorOS 2.5。指定私有镜像时可不指定。 **取值范围**：不涉及。 | | imageId | String | **参数解释**：操作系统镜像id。 **取值范围**：不涉及。 | | imageType | String | **参数解释**：操作系统镜像类型。设置私有镜像时必须指定。默认为预置镜像，无需指定该字段。 **取值范围**：可选值如下： - private：私有镜像 - ""：不指定类型即预置镜像。 | | autoMatch | String | **参数解释**：操作系统镜像自动匹配配置。当配置该参数时将会自动选择最优镜像，同时该参数会自动清空。 **取值范围**：操作系统名称和版本，如EulorOS 2.5。 | 表8NodeNetwork | 参数 | 参数类型 | 描述 | |:---|:---|:---| | vpc | String | **参数解释**：vpc id。 **取值范围**：不涉及。 | | subnet | String | **参数解释**：子网id。 **取值范围**：不涉及。 | | securityGroups | Array of strings | **参数解释**：安全组id集合。 | 表9VolumeVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | volumeType | String | **参数解释**：磁盘类型，具体内容可参考磁盘类型及性能介绍。 **取值范围**： - SSD：超高IO硬盘 - GPSSD：通用型SSD | | size | String | **参数解释**：磁盘大小，单位为Gi。 **取值范围**：不涉及。 | | count | Integer | **参数解释**：磁盘个数。不指定默认值为1。 **取值范围**：不涉及。 | 表10ResourceExtendParams | 参数 | 参数类型 | 描述 | |:---|:---|:---| | dockerBaseSize | String | **参数解释**：节点的容器镜像空间大小。 **取值范围**：可选值如下： - 指定大小：dockerBaseSize的大小范围默认为50-500，但实际上限受到节点的容器数据盘大小约束。 - 不限制：dockerBaseSize="0"，表示不限制容器镜像空间大小。 | | postInstall | String | **参数解释**：安装后执行脚本，输入的值需要经过Base64编码。 **取值范围**：不涉及。 | | runtime | String | **参数解释**：容器运行时。 **取值范围**：可选值如下： - docker：容器运行时，是目前最常用的容器化引擎，基于容器镜像创建和管理容器实例。 - containerd：工业级的容器运行时，专注于容器的生命周期管理，是 Docker 底层核心组件之一，也可独立部署使用。 | | labelPolicyOnExistingNodes | String | **参数解释**：存量节点k8s标签更新策略，值为空时默认更新存量节点。 **取值范围**：可选值如下： - refresh：更新。 - ignore：不更新。 | | taintPolicyOnExistingNodes | String | **参数解释**：存量节点k8s污点更新策略，值为空时默认更新存量节点。 **取值范围**：可选值如下： - refresh：更新。 - ignore：不更新。 | | tagPolicyOnExistingNodes | String | **参数解释**：存量节点资源标签更新策略，值为空时默认更新存量节点。 **取值范围**：可选值如下： - refresh：更新。 - ignore：不更新。 | | XParameterPlaneSubnet | String | **参数解释**：跨物理集群之间进行参数面数据传输使用的子网id。不可与节点子网和容器子网重复。 **取值范围**：不涉及。 | | nodePoolName | String | **参数解释**：用户指定的节点池名称。最小长度为2，最大长度为50的小写字母、中划线-、数字组成，由小写字母开头，不能以-，-default结尾。 **取值范围**：不涉及 | 表11NodeStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | phase | String | **参数解释**：节点当前状态。 **取值范围**：可选值如下： - Available：节点可用。 - Creating：节点创建中。 - Deleting：节点删除中。 - Abnormal：节点异常。 - Checking: 节点自检中。 | | az | String | **参数解释**：节点所在的az。 **取值范围**：不涉及。 | | privateIp | String | **参数解释**：节点的IP地址。 **取值范围**：不涉及。 | | resources | [NodeResource] object | **参数解释**：节点资源量信息。 | | availableResources | [NodeResource] object | **参数解释**：节点可用资源量信息。 | 表12NodeResource | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cpu | String | **参数解释**：节点的CPU核心数量。 **取值范围**：不涉及。 | | memory | String | **参数解释**：节点的内存大小。以Gi为单位。 **取值范围**：不涉及。 | | nvidia.com/gpu | String | **参数解释**：节点的GPU卡数。 **取值范围**：不涉及。 | | huawei.com/ascend-snt3 | String | **参数解释**：节点的snt3型NPU卡数量。 **取值范围**：不涉及。 | | huawei.com/ascend-snt9 | String | **参数解释**：节点的snt9型NPU卡数量。 **取值范围**：不涉及。 | **状态码：404** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 | | error_msg | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。 | #### 请求示例 查询资源池单个节点详情。 ``` GET https://{endpoint}/v2/{project_id}/pools/{pool_name}/nodes/{node_name} { } ``` #### 响应示例 **状态码：200** OK。 ``` { "kind" : "Node", "apiVersion" : "v2", "metadata" : { "name" : "os-node-created-zlncn", "creationTimestamp" : "2022-09-16T05:32:44Z" }, "spec" : { "flavor" : "modelarts.vm.cpu.4ud" }, "status" : { "phase" : "Available", "az" : "xx-xxxx-xx", "privateIp" : "192.168.0.1", "resources" : { "cpu" : "3920m", "memory" : "6270Mi" }, "availableResources" : { "cpu" : "2970m", "memory" : "4558Mi" } } } ``` **状态码：404** Not Found。 ``` { "error_code" : "ModelArts.50015001", "error_msg" : "pool not found" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK。 | | 404 | Not Found。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。