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

创建平台

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

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