创建委托

功能介绍

该接口提供创建委托关系的功能。

URI

POST /v3.0/OS-AGENCY/agencies

请求消息

• Request Header参数说明

  参数	必选/可选	类型	描述
  Content-Type	必选	String	application/json;charset=utf8
  X-Auth-Token	必选	String	已认证的拥有Security Administrator权限的token。

• Request Body参数说明

  参数	是否为必选	类型	说明
  name	是	String	委托的名称，长度不大于64位。
  domain_id	是	String	当前租户的ID。
  trust_domain_id	至少一个	String	委托租户的ID。
  trust_domain_name		String	委托租户的名称。
  description	否	String	委托的描述，长度不大于255位。
  duration	否	String	委托的期限，默认为null，表示委托不过期；取值为FOREVER，表示委托的期限为永久；取值为ONEDAY，表示委托的期限为一天。

  

  请求体中的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 POST -d'{"agency" : {"name" : "exampleagency","domain_id" : "0ae9c6993a2e47bb8c4c7a9bb8278d61","trust_domain_id" : "35d7706cedbc49a18df0783d00269c20","trust_domain_name" : "exampledomain","description" : "testsfdas"}}' https:///v3.0/OS-AGENCY/agencies

响应消息

• Response Body参数说明

  参数	必选/可选	类型	描述
  agency	是	JSONObject	委托对象。

• agency格式说明

  参数	必选/可选	类型	描述
  id	是	String	委托的ID。
  name	是	String	委托的名称。
  domain_id	是	String	当前租户的ID。
  trust_domain_id	是	String	委托租户的ID。
  description	是	String	委托的描述。
  duration	是	String	委托的期限。
  expire_time	是	String	委托的到期时间。
  create_time	是	String	委托的创建时间。

• 响应示例（请求成功）

  {
    "agency" : {
       "description" : "testsfdas",
       "trust_domain_id" : "35d7706cedbc49a18df0783d00269c20",
       "id" : "c1a06ec7387f430c8122d6f336c66dcf",
       "duration" : null,
       "create_time" : "2017-01-06T05:56:09.738212",
       "expire_time" : null,
       "domain_id" : "0ae9c6993a2e47bb8c4c7a9bb8278d61",
       "name" : "exampleagency"
      }
  }

• 响应样例（请求失败）

  {
      "error": {
          "message": "'name' is a required property",
          "code": 400,
          "title": "Bad Request"
      }
  }

状态码