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

查询指定条件下的委托列表信息

功能介绍

该接口用来获取指定条件下的委托列表信息。

URI

  • URI格式

    GET /v3.0/OS-AGENCY/agencies{?domain_id,name,trust_domain_id}

  • 查询参数说明

    参数

    是否为必选

    类型

    说明

    domain_id

    String

    当前租户的ID。

    name

    String

    委托的名称。

    trust_domain_id

    String

    被委托方租户的ID。

请求消息

  • Request Header参数说明

    参数

    是否为必选

    类型

    说明

    Content-Type

    String

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

    X-Auth-Token

    String

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

  • 请求样例
    curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X GET https:///v3.0/OS-AGENCY/agencies?domain_id=0ae9c6993a2e47bb8c4c7a9bb8278d61

响应消息

  • Response Body参数说明

    参数

    必选/可选

    类型

    描述

    agencies

    JSONArray

    委托列表。

  • agency格式说明

    参数

    必选/可选

    类型

    描述

    id

    String

    委托的ID。

    name

    String

    委托的名称。

    domain_id

    String

    当前租户的ID。

    trust_domain_id

    String

    委托租户的ID。

    trust_domain_name

    String

    委托租户的名称。

    description

    String

    委托的描述。

    duration

    String

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

    expire_time

    String

    委托的到期时间。

    create_time

    String

    委托的创建时间。

  • 响应示例(请求成功)
    {
      "agencies": [
        {
          "trust_domain_name": "exampledomain",
          "description": " testsfdas ",
          "trust_domain_id": "b3f266d0c08544a0859740de8b84e850",
          "id": "afca8ddf2e92469a8fd26a635da5206f",
          "duration": null,
          "create_time": "2017-01-04T09:09:15.000000",
          "expire_time": null,
          "domain_id": "0ae9c6993a2e47bb8c4c7a9bb8278d61",
          "name": "exampleagency"
        }
      ]
    }
  • 响应样例(请求失败)
    {
      "error": {
        "message": "You are not authorized to perform the requested action: identity:list_agencies",
        "code": 403,
        "title": "Forbidden"
      }
    }

状态码

状态码

说明

200

请求成功。

401

认证失败。

403

鉴权失败。

404

未找到相应的资源。

500

内部服务错误。