A comprehensive reference of all available APIs - Quick BI - Alibaba Cloud - Quick BI

API standards and multilingual preset SDKs

The OpenAPI of this product (quickbi-public/2022-01-01) uses the RPC signature style. We have encapsulated SDKs for common programming languages for developers. Developers can download the SDK to directly call this product's OpenAPI without worrying about technical details. If the existing SDK does not meet your needs, you can use the signature mechanism for self-signing integration. Since the details of self-signing are very complex, it may take around 5 business days. Therefore, we recommend joining our DingTalk service group (147535001692) and conducting signature integration under expert guidance.

Before using the API, you need to prepare your identity account and access key (AccessKey) to effectively access the API through client tools (such as SDK and CLI). For details, see Obtain an AccessKey.

Custom signature scenarios

If your business scenario has special requirements and you need to integrate the API through self-signing, we recommend consulting our technical support team first (DingTalk service group: 147535001692) to obtain professional guidance and ensure efficient integration.

Account and security preparation

Alibaba Cloud accounts have full administrative permissions over all resources. Once an AccessKey is compromised, all associated resources will be at risk of unauthorized access. To ensure security, it is recommended to create a RAM user with only API access permissions and configure its AccessKey, while configuring RAM policies based on the principle of least privilege (PoLP). Use the Alibaba Cloud account only in specific scenarios where Alibaba Cloud account permissions are explicitly required.

Organization Management

API	Title	Description
Organization User Management	Organization User Management
CheckOrganizationMember	CheckOrganizationMember	Checks if a user is a member of an organization.
AddUser	Add Organization Member	Add organization members.
BatchAddFeishuUsers	Batch Add Feishu Users	Batch add Feishu users.
UpdateUser	UpdateUser	Update the information of a specific member in an organization.
QueryUserList	QueryUserList	Lists organization members.
QueryUserInfoByUserId	QueryUserInfoByUserId	Queries user information by user ID.
QueryUserInfoByAccount	QueryUserInfoByAccount	Queries user information by Alibaba Cloud ID or Alibaba Cloud account name.
Role Management	Role Management
ListWorkspaceUserRolesByUserId	ListWorkspaceUserRolesByUserId	Queries all workspace roles of a user.
ListOrganizationRoles	Get Organization Role List	Retrieve the list of custom roles at the organization level.

Permission Management

API	Title	Description
Report Sharing Authorization Management	Report Sharing Authorization Management
AddWorksAuthorization	AddWorksAuthorization	Adds an authorization for a work.
DataPortal Menu Authorization Management	DataPortal Menu Authorization Management
ListPortalMenuAuthorization	ListPortalMenuAuthorization	Retrieves a list of authorization details for the menus in a BI portal.
ListWhitePortalMenu	ListWhitePortalMenu	Retrieves the whitelist for a BI portal menu.
Row-Level Permission Management	Row-Level Permission Management
SetDataLevelPermissionRuleConfig	Set Single Dataset Row and Column Permission Configuration Information	Set single dataset row and column permission configuration information (addition and update)
AddDataLevelPermissionRuleUsers	AddDataLevelPermissionRuleUsers	Adds specified users and user groups to a row-level permission rule.
AddDataLevelPermissionWhiteList	AddDataLevelPermissionWhiteList	Modifies the whitelist for row-level and column-level permissions of a specified dataset.
DeleteDataLevelRuleConfig	DeleteDataLevelRuleConfig	Deletes a row-level permission rule.
DeleteDataLevelPermissionRuleUsers	DeleteDataLevelPermissionRuleUsers	Deletes specified users from a row-level permission rule.
UpdateDataLevelPermissionStatus	UpdateDataLevelPermissionStatus	Updates the row-level and column-level permission status for a dataset.
SetDataLevelPermissionExtraConfig	SetDataLevelPermissionExtraConfig	Set extra configuration for row and column permissions.
QueryDatasetSwitchInfo	QueryDatasetSwitchInfo	Get the row-level permission switch status for a specified dataset.

Resource Management

API	Title	Description
Report Resource Management	Report Resource Management
UpdateEmbeddedStatus	UpdateEmbeddedStatus	Change the embedding status of a report, turn on embedding, or turn off embedding.
QueryWorksByOrganization	Query All Works Under the Organization	Query all works under the entire organization, with the option to specify the type of work.
QueryReadableResourcesListByUserIdV2	Query List of Works User Has Permission to View (New)	Query list of works user has permission to view (new)
QueryEmbeddedStatus	QueryEmbeddedStatus	Queries whether embedding is enabled for a report.
Dataset Resource Management	Dataset Resource Management
UpdateDataSource	UpdateDataSource	Modifies a data source configuration.
CreateDataset	CreateDataset	Creates a dataset from a physical table.
CheckDatasetExisted	CheckDatasetExisted	Checks whether a dataset with the specified CubeId exists.
CreateCubeBySql	CreateCubeBySql	Creates a dataset from a custom SQL statement.
AddDataSource	AddDataSource	Adds a data source.
UpdateCubeBySql	UpdateCubeBySql	Updates a dataset that is based on a custom SQL statement.
QueryLastAccelerationEngineJob	QueryLastAccelerationEngineJob	Query the Most Recent Acceleration Task by Dataset ID
QueryDatasetInfo	QueryDatasetInfo	Indicates whether the table is a custom SQL table. Valid values: \\* true: custom SQL table \\* false: non-custom SQL table
QueryDatasetDetailInfo	QueryDatasetDetailInfo	Retrieves the details of a specified dataset, including its data source, directory, and dataset model.
QueryDatasetList	QueryDatasetList	Queries the datasets in a specified workspace. The results are sorted in descending order by creation time.
ListAccelerationOfWorkspace	ListAccelerationOfWorkspace	Retrieves information about acceleration tasks in a workspace.
QueryAccelerationLogByCubeId	QueryAccelerationLogByCubeId	Queries the run logs of acceleration tasks for a specified dataset.
Workspace Management	Workspace Management
CreateWorkspace	CreateWorkspace	Creates a workspace.
AddUserToWorkspace	Add Member to Workspace	Adds a member to a specified workspace.
QueryOrganizationWorkspaceList	Get Workspace List Under Organization	Lists the workspaces in the current organization.
Homepage Management	Homepage Management
ListCollections	ListCollections	Retrieve the list of works that a user has favorited.
Subscription Management	Subscription Management
GetMailTaskList	GetMailTaskList	Retrieves a list of tracking tasks. Note: If the caller's AccessKey (AK) does not have permission to view tracking tasks of other users, this operation returns only the tasks that the caller is authorized to access.

Data Management

API	Title	Description
Data Service	Data Service
QueryData	QueryData	Calls a DataService Studio API to query data.
QueryDataService	Invoke Data Service API	Invoke an already created API in the data service.

Embedding Analysis

API	Title	Description
Report Embedding	Report Embedding
CreateTicket	Generate Report Embedding Ticket	Generate a ticket for third-party embedding.
DeleteTicket	Delete Embedded Ticket	Delete Third-Party Embedded Ticket
DelayTicketExpireTime	DelayTicketExpireTime	Update the expiration time of the ticket embedded in the report.
UpdateTicketNum	UpdateTicketNum	Update the ticket quantity on the specified ticket used for the exemption embedded report.
QueryTicketInfo	QueryTicketInfo	Obtains the details of a specified ticket for a report that is not embedded in the report.

Statistical Analysis

API	Title	Description
Resource Analysis	Resource Analysis
QueryAuditLog	Query Audit Log Information	Queries audit log information.

SmartQ

API	Title	Description
SmartQ Embedding	SmartQ Embedding
CreateTicket4Copilot	Generate Smart Q Embedding Ticket	Generates a ticket to embed Copilot.
SmartQ Management	SmartQ Management
ModifyDashboardNl2sqlStatus	ModifyDashboardNl2sqlStatus	Modifies the Q-Assistant status for multiple dashboards.
QueryDashboardNl2sql	QueryDashboardNl2sql	Query Dashboard's Question Resource Information
SmartqAuthorize	Batch Management of Smart Q\\\\\\&A Authorizations	Manages authorizations for Intelligent Q&A in batches.
QueryLlmCubeWithThemeListByUserId	Check which datasets and analysis themes the user has question authorization for	Check which datasets and analysis themes the user has question authorization for
QuerySmartqPermissionByCubeId	Check if a user has permission for a specific smart question dataset	Queries the permissions of a user on a Smart Q&A dataset.
QueryDatasetSmartqStatus	Check if the Dataset has Enabled Smart Query	Checks whether Intelligent Q&A is enabled for a dataset.
SmartqQueryAbility	Smart Query	Runs an intelligent Q&A query.

Others

API	Title	Description
AddShareReport	Add data work sharing configuration	Add a sharing configuration for data works.
AddUserGroupMember	AddUserGroupMember	Adds an organization member to a specified user group.
AddUserGroupMembers	AddUserGroupMembers	Add users to a specified user group at a time.
AddUserTagMeta	Add Organization Member Tag Metadata	Add organization member tag metadata.
AddWorkspaceUsers	Batch Add Members to Workspace	Batch add members to the workspace.
AllotDatasetAccelerationTask	AllotDatasetAccelerationTask	Trigger the collection acceleration of the Quick engine for datasets.
AuthorizeMenu	AuthorizeMenu	Batch authorization of BI portal menu will be skipped automatically.
CancelAuthorizationMenu	Batch Cancel Data Portal Menu Authorization	Cancel the authorization records for specified users and user groups based on the portal menu ID.
CancelCollection	CancelCollection	Cancel the data works from the user's collection.
CancelReportShare	CancelReportShare	Delete a share authorization for a data work.
ChangeVisibilityModel	ChangeVisibilityModel	Modifies the visibility mode of the BI portal menu and whether the menu is only authorized to be visible.
CheckReadable	CheckReadable	Queries whether a user has permissions to view data works, such as dashboards and workbooks.
CreateUserGroup	CreateUserGroup	Create a user group. You can specify a parent user group.
DataSetBlood	DataSetBlood	Query works information under the specified dataset.
DataSourceBlood	Query dataset information under the specified data source	Query dataset information under the specified data source
DeleteUser	Delete Organization User	Delete the specified organization user.
DeleteUserFromWorkspace	Remove Workspace Member	Delete a member from the specified workspace.
DeleteUserGroup	DeleteUserGroup	Deletes a user group in an organization.
DeleteUserGroupMember	DeleteUserGroupMember	Deletes a specified member from a specified user group.
DeleteUserGroupMembers	DeleteUserGroupMembers	Batch remove specified users from user groups.
DeleteUserTagMeta	DeleteUserTagMeta	Deletes the tag metadata of an organization member.
GetDataSourceConnectionInfo	GetDataSourceConnectionInfo	Get Data Source Information
GetMailTaskStatus	GetMailTaskStatus	Check the running status of mail tasks within an organization
GetUserGroupInfo	Get User Group Information by Keyword	Search for user group information based on the keyword of the user group name.
GetWorksEmbedList	Get Embedded Reports	Query the list of embedded reports
ListApiDatasource	ListApiDatasource	Queries API data sources.
ListByUserGroupId	ListByUserGroupId	Queries user group information at a time by user group ID.
ListCubeDataLevelPermissionConfig	ListCubeDataLevelPermissionConfig	You can this operation to obtain a list of row and column permission configurations for a specified dataset.
ListDataLevelPermissionWhiteList	Get Dataset Row and Column Permission Whitelist	Retrieve the whitelist for dataset row and column permissions based on the type of permission.
ListDataSource	ListDataSource	Query all data sources under the specified space
ListFavoriteReports	Favorite Reports List on Home Dashboard	Overview
ListOrganizationRoleUsers	ListOrganizationRoleUsers	Get user list under the specified organization role.
ListPortalMenus	ListPortalMenus	Gets a hierarchical list of menus under a specific BI portal.
ListRecentViewReports	ListRecentViewReports	You can call this operation to obtain a list of the most frequently viewed and footsteps displayed in the homepage dashboard for a specified user.
ListSharedReports	ListSharedReports	You can this operation to obtain the list of authorized works displayed on the homepage of a specified user.
ListUserGroupsByUserId	ListUserGroupsByUserId	Queries all user groups to which a user belongs based on the user ID.
ListWorkspaceRoleUsers	ListWorkspaceRoleUsers	Get user list under the specified workspace role.
ListWorkspaceRoles	ListWorkspaceRoles	Get the list of workspace roles.
ManualRunMailTask	ManualRunMailTask	Manually Execute Email Task
ModifyApiDatasourceParameters	ModifyApiDatasourceParameters	Modifies the configurations of a specified API data source.
ModifyCopilotEmbedConfig	Modify Intelligent Query Embedding Configuration	Modify Intelligent Query Embedding Configuration
QueryApprovalInfo	QueryApprovalInfo	Get approval flow information based on the approver.
QueryComponentPerformance	QueryComponentPerformance	Queries component performance logs.
QueryCopilotEmbedConfig	Get the List of Configurations for Activating XiaoQ Embedding	Get the List of Configurations for Activating XiaoQ Embedding
QueryCubeOptimization	QueryCubeOptimization	Queries dataset optimization suggestions.
QueryCubePerformance	QueryCubePerformance	Queries the performance logs of a dataset.
QueryDataRange	Get Data Range Catalog List	Get Data Range Catalog List
QueryDataServiceList	QueryDataServiceList	Query Data Service API List
QueryEmbeddedInfo	QueryEmbeddedInfo	Obtain the embedding configuration in the organization, including the maximum number of embeddings and the number of embeddings.
QueryOrganizationRoleConfig	QueryOrganizationRoleConfig	Gets the configuration of the specified organization role.
QueryReadableResourcesListByUserId	QueryReadableResourcesListByUserId	Queries the list of works that a user has the permission to view, including the statements that are authorized to share in a space.
QueryReportPerformance	QueryReportPerformance	Queries report performance logs.
QueryShareList	Query the Sharing Records of a Work	Query the list of objects to which a work has been shared, returning only the sharing configurations that are still within their validity period.
QuerySharesToUserList	QuerySharesToUserList	You can call this operation to query the list of works authorized to a user.
QueryUserGroupListByParentId	QueryUserGroupListByParentId	You can this operation to obtain information about child user groups under a specified parent user group.
QueryUserGroupMember	Query User Group Member List	Retrieve the list of members under a user group.
QueryUserRoleInfoInWorkspace	Query Preset Roles of Workspace Members	Get the preset workspace role information for a specified workspace member.
QueryUserTagMetaList	QueryUserTagMetaList	Queries the metadata list of member tags in an organization.
QueryUserTagValueList	QueryUserTagValueList	Query the list of specific user tag values.
QueryWorks	QueryWorks	Queries information about a specified data work.
QueryWorksBloodRelationship	QueryWorksBloodRelationship	Obtains the kinship of a data work, including the datasets referenced by each component and query field information. Currently, only supported data works include dashboards, workbooks, and self-service data retrieval.
QueryWorksByWorkspace	QueryWorksByWorkspace	Queries all works in a workspace under an organization. You can specify the type of work.
QueryWorkspaceRoleConfig	QueryWorkspaceRoleConfig	Get Configuration Information for a Specified Workspace Role
QueryWorkspaceUserList	List Members Under a Workspace	Query the list of members under a specified workspace.
ResultCallback	ResultCallback	You can customize the callback interface for approval processes to process Quick BI approval processes.
SaveFavorites	Add Work to Favorites	Add a user's favorite work
SetDataLevelPermissionWhiteList	SetDataLevelPermissionWhiteList	Sets the whitelist for the specified row-level permissions.
SmartqAuthTransfer	Synchronize the question count permissions of a specified user to other users	Synchronize the question count permissions of a specified user to other users
UpdateUserGroup	UpdateUserGroup	Updates information about a specified user group in an organization.
UpdateUserTagMeta	UpdateUserTagMeta	Used for updating the metadata of organization member tags
UpdateUserTagValue	Update Organization Member Tag Value	Update the tag value of an organization member.
UpdateWorkspaceUserRole	Modify Workspace Member Role	Modify the role of a specified member under the workspace, existing roles will be overwritten.
UpdateWorkspaceUsersRole	Batch Update Workspace Member Roles	Batch update the role information of workspace members, existing roles will be overwritten
WithdrawAllUserGroups	WithdrawAllUserGroups	Make the user exit all user groups. This process is irreversible. Exercise caution when performing this operation.