查询资源池节点自定义配置模板 - 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
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释:。获取方法请参见](modelarts_03_0147.xml)。 约束限制:1 - 64字符,字母、数字和中划线。 取值范围:不涉及。 默认取值:不涉及。 |
| pool_name | 是 | String | 参数解释:池名称。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| apiversion | String | 参数解释:API版本。 取值范围:固定为v2。 |
| kind | String | 参数解释:配置类型。 取值范围:固定为NodeConfigTemplate。 |
| metadata | nodeconfigtemplateMeta object | 参数解释:节点配置模板元数据。 |
| spec | nodeconfigtemplatesSpec object | 参数解释:节点配置模板规格。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| templates | Array of nodeconfigTemplateItem objects | 参数解释:节点配置模板列表。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| X-request-id | String | This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误描述 |
请求示例
无
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 节点自定义配置模板 |
| 400 | Error response |
错误码
请参见错误码。