查询规则集列表-V2 - ListAllCriterionSets
功能介绍
该接口用于查询规则集列表,返回规则集详细信息。支持按照语言、规则集名字等筛选。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| codeartscheck::listRuleSets | List | - | - | - | - |
URI
GET /v2/all-criterionsets
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| languages | 否 | String | 参数解释: 规则语言,多个以英文逗号分隔。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
| search | 否 | String | 参数解释: 搜索关键字。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| page_size | 否 | Integer | 参数解释: 每页规则集数量。 约束限制: 不涉及。 取值范围: 1-50 默认取值: 10 |
| page | 否 | Integer | 参数解释: 规则集页数。 约束限制: 不涉及。 取值范围: 0-999 默认取值: 1 |
| my_create | 否 | String | 参数解释: 是否查询我创建的规则集。 约束限制: 不涉及。 取值范围:
默认取值: false |
| project_id | 否 | String | 参数解释: 项目的32位UUID,项目唯一标识,通过查询项目列表接口获取。 约束限制: 不涉及。 取值范围: 字符集为大小写字母和数字,字符串长度不少于1,不超过128。 默认取值: 不涉及。 |
| is_call_status | 否 | String | 参数解释: 是否查询使用状态。 约束限制: 不涉及。 取值范围:
默认取值: true。 |
| sort_field | 否 | String | 参数解释: 排序参数。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
| sort_order | 否 | String | 参数解释: 排序参数。 约束限制: 不涉及。 取值范围:
默认取值: up。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 长度为[1~100000]个字符。 默认取值: 不涉及。 |
| operator | 否 | String | 参数解释: 操作人,填写账号用户名。 约束限制: 不涉及。 取值范围: 字符串长度不少于1,不超过128。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| httpStatus | String | 参数解释: HTTP响应状态。 取值范围:
|
| result | CriterionSetsInfo object | 参数解释: 规则列表。 取值范围: 不涉及。 |
| status | String | 参数解释: 接口响应状态。 取值范围:
|
| 参数 | 参数类型 | 描述 |
|---|---|---|
| criterionSetList | Array of CriterionSetListV2Body objects | 参数解释: 规则列表。 取值范围: 不涉及。 |
| total | Integer | 参数解释: 规则总数。 取值范围: ≥0 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 规则集ID。 取值范围: 不涉及。 |
| name | String | 参数解释: 规则集中文名称。 取值范围: 不涉及。 |
| comments | String | 参数解释: 规则集中文描述。 取值范围: 不涉及。 |
| type | String | 参数解释: 规则集类型。 取值范围:
|
| creator | String | 参数解释: 规则集创建者。 取值范围: 用户名。 |
| createTime | String | 参数解释: 规则集创建时间。 取值范围: 0时区标准时间。 |
| lastReviser | String | 参数解释: 规则集最近一次更新的操作人。 取值范围: 用户名。 |
| lastUpdateTime | String | 参数解释: 规则集最近一次更新的时间。 取值范围: 0时区标准时间。 |
| language | String | 参数解释: 规则集语言。 取值范围:
|
| parentId | String | 参数解释: 父规则集ID。 取值范围: 32位UUID组成的字符串。多个ID之间用逗号分隔。 |
| numCriterion | Integer | 参数解释: 规则集中已启用的规则数量。 取值范围: ≥0 |
| canEdit | Boolean | 参数解释: 当前用户是否具有修改该规则集的权限。 取值范围:
|
| canDelete | Boolean | 参数解释: 当前用户是否具有删除该规则集的权限。 取值范围:
|
| managers | String | 参数解释: 规则集管理员。 取值范围: 用户ID。多个ID用逗号分隔。 |
| parentSetNames | String | 参数解释: 父规则集的名称。 取值范围: 多个规则集名称之间用逗号分隔。 |
| domainId | String | 参数解释: 租户ID。 取值范围: 32位UUID。 |
| inheritMode | String | 参数解释: 继承类型。 取值范围:
|
| creatorId | String | 参数解释: 创建者用户ID。 取值范围: 32位UUID。 |
| isSystemDefault | String | 参数解释: 是否为系统默认规则集。 取值范围:
|
| isProjectDefault | String | 参数解释: 是否为项目默认规则集。 取值范围:
|
| isSystemSet | String | 参数解释: 是否为系统规则集。 取值范围:
|
| ruleIds | String | 参数解释: 规则集中已启用的能力规则unique_id。 取值范围: unique_id为32位UUID。多个unique_id之间用逗号分隔。 |
| region | String | 参数解释: 规则集所在局点。 取值范围: 不涉及。 |
| canSetDefault | Boolean | 参数解释: 是否具有设置默认规则集的权限。 取值范围:
|
| isUsed | Boolean | 参数解释: 规则集是否被使用。 取值范围:
|
| childSets | Array of strings | 参数解释: 子规则集。 取值范围: 不涉及。 |
| isReliable | Boolean | 参数解释: 是否为可信规则集。该字段已弃用。 取值范围:
|
| isRecommand | String | 参数解释: 是否为推荐规则集。该字段已弃用。 取值范围:
|
| isDefault | Boolean | 参数解释: 是否为默认规则集。该字段已弃用。 取值范围:
|
| defaultSet | String | 参数解释: 是否为默认规则集。该字段已弃用。 取值范围:
|
| deptId | String | 参数解释: 该字段已弃用。 取值范围: 不涉及。 |
| deptName | String | 参数解释: 该字段已弃用。 取值范围: 不涉及。 |
| reliableTag | String | 参数解释: 该字段已弃用。 取值范围: 不涉及。 |
| recommandType | String | 参数解释: 该字段已弃用。 取值范围: 不涉及。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误描述。 取值范围: 不涉及。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误描述。 取值范围: 不涉及。 |
请求示例
GET https://{endpoint}/v2/all-criterionsets?project_id=8c7c74775f4f496596e4a39d34b209c3&languages=JAVA&page=1&page_size=10&is_call_status=false 响应示例
状态码:200
query criterionsets
{
"httpStatus" : "OK",
"result" : {
"criterionSetList" : [ {
"businessId" : "",
"businessName" : "",
"canDelete" : true,
"canEdit" : true,
"childSets" : [ ],
"comments" : "",
"createTime" : "2020-11-13 15:35:06.0",
"creator" : "SYSTEM",
"creatorId" : "",
"deptId" : "",
"deptName" : "",
"detecteObjType" : "biz_code",
"id" : "24519a31060141708a0c61c1ac75e672",
"isProjectDefault" : "0",
"isRecommand" : "0",
"isReliable" : true,
"isSystemDefault" : "0",
"isSystemSet" : "0",
"lastReviser" : "SYSTEM",
"lastUpdateTime" : "2020-11-13 15:35:06",
"managers" : "",
"name" : "三层运营规则集",
"numCriterion" : 0,
"order" : 1,
"parentFolderId" : "",
"parentSetNames" : "",
"recommandType" : "0",
"reliableTag" : "",
"type" : "dir"
} ],
"total" : 1
},
"status" : "success"
} 状态码:400
Bad Request
{
"error_code" : "CC.xxxxxxxx.400",
"error_msg" : "请求参数校验失败,请检查请求参数是否正确。"
} 状态码:401
Unauthorized
{
"error_code" : "CC.00000003",
"error_msg" : "认证信息过期。"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | query criterionsets |
| 400 | Bad Request |
| 401 | Unauthorized |
错误码
请参见错误码。