文档首页> 统一身份认证服务 IAM> API参考> API> 联邦身份认证管理> 查询联邦用户可以访问的帐号列表
更新时间:2023-07-05 GMT+08:00

查询联邦用户可以访问的帐号列表

功能介绍

该接口用于查询联邦用户可以访问的帐号列表。

该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见:地区和终端节点

URI

GET /v3/OS-FEDERATION/domains

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

联邦认证的unscoped token。

响应参数

表2 响应Body参数

参数

参数类型

描述

domains

Array of objects

帐号信息列表。

links

Object

资源链接信息。

表3 domains

参数

参数类型

描述

enabled

Boolean

是否启用帐号,true为启用,false为停用,默认为true。

id

String

帐号ID。

name

String

帐号名。

links

Object

帐号的资源链接信息。

description

String

帐号的描述信息。

请求示例

查询联邦用户可以访问的帐号列表。

GET https://iam.myhuaweicloud.com/v3/OS-FEDERATION/domains

响应示例

状态码为 200 时:

请求成功。

{
    "domains": [
        {
            "description": "",
            "enabled": true,
            "id": "d78cbac186b744899480f25bd022f468",
            "links": {
                "self": "https://iam.myhuaweicloud.com/v3/domains/d78cbac186b744899480f25bd022f468"
            },
            "name": "IAMDomain"
        }
    ],
    "links": {
        "self": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/domains"
    }
}

返回值

返回值

描述

200

请求成功。

400

参数无效。

401

认证失败。

403

没有操作权限。

405

不允许的方法。

413

请求体过大。

500

内部服务错误。

503

服务不可用。

错误码