# 修改委托 - UpdateAgency #### 功能介绍 该接口可以用于++[管理员](https://support.huaweicloud.com/usermanual-iam/iam_01_0001.html)++ 修改委托。 该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：[地区和终端节点](https://developer.huaweicloud.com/endpoint?IAM)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IAM/doc?api=UpdateAgency)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iam/iam_19_0001.html)。 #### URI PUT /v3.0/OS-AGENCY/agencies/{agency_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | agency_id | 是 | String | 待修改的委托ID，获取方式请参见：[获取账号、IAM用户、项目、用户组、区域、委托的名称和ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html)。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | 该字段内容填为"application/json;charset=utf8"。 | | X-Auth-Token | 是 | String | 访问令牌，承载用户的身份、权限等信息。 token所需权限请参见[授权项](https://support.huaweicloud.com/api-iam/iam_19_0001.html)。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | [agency] | 是 | object | 委托信息。 | 表4agency | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 否 | object | 委托的期限，单位为"天"。四个参数至少填写一个。 取值范围： - FOREVER：表示委托的期限为永久。 - ONEDAY：表示委托的期限为一天。 - 自定义天数：表示委托的期限为有限天数，如20。 | #### 响应参数 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | [agency] | object | 委托信息。 | 表6agency | 参数 | 参数类型 | 描述 | |:---|:---|:---| | create_time | String | 委托创建时间。 说明： UTC时间，格式为YYYY-MM-DDTHH:mm:ss.ssssss，日期和时间戳格式如：2023-06-28T08:56:33.710000。 | | description | String | 委托描述信息。 | | domain_id | String | 委托方账号ID。 | | duration | object | 委托的期限，单位为"小时"。 - FOREVER/null：表示委托的期限为永久。 - 24：表示委托的期限为一天，即24小时。 - XXX：表示委托的期限为有限时间，如480小时。 | | expire_time | String | 委托过期时间。"null"表示不过期。 说明： UTC时间，格式为YYYY-MM-DDTHH:mm:ss.ssssss，日期和时间戳格式如：2023-06-28T08:56:33.710000。 | | id | String | 委托ID。 | | name | String | 委托名。 | | trust_domain_id | String | 被委托方账号ID。 | #### 请求示例 修改委托的有效时间为1天。 ``` PUT https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies/{agency_id} ``` ``` { "agency": { "trust_domain_id": "b2cd82a33fb043dc9304bf72...", "trust_domain_name": "IAMDomainB", "description": "IAMDescription", "duration": "ONEDAY" } } ``` #### 响应示例 **状态码为 200 时:** 修改成功。 ``` { "agency": { "description": "IAMDescription", "trust_domain_id": "b2cd82a33fb043dc9304bf72a0...", "id": "0760a9e2a60026664f1fc0031f9f205e", "duration": 24, "create_time": "2020-01-04T03:37:16.000000", "expire_time": "2020-01-21T13:06:11.241588", "domain_id": "d78cbac186b744899480f25...", "name": "IAMAgency" } } ``` #### 返回值 | 返回值 | 描述 | |:---|:---| | 200 | 修改成功。 | | 400 | 参数无效。 | | 401 | 认证失败。 | | 403 | 没有操作权限。 | | 404 | 未找到相应的资源。 | | 500 | 内部服务错误。 | #### 错误码 无