cdnca

API reference

/v1/admin/node-isolations

1 operations

← All groups · First call? Read the tutorial: auth, permissions, requests and responses, common failures

MethodPathSummaryAuth
GET/v1/admin/node-isolations查询当前作用域内持久化的节点配置同步隔离状态Session

Contract file：api/control-node-isolation.openapi.yaml

Operation details

GET /v1/admin/node-isolations

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

operationId
listNodeIsolationStates
Auth
  • Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
Required permissions

The contract has no separate permission annotation; see the description below and the 403 response.

Parameters

listNodeIsolationStates Parameters
NameInTypeRequiredDescription
node_idqueryarray<string(uuid)>No可重复；省略时返回当前作用域内全部已有隔离状态事实。
X-Request-IDheaderstringNo—

Responses

listNodeIsolationStates Responses
StatusDescription
200状态按节点 ID 稳定排序；没有状态事实的节点不在结果中。

Fields：items: array<IsolationState>

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

What to do on failure

  • 400 Fix the parameters or body per the field list; do not retry unchanged.
  • 401 Check the credential format and whether it expired or was rotated.
  • 403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.
  • 503 A dependency is unavailable: retry later with the original Idempotency-Key.

↑ Back to list