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

获取指定委托的详细信息

功能介绍

该接口用来获取指定委托的详细信息。

URI

  • URI格式

    GET /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。

  • 请求样例
    curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X GET 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。

    trust_domain_name

    String

    委托租户的名称。

    description

    String

    委托的描述。

    duration

    String

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

    expire_time

    String

    委托的到期时间。

    create_time

    String

    委托的创建时间。

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

状态码

状态码

说明

200

请求成功。

401

认证失败。

403

鉴权失败。

404

不存在对应的委托。

500

内部服务错误。