cdnca

开放接口

/v1/admin/entitlement

1 个接口

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

方法路径摘要认证
POST/v1/admin/entitlement/refreshRefresh the locally verified entitlement lease登录会话

契约文件：api/control-entitlement-refresh.openapi.yaml

接口详情

POST /v1/admin/entitlement/refresh

Refresh the locally verified entitlement lease

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

全部需要：platform.admin

说明（契约原文）

Requires a live platform administrator session. The control plane contacts the configured license service, verifies the signed lease, and atomically installs it locally. Existing edge traffic does not depend on this request or on license-service availability.

参数

refreshAdminEntitlement 参数
名称位置类型必填说明
X-Request-IDheaderstring是—
Idempotency-Keyheaderstring是—

请求体

application/json · 必填：是

响应

refreshAdminEntitlement 响应
状态码说明
200The signed lease was verified and installed.

字段：schema: string request_id: string snapshot: object

400Stable API error.
401Stable API error.
403Stable API error.
409Stable API error.
502Stable API error.
503Stable API error.
504Stable API error.

失败时怎么办

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

↑ 回到列表