更新时间:2022-08-16 GMT+08:00

修改委托

功能介绍

该接口提供修改委托的信息,包括租户的trust_domain_id、description、trust_domain_name字段。

URI

  • URI格式

    PUT /v3.0/OS-AGENCY/agencies/{agency_id}

  • URI参数说明

    参数

    是否为必选

    类型

    说明

    agency_id

    String

    委托的ID。

请求消息

  • Request Header参数说明

    参数

    是否为必选

    类型

    说明

    Content-Type

    String

    该字段内容填为“application/json;charset=utf8”

    X-Auth-Token

    String

    已认证的拥有Security Administrator权限的token。

  • Request Body参数说明

    属性

    是否为必选

    类型

    说明

    trust_domain_id

    String

    委托租户的ID,且委托租户必须已存在。

    trust_domain_name

    String

    委托租户的名称,且委托租户必须已存在。

    description

    String

    委托的描述。

    请求体中的trust_domain_id和trust_domain_name两者二选一,即有一个存在即可,两者都存在的话,以trust_domain_name为主。

  • 请求样例
    curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X PUT -d '{"agency" : {"trust_domain_id" : "35d7706cedbc49a18df0783d00269c20","trust_domain_name" : "exampledomain","description" : "111111"}}' https:///v3.0/OS-AGENCY/agencies/2809756f748a46e2b92d58d309f67291

响应消息

  • Response Body参数说明

    参数

    必选/可选

    类型

    描述

    agency

    JSONObject

    委托对象。

  • agency格式说明

    参数

    必选/可选

    类型

    描述

    id

    String

    委托的ID。

    name

    String

    委托的名称。

    domain_id

    String

    当前租户的ID。

    trust_domain_id

    String

    委托租户的ID。

    description

    String

    委托的描述。

    duration

    String

    委托的期限。默认为null,表示不过期。

    expire_time

    String

    委托的到期时间。

    create_time

    String

    委托的创建时间。

  • 响应示例(请求成功)
    {
      "agency" : {
         "description" : " testsfdas ",
         "trust_domain_id" : "3ebe1024db46485cb02ef08d3c348477",
         "id" : "c1a06ec7387f430c8122d6f336c66dcf",
         "duration" : null,
         "create_time" : "2017-01-06T05:56:09.738212",
         "expire_time" : null,
         "domain_id" : "0ae9c6993a2e47bb8c4c7a9bb8278d61",
         "name" : "exampleagency"
        }
    }
  • 响应样例(请求失败)
    {
      "error": {
        "message": "TrustDomainNotFound",
        "code": 404,
        "title": "Not Found"
      }
    }

状态码

状态码

说明

200

请求成功。

400

参数错误。

401

认证失败。

403

鉴权失败。

404

未找到相应的资源。

500

内部服务错误。