# 创建组件规则

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/rules/category/components
payload:
    {
    "name": "string",
    "description": "string",
    "severity": "Info",
    "category": "Component",
    "threshold": {
      "operator": "string",
      "value": 0,
      "type": "Percentage"
    },
    "components": [
      "string"
    ],
    "parameters": [
      "string"
    ],
    "inputs": [
      "string"
    ],
    "exists": true
  }
```

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

## 程序

1. 调用 POST /api/v1/projects/quality/rules/category/component 端点以创建 组件 类别规则。 如果您想创建其他类别的规则，还有其他可用的端点。
2. 在 正文 区域中，输入以下信息：
   | 参数名称 | 值 |
   | --- | --- |
   | 名称 | 输入规则的名称。 |
   | 说明 | 输入规则的说明。 |
   | 严重性 | 输入规则的严重性。严重性是根据规则对项目质量的影响来设置的。您可以提供以下严重性类型之一：<br>信息、<br>次要、<br>主要、<br>严重。 |
   | 运算符 | 指定用于与阈值进行比较的比较运算符：&lt;=、\&gt;=、=、\&gt;= |
   | 值 | 输入阈值。此值设置一个限制或边界，在其之上或之下应观察到某种情况。此字段接受从 0 开始的数值。 |
   | 类型 | 输入以下其中一种阈值类型：百分比 或 数值。 |
   | 组件 | 输入连接器或组件名称。 |
   | 参数 | 作业中的每个组件或节点都可以有参数，例如代码、URL、URI。例如，tJava 组件有一个代码参数。<br><br>每个作业都可以有参数<br>(项目参数)，例如<br>隐式加载或<br>多线程执行。<br><br>每个连接可以有参数，例如<br>PARTITIONER 或<br>NUM\_PARTITIONS。 |
   | 输入 | 您可以添加正则表达式列表或任何文本来验证规则。 |
   | 存在 | 确定特定组件是否存在于作业中。这些值可以是真或假。 |

   示例：
   ```
    {
       "name": "Java Logs",
       "description": "Identify Jobs that contain java logs",
       "severity": "Info",
       "category": "Component",
       "threshold": {
         "operator": "<=",
         "value": 0,
         "type": "Numeric"
       },
       "components": [
         "tJava", "tJavaFlex", "tJavaRow"
       ],
       "parameters": [
         "CODE", "CODE_START", "CODE_MAIN", "CODE_END"
       ],
       "inputs": [
         "System.out.print", "System.err.print"
       ],
       "exists": true
     }
   ```
3. 点击执行以发出您的调用。

## 结果

规则已创建。