文档首页/ 智能数据湖 AIDataLake/ API参考/ 委托管理/ 查询服务委托 - ShowV2Agency
更新时间：2026-07-13 GMT+08:00
查看PDF
分享

查询服务委托 - ShowV2Agency

功能介绍

查询授权给AI DataLake服务的委托。用户调用该接口查询已授权给AI DataLake的委托，以及委托中具体的权限内容。此接口为同步接口，无配套使用接口和特殊场景。

调用方法

请参见如何调用API。

URI

GET /v2/agencies/{agency_name}

表1 路径参数

参数

是否必选

参数类型

描述

agency_name

是

String

参数解释：委托名称。

约束限制：固定值ai_datalake_admin_trust。

取值范围：不涉及。

默认取值：不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：用户Token。

约束限制：不涉及。

取值范围：长度不超过65534个字符。

默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

agency_name

String

参数解释：委托名称。

取值范围：固定值ai_datalake_admin_trust。

authorized

Boolean

参数解释：授权与否。如果用户的服务委托权限包含系统所需要的委托权限则返回true，否则返回false。

取值范围：

  • true：已授权。

  • false：未授权。

create_time

String

参数解释：资源创建时间。

取值范围：ISO 8601格式，yyyy-MM-dd'T'HH:mm:ss.SSSZ，UTC时间。

agency_policies

Array of V2AgencyPolicy objects

参数解释：委托策略列表。
表4 V2AgencyPolicy

参数

参数类型

描述

policy_name

String

参数解释：权限策略名称，指定授权给AI DataLake服务的权限策略。

取值范围：

  • AI_DATALAKE_COMMON_POLICY：基础服务相关权限策略。

  • AI_DATALAKE_SELF_POLICY：服务自身访问权限策略，用于服务内部资源访问。

  • AI_DATALAKE_SMN_POLICY：消息通知功能相关权限策略，用来将系统通知消息转发到SMN。

  • AI_DATALAKE_LAKEFORMATION_POLICY：LakeFormation功能相关权限策略。

  • AI_DATALAKE_AOM_POLICY：AOM功能相关权限策略。

  • AI_DATALAKE_SWR_POLICY：镜像包注册功能相关权限策略。

  • AI_DATALAKE_LTS_POLICY：日志功能相关权限策略。

  • AI_DATALAKE_VPCEP_POLICY：网络打通功能相关权限策略。

  • AI_DATALAKE_DNS_POLICY：DNS相关权限策略。

  • AI_DATALAKE_OBS_POLICY：OBS相关权限策略。

  • AI_DATALAKE_VPC_POLICY：VPC相关权限策略。

  • AI_DATALAKE_DCS_POLICY：DCS相关权限策略。

  • AI_DATALAKE_DEW_POLICY：DEW相关权限策略。

display_name

String

参数解释：权限策略名称。

取值范围：长度0~128个字符。

is_required

Boolean

参数解释：是否是必需的。

取值范围：

  • true：必需。

  • false：非必需。

is_enable

Boolean

参数解释：是否已开启。

取值范围：

  • true：已开启。

  • false：未开启。

description

String

参数解释：策略描述。

取值范围：长度为0~128个字符。

action_details

Array of ActionDetail objects

参数解释：权限策略的action详情列表，详细说明该策略包含的权限操作。

create_time

String

参数解释：资源创建时间。

取值范围：ISO 8601格式，yyyy-MM-dd'T'HH:mm:ss.SSSZ，UTC时间。
表5 ActionDetail

参数

参数类型

描述

action

String

参数解释：权限操作内容。

取值范围：长度0~128个字符。

action_description

String

参数解释：权限操作的描述，说明该操作的具体含义。

取值范围：长度0~1024个字符。

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

取值范围：长度为8~36个字符。

error_msg

String

参数解释：错误描述。

取值范围：长度为2~512个字符。

solution_msg

String

参数解释：解决方案。

取值范围：长度为0~4096个字符。

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

取值范围：长度为8~36个字符。

error_msg

String

参数解释：错误描述。

取值范围：长度为2~512个字符。

solution_msg

String

参数解释：解决方案。

取值范围：长度为0~4096个字符。

状态码：403

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

取值范围：长度为8~36个字符。

error_msg

String

参数解释：错误描述。

取值范围：长度为2~512个字符。

solution_msg

String

参数解释：解决方案。

取值范围：长度为0~4096个字符。

状态码：404

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

取值范围：长度为8~36个字符。

error_msg

String

参数解释：错误描述。

取值范围：长度为2~512个字符。

solution_msg

String

参数解释：解决方案。

取值范围：长度为0~4096个字符。

状态码：408

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

取值范围：长度为8~36个字符。

error_msg

String

参数解释：错误描述。

取值范围：长度为2~512个字符。

solution_msg

String

参数解释：解决方案描述。

取值范围：长度为0~4096个字符。

状态码：500

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

取值范围：长度为8~36个字符。

error_msg

String

参数解释：错误描述。

取值范围：长度为2~512个字符。

solution_msg

String

参数解释：解决方案。

取值范围：长度为0~4096个字符。

请求示例

查询对于本服务的授权情况。

GET /v2/agencies/ai_datalake_admin_trust

响应示例

状态码：200

请求成功。

{
  "agency_name" : "ai_datalake_alpha_admin_trust",
  "authorized" : true,
  "create_time" : "2026-04-09T08:10:33.000+00:00",
  "agency_policies" : [ {
    "policy_name" : "AI_DATALAKE_AOM_POLICY",
    "display_name" : "运维管理 AOM",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用运维管理服务所需的权限。",
    "action_details" : [ {
      "action" : "aom:metric:put",
      "action_description" : "上报指标"
    }, {
      "action" : "aom:alarm:put",
      "action_description" : "上报告警"
    } ],
    "create_time" : "2026-03-23T08:24:57.602+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_COMMON_POLICY",
    "display_name" : "通用基础 Common",
    "is_required" : true,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用基础通用服务所需的权限。",
    "action_details" : [ {
      "action" : "iam:agencies:listAgencies",
      "action_description" : "列举委托"
    }, {
      "action" : "iam:roles:getRole",
      "action_description" : "查询角色"
    }, {
      "action" : "iam:roles:listRoles",
      "action_description" : "列举角色"
    }, {
      "action" : "iam:permissions:listRolesForAgency",
      "action_description" : "查询委托的角色权限"
    }, {
      "action" : "iam:users:getUser",
      "action_description" : "查询用户"
    }, {
      "action" : "obs:bucket:ListAllMyBuckets",
      "action_description" : "列举所有桶"
    }, {
      "action" : "obs:bucket:ListBucket",
      "action_description" : "列举桶"
    }, {
      "action" : "obs:object:GetObjectVersion",
      "action_description" : "获取对象版本"
    }, {
      "action" : "obs:object:GetObject",
      "action_description" : "获取对象"
    } ],
    "create_time" : "2026-03-10T04:20:24.801+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_DCS_POLICY",
    "display_name" : "分布式缓存服务 DCS",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用 Ray 连接 Redis 所需的权限。",
    "action_details" : [ {
      "action" : "dcs:instance:get",
      "action_description" : "获取DCS实例详情"
    }, {
      "action" : "dcs:instance:getConfiguration",
      "action_description" : "获取DCS实例配置"
    }, {
      "action" : "dcs:ssl:get",
      "action_description" : "获取SSL证书信息"
    }, {
      "action" : "dcs:aclaccount:list",
      "action_description" : "查询ACL账户列表"
    }, {
      "action" : "dcs:instance:list",
      "action_description" : "查询DCS实例列表"
    }, {
      "action" : "dcs:ssl:modify",
      "action_description" : "修改实例SSL配置"
    } ],
    "create_time" : "2026-04-14T07:17:52.333+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_DEW_POLICY",
    "display_name" : "密码安全中心 DEW",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用 Ray 连接 DEW 所需的权限。",
    "action_details" : [ {
      "action" : "csms:secret:get",
      "action_description" : "获取密钥信息"
    }, {
      "action" : "csms:secretVersion:get",
      "action_description" : "获取密钥版本信息"
    }, {
      "action" : "kms:dek:crypto",
      "action_description" : "加密数据密钥"
    }, {
      "action" : "kms:dek:decrypt",
      "action_description" : "解密数据密钥"
    } ],
    "create_time" : "2026-04-15T07:07:44.120+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_DNS_POLICY",
    "display_name" : "DNS服务 DNS",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用 DNS 服务所需的权限。",
    "action_details" : [ {
      "action" : "dns:zone:get",
      "action_description" : "查询Zone"
    }, {
      "action" : "dns:zone:create",
      "action_description" : "创建Zone"
    }, {
      "action" : "dns:zone:list",
      "action_description" : "列举Zone"
    }, {
      "action" : "dns:zone:delete",
      "action_description" : "删除Zone"
    }, {
      "action" : "dns:recordset:update",
      "action_description" : "更新记录集"
    }, {
      "action" : "dns:recordset:create",
      "action_description" : "创建记录集"
    }, {
      "action" : "dns:recordset:delete",
      "action_description" : "删除记录集"
    }, {
      "action" : "dns:recordset:list",
      "action_description" : "列举记录集"
    } ],
    "create_time" : "2026-03-10T04:20:25.359+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_LAKEFORMATION_POLICY",
    "display_name" : "湖仓构建 LakeFormation",
    "is_required" : true,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用 LakeFormation 服务所需的权限。",
    "action_details" : [ {
      "action" : "lakeformation:accessTenant:grant",
      "action_description" : "授予租户访问权限"
    }, {
      "action" : "lakeformation:access:delete",
      "action_description" : "删除访问权限"
    }, {
      "action" : "lakeformation:access:create",
      "action_description" : "创建访问权限"
    }, {
      "action" : "lakeformation:access:describe",
      "action_description" : "查询访问权限"
    }, {
      "action" : "lakeformation:table:describe",
      "action_description" : "查询表详情"
    }, {
      "action" : "lakeformation:credential:describe",
      "action_description" : "查询凭证信息"
    }, {
      "action" : "lakeformation:policy:describe",
      "action_description" : "查询策略信息"
    }, {
      "action" : "lakeformation:table:drop",
      "action_description" : "删除表"
    }, {
      "action" : "lakeformation:table:create",
      "action_description" : "创建表"
    }, {
      "action" : "lakeformation:policy:create",
      "action_description" : "创建策略"
    }, {
      "action" : "lakeformation:database:describe",
      "action_description" : "查询数据库详情"
    }, {
      "action" : "lakeformation:table:alter",
      "action_description" : "修改表属性"
    }, {
      "action" : "lakeformation:policy:describe",
      "action_description" : "查询策略信息"
    }, {
      "action" : "lakeformation:credential:describe",
      "action_description" : "查询凭证信息"
    }, {
      "action" : "lakeformation:function:describe",
      "action_description" : "查询函数详情"
    }, {
      "action" : "lakeformation:catalog:describe",
      "action_description" : "查询Catalog详情"
    }, {
      "action" : "lakeformation:database:create",
      "action_description" : "创建数据库"
    }, {
      "action" : "lakeformation:database:drop",
      "action_description" : "删除数据库"
    }, {
      "action" : "lakeformation:function:create",
      "action_description" : "创建函数"
    }, {
      "action" : "lakeformation:function:alter",
      "action_description" : "修改函数属性"
    }, {
      "action" : "lakeformation:function:drop",
      "action_description" : "删除函数"
    }, {
      "action" : "lakeformation:policy:drop",
      "action_description" : "删除策略"
    }, {
      "action" : "lakeformation:role:describe",
      "action_description" : "查询角色详情"
    }, {
      "action" : "lakeformation:user:describe",
      "action_description" : "查询用户详情"
    }, {
      "action" : "lakeformation:transaction:operate",
      "action_description" : "操作事务"
    } ],
    "create_time" : "2026-03-10T04:20:24.582+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_LTS_POLICY",
    "display_name" : "日志服务 LTS",
    "is_required" : true,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用日志功能所需的权限。",
    "action_details" : [ {
      "action" : "lts:groups:get",
      "action_description" : "查询日志组"
    }, {
      "action" : "lts:groups:list",
      "action_description" : "列举日志组"
    }, {
      "action" : "lts:groups:create",
      "action_description" : "创建日志组"
    }, {
      "action" : "lts:topics:get",
      "action_description" : "查询日志流"
    }, {
      "action" : "lts:topics:list",
      "action_description" : "列举日志流"
    }, {
      "action" : "lts:topics:create",
      "action_description" : "创建日志流"
    } ],
    "create_time" : "2026-03-10T04:20:24.243+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_OBS_POLICY",
    "display_name" : "对象存储 OBS",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用 OBS 所需的权限。",
    "action_details" : [ {
      "action" : "obs:bucket:CreateBucket",
      "action_description" : "创建桶"
    }, {
      "action" : "obs:bucket:DeleteBucket",
      "action_description" : "删除桶"
    }, {
      "action" : "obs:bucket:PutLifecycleConfiguration",
      "action_description" : "设置生命周期配置"
    }, {
      "action" : "obs:bucket:ListBucketMultipartUploads",
      "action_description" : "列举分段上传"
    }, {
      "action" : "obs:bucket:HeadBucket",
      "action_description" : "判断桶是否存在"
    }, {
      "action" : "obs:bucket:ListAllMyBuckets",
      "action_description" : "列举所有桶"
    }, {
      "action" : "obs:bucket:ListBucket",
      "action_description" : "列举桶"
    }, {
      "action" : "obs:bucket:PutEncryptionConfiguration",
      "action_description" : "设置加密配置"
    }, {
      "action" : "obs:bucket:PutBucketObjectLockConfiguration",
      "action_description" : "设置对象锁定配置"
    }, {
      "action" : "obs:object:PutObject",
      "action_description" : "上传对象"
    }, {
      "action" : "obs:object:GetObject",
      "action_description" : "获取对象"
    }, {
      "action" : "obs:object:DeleteObject",
      "action_description" : "删除对象"
    }, {
      "action" : "obs:bucket:GetLifecycleConfiguration",
      "action_description" : "获取生命周期配置"
    } ],
    "create_time" : "2026-03-10T04:20:25.164+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_SELF_POLICY",
    "display_name" : "自身服务 Self",
    "is_required" : true,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用自身服务所需的权限。",
    "action_details" : [ {
      "action" : "DataArtsFabric:workspace:list",
      "action_description" : "列举工作空间"
    }, {
      "action" : "DataArtsFabric:endpoint:show",
      "action_description" : "查看端点"
    }, {
      "action" : "DataArtsFabric:workspace:showImage",
      "action_description" : "Fabric 服务使用自身服务所需的权限。"
    }, {
      "action" : "DataArtsFabric:workspace:listRoute",
      "action_description" : "查询工作空间路由"
    }, {
      "action" : "DataArtsFabric:endpoint:list",
      "action_description" : "列举端点"
    }, {
      "action" : "DataArtsFabric:job:dropJobInstance",
      "action_description" : "删除作业实例"
    }, {
      "action" : "DataArtsFabric:job:listJobInstance",
      "action_description" : "列举作业实例"
    }, {
      "action" : "DataArtsFabric:workspace:showSession",
      "action_description" : "查看会话"
    }, {
      "action" : "DataArtsFabric:workspace:listMessagePolicy",
      "action_description" : "列举消息策略"
    }, {
      "action" : "DataArtsFabric:workspace:executeStatement",
      "action_description" : "执行语句"
    }, {
      "action" : "DataArtsFabric:workspace:showStatementResult",
      "action_description" : "查看语句结果"
    }, {
      "action" : "DataArtsFabric:workspace:deleteSqlSession",
      "action_description" : "删除SQL会话"
    }, {
      "action" : "DataArtsFabric:workspace:cancelStatement",
      "action_description" : "取消语句"
    }, {
      "action" : "DataArtsFabric:workspace:createSqlSession",
      "action_description" : "创建SQL会话"
    }, {
      "action" : "DataArtsFabric:workspace:listSessionStatementRecords",
      "action_description" : "列举会话语句记录"
    }, {
      "action" : "DataArtsFabric:workspace:listSqlSessions",
      "action_description" : "列举SQL会话"
    }, {
      "action" : "DataArtsFabric:workspace:listStatementRecords",
      "action_description" : "列举语句记录"
    }, {
      "action" : "DataArtsFabric:workspace:showSqlSession",
      "action_description" : "查看SQL会话"
    }, {
      "action" : "DataArtsFabric:sparkJob:list",
      "action_description" : "查询Spark Job作业列表"
    }, {
      "action" : "DataArtsFabric:sparkSql:list",
      "action_description" : "查询Spark Sql作业列表"
    } ],
    "create_time" : "2026-03-10T04:20:24.426+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_SWR_POLICY",
    "display_name" : "镜像服务 SWR",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用镜像包注册功能所需的权限。",
    "action_details" : [ {
      "action" : "swr:repo:listRepoDomains",
      "action_description" : "列举镜像仓库组织"
    }, {
      "action" : "swr:repo:listRepoTags",
      "action_description" : "列举镜像标签"
    }, {
      "action" : "swr:repo:createRepoDomain",
      "action_description" : "创建镜像仓库"
    }, {
      "action" : "swr:repo:getRepo",
      "action_description" : "获取镜像仓库"
    }, {
      "action" : "swr:system:createLoginSecret",
      "action_description" : "生成临时登录指令"
    }, {
      "action" : "swr:repo:download",
      "action_description" : "下载镜像"
    } ],
    "create_time" : "2026-03-10T04:20:25.786+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_VPC_POLICY",
    "display_name" : "虚拟私有云 VPC",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用 VPC 所需的权限。",
    "action_details" : [ {
      "action" : "vpc:peerings:get",
      "action_description" : "查询对等连接详情"
    }, {
      "action" : "vpc:peerings:create",
      "action_description" : "创建对等连接"
    }, {
      "action" : "vpc:peerings:accept",
      "action_description" : "接受对等连接"
    }, {
      "action" : "vpc:peerings:delete",
      "action_description" : "删除对等连接"
    }, {
      "action" : "vpc:peerings:update",
      "action_description" : "更新对等连接"
    }, {
      "action" : "vpc:routes:delete",
      "action_description" : "删除虚拟私有云路由"
    }, {
      "action" : "vpc:routes:create",
      "action_description" : "创建虚拟私有云路由"
    }, {
      "action" : "vpc:routes:list",
      "action_description" : "查询虚拟私有云路由列表"
    }, {
      "action" : "vpc:routeTables:get",
      "action_description" : "查询路由表详情"
    }, {
      "action" : "vpc:routeTables:update",
      "action_description" : "更新路由表"
    }, {
      "action" : "vpc:routeTables:create",
      "action_description" : "创建路由表"
    }, {
      "action" : "vpc:routeTables:associate",
      "action_description" : "关联路由表"
    }, {
      "action" : "vpc:routeTables:delete",
      "action_description" : "删除路由表"
    }, {
      "action" : "vpc:routeTables:list",
      "action_description" : "查询路由表列表"
    } ],
    "create_time" : "2026-03-23T02:59:32.908+00:00"
  }, {
    "policy_name" : "AI_DATALAKE_VPCEP_POLICY",
    "display_name" : "网络连接 VPCEP",
    "is_required" : false,
    "is_enable" : true,
    "description" : "AI DataLake 服务使用连接用户网络所需的权限。",
    "action_details" : [ {
      "action" : "vpcep:epservices:get",
      "action_description" : "查询终端节点服务"
    }, {
      "action" : "vpcep:connections:update",
      "action_description" : "更新连接"
    }, {
      "action" : "vpcep:permissions:update",
      "action_description" : "更新权限"
    }, {
      "action" : "vpcep:permissions:list",
      "action_description" : "列举权限"
    }, {
      "action" : "vpcep:epserviceDesc:get",
      "action_description" : "查询终端节点服务描述"
    }, {
      "action" : "vpcep:endpoints:get",
      "action_description" : "查询终端节点"
    }, {
      "action" : "vpcep:endpoints:delete",
      "action_description" : "删除终端节点"
    }, {
      "action" : "vpcep:endpoints:create",
      "action_description" : "创建终端节点"
    }, {
      "action" : "vpcep:connections:list",
      "action_description" : "列举连接"
    }, {
      "action" : "vpcep:endpoints:list",
      "action_description" : "列举终端节点"
    } ],
    "create_time" : "2026-03-10T04:20:25.014+00:00"
  } ]
}

状态码：400

请求参数错误。

{
  "error_code" : "AIDataLake.00010011",
  "error_msg" : "Invalid specification code.",
  "solution_msg" : "Enter a correct specification code."
}

状态码：401

未授权。

{
  "error_code" : "APIGW.0301",
  "error_msg" : "Incorrect IAM authentication information decrypt token fail"
}

状态码：403

禁止访问。

{
  "error_code" : "AIDataLake.00010038",
  "error_msg" : "Unauthorized requests.",
  "solution_msg" : "Check permissions {xxx} and retry after authorization."
}

状态码：404

资源未找到。

{
  "error_code" : "AIDataLake.00010004",
  "error_msg" : "Not Found",
  "solution_msg" : "Please check the resource ID and try again"
}

状态码：408

请求超时。

{
  "error_code" : "common.00000408",
  "error_msg" : "timeout exception occurred"
}

状态码：500

内部服务器错误。

{
  "error_code" : "AIDataLake.00010067",
  "error_msg" : "Failed to initialize the task because the number of tasks may have reached the upper limit.",
  "solution_msg" : "Try again later."
}

状态码

状态码

描述

200

请求成功。

400

请求参数错误。

401

未授权。

403

禁止访问。

404

资源未找到。

408

请求超时。

500

内部服务器错误。
父主题： 委托管理

相关文档