Automation Cloud API 指南

上次更新日期 2026年1月30日

创建规则

在组织中创建新的授权规则。

Endpoint

POST /api/Rule

请求正文

字段	类型	必填	描述
`name`	字符串	是	规则名称
`description`	字符串	否	规则目的说明
`enabled`	布尔值	是	规则是否处于活动状态
`definition`	字符串	否	规则定义，以 JSON 编码的字符串形式表示。
`partitionGlobalId`	GUID	是	组织的全局标识符。有关检索`partitionGlobalId`的步骤，请参阅检索 API 使用的分区全局 ID 。

请求标头

--header 'Authorization: Bearer {access_token}'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'
--header 'Content-Type: application/json'

响应

备注：

响应会将创建的规则返回为RuleDto ，包括生成的id 。
partitionGlobalId可能会作为零 GUID 返回，具体取决于环境或规则提供程序的行为。
definition保留，并作为 JSON 编码的字符串返回。
如果创建时未解析任何组，则assignedGroups将以空数组 ( [] ) 的形式返回。

{
  "id": 3684,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}",
  "assignedGroups": []
}
{
  "id": 3684,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}",
  "assignedGroups": []
}

请求示例

{
  "name": "Test",
  "description": "Test",
  "partitionGlobalId": "47a714db-cd27-4250-9668-2054e008c448",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}"
}
{
  "name": "Test",
  "description": "Test",
  "partitionGlobalId": "47a714db-cd27-4250-9668-2054e008c448",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}"
}