请求示例 免审批变更单创建，携带Action字段。 POST https://{Endpoint}/v1/external/change/create { "title": "coc:change:CodeArtsServiceUpgrade10007", "change_notes": "coc:change:CodeArtsServiceUpgrade10005", "change_scene_id": "GOCMLL01001", "change_type": "change_type_conventional", "level": "change_level_030", "actions": "coc:change:CodeArtsServiceUpgrade", "current_cloud_service_id": "6577d822b90cb779d5765318", "change_scopes": [ { "region": "***", "resource_biz_id": "66bd7b468a80993d5650b77a", "app_name": "cdr0031" } ], "change_plans": [ { "executors": "bae47db0f86c48318ea65f10bd8aa417", "expected_start_time": 1745305517577, "expected_end_time": 1745308803281"target_value": "***" } ] }

响应参数 状态码：200 表4 响应Body参数列表 名称 类型 是否必选 描述 provider_code String 否 服务标识。 缺省值：049 最小长度：0 最大长度：256 error_code String 否 请求响应代码，范围：0000~9999，正常时取值：0。 缺省值：0 最小长度：0 最大长度：256 error_msg String 否 请求响应描述。 最小长度：0 最大长度：256

请求参数 表1 请求body参数 名称 类型 是否必选 描述 title String 是 变更标题。 最小长度：1 最大长度：255 默认取值：不涉及 change_notes String 是 变更描述。 最小长度：1 最大长度：1000 默认取值：不涉及 change_type String 是 变更类型。 最小长度：1 最大长度：255 取值： change_type_conventional：常规变更 change_type_urgentu：紧急变更 默认取值：不涉及 level String 是 变更级别。 最小长度：1 最大长度：255 取值： change_level_010 A change_level_020 B change_level_030 C change_level_040 D 默认取值：不涉及 change_scheme String 否 变更模式。 最小长度：1 最大长度： 255 取值： change_scheme_runbook：作业 change_scheme_guides：变更指导书 默认取值：不涉及 change_guides String 否 变更指导书ID。 最小长度：0 最大长度： 255 默认取值：不涉及 change_scene_id String 是 变更场景。 最小长度：1 最大长度：255 取值：取配置页面【流程管理】下“变更场景”TAB页中列表属性ID列的值，示例：GOCMLL06 默认取值：不涉及 current_cloud_service_id String 是 归属应用。 最小长度：1 最大长度：255 默认取值：不涉及 location_id String 否 变更区域。 最小长度：1 最大长度：255 默认取值：不涉及 actions String 否 Action。 最小长度：0 最大长度：255 取值：取页面【变更管控】列表中的Action ID，用于对特殊Action有特殊逻辑场景。 默认取值：不涉及 is_start_process Boolean 否 是否启动流程。 枚举值： true false 默认取值：false change_scopes Arrays of ChangeScopeInfo 是 变更范围。 数组长度：1 - 100 默认取值：不涉及 change_plans Arrays of ChangePlansInfo 是 变更计划。 数组长度：1 - 100 默认取值：不涉及 表2 ChangeScopeInfo属性 名称 类型 是否必选 描述 app_name String 是 变更应用。 最小长度：1 最大长度：255 默认取值：不涉及 target_type String 否 子单类型，固定值：change_scope 默认取值：不涉及 region String 是 变更区域。 最小长度：1 最大长度：255 默认取值：不涉及 resource_biz_id String 是 应用ID。 最小长度：1 最大长度：255 默认取值：不涉及 表3 ChangePlansInfo属性： 名称 类型 是否必选 描述 target_type String 否 子单类型，固定值：child_ticket。 最小长度：0 最大长度：255 默认取值：不涉及 target_value String 是 变更区域。 最小长度：1 最大长度：255 默认取值：不涉及 expected_start_time Long 是 计划开始时间，时间戳。 最小值：0 最大值：999999999 默认取值：不涉及 expected_end_time Long 是 计划结束时间，时间戳。 最小值：0 最大值：999999999 默认取值：不涉及 executors String 是 实施人。 最小长度：1 最大长度：255 默认取值：不涉及 cooperators String 是 配合人。 最小长度：1 最大长度：255 默认取值：不涉及

前提条件 开启变更管控需要申请 IAM 权限，具体的actionID如下： IAM v3版本权限： "iam:roles:listRoles", "iam:permissions:grantRoleToAgency", "iam:permissions:grantRoleToAgencyOnDomain", "iam:roles:createRole", "iam:groups:listGroups", "iam:permissions:listRoleAssignments", "iam:permissions:grantRoleToGroupOnDomain", "iam:permissions:revokeRoleFromGroupOnDomain", "iam:permissions:revokeRoleFromGroupOnDomain", "iam:roles:deleteRole", "iam:roles:updateRole" IAM v5版本权限：（IAM的新版本页面中身份策略添加action） "iam:policies:createV5", "iam:policies:listV5", "iam:groups:attachPolicyV5", "iam:groups:detachPolicyV5", "iam:policies:deleteV5", "iam:policies:listVersionsV5", "iam:policies:createVersionV5", "iam:policies:deleteVersionV5"

注意事项 当前coc生成的变更管控策略默认仅提供绑定在用户组的功能，请勿将策略用作其他用途； 您可以通过coc界面action的修改按钮来控制相应功能是否开启管控，注意所有操作请在coc完成，切勿直接操作策略。 工单提权开启后，策略绑定了用户后，若需要关闭工单提权，需先将用户组中的策略解绑后才能关闭。 工单提权时校验操作的资源region、应用和工单状态，若操作的资源无所属region、应用，则不校验，会显示该用户名下所有的工单。每种该工单的状态校验如下： 事件单状态校验： P1、P2、P3、P4已受理状态的事件单； 提权应用必须与事件单分析处理阶段的当前责任应用一致； 提权操作人必须与事件分析处理阶段的当前责任人一致； 提权区域必须与事件单的区域一致。 WarRoom状态校验： WarRoom的状态为(启动WarRoom、故障界定)； 提权应用在WarRoom的影响应用列表中； 提权操作人是WarRoom的恢复责任人、恢复成员、管理员。 变更单状态校验： 提权应用，Region必须与变更单中的一致； 此次提权的操作人必须是变更单的实施人； 当前操作时间必须在变更单的计划实施时间窗内（当前操作时间必须大于计划开始时间且小于计划结束时间）； 变更单必须单击“变更开始”。 开启工单提权后，北向接口无法使用。例如执行脚本开启工单提权，北向调用脚本接口无法使用。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 oper_type 是 String 变更类型 取值范围： storage：存储空间扩容，代理数量不变。 horizontal：代理数量扩容，每个broker的存储空间不变。 vertical：垂直扩容，broker的底层虚机规格变更，代理数量和存储空间不变。 new_storage_space 否 Integer 当oper_type类型是storage或horizontal时，该参数有效且必填，实例存储空间 = 代理数量 * 每个broker的存储空间。 当oper_type类型是storage时，代理数量不变，每个broker存储空间最少扩容100GB。 当oper_type类型是horizontal时，每个broker的存储空间不变。 new_product_id 否 String 当oper_type类型是vertical时，该参数才有效且必填。 new_broker_num 否 Integer 代理数量 当oper_type参数为horizontal时，该参数必填。 publicip_id 否 String 实例绑定的弹性IP地址的ID。 以英文逗号隔开多个弹性IP地址的ID。 当oper_type参数为horizontal且开启了公网访问时，此参数必填。

OPS05-01 进行生产准备度评审（Product Readiness Review） 风险等级 高 关键策略 Production Readiness Review 生产准备度评估基线：从SLI/SLO、可冗余、可容灾、可过载控制、可故障管理、可变更能力、可运维、安全生产等维度，对服务可用性及运维能力提出基线要求。在服务产品开发前端构筑能力，进行相关需求规划、设计和开发工作，并在服务上线前进行生产准入审视。 具备以下核心价值： 1）准确评价产品可用性、维护能力并明确相关上线标准；不满足上云标准的服务，原则上不允许上线。 2）持续导入服务可服务性、运维需求基线，实现标准化、减少例外操作，帮助服务快速上云。 3）持续提升自动化验证能力，减少手工评估，提升产品的交付与运维效率。 相关云服务和工具 COC PRR评审 父主题： OPS05 运维准备和变更管理