创建规范
基于一个已有规范复制并创建新的规范。
请求地址:/openapi/v1/ruleSet/create
请求方法:POST
调用前准备
- 可先调用 查询规范列表 获取可作为复制来源的
parentId。 - 建议为新规范设置便于识别的名称和描述,便于后续查询、绑定和维护。
请求参数
| 参数 | 类型 | 是否必填 | 说明 | 示例 |
|---|---|---|---|---|
| name | String | 是 | 规范名称。 | 生产环境 SQL 规范 |
| parentId | String | 是 | 复制来源规范 ID。可调用查询规范列表获取。 | rs-default-dev |
| description | String | 是 | 规范描述。 | 适用于生产环境 SQL 开发流程 |
如何使用返回值
调用成功后,响应中的 data 为新创建的规范 ID。后续调用 删除规范 或 绑定或解绑规范资源 时,可将该值作为 id 传入。
请求示例
{
"name": "生产环境 SQL 规范",
"parentId": "rs-default-dev",
"description": "适用于生产环境 SQL 开发流程"
}
返回参数
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| success | Boolean | 请求是否成功。 | true |
| requestId | String | 请求 ID,可用于问题排查和链路追踪。 | Ew4t6KMF-HNNOpCMnNKPn0RHdIOh4TLN |
| data | String | 新创建的规范 ID。 | rs-dii9zwptapl1 |
| errorCode | String | 调用失败时返回的错误码。 | 无 |
| message | String | 调用失败时返回的异常信息。 | 无 |
调用成功示例
{
"success": true,
"requestId": "Ew4t6KMF-HNNOpCMnNKPn0RHdIOh4TLN",
"data": "rs-dii9zwptapl1"
}