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

创建平台

创建新联邦平台连接凭证功能标志。

POST/api/v1/platforms

操作 ID

CreatePlatform

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

请求体字段

  • name
    String

    资源名称。

    示例： prod-zstack-01

  • productType
    String

    产品类型。

    示例： zstack

  • hostIp
    String

    主机IP地址。

    示例： 192.168.1.100

  • hostPort
    Integer

    主机端口。

    示例： 8080

  • username
    String

    用户名。

    示例： admin

响应状态

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

  • 变更时间

    新增请求体字段 bootstrapNodes, clientRequestId, enabledModules...
    查看 API