跳转到主要内容
ZStack
平台运维相关接口/平台管理

更新ZNS端点

更新平台连接的 ZNS 端点配置并返回刷新后的连接记录。

PUT/api/v1/platforms/{uuid}/endpoint

操作 ID

UpdateZnsEndpoint

起始版本

1.2.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

路径参数

  • uuid
    String必填

    资源的UUID，唯一标识该资源。

请求体字段

  • endpointMode
    String必填

    资源。

    示例： value

  • endpoint
    Object必填

    接收端地址。

    • host
      String

      主机地址。

      示例： 172.31.6.104

    • port
      Integer

      端口号。

      示例： 7278

  • bootstrapNodes
    List必填

    资源。

    示例： (nested array)

    • host
      String

      主机地址。

      示例： 172.31.6.104

    • port
      Integer

      端口号。

      示例： 7278

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • uuid
    String

    资源的UUID，唯一标识该资源。

    示例： plat-abc123-def456

  • name
    String

    资源名称。

    示例： prod-zstack-01

  • productType
    String

    产品类型。

    示例： zstack

  • hostIp
    String

    主机IP地址。

    示例： 192.168.1.100

  • hostPort
    Integer

    主机端口。

    示例： 8080

  • accessKeyName
    String

    访问密钥名称。

    示例： admin-key

  • status
    String

    状态信息。

    示例： connected

  • lastError
    String

    最近一次错误。

    示例： connection timeout

  • features
    Object

    功能开关集合。

    • syncResource
      Boolean

      同步资源。

      示例： true

    • monitoring
      Boolean

      监控开关。

      示例： true

    • logCollection
      Boolean

      日志采集。

      示例： false

    • credential
      Object

      凭证。

      • usernameEnc
        String

        用户名加密。

        示例： value

      • passwordEnc
        String

        密码加密。

        示例： value

  • version
    String

    版本号。

    示例： 4.3.0

  • healthStatus
    String

    健康度状态。

    示例： healthy

  • lastSuccessAt
    String

    最近一次成功时间。

    示例： 2026-01-15T08:00:00Z

  • lastErrorAt
    String

    最近一次错误时间。

    示例： 2026-01-15T08:00:00Z

  • lastErrorDetail
    String

    最近一次错误详情。

    示例： dial tcp 192.168.1.100:8080: connect: connection refused

  • successCount
    Integer

    成功数量。

    示例： 1024

  • errorCount
    Integer

    错误数量。

    示例： 3

  • createDate
    String

    创建时间。

    示例： 2026-01-15T08:00:00Z

  • lastOpDate
    String

    最近一次操作时间。

    示例： 2026-01-15T08:00:00Z

  • scope
    String

    作用范围。

    示例： region

  • regionUuid
    String

    区域UUID。

    示例： region-abc123-def456

  • deletionPhase
    String

    删除阶段。

    示例： Failed

  • deleteRetryable
    Boolean

    删除可重试。

    示例： true

  • deletionFailureReason
    String

    删除失败原因。

    示例： revoke zns access key before delete: connection refused

变更历史

查看全部变更历史

  • 变更时间

    新增响应字段 deleteRetryable, deletionFailureReason, deletionPhase
    查看 API