更新时间:2025-08-19 GMT+08:00

配置授权

功能介绍

配置授权接口用于配置ModelArts的授权。该接口适用于以下场景:当需要为IAM子用户设置访问ModelArts的权限时,管理员可通过此接口配置授权。使用该接口的前提条件是管理员具备IAM系统的Security Administrator权限,并且需要为子用户设置访问密钥。配置完成后,子用户将被授予访问ModelArts资源的权限,从而能够正常使用训练管理、开发环境、数据管理、在线服务等功能。若管理员无权限操作或子用户不存在,接口将返回相应的错误信息。

调试

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

URI

POST /v2/{project_id}/authorizations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

user_id

String

参数解释:用户ID,获取方法请参见获取用户ID和名称。当user_id为all时,表示对所有IAM子用户进行授权,如果已有部分用户已授权,则更新授权。仅当授权类型为委托时,需要该字段。

约束限制:不涉及。

取值范围:字符串长度在3到32个字符之间,支持大小写字母、数字、中划线。

默认取值:不涉及。

type

String

参数解释:授权类型。推荐使用委托方式。

约束限制:不涉及。

取值范围:枚举类型,取值如下:

  • AGENCY:委托

  • CREDENTIAL:访问密钥(AK/SK)

默认取值:不涉及。

content

String

参数解释:授权内容。

约束限制

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

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

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

默认取值:不涉及。

secret_key

String

参数解释:秘密访问密钥(SK)。

约束限制:仅当授权类型为访问密钥时,需要该字段。

取值范围:字符串长度为40,支持大小写字母、数字。

默认取值:不涉及。

user_name

String

参数解释:用户名。

约束限制:当user_id为all-users时,显示为所有用户。

取值范围:不涉及。

默认取值:不涉及。

user_type

String

参数解释:用户类型。

约束限制:不涉及。

取值范围:枚举类型,取值如下:

  • IAM:授权对象类型是IAM子用户,必传字段user_id。

  • FEDERATE:授权对象类型是联邦用户,必传字段user_name,user_id不传。

  • GRANT:授权对象类型是委托用户,必传字段user_id,值为委托用户的委托id。

  • ALL-USERS:授权对象类型是所有用户,必传字段user_id值是all。

默认取值:IAM。

响应参数

状态码:200

OK。

请求示例

上传授权。设置授权类型为“agency”,授权内容为“modelarts_agency”。

POST https://{endpoint}/v2/{project_id}/authorizations

{
  "user_id" : "****d80fb058844ae8b82aa66d9fe****",
  "type" : "agency",
  "content" : "modelarts_agency"
}

响应示例

状态码:200

OK。

{
  "result" : "true"
}

状态码

状态码

描述

200

OK。

400

Bad Request。

401

Unauthorized。

403

Forbidden。

404

Not Found。

错误码

请参见错误码