访问管理
更新时间：2026-07-24
本页覆盖管理员访问令牌和公网 EIP 的管理接口。公共约定、状态枚举和错误响应见集群生命周期 OpenAPI。
查询管理员访问令牌状态
查询集群管理员访问令牌是否已初始化，以及当前是否存在令牌签发或重置操作。
Http
1GET /v1/dedicated/cluster/{clusterId}/admin-tokenPath 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
clusterId |
string | 是 | 集群 ID。 |
响应示例
JSON
1{
2 "adminToken": {
3 "state": "initialized",
4 "lastIssuedAt": "2026-07-08T10:00:00Z",
5 "lastIssuedBy": "user-id",
6 "lastUnknownAt": null,
7 "lastUnknownReason": null,
8 "operationInProgress": false,
9 "currentOperationType": null,
10 "currentOperationStartedAt": null
11 }
12}state 取值如下：
uninitialized：尚未签发管理员访问令牌。initialized：管理员访问令牌已初始化。unknown：服务暂时无法确认令牌状态；重置前应明确确认影响。
本接口不会返回令牌明文。
获取或重置管理员访问令牌
首次获取管理员访问令牌，或确认后重置已有管理员访问令牌。该操作要求使用主账号身份调用。
Http
1POST /v1/dedicated/cluster/{clusterId}/admin-token
2Content-Type: application/jsonPath 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
clusterId |
string | 是 | 集群 ID。 |
请求体
JSON
1{"confirmReset": true}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
confirmReset |
boolean | 条件必填 | 令牌状态为 initialized 或 unknown 时必须为 true；首次初始化时可省略。 |
响应示例
JSON
1{"token": "<plain-admin-token>"}令牌明文只在本次成功响应中返回一次，平台不保存明文。请立即保存到凭证管理系统，不要写入日志、源码、工单或聊天记录。重置成功后，旧管理员访问令牌立即失效，依赖旧令牌的任务需要同步更新。
绑定 EIP
将账号下已有的 EIP 绑定到指定集群，启用公网访问。该操作要求使用主账号身份调用。
Http
1PUT /v1/dedicated/cluster/{clusterId}/eip
2Content-Type: application/jsonPath 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
clusterId |
string | 是 | 集群 ID。 |
请求体
JSON
1{"eipId": "eip-abc123"}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
eipId |
string | 是 | 用户账号下符合绑定条件的 EIP ID。 |
响应示例
JSON
1{
2 "clusterId": "tsdb-cl-abc123",
3 "access": {
4 "publicAccessStatus": "Binding",
5 "publicIp": null,
6 "eipId": "eip-abc123"
7 }
8}绑定是异步操作。等待集群详情中的 publicAccessStatus 变为 Bound 后，再使用公网连接信息。该接口不会创建或购买 EIP。
公网访问状态可能依次经历 Unbound、Binding 和 Bound；失败时为 Error。只能绑定当前账号下符合绑定条件的用户自有 EIP，EIP 本身的购买、带宽和费用由 EIP 产品管理。请求超时或失败时，应先查询集群详情中的公网访问状态，再决定是否重试。
解绑 EIP
解除 EIP 与指定集群的绑定，关闭该公网访问入口。该操作要求使用主账号身份调用。
Http
1DELETE /v1/dedicated/cluster/{clusterId}/eipPath 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
clusterId |
string | 是 | 集群 ID。 |
响应示例
JSON
1{
2 "clusterId": "tsdb-cl-abc123",
3 "access": {
4 "publicAccessStatus": "Unbinding",
5 "publicIp": null,
6 "eipId": null
7 }
8}解绑是异步操作。等待集群详情中的 publicAccessStatus 变为 Unbound 后，再认为公网入口已关闭。该接口不会释放 EIP 本身。
解绑前请确认没有生产应用依赖当前公网地址；需要继续访问的应用应先切换到已确认可用的内网访问地址。
评价此篇文章