调用GetDataServiceFolder查询数据服务文件夹。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| TenantId |
integer |
否 |
该字段已废弃。租户 ID。您可登录 DataWorks 控制台,进入数据开发(DataStudio)页面,单击右上方当前登录用户名称,选择菜单 > 用户信息,获取租户 ID。 |
10003 |
| ProjectId |
integer |
是 |
工作空间的 ID。 可通过 ListProjects 响应中的 PageResult.ProjectList[].ProjectId 获取。 通过 ListProjects 获取工作空间 ID 时,请先确认账号已开通该接口要求的 DataWorks 版本并具备相应权限;示例 ID 仅用于展示格式。 |
10002 |
| FolderId |
integer |
是 |
文件夹的 ID。 可通过 ListDataServiceFolders 响应中的 FolderPagingResult.Folders[].FolderId 获取。 |
10001 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回数据。 |
||
| RequestId |
string |
请求 ID,一次请求的唯一标识。 |
0000-ABCD-EF**** |
| Folder |
object |
文件夹详情。 |
|
| ParentId |
integer |
父文件夹 ID。业务流程下根文件夹 ID 等于 0,用户创建文件夹 ID 大于 0。 |
0 |
| ModifiedTime |
string |
文件夹的编辑时间。 格式示例为 |
2020-09-24T18:37:51+0800 |
| GroupId |
string |
文件夹所属业务流程的 ID。 |
ds_1234 |
| FolderId |
integer |
文件夹的 ID。 |
11 |
| ProjectId |
integer |
工作空间的 ID。 |
10001 |
| FolderName |
string |
文件夹的名称。 |
test1 |
| CreatedTime |
string |
文件夹的创建时间。 格式示例为 |
2020-09-24T18:37:51+0800 |
| TenantId |
integer |
租户 ID。 |
10002 |
示例
正常返回示例
JSON格式
{
"RequestId": "0000-ABCD-EF****",
"Folder": {
"ParentId": 0,
"ModifiedTime": "2020-09-24T18:37:51+0800",
"GroupId": "ds_1234",
"FolderId": 11,
"ProjectId": 10001,
"FolderName": "test1",
"CreatedTime": "2020-09-24T18:37:51+0800",
"TenantId": 10002
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 500 | InternalError.System | An internal system error occurred. Try again later. | |
| 500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | |
| 403 | Forbidden.Access | Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. | 没有权限,请授权 |
| 429 | Throttling.Api | The request for this resource has exceeded your available limit. | |
| 429 | Throttling.System | The DataWorks system is busy. Try again later. | |
| 429 | Throttling.User | Your request is too frequent. Try again later. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。