Skip to main content
PUT
批量为仓库建立索引

权限

需要使用服务用户或个人访问令牌。权限检查方式取决于你的组织如何管理代码仓库访问:
  • 组织级权限:调用方需要组织级别的 IndexOrgRepositories 权限。
  • 细粒度代码仓库授权:不检查 IndexOrgRepositories。调用方需要组织级别的 Read 权限,并且对请求中的每个代码仓库都拥有 repo.use_read 和 repo.index 两项授权。如果任一代码仓库缺少其中任一项授权,整个请求都会被拒绝,返回 403,且不会为任何代码仓库建立索引。

行为

此端点具有幂等性——使用相同的代码仓库多次调用它,不会创建重复的索引作业。它会为请求中的每个代码仓库启用索引,并触发相应的索引作业。 你也可以选择为每个代码仓库指定 branch_names,以索引特定分支。若省略,则使用默认分支。

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

路径参数

org_id
string
必填

组织 ID(前缀:org-)

示例:

"org-abc123def456"

请求体

application/json
repositories
RepositoryIndexingItem · object[]
必填
Required array length: 1 - 100 elements

响应

成功响应

branches
string[]
必填
indexing_enabled
boolean
必填
repository_path
string
必填
indexing_status
RepoIndexingStatusResponse · object | null