转移仓库 - TransferRepository
功能介绍
将仓库转移到其他代码组
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
当前API调用无需身份策略权限。
URI
POST /v4/repositories/{repository_id}/transfer
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
repository_id | 是 | Integer | 参数解释: 仓库的ID,通过查询用户所有仓库接口查询项目列表获取。 约束限制: 不涉及。 默认取值: 不涉及。 取值范围: 1~2147483647 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
namespace | 否 | String | 参数解释: 命名空间路径。 约束限制: 必填。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
id | Integer | 参数解释: 仓库ID。 取值范围: 1~2147483647 |
description | String | 参数解释: 仓库描述信息。 |
name | String | 参数解释: 仓库名称。 |
name_with_namespace | String | 参数解释: 仓库完整名称。 |
path | String | 参数解释: 仓库路径。 |
path_with_namespace | String | 参数解释: 仓库完整路径。 |
created_at | String | 参数解释: 创建时间。 |
updated_at | String | 参数解释: 更新时间。 |
archived | Boolean | 参数解释: 是否归档。 |
ssh_url_to_repo | String | 参数解释: 仓库ssh地址。 |
http_url_to_repo | String | 参数解释: 仓库http地址。 |
project_id | String | 参数解释: 仓库所属项目ID。 |
project_name | String | 参数解释: 仓库所属项目名称。 |
develop_mode | String | 参数解释: 仓库开发模式。 取值范围: |
moderation_result | Boolean | 参数解释: 审核状态。 |
default_branch | String | 参数解释: 仓库默认分支 约束限制: 不涉及。 |
avatar_url | String | 参数解释: 仓库图标url 约束限制: 不涉及。 |
star_count | Integer | 参数解释: 关注数 约束限制: 不涉及。 取值范围: 1~2147483647 |
forks_count | Integer | 参数解释: fork数 约束限制: 不涉及。 取值范围: 1~2147483647 |
open_issues_count | Integer | 参数解释: 开启issue数 约束限制: 不涉及。 取值范围: 1~2147483647 |
open_merge_requests_count | Integer | 参数解释: 开启中的CR、MR数量 约束限制: 不涉及。 取值范围: 1~2147483647 |
last_activity_at | String | 参数解释: 最后活跃时间 约束限制: 不涉及。 |
namespace | NamespaceBasicDto object | 参数解释: 命名空间 约束限制: 不涉及。 |
empty_repo | Boolean | 参数解释: 空仓库 约束限制: 不涉及。 |
starred | Boolean | 参数解释: 是否已关注 约束限制: 不涉及。 |
visibility | String | 参数解释: 仓库可见等级 约束限制: 不涉及。 |
security_tag | String | 参数解释: 仓库保密等级 约束限制: 不涉及。 |
security | String | 参数解释: 仓库保密等级 约束限制: 不涉及。 |
network_type | String | 参数解释: 网络类型 约束限制: 不涉及。 |
owner | RepositoryUserBasicDto object | 参数解释: 仓库所有者 约束限制: 不涉及。 |
creator | RepositoryUserBasicDto object | 参数解释: 仓库创建者 约束限制: 不涉及。 |
creator_id | Integer | 参数解释: 创建者ID 约束限制: 不涉及。 取值范围: 1~2147483647 |
forked_from_repository | RepositorySimpleDto object | 参数解释: fork仓库源仓 约束限制: 不涉及。 |
encryption_status | String | 参数解释: 仓库加密状态 取值范围: 默认取值: 不涉及。 |
repo_encryption_enabled | Boolean | 参数解释: 是否开启仓库加密 取值范围: |
uuid | String | 参数解释: 仓库唯一标识符。 约束限制: 不涉及。 |
ancestor_ids | Array of integers | 参数解释: 祖先仓库ID列表。 约束限制: 不涉及。 取值范围: 1~2147483647 |
ancestor_names | Array of strings | 参数解释: 祖先仓库名称列表。 约束限制: 不涉及。 |
import_status | String | 参数解释: 导入状态。 约束限制: 不涉及。 |
import_url | String | 参数解释: 导入源地址。 约束限制: 不涉及。 |
import_error | String | 参数解释: 导入错误信息。 约束限制: 不涉及。 |
repo_type | String | 参数解释: 仓库类型。 约束限制: 不涉及。 |
only_allow_merge_if_pipeline_succeeds | Boolean | 参数解释: 是否仅在流水线成功时允许合并。 约束限制: 不涉及。 |
request_access_enabled | Boolean | 参数解释: 是否启用访问请求。 约束限制: 不涉及。 |
only_allow_merge_if_all_discussions_are_resolved | Boolean | 参数解释: 是否仅在所有检视意见解决时允许合并。 约束限制: 不涉及。 |
merge_method | String | 参数解释: 合并方法。 约束限制: 不涉及。 |
fork_network_repositories | Array of RepositoryIdentityDto objects | 参数解释: fork关联仓库列表。 约束限制: 不涉及。 |
permissions | PermissionsDto object | 权限 |
repository_type | String | 参数解释: 仓库类型。 约束限制: 不涉及。 |
statistics | RepositoryStatisticsDto object | 参数解释: 项目统计信息。 约束限制: 不涉及。 |
branch_count | Integer | 参数解释: 分支数量。 约束限制: 不涉及。 取值范围: 1~2147483647 |
tag_count | Integer | 参数解释: Tag数量。 约束限制: 不涉及。 取值范围: 1~2147483647 |
label_count | Integer | 参数解释: 标签数量。 约束限制: 不涉及。 取值范围: 1~2147483647 |
member_count | Integer | 参数解释: 成员数量。 约束限制: 不涉及。 取值范围: 1~2147483647 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | Integer | 参数解释: 命名空间ID。 约束限制: 不涉及。 取值范围: 1~2147483647 |
name | String | 参数解释: 命名空间名称。 约束限制: 不涉及。 |
path | String | 参数解释: 路径。 约束限制: 不涉及。 |
develop_mode | String | 参数解释: 开发模式。 约束限制: 不涉及。 |
kind | String | 参数解释: 类型。 约束限制: 不涉及。 |
full_path | String | 参数解释: 完整路径。 约束限制: 不涉及。 |
full_name | String | 参数解释: 完整名称。 约束限制: 不涉及。 |
parent_id | Integer | 参数解释: 父级ID。 约束限制: 不涉及。 取值范围: 1~2147483647 |
visibility_level | Integer | 参数解释: 可见级别。 约束限制: 不涉及。 取值范围: 1~2147483647 |
enable_file_control | Boolean | 参数解释: 开启文件权限控制。 约束限制: 不涉及。 |
owner_id | Integer | 参数解释: 所有人ID。 约束限制: 不涉及。 取值范围: 1~2147483647 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | Integer | 参数解释: 用户id 约束限制: 不涉及。 取值范围: 1~2147483647 |
name | String | 参数解释: 用户名称 约束限制: 不涉及。 |
username | String | 参数解释: 用户名 约束限制: 不涉及。 |
state | String | 参数解释: 用户状态。 取值范围: |
service_license_status | Integer | 参数解释: 服务级权限状态 0:停用 1:启用 约束限制: 不涉及。 取值范围: 1~2147483647 |
name_cn | String | 参数解释: 用户中文名称 约束限制: 不涉及。 |
nick_name | String | 参数解释: 用户昵称 约束限制: 不涉及。 |
tenant_name | String | 参数解释: 租户名称 约束限制: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | Integer | 参数解释: 仓库ID。 取值范围: 1~2147483647 |
description | String | 参数解释: 仓库描述信息。 |
name | String | 参数解释: 仓库名称。 |
name_with_namespace | String | 参数解释: 仓库完整名称。 |
path | String | 参数解释: 仓库路径。 |
path_with_namespace | String | 参数解释: 仓库完整路径。 |
created_at | String | 参数解释: 创建时间。 |
updated_at | String | 参数解释: 更新时间。 |
archived | Boolean | 参数解释: 是否归档。 |
ssh_url_to_repo | String | 参数解释: 仓库ssh地址。 |
http_url_to_repo | String | 参数解释: 仓库http地址。 |
project_id | String | 参数解释: 仓库所属项目ID。 |
project_name | String | 参数解释: 仓库所属项目名称。 |
develop_mode | String | 参数解释: 仓库开发模式。 取值范围: |
moderation_result | Boolean | 参数解释: 审核状态。 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | Integer | 参数解释: 项目ID。 约束限制: 不涉及。 取值范围: 1~2147483647 |
path_with_namespace | String | 参数解释: 项目路径。 约束限制: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
repository_access | MemberAccess object | 参数解释: 仓库权限。 约束限制: 不涉及。 |
group_access | MemberAccess object | 参数解释: 代码组权限。 约束限制: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
access_level | Integer | 参数解释: 访问级别。 约束限制: 不涉及。 取值范围: 1~2147483647 |
notification_level | Integer | 参数解释: 通知级别。 约束限制: 不涉及。 取值范围: 1~2147483647 |
参数 | 参数类型 | 描述 |
|---|---|---|
commit_count | Integer | 参数解释: 提交数量。 约束限制: 不涉及。 取值范围: 1~2147483647 |
storage_size | Double | 参数解释: 存储大小。 约束限制: 不涉及。 取值范围: 1.0~1024000.0 |
repository_size | Double | 参数解释: 仓库大小。 约束限制: 不涉及。 取值范围: 1.0~1024000.0 |
lfs_objects_size | Double | 参数解释: LFS对象大小。 约束限制: 不涉及。 取值范围: 1.0~1024000.0 |
tenant_repo_size_limit | Long | 参数解释: 租户仓库大小限制。 约束限制: 不涉及。 取值范围: 1~2147483647 |
状态码:401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释: 错误码。 |
error_msg | String | 参数解释: 错误信息。 |
状态码:403
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释: 错误码。 |
error_msg | String | 参数解释: 错误信息。 |
请求示例
/api/v4/repositories/2112082075/transfer
{
"namespace" : "85983ce3309e4d06a2c5b48ce938c9b2/gg1"
} 响应示例
状态码:200
OK
{
"id" : 2112082075,
"description" : "",
"name" : "rr",
"name_with_namespace" : "85983ce3309e4d06a2c5b48ce938c9b2 / gg1 / rr",
"path" : "rr",
"path_with_namespace" : "85983ce3309e4d06a2c5b48ce938c9b2/gg1/rr",
"created_at" : "2025-12-23T11:03:25.000+08:00",
"updated_at" : "2025-12-23T03:28:13.000+08:00",
"archived" : false,
"ssh_url_to_repo" : "git@test.com:85983ce3309e4d06a2c5b48ce938c9b2/gg1/rr.git",
"http_url_to_repo" : "https://test.com/85983ce3309e4d06a2c5b48ce938c9b2/gg1/rr.git",
"project_id" : "85983ce3309e4d06a2c5b48ce938c9b2",
"project_name" : "encrypt_testsecurity_tag_code",
"develop_mode" : "normal",
"moderation_result" : true,
"default_branch" : "master",
"star_count" : 0,
"forks_count" : 0,
"open_merge_requests_count" : null,
"last_activity_at" : "2025-12-23T11:03:25.000+08:00",
"namespace" : {
"id" : 2111955247,
"name" : "gg1",
"path" : "gg1",
"develop_mode" : "normal",
"kind" : "group",
"full_path" : "85983ce3309e4d06a2c5b48ce938c9b2/gg1",
"full_name" : null,
"parent_id" : 2111945387,
"visibility_level" : 0,
"enable_file_control" : null,
"owner_id" : null
},
"empty_repo" : null,
"starred" : null,
"visibility" : "private",
"security" : "internal",
"owner" : {
"id" : 7574,
"name" : "user",
"username" : "a618e34bd5704be3ae3395dfede06041",
"state" : "active",
"service_license_status" : null,
"name_cn" : "user",
"nick_name" : "user",
"tenant_name" : "user"
},
"creator_id" : 7574,
"only_allow_merge_if_pipeline_succeeds" : false,
"only_allow_merge_if_all_discussions_are_resolved" : false,
"merge_method" : "merge"
} 状态码:401
Unauthorized
{
"error_code" : "DEV.00000003",
"error_msg" : "认证信息过期"
} 状态码:403
Bad Request
{
"error_code" : "CH.004403",
"error_msg" : "您没有操作权限,请升级权限后重试。"
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
401 | Unauthorized |
403 | Bad Request |
错误码
请参见错误码。

