文档首页/ 魔坊(ModelArts)模型训推平台/ API参考/ 授权管理/ 校验委托使用权限 - VerifyAgency
更新时间:2026-11-12 GMT+08:00

校验委托使用权限 - VerifyAgency

功能介绍

校验当前用户是否有权使用指定委托,仅支持委托给ModelArts服务的委托,通过PDP5的iam:agencies:pass鉴权判定

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /v2/{project_id}/atelier/agency/verify

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:用户项目ID,获取方法请参见获取项目ID和名称。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

agency_name

是

String

参数解释:

授权内容。

  • 当授权类型是委托,该字段为委托名称。

  • 当授权类型是访问密钥,该字段为访问密钥ID(AK)。

取值范围:长度限制64个字符。

响应参数

状态码:200

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表4 响应Body参数

参数

参数类型

描述

is_authorized

Boolean

是否有权使用该委托,true表示有权,false表示无权

agency_name

String

参数解释:

授权内容。

  • 当授权类型是委托,该字段为委托名称。

  • 当授权类型是访问密钥,该字段为访问密钥ID(AK)。

取值范围:长度限制64个字符。

状态码:400

表5 响应Header参数

参数

参数类型

描述

X-request-id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

{
  "agency_name" : "modelarts_agency"
}

响应示例

状态码:200

{
  "agency_name" : "modelarts_agency",
  "is_authorized" : true
}

状态码

状态码

描述

200

委托校验成功响应

400

Error response

错误码

请参见错误码。