更新时间:2026-04-07 GMT+08:00
分享

转移仓库 - TransferRepository

功能介绍

将仓库转移到其他代码组

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

当前API调用无需身份策略权限。

URI

POST /v4/repositories/{repository_id}/transfer

表1 路径参数

参数

是否必选

参数类型

描述

repository_id

Integer

参数解释:

仓库的ID,通过查询用户所有仓库接口查询项目列表获取。

约束限制:

不涉及。

默认取值:

不涉及。

取值范围:

1~2147483647

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

namespace

String

参数解释:

命名空间路径。

约束限制:

必填。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

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

参数解释:

仓库开发模式。

取值范围:

  • normal

  • CR

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

参数解释:

仓库加密状态

取值范围:

  • encrypting,加密中。

  • encrypted,已加密。

  • decrypting,解密中。

  • decrypted,已解密。

默认取值:

不涉及。

repo_encryption_enabled

Boolean

参数解释:

是否开启仓库加密

取值范围:

  • true,已开启加密。

  • false,未开启加密。

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

表5 NamespaceBasicDto

参数

参数类型

描述

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

表6 RepositoryUserBasicDto

参数

参数类型

描述

id

Integer

参数解释:

用户id

约束限制:

不涉及。

取值范围:

1~2147483647

name

String

参数解释:

用户名称

约束限制:

不涉及。

username

String

参数解释:

用户名

约束限制:

不涉及。

state

String

参数解释:

用户状态。

取值范围:

  • active,激活。

  • blocked,禁用。

service_license_status

Integer

参数解释:

服务级权限状态 0:停用 1:启用

约束限制:

不涉及。

取值范围:

1~2147483647

name_cn

String

参数解释:

用户中文名称

约束限制:

不涉及。

nick_name

String

参数解释:

用户昵称

约束限制:

不涉及。

tenant_name

String

参数解释:

租户名称

约束限制:

不涉及。

表7 RepositorySimpleDto

参数

参数类型

描述

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

参数解释:

仓库开发模式。

取值范围:

  • normal

  • CR

moderation_result

Boolean

参数解释:

审核状态。

表8 RepositoryIdentityDto

参数

参数类型

描述

id

Integer

参数解释:

项目ID。

约束限制:

不涉及。

取值范围:

1~2147483647

path_with_namespace

String

参数解释:

项目路径。

约束限制:

不涉及。

表9 PermissionsDto

参数

参数类型

描述

repository_access

MemberAccess object

参数解释:

仓库权限。

约束限制:

不涉及。

group_access

MemberAccess object

参数解释:

代码组权限。

约束限制:

不涉及。

表10 MemberAccess

参数

参数类型

描述

access_level

Integer

参数解释:

访问级别。

约束限制:

不涉及。

取值范围:

1~2147483647

notification_level

Integer

参数解释:

通知级别。

约束限制:

不涉及。

取值范围:

1~2147483647

表11 RepositoryStatisticsDto

参数

参数类型

描述

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

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

error_msg

String

参数解释:

错误信息。

状态码:403

表13 响应Body参数

参数

参数类型

描述

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

错误码

请参见错误码

相关文档