跳到主要内容

创建规范

基于一个已有规范复制并创建新的规范。

请求地址:/openapi/v1/ruleSet/create

请求方法:POST

调用前准备

  • 可先调用 查询规范列表 获取可作为复制来源的 parentId
  • 建议为新规范设置便于识别的名称和描述,便于后续查询、绑定和维护。

请求参数

参数类型是否必填说明示例
nameString规范名称。生产环境 SQL 规范
parentIdString复制来源规范 ID。可调用查询规范列表获取。rs-default-dev
descriptionString规范描述。适用于生产环境 SQL 开发流程

如何使用返回值

调用成功后,响应中的 data 为新创建的规范 ID。后续调用 删除规范绑定或解绑规范资源 时,可将该值作为 id 传入。

请求示例

{
"name": "生产环境 SQL 规范",
"parentId": "rs-default-dev",
"description": "适用于生产环境 SQL 开发流程"
}

返回参数

参数类型说明示例
successBoolean请求是否成功。true
requestIdString请求 ID,可用于问题排查和链路追踪。Ew4t6KMF-HNNOpCMnNKPn0RHdIOh4TLN
dataString新创建的规范 ID。rs-dii9zwptapl1
errorCodeString调用失败时返回的错误码。
messageString调用失败时返回的异常信息。

调用成功示例

{
"success": true,
"requestId": "Ew4t6KMF-HNNOpCMnNKPn0RHdIOh4TLN",
"data": "rs-dii9zwptapl1"
}