文档首页/ 魔坊（ModelArts）模型训推平台/ API参考/ 专属资源池和轻量算力集群/ 节点配置模板/ 查询节点配置模板 - ShowNodeConfigTemplate
更新时间：2026-07-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询节点配置模板 - ShowNodeConfigTemplate

功能介绍

查询节点配置模板接口用于获取指定节点配置模板的详细信息。该接口适用于以下场景：当用户需要查看节点配置模板的内容、管理节点配置或进行相关操作时，可通过此接口获取指定节点配置模板的详细信息。使用该接口的前提条件是节点配置模板已存在且用户具有相应的访问权限。调用该接口后，系统将返回指定节点配置模板的详细信息，包括模板名称、版本、配置参数及描述等。若节点配置模板不存在或用户无权限访问，接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v1/{project_id}/nodeconfigtemplates/{nodeconfigtemplate_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：用户项目ID。获取方法请参见获取项目ID和名称。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

nodeconfigtemplate_name

是

String

参数解释：节点配置模板的名称。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

apiVersion

String

参数解释：API版本。

取值范围：可选值如下：

  • v1

kind

String

参数解释：资源类型。

取值范围：可选值如下：

  • NodeConfigTemplate：节点配置模板

metadata

NodeConfigTemplateMeta object

参数解释：节点配置模板的metadata信息。

spec

NodeConfigTemplateSpec object

参数解释：节点配置模板的规格信息。
表3 NodeConfigTemplateMeta

参数

参数类型

描述

name

String

参数解释：节点配置模板的名称。

取值范围：不涉及。
表4 NodeConfigTemplateSpec

参数

参数类型

描述

dockerBaseSize

Integer

参数解释：资源池节点上单容器的可用磁盘空间大小，单位G。

取值范围：不涉及。

dockerLvmConfig

DockerLvmConfig object

参数解释：资源池节点Docker数据盘配置项。

osList

Array of AffinityOS objects

参数解释：该规格支持的Modelarts内置操作系统列表。
表5 DockerLvmConfig

参数

参数类型

描述

dockerThinPool

Integer

参数解释：资源池节点Docker盘占数据盘的百分比。例如Docker盘大小占用数据盘20%，该参数值为20。

取值范围：不涉及。

kubernetesLV

Integer

参数解释：资源池节点上kubelet占数据盘的百分比。例如Docker盘大小占用数据盘20%，该参数值为20。

取值范围：不涉及。

dockerDiskType

String

参数解释：磁盘类型。

取值范围：可选值如下：

  • evs：云硬盘

  • ssd：本地SSD硬盘

lvType

String

参数解释：LVM写入模式。

取值范围：可选值如下：

  • striped：条带模式，使用多块磁盘组成条带模式，能够提升磁盘性能

  • linear：线性模式
表6 AffinityOS

参数

参数类型

描述

name

String

参数解释：操作系统名称。

取值范围：不涉及。

imageId

String

参数解释：操作系统镜像id, 裸金属规格该字段不为空。

取值范围：不涉及。

preferred

Boolean

参数解释：是否优选。

取值范围：不涉及。

eos

Boolean

参数解释：操作系统是否即将停止服务, end of service。

取值范围：不涉及。

offline

Boolean

参数解释：操作系统是否下线。

取值范围：不涉及

状态码：404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

取值范围：不涉及。

error_msg

String

参数解释：错误描述信息。

取值范围：不涉及。

请求示例

无

响应示例

状态码：200

OK。

{
  "kind" : "NodeConfigTemplate",
  "apiVersion" : "v1",
  "metadata" : {
    "name" : "base.template"
  },
  "spec" : {
    "dockerBaseSize" : 50,
    "dockerLvmConfig" : {
      "dockerThinPool" : 90,
      "kubernetesLV" : 10,
      "dockerDiskType" : "evs"
    }
  }
}

状态码：404

Not Found。

{
  "error_code" : "ModelArts.50005101",
  "error_msg" : "Nodeconfigtemplate {name} not found"
}

状态码

状态码

描述

200

OK。

404

Not Found。

错误码

请参见错误码。

父主题： 节点配置模板