创建委托
调试
您可以在API Explorer中调试该接口。
URI
POST /v3.0/OS-AGENCY/agencies
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Content-Type |
是 |
String |
该字段内容填为“application/json;charset=utf8”。 |
X-Auth-Token |
是 |
String |
访问令牌，承载用户的身份、权限等信息。 token所需权限请参见授权项。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
是 |
object |
委托信息。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
name |
是 |
String |
委托名，长度不大于64位。 |
domain_id |
是 |
String |
委托方账号ID。 |
trust_domain_id |
否 |
String |
被委托方账号ID。trust_domain_id和trust_domain_name至少填写一个，若都填写优先校验trust_domain_name。 |
trust_domain_name |
否 |
String |
被委托方账号名。trust_domain_id和trust_domain_name至少填写一个，若都填写优先校验trust_domain_name。 |
description |
否 |
String |
委托描述信息，长度不大于255位。 |
duration |
否 |
String |
委托的期限，单位为“天”。默认为FOREVER。 取值范围：
|
响应参数
参数 |
参数类型 |
描述 |
|---|---|---|
object |
委托信息。 |
参数 |
参数类型 |
描述 |
|---|---|---|
create_time |
String |
委托创建时间。
说明：
UTC时间，格式为 YYYY-MM-DDTHH:mm:ss.ssssssZ，日期和时间戳格式参照 ISO-8601，如：2023-06-28T08:56:33.710000Z。 |
description |
String |
委托描述信息。 |
domain_id |
String |
委托方账号ID。 |
duration |
String |
委托的期限，单位为“小时”。
|
expire_time |
String |
委托过期时间。“null”表示不过期。
说明：
UTC时间，格式为 YYYY-MM-DDTHH:mm:ss.ssssssZ，日期和时间戳格式参照 ISO-8601，如：2023-06-28T08:56:33.710000Z。 |
id |
String |
委托ID。 |
name |
String |
委托名。 |
trust_domain_id |
String |
被委托方账号ID。 |
trust_domain_name |
String |
被委托方账号名。 |
请求示例
创建一个名为“IAMAgency”的委托，被委托账号ID是c2cd82a33fb043dc9304bf72a...，账号名是IAMDomainB，委托的有效期限是永久。
POST https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies
{
"agency": {
"name": "IAMAgency",
"domain_id": "d78cbac186b744899480f25bd...",
"trust_domain_id": "c2cd82a33fb043dc9304bf72a...",
"trust_domain_name": "IAMDomainB",
"duration": "FOREVER",
"description": "IAMDescription"
}
}
响应示例
状态码为 201 时:
创建成功。
{
"agency": {
"description": "IAMDescription",
"trust_domain_id": "a2cd82a33fb043dc9304bf72a0f...",
"id": "078ade0fc20010004f8fc0034fad529d",
"duration": "FOREVER",
"create_time": "2020-01-20T12:59:20.811642",
"expire_time": null,
"domain_id": "d78cbac186b744899480f25bd02...",
"name": "IAMAgency"
}
}
返回值
返回值 |
描述 |
|---|---|
201 |
创建成功。 |
400 |
参数无效。 |
401 |
认证失败。 |
403 |
没有操作权限。 |
404 |
未找到相应的资源。 |
409 |
资源冲突。 |
500 |
内部服务错误。 |
错误码
无
