CreatePermissionRules - 创建权限规则-智能体构建和治理平台 AgentCore-阿里云帮助中心

创建权限规则。

接口说明

为指定工作空间中的资源批量创建权限规则。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:CreatePermissionRules

create

*Workspace

acs:agentcore:{#regionId}:{#accountId}:workspace/{#WorkspaceId}

无

请求语法

POST /workspaces/{workspaceId}/permission-rules HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
workspaceId	string	是	工作空间 ID	workspace-id

请求参数

名称	类型	必填	描述	示例值
body	object	否	创建权限规则的请求体。
rules	array<object>	是	待创建的权限规则列表。
	object	否	权限规则。
resourceType	string	是	资源类型。枚举值： MCP AGENT	AGENT
resourceId	string	是	资源 ID。	agent-1234567890
source	string	是	规则来源。枚举值： AgentCore	AgentCore
targetScope	string	是	目标范围。枚举值： ALL SPECIFIED	SPECIFIED
targets	array	否	规则作用目标列表。
	string	否	规则作用目标。	acs:agentcore:cn-hangzhou:1234567890123456:workspace/ws-1234567890
effect	string	是	授权效果。枚举值： PERMIT FORBID	ALLOW
enforcementMode	string	是	规则执行模式。枚举值： ENFORCE	ENFORCE
principalType	string	是	主体类型。枚举值： USER AGENT	USER
principalId	string	是	主体 ID。	1234567890123456
clientToken	string	否	幂等令牌	550e8400-e29b-41d4-a716-446655440000

返回参数

名称	类型	描述	示例值
	object
requestId	string	请求 ID。	1a2b3c4d-xxxx-xxxx-xxxx-xxxxxxxxxxxx
message	string	请求处理结果消息。	success
httpStatusCode	integer	HTTP 状态码。	200
code	string	业务状态码。	Success
success	boolean	请求是否成功。
data	object	创建结果。
rules	array<object>	已创建的权限规则列表。
	object	权限规则。
permissionRuleId	string	权限规则 ID。	pr-1234567890
resourceType	string	资源类型。枚举值： MCP AGENT	AGENT
resourceId	string	资源 ID。	agent-1234567890
source	string	规则来源。枚举值： AgentCore	AgentCore
sourceDetail	string	规则来源详情。枚举值： EXPLICIT TEAM	OpenAPI
targetScope	string	目标范围。枚举值： ALL SPECIFIED	SPECIFIED
targets	array	规则作用目标列表。
	string	规则作用目标。	acs:agentcore:cn-hangzhou:1234567890123456:workspace/ws-1234567890
effect	string	授权效果。枚举值： PERMIT FORBID	ALLOW
enforcementMode	string	规则执行模式。枚举值： ENFORCE	ENFORCE
principalType	string	主体类型。枚举值： USER AGENT	USER
principalId	string	主体 ID。	1234567890123456
principalName	string	主体名称。	example-user
createdAt	string	创建时间，RFC 3339 格式。	2026-01-01T00:00:00Z
updatedAt	string	更新时间，RFC 3339 格式。	2026-01-01T00:00:00Z

示例

正常返回示例

JSON格式

{
  "requestId": "1a2b3c4d-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "message": "success",
  "httpStatusCode": 200,
  "code": "Success",
  "success": true,
  "data": {
    "rules": [
      {
        "permissionRuleId": "pr-1234567890",
        "resourceType": "AGENT",
        "resourceId": "agent-1234567890",
        "source": "AgentCore",
        "sourceDetail": "OpenAPI",
        "targetScope": "SPECIFIED",
        "targets": [
          "acs:agentcore:cn-hangzhou:1234567890123456:workspace/ws-1234567890"
        ],
        "effect": "ALLOW",
        "enforcementMode": "ENFORCE",
        "principalType": "USER",
        "principalId": "1234567890123456",
        "principalName": "example-user",
        "createdAt": "2026-01-01T00:00:00Z",
        "updatedAt": "2026-01-01T00:00:00Z"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息
400	InvalidParameter	A permission rule parameter is invalid.
403	NoPermission	You are not authorized to perform this operation.
404	Resource.NotFound	The specified AgentCore workspace does not exist.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。