更新时间:2024-07-25 GMT+08:00

查询角色的详细信息

功能介绍

该接口提供查询角色详细信息功能,包括角色中的权限策略,权限通过角色(Role)来表达,一个Role代表成一组action。

URI

  • URI格式

    GET /v3/roles/{role_id}

  • URI参数说明

    属性

    是否必选

    类型

    说明

    role_id

    String

    role的ID。

请求

  • Request Header参数说明

    参数

    是否必选

    类型

    说明

    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://sample.domain.com/v3/roles/19bb93eec4ca4f08aefdc02da76d8f3c

响应

  • Response Body参数说明

    参数

    是否必选

    类型

    说明

    role

    Dict

    role的详细信息。

  • role格式说明

    参数

    是否必选

    类型

    说明

    domain_id

    String

    role所属domain的ID。

    id

    String

    role的ID。

    links

    Dict

    role的资源链接。

    name

    String

    role的名称。

    type

    String

    role的显示模式,其中:

    • AX表示在domain层显示;
    • XA表示在project层显示;
    • AA表示在domain和project层均显示;
    • XX表示在domain和project层均不显示。

    display_name

    String

    role所展示的名称。

    catalog

    String

    role所在的目录。

    policy

    Dict

    role的具体策略。

    description

    String

    role的描述。

  • 响应样例
    {
      "role": {
        "display_name": "Tanent Guest",
        "description": "Tanent Guest",
        "links": {
          "self": "https://sample.domain.com/v3/roles/19bb93eec4ca4f08aefdc02da76d8f3c"
        },
        "domain_id": null,
        "catalog": "BASE",
        "policy": {
          "Version": "1.0",
          "Statement": [
            {
              "Action": [
                "::Get",
                "::List"
              ],
              "Effect": "Allow"
            },
            {
              "Action": [
                "identity:*"
              ],
              "Effect": "Deny"
            }
          ]
        },
        "id": "19bb93eec4ca4f08aefdc02da76d8f3c",
        "type": "AA",
        "name": "readonly"
      }
    }

状态码

状态码

说明

200

请求成功。

400

参数无效。

401

认证失败。

403

没有操作权限。

404

找不到资源。