更新时间：2025-08-19 GMT+08:00
创建ModelArts委托
功能介绍
创建ModelArts委托接口用于创建包含OBS、SWR、IEF等依赖服务的ModelArts委托。该接口适用于以下场景：当需要配置ModelArts访问OBS、SWR、IEF等服务的权限时，用户可通过此接口创建委托。使用该接口的前提条件是用户具备创建委托的权限，并且需要在IAM系统中具备相应的权限。创建完成后，ModelArts将被授权访问OBS、SWR、IEF等服务，从而能够正常执行数据存储、镜像拉取、模型部署等功能。若用户无权限创建委托或依赖服务未配置，接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/agency
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：用户项目ID，获取方法请参见获取项目ID和名称。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
agency_name_suffix |
否 |
String |
参数解释：委托名称后缀。委托名称前缀固定为ma_agency。如该字段为iam-user01，则创建出来的委托名称为ma_agency_iam-user01。默认为空，表示创建名称为ma_agency的委托。 约束限制：不涉及。 取值范围：长度限制为50个字符。 默认取值：空。 |
响应参数
状态码：200
OK。
无
请求示例
创建ModelArts委托。设置委托名称后缀为“iam-user01”。
POST https://{endpoint}/v2/{project_id}/agency
{
"agency_name_suffix" : "iam-user01"
}
响应示例
状态码：200
OK。
{
"agency_name" : "ma_agency_iam-user01"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK。 |
|
400 |
Bad Request。 |
|
401 |
Unauthorized。 |
|
403 |
Forbidden。 |
|
404 |
Not Found。 |
错误码
请参见错误码。
父主题： 授权管理
