# 转移仓库 - TransferRepository #### 功能介绍 将仓库转移到其他代码组 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CodeArtsRepo/doc?api=TransferRepository&version=v4)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 当前API调用无需身份策略权限。 #### URI POST /v4/repositories/{repository_id}/transfer 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | repository_id | 是 | Integer | **参数解释：** 仓库的ID，通过[查询用户所有仓库](https://support.huaweicloud.com/api-codeartsrepo/ListUserAllRepositories.html)接口查询项目列表获取。 **约束限制：** 不涉及。 **默认取值：** 不涉及。 **取值范围：** 1\~2147483647 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | namespace | 否 | String | **参数解释：** 命名空间路径。 **约束限制：** 必填。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | project_id | 否 | String | **参数解释：** 项目的32位uuid，项目唯一标识，通过[查询项目列表](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)接口查询项目列表获取。 **取值范围：** 字符串长度32。 | #### 响应参数 **状态码：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 | 表5NamespaceBasicDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 表6RepositoryUserBasicDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释：** 租户名称 **约束限制：** 不涉及。 | 表7RepositorySimpleDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释：** 审核状态。 | 表8RepositoryIdentityDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 项目ID。 **约束限制：** 不涉及。 **取值范围：** 1\~2147483647 | | path_with_namespace | String | **参数解释：** 项目路径。 **约束限制：** 不涉及。 | 表9PermissionsDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | repository_access | [MemberAccess] object | **参数解释：** 仓库权限。 **约束限制：** 不涉及。 | | group_access | [MemberAccess] object | **参数解释：** 代码组权限。 **约束限制：** 不涉及。 | 表10MemberAccess | 参数 | 参数类型 | 描述 | |:---|:---|:---| | access_level | Integer | **参数解释：** 访问级别。 **约束限制：** 不涉及。 **取值范围：** 1\~2147483647 | | notification_level | Integer | **参数解释：** 通知级别。 **约束限制：** 不涉及。 **取值范围：** 1\~2147483647 | 表11RepositoryStatisticsDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释：** 错误信息。 | #### 请求示例 ``` /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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-codeartsrepo/ErrorCode.html)。