# 创建规范

Availability-note[测试版](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-beta)

测试版内容

在此场景中，您使用 Talend API 创建规范以提高项目质量。

## 关于本任务

以下是有关 API 调用的一些详细信息：

```
Method: POST
endpoint: api/v1/projects/quality/specifications
payload:[
  {
    "name": "string",
    "description": "string",
    "rules": [
      "string"
    ],
    "threshold": {
      "operator": "string",
      "value": 0,
      "type": "Percentage"
    }
  }
]
```

![选择 API 以获取所有规范。](https://help.qlik.com/Resources/Images/qlik-talend-cloud-migration-toolkit-user-guide/tcmp-specs-api.png)

## 程序

1. 调用 GET /api/v1/projects/quality/rules 端点以获取所有规则。
2. 记下您要添加到要创建的新规范中的规则 ID。
3. 调用 POST /api/v1/projects/quality/specifications 端点以创建规范。
4. 在 正文 区域中，输入以下信息：
   | 参数名称 | 值 |
   | --- | --- |
   | 名称 | 输入规则的名称。 |
   | 说明 | 输入规则的说明。 |
   | 规则 | 输入一个或多个规则 ID。 |
   | 运算符 | 指定用于与阈值进行比较的比较运算符： &lt;=,<br>\&gt;=,<br>=,<br>\&gt;= |
   | 值 | 输入阈值。此值设置一个限制或边界，在其之上或之下应观察到某种情况。此字段接受从 0 开始的数值。 |
   | 类型 | 输入以下其中一种阈值类型：百分比 或 数值。 |

   示例：
   ```
   {
     "name": "cloud-migration", 
     "description": "This specification contains rules related best practices for Talend Cloud Migration", 
     "rules": [
         "30599ac4-09b0-4abd", "30599ac4-09b0-4abc" 
         ], 
         "threshold": {
             "operator": "=", 
             "value": 0, 
             "type": "PERCENTAGE" 
          }
   }
   ```
5. 点击执行以发出您的调用。

## 结果

规范已创建。