ListKnowledgeBaseAdministrators - 查询知识库管理员列表

更新时间:
复制 MD 格式

分页查询指定知识库的管理员。

接口说明

列出管理员。仅知识库 Owner 或管理员可操作,调用者与租户由 POP 认证上下文确定。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

KnowledgeBaseId

string

是

知识库 ID

12345678-1234-4234-8234-123456789abc

MaxResults

integer

否

每页条数,省略默认 20,范围 1 至 100。

20

NextToken

string

否

上一页返回的游标,首次不传

eyJvZmZzZXQiOjIwfQ

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

本次请求的唯一标识,可用于定位问题。

00000000-0000-4000-8000-000000000001

Success

boolean

请求是否成功

Data

object

成功时返回的业务数据。

KnowledgeBaseAdministrators

array<object>

本页管理员,不包含 Owner

object

KnowledgeBaseId

string

知识库 ID

12345678-1234-4234-8234-123456789abc

UserId

string

管理员的 DataWorks UserId

1000000000000000

DisplayName

string

用户展示名称,可选;不作为身份依据

用户甲

CreateTime

integer

该记录的创建时间,以毫秒级 Unix 时间戳表示。

1790200400000

NextToken

string

后续页游标;无后续页返回 null

eyJvZmZzZXQiOjIwfQ

MaxResults

integer

本次请求采用的每页条数上限;省略入参时为 20,不是本页实际返回条数

20

Code

string

业务错误码;请求失败时用于判断错误类型。

InvalidParameter

Message

string

请求失败时的安全错误信息。

请求参数不合法。

示例

正常返回示例

JSON格式

{
  "RequestId": "00000000-0000-4000-8000-000000000001",
  "Success": true,
  "Data": {
    "KnowledgeBaseAdministrators": [
      {
        "KnowledgeBaseId": "12345678-1234-4234-8234-123456789abc",
        "UserId": "1000000000000000",
        "DisplayName": "用户甲",
        "CreateTime": 1790200400000
      }
    ],
    "NextToken": "eyJvZmZzZXQiOjIwfQ",
    "MaxResults": 20
  },
  "Code": "InvalidParameter",
  "Message": "请求参数不合法。"
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter The request parameters are invalid.
403 Forbidden You are not authorized to perform this operation.
404 ResourceNotFound The requested resource does not exist or is not visible.
503 ServiceUnavailable The service is temporarily unavailable.
409 Conflict The resource state conflicts with this operation.

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。