更新时间:2024-09-05 GMT+08:00
分享

查询应用组授权记录

功能介绍

查询应用内已授权的用户列表。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/app-groups/actions/list-authorizations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

单次查询的大小[1-100]。

offset

Integer

查询的偏移量。

app_group_id

String

应用组ID。

account

String

应用授权的用户(组)名称,精确查询。

account_type

String

应用授权的用户(组)类型:

  • 'USER' - 用户

  • 'USER_GROUP' - 用户组

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

count

Integer

总数。

authorizations

Array of Authorization objects

授权信息。

表5 Authorization

参数

参数类型

描述

id

String

授权ID。

account_id

String

用户ID(或用户组ID)。

account

String

用户名(或用户组名)。

app_id

String

应用ID (按照组授权时,该字段为空)。

app_name

String

应用名称 (按照组授权时,该字段为空)。

app_group_id

String

应用组ID。

app_group_name

String

应用组名称。

authorization_type

String

授权类型,基于应用(组)授权,默认为APP_GROUP授权。

  • APP - 按照应用授权(尚未支持)。

  • APP_GROUP - 按照应用组授权。

account_type

String

用户类型。

platform_type

String

平台类型。

domain

String

域名城。

create_at

String

发布时间。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码: 401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码: 403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码: 404

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码: 405

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码: 500

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码: 503

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

请求示例

GET /v1/a4da8115c9d8464ead3a38309130523f/app-groups/actions/list-authorizations?limit=10&app_group_id=575772274859184146&offset=0

响应示例

状态码: 200

成功响应。

{
  "count" : 1,
  "authorizations" : [ {
    "account" : "user000",
    "app_id" : "",
    "app_name" : "",
    "app_group_id" : "575772274859184146",
    "app_group_name" : "开放性API创建应用组测试",
    "authorization_type" : "APP_GROUP",
    "account_type" : "USER",
    "domain" : "wksapp***.huawei.com",
    "create_at" : "2023-06-06T14:14:05.576Z"
  } ]
}

状态码

状态码

描述

200

成功响应。

400

由于包含语法错误,当前请求无法被服务器理解。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

405

请求中指定的方法不被允许。

500

服务内部错误,具体返回错误码请参见错误码说明。

503

服务不可用。

错误码

请参见错误码

相关文档