Skip to content

feat: 提供创建执行方案的OpenAPI V4接口 #4247#4341

Merged
jsonwan merged 6 commits into
TencentBlueKing:masterfrom
jsonwan:issue_4247
Jun 5, 2026
Merged

feat: 提供创建执行方案的OpenAPI V4接口 #4247#4341
jsonwan merged 6 commits into
TencentBlueKing:masterfrom
jsonwan:issue_4247

Conversation

@jsonwan

@jsonwan jsonwan commented Jun 4, 2026

Copy link
Copy Markdown
Collaborator
  1. 提供接口实现、文档与APIGW资源。

jsonwan added 5 commits June 4, 2026 14:16
- 新增 V4CreateJobPlanRequest / V4JobPlanVariableItem / EsbJobPlanV4DTO
- 新增 OpenApiJobPlanV4Resource#createJobPlan 接口定义
- 在 support-files/bk-api-gateway/v3/resources.yaml 注册 /api/v4/create_job_plan
- 新增中英文 API 文档 apidocs/zh|en/v4/v4_create_job_plan.md.j2
1.补全 PLAN_NAME_EXIST(1243042) 的 i18n 文案,修复 TC12 同名创建方案 HTTP 500 应返回 409 的问题。
type: array
items:
type: object
properties:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

每个拓扑节点元素require id和node_type,建议补上

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

已添加

@Getter
@Setter
@EqualsAndHashCode(callSuper = true)
public class EsbJobPlanV4DTO extends EsbAppScopeDTO {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

注释里写OpenAPI,类命名用的是ESB;其他类都叫OpenApixxxV4xxx,这里是Esb,命名不统一,建议也叫OpenApi。且在实际开发中,发现AI对openapi和esb不太理解,会把他们当作两个不相关的东西。所以干脆V4以后的接口相关的类都叫OpenApiV4xxx好了

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

已修改

@wuyzh39 wuyzh39 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

两个小问题看下

1. 按 PR TencentBlueKing#4341 Review 将 EsbJobPlanV4DTO 重命名为 OpenApiV4JobPlanDTO,与 OpenApiV4HostDTO 等 V4 命名一致。

2. resources.yaml 中 create_job_plan 的 topo_node_list 元素补充 required: id、node_type。
@jsonwan jsonwan merged commit 495b6e4 into TencentBlueKing:master Jun 5, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants