批量重试指定目录及其子目录下的所有失败数据源。
接口说明
请求说明
该 API 用于获取并重试指定用户个人目录(包括其所有子目录)中状态为 FAILED 的数据源。请求将立即返回,实际的重试任务将在后台异步执行。请注意,只有当前登录用户有权访问且属于其创建的资源才能被重试。
安全与权限
此操作需要适当的 RAM 权限。
只能对当前用户所属租户内的资源进行操作。
确保
tenantId和userId来自经过验证的身份信息。
注意事项
directoryId是必需参数,指定了要检查和重试失败数据源的目标目录。如果没有提供
tenantId,则默认使用调用方的租户 ID。API 支持多种认证方式,包括 AK、BearerToken 以及 APP 认证。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
winnexo:RetryDirectoryFailedSources |
create |
*全部资源
|
无 | 无 |
请求语法
POST /openapi/retryDirectoryFailedSources HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
租户 ID,公共参数;winnexo-cli 通过 --tenant-id 显式传入。 |
10000 |
| directoryId |
string |
是 |
企业知识库目录 ID(递归包含子目录下的失败资源)。 |
exampleDirectoryId |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
重试个人目录下所有失败数据源 |
||
| code |
string |
状态码。 |
200 |
| message |
string |
状态码描述。 |
ok |
| requestId |
string |
请求追踪 ID。 |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| directoryId |
string |
企业知识库目录 ID(递归包含子目录下的失败资源)。 |
exampleDirectoryId |
| failedCount |
integer |
目录下失败资源总数。 |
1 |
| enqueuedCount |
integer |
成功入队重试的数量。 |
1 |
| skippedCount |
integer |
跳过(非 FAILED 状态)的数量。 |
1 |
| enqueuedIds |
array |
已重新入队的来源 ID 列表。 |
string_value |
|
string |
已重新入队的来源 ID。 |
ID |
|
| failedSources |
array<object> |
失败的数据源 ID 列表 |
|
|
object |
失败的数据源 ID 列表 |
||
| sourceId |
string |
数据源 ID。 |
exampleSourceId |
| name |
string |
文件名。 |
示例名称.pdf |
| sourceType |
string |
数据源类型 |
string_value |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "ok",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"directoryId": "exampleDirectoryId",
"failedCount": 1,
"enqueuedCount": 1,
"skippedCount": 1,
"enqueuedIds": [
"ID"
],
"failedSources": [
{
"sourceId": "exampleSourceId",
"name": "示例名称.pdf",
"sourceType": "string_value"
}
]
}