文档首页/ 魔坊(ModelArts)模型训推平台/ API参考/ 节点自定义配置/ 查询资源池节点自定义配置模板 - ShowPoolNodeConfigTemplate
更新时间:2026-06-03 GMT+08:00

查询资源池节点自定义配置模板 - ShowPoolNodeConfigTemplate

功能介绍

查询资源池节点自定义配置模板接口用于获取节点配置模板的结构定义与参数规范。该接口适用于以下场景:当需要了解节点自定义配置的模板结构(如参数字段、校验规则、示例值)、验证配置模板是否符合规范或进行配置模板选型时,用户可通过此接口获取模板的元数据(如参数说明、类型限制、依赖关系等)。使用该接口的前提条件是目标配置模板必须已注册至系统且处于可访问状态,调用者需具备模板查看权限,且系统配置管理服务正常运行。查询操作完成后,系统将返回模板的完整定义信息(如参数列表、版本号、更新时间等),且不会对模板内容或节点配置产生影响。若模板未注册、用户权限不足或系统服务异常,接口将返回对应的错误信息(如"404 Not Found"、"403 Forbidden"或"503 Service Unavailable")。

调试

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

授权信息

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

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

URI

GET /v2/{project_id}/pools/{pool_name}/node-config-template

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:。获取方法请参见](modelarts_03_0147.xml)。

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

pool_name

String

参数解释:池名称。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

apiversion

String

参数解释:API版本。

取值范围:固定为v2。

kind

String

参数解释:配置类型。

取值范围:固定为NodeConfigTemplate。

metadata

nodeconfigtemplateMeta object

参数解释:节点配置模板元数据。

spec

nodeconfigtemplatesSpec object

参数解释:节点配置模板规格。

表3 nodeconfigtemplateMeta

参数

参数类型

描述

name

String

参数解释:节点名称。

取值范围:固定为node-config-template。

表4 nodeconfigtemplatesSpec

参数

参数类型

描述

templates

Array of nodeconfigTemplateItem objects

参数解释:节点配置模板列表。

表5 nodeconfigTemplateItem

参数

参数类型

描述

configs

Object

参数解释:支持的配置项列表和默认值。

状态码:400

表6 响应Header参数

参数

参数类型

描述

X-request-id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

响应示例

状态码

状态码

描述

200

节点自定义配置模板

400

Error response

错误码

请参见错误码