全部产品
Search
文档中心

智能商业分析 Quick BI:QueryWorksByWorkspace - 查询工作空间下的所有作品

更新时间:Aug 28, 2026

查询组织下某个工作空间下的所有作品,可指定作品类型。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

quickbi-public:QueryWorksByWorkspace

list

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

WorkspaceId

string

是

工作空间 ID。

89713491-cb4f-4579-b889-e82c35f1****

WorksType

string

否

作品类型。取值范围:

  • DATAPRODUCT:数据门户

  • PAGE:仪表板

  • FULLPAGE:全屏仪表板

  • REPORT:电子表格

PAGE

Status

integer

否

作品状态。取值范围:

  • 0:未发布

  • 1:已发布

  • 2:已修改未发布

  • 3:已下线

0

ThirdPartAuthFlag

integer

否

第三方嵌入状态。取值范围:

  • 0:暂未开通嵌入

  • 1:已开通嵌入

0

PageNum

integer

否

页码。

  • 默认值 1。

1

PageSize

integer

否

每页行数。

  • 默认值 10。

10

返回参数

名称

类型

描述

示例值

object

Success

boolean

是否请求成功。取值范围:

  • true:请求成功

  • false:请求失败

true

RequestId

string

请求 ID。

D787E1A3-A93C-424A-B626-C2B05DF8D885

Result

object

返回组织工作空间下所有符合请求条件的作品列表。

Data

array<object>

作品列表详情。

array<object>

Auth3rdFlag

integer

第三方嵌入状态。取值范围:

  • 0:暂未开通嵌入

  • 1:已开通嵌入

1

Description

string

作品备注。

备注

Directory

object

作品所属目录。

Id

string

所属目录 ID。

83d37ba6-d909-48a2-a517-f4d05c3a****

Name

string

所属目录名称。

所属目录名称。

PathId

string

所属目录 ID 的层级结构,以『/』分隔。

83d37ba6-d909-48a2-a517-f4d05c3a****

PathName

string

所属目录名称的层级结构,以『/』分隔。

测试目录

GmtCreate

string

作品创建的毫秒级时间戳。

1496651577000

GmtModify

string

作品修改的毫秒级时间戳。

1572334870000

ModifyName

string

作品修改者的昵称。

张三

OwnerId

string

作品所有者在 Quick BI 的 UserID。

作品所属工作空间名称。

OwnerName

string

作品所有者的昵称。

李四

PublicFlag

boolean

是否公开

true

PublicInvalidTime

integer

报表公开的截止日期

1721366354000

SecurityLevel

string

作品协同授权的安全策略。取值:

  • 0:私密

  • 12:授权指定成员

  • 1 或 11:授权所有空间成员

说明
  • 若您使用旧版权限,则返回值为 1。

  • 若您使用新版权限,则返回值为 11。

0

Status

integer

仪表板,全屏仪表板,电子表格的状态。其他作品类型默认为 1,取值范围:

  • 0:未发布

  • 1:已发布

  • 2:已修改未发布

  • 3:已下线

1

WorkName

string

作品名称。

测试报表

WorkType

string

作品类型。取值范围:

  • DATAPRODUCT:数据门户

  • PAGE:仪表板

  • FULLPAGE:全屏仪表板

  • REPORT:电子表格

  • dashboardOfflineQuery:自助取数

  • ANALYSIS:即席分析

  • DATAFORM:表单填报

PAGE

WorksId

string

作品 ID。

897ce25e-f993-4abd-af84-d13c5610****

WorkspaceId

string

作品所属工作空间的 ID。

87c6b145-090c-43e1-9426-8f93be23****

WorkspaceName

string

作品所属工作空间名称。

测试工作空间

PageNum

integer

页码。

1

PageSize

integer

请求接口时设置的每页行数。

10

TotalNum

integer

总行数。

1

TotalPages

integer

总页码。

1

示例

正常返回示例

JSON格式

{
  "Success": true,
  "RequestId": "D787E1A3-A93C-424A-B626-C2B05DF8D885",
  "Result": {
    "Data": [
      {
        "Auth3rdFlag": 1,
        "Description": "备注",
        "Directory": {
          "Id": "83d37ba6-d909-48a2-a517-f4d05c3a****",
          "Name": "所属目录名称。",
          "PathId": "83d37ba6-d909-48a2-a517-f4d05c3a****",
          "PathName": "测试目录"
        },
        "GmtCreate": "1496651577000",
        "GmtModify": "1572334870000",
        "ModifyName": "张三",
        "OwnerId": "作品所属工作空间名称。",
        "OwnerName": "李四",
        "PublicFlag": true,
        "PublicInvalidTime": 1721366354000,
        "SecurityLevel": "0",
        "Status": 1,
        "WorkName": "测试报表",
        "WorkType": "PAGE",
        "WorksId": "897ce25e-f993-4abd-af84-d13c5610****",
        "WorkspaceId": "87c6b145-090c-43e1-9426-8f93be23****",
        "WorkspaceName": "测试工作空间"
      }
    ],
    "PageNum": 1,
    "PageSize": 10,
    "TotalNum": 1,
    "TotalPages": 1
  }
}

错误码

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

变更历史

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