更新时间:2024-05-30 GMT+08:00

查看授权列表

功能介绍

查看授权列表。

调试

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

URI

GET /v2/{project_id}/authorizations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户项目ID。获取方法请参见获取项目ID和名称

表2 Query参数

参数

是否必选

参数类型

描述

sort_by

String

指定排序字段。枚举值如下:

  • user_name:IAM用户名称

  • create_time:创建时间

order

String

排序方式。枚举值如下:

  • asc:递增排序

  • desc:递减排序

limit

Integer

指定每一页返回的最大条目数,默认为1000。

取值范围[1,1000]。

offset

Integer

分页列表的起始页,默认为0。

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

total_count

Number

授权信息总数。

auth

Array of AuthorizationResponse objects

授权信息列表。

表4 AuthorizationResponse

参数

参数类型

描述

user_id

String

用户ID,获取方法请参见获取用户ID和名称

当user_id为all时,表示对所有IAM子用户进行授权,如果已有部分用户已授权,则更新授权。

仅当授权类型为委托时,需要该字段。

type

String

授权类型。推荐使用委托方式。

可选值:

  • agency:委托

  • credential:访问密钥(AK/SK)

content

String

授权内容。

  • 当授权类型是委托,该字段为委托名称。

  • 当授权类型是访问密钥,该字段为访问密钥ID(AK)。

secret_key

String

秘密访问密钥(SK)。仅当授权类型为访问密钥时,需要该字段。

user_name

String

用户名,当user_id为all-users时,显示为所有用户。

create_time

Long

创建时间戳。

请求示例

查看授权列表

GET https://{endpoint}/v2/{project_id}/authorizations

响应示例

状态码: 200

OK

{
  "total_count" : 1,
  "auth" : [ {
    "user_id" : "****d80fb058844ae8b82aa66d9fe****",
    "user_name" : "iam-user01",
    "type" : "agency",
    "content" : "modelarts_agency",
    "create_time" : 15657747821288
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码