cdnca

开放接口

/v1/admin/node-isolations

1 个接口

← 全部分组 · 第一次调用？先看教程：认证、权限、请求与响应、常见失败

方法路径摘要认证
GET/v1/admin/node-isolations查询当前作用域内持久化的节点配置同步隔离状态登录会话

契约文件：api/control-node-isolation.openapi.yaml

接口详情

GET /v1/admin/node-isolations

查询当前作用域内持久化的节点配置同步隔离状态

operationId
listNodeIsolationStates
认证
  • 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
所需权限

契约没有单独标注权限码，权限要求见下方说明与 403 响应。

参数

listNodeIsolationStates 参数
名称位置类型必填说明
node_idqueryarray<string(uuid)>否可重复；省略时返回当前作用域内全部已有隔离状态事实。
X-Request-IDheaderstring否—

响应

listNodeIsolationStates 响应
状态码说明
200状态按节点 ID 稳定排序；没有状态事实的节点不在结果中。

字段：items: array<IsolationState>

400稳定错误码；界面必须按 locale 映射，不得直接展示 message。
401稳定错误码；界面必须按 locale 映射，不得直接展示 message。
403稳定错误码；界面必须按 locale 映射，不得直接展示 message。
503稳定错误码；界面必须按 locale 映射，不得直接展示 message。
default稳定错误码；界面必须按 locale 映射，不得直接展示 message。

失败时怎么办

  • 400 按字段说明修正参数或请求体再发；不要原样重试。
  • 401 检查凭据格式、是否过期或被轮换。
  • 403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。
  • 503 依赖暂不可用：稍后用原 Idempotency-Key 重试。

↑ 回到列表