跳转到主要内容
API Explorer|API Explorer
基础设施相关接口/变更管理
POSTChangeManagement起始版本 1.0同步需要认证

创建变更请求

创建新变更请求已规划调度计划影响范围。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • titleString必填

    标题。

    示例： Upgrade database cluster to v14

  • descriptionString必填

    资源的详细描述。

    示例： Rolling upgrade of PostgreSQL from v13 to v14 with no downtime

  • changeTypeString必填

    变更类型。

    示例： CHANGE_TYPE_UNSPECIFIED

  • plannedStartString必填

    已规划开始。

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

  • plannedEndString必填

    已规划结束。

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

响应状态

200 OK

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

  • idString

    资源ID。

    示例： cr-a1b2c3d4-e5f6-7890-abcd-ef1234567890

  • titleString

    标题。

    示例： Upgrade database cluster to v14

  • descriptionString

    资源的详细描述。

    示例： Rolling upgrade of PostgreSQL from v13 to v14 with no downtime

  • changeTypeString

    变更类型。

    示例： CHANGE_TYPE_UNSPECIFIED

  • statusString

    状态信息。

    示例： CHANGE_STATUS_UNSPECIFIED

  • plannedStartString

    已规划开始。

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

  • plannedEndString

    已规划结束。

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

  • impactScopeObject

    影响范围。

    • entityTypeString

      实体类型。

      示例： VmInstance

    • entityIdsList

      实体ID。

      示例： item1,item2

  • expectedAlertsList

    预期告警。

    示例： item1,item2

  • changeOwnerString

    变更负责人。

    示例： admin

  • approverIdsList

    审批人ID。

    示例： item1,item2

  • silenceIdString

    静默ID。

    示例： silence-abc123

  • createdAtString

    创建时间。

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

请求地址

POST/api/v1/change-management/change-requests

/api/v1/change-management/change-requests

操作 ID

CreateChangeRequest

永久链接

请求示例

curl -X POST '{host}/api/v1/change-management/change-requests' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"title":"Upgrade database cluster to v14","description":"Rolling upgrade of PostgreSQL from v13 to v14 with no downtime","changeType":"CHANGE_TYPE_UNSPECIFIED","plannedStart":"2026-01-15T08:00:00Z","plannedEnd":"2026-01-15T08:00:00Z","impactScope":{"entityType":"VmInstance","entityIds":"item1,item2"},"expectedAlerts":"item1,item2","changeOwner":"admin","approverIds":"item1,item2"}'

响应示例

200
{
  "id": "cr-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "title": "Upgrade database cluster to v14",
  "description": "Rolling upgrade of PostgreSQL from v13 to v14 with no downtime",
  "changeType": {},
  "status": {},
  "plannedStart": "example",
  "plannedEnd": "example",
  "impactScope": {}
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史