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

查询平台列表

列表已注册联邦平台分页支持。

GET/api/v1/platforms

操作 ID

ListPlatforms

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

查询参数

  • limit
    Integer

    最多返回的记录数。

    示例： 0

  • offset
    Integer

    查询起始偏移量。

    示例： 0

响应状态

200 OK
200 OK

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

  • items
    List

    条目列表。

    示例： (nested array)

    • 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

  • total
    Integer

    返回结果总数。

    示例： 42

  • limit
    Integer

    最大返回条目数。

    示例： 20

  • offset
    Integer

    查询起始偏移量。

    示例： 20

变更历史

查看全部变更历史

  • 变更时间

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