文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 委托/ 查询委托信息 - ListOpsAgencies
更新时间：2026-04-15 GMT+08:00
查看PDF
分享

查询委托信息 - ListOpsAgencies

功能介绍

该接口用于查询当前系统中已有的委托关系和授权信息，支持查看委托对象、权限范围和状态，适用于权限管理和委托关系维护的场景。

适用场景：

  • 查看和管理现有委托关系和授权状态。

  • 进行权限审计和合规性检查。

  • 维护和监控委托权限配置。

URI

GET /v1/ops/agencies

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释：

消息体编码格式。用于告知服务端请求体（Body）所采用的主体数据类型，以便服务端正确解析。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

application/json

Authorization

是

String

参数解释：

签名认证信息，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Sdk-Date

是

String

参数解释：

请求发送的时间，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

agencies

Array of OpsAgency objects

参数解释：

委托（Agency）或信任委托的列表。

取值范围：

不涉及。
表3 OpsAgency

参数

参数类型

描述

urn

String

参数解释：

统一资源名称（URN），用于唯一标识委托或信任委托。

取值范围：

不涉及。

trust_policy

String

参数解释：

信任策略文档的JSON字符串，定义了谁可以获取该委托。

取值范围：

不涉及。

agency_id

String

参数解释：

委托或信任委托的唯一标识符（ID）。

取值范围：

不涉及。

agency_name

String

参数解释：

委托或信任委托的显示名称。

取值范围：

不涉及。

请求示例

获取当前租户下配置的所有委托授权信息列表，用于检查服务代理权限的生效状态。

GET https://*.com/agentarts/v1/ops/agencies

无

响应示例

状态码：200

查询成功

{
  "agencies" : [ {
    "urn" : "iam::accountid:agency:name",
    "trust_policy" : "{\"Version\":\"5.0\",\"Statement\":[{\"Action\":[\"sts:agencies:assume\",\"sts::tagSession\",\"sts::setSourceIdentity\"],\"Effect\":\"Allow\",\"Principal\":{\"IAM\":[\"xxx\"]}}]}",
    "agency_id" : "string",
    "agency_name" : "name"
  } ]
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

父主题： 委托

相关文档