获取仓库详情
功能介绍
获取仓库详情
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v4/repositories/{repository_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
repository_id |
是 |
Integer |
参数解释: 仓库的ID,通过查询用户所有仓库接口查询项目列表获取。 约束限制: 不涉及。 取值范围: 1-2147483647 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
响应参数
状态码: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地址。 |
web_url |
String |
参数解释: 仓库页面链接。 |
readme_url |
String |
参数解释: 仓库readme文件链接。 |
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仓库源仓 约束限制: 不涉及。 |
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地址。 |
web_url |
String |
参数解释: 仓库页面链接。 |
readme_url |
String |
参数解释: 仓库readme文件链接。 |
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 |
请求示例
无
响应示例
状态码:200
仓库最近推送事件
{ "id" : 2111993598, "description" : null, "name" : "test_import", "name_with_namespace" : "22d9c8e7fe464697bc2a358df175dd29 / g111 / g22 / g3 / g4 / g5 / test_import", "path" : "test_import", "path_with_namespace" : "22d9c8e7fe464697bc2a358df175dd29/g111/g22/g3/g4/g5/test_import", "created_at" : "2025-01-14T20:13:56.000+08:00", "updated_at" : "2025-01-14T20:13:56.000+08:00", "archived" : false, "ssh_url_to_repo" : "git@repo.com:22d9c8e7fe464697bc2a358df175dd29/g111/g22/g3/g4/g5/test_import.git", "http_url_to_repo" : "https://repo.com/22d9c8e7fe464697bc2a358df175dd29/g111/g22/g3/g4/g5/test_import.git", "project_id" : "22d9c8e7fe464697bc2a358df175dd29", "project_name" : "SubscriptionTest", "develop_mode" : "normal", "moderation_result" : true, "default_branch" : "master", "star_count" : 0, "forks_count" : 0, "open_merge_requests_count" : 0, "last_activity_at" : "2025-01-14T20:13:56.000+08:00", "namespace" : { "id" : 2111853526, "name" : "g5", "path" : "g5", "develop_mode" : "normal", "kind" : "group", "full_path" : "22d9c8e7fe464697bc2a358df175dd29/g111/g22/g3/g4/g5", "full_name" : null, "parent_id" : 2111853525, "visibility_level" : 0, "enable_file_control" : null, "owner_id" : null }, "empty_repo" : false, "starred" : false, "visibility" : "private", "security" : "internal", "owner" : { }, "creator" : { "id" : 9124, "name" : "test_user", "username" : "c369c68f1ff84679b5a8ed904d8bff1c", "state" : "active", "service_license_status" : null, "name_cn" : "test_user", "nick_name" : "beta_dv", "tenant_name" : "test_tenant" }, "creator_id" : 9124, "statistics" : { }, "branch_count" : 2, "tag_count" : 0, "member_count" : 8, "import_status" : "none", "import_url" : "https://gitee.com/api-review-test-group/return-test.git", "import_error" : null, "repo_type" : "normal", "only_allow_merge_if_pipeline_succeeds" : false, "only_allow_merge_if_all_discussions_are_resolved" : false, "merge_method" : "merge", "fork_network_repositories" : [ ], "permissions" : { "repository_access" : { "access_level" : 50, "notification_level" : 3 }, "group_access" : { "access_level" : 50, "notification_level" : 3 } }, "repository_type" : null, "uuid" : "b166cca9cf9442a0b82159769d6aec4c", "ancestor_ids" : [ 2111851014, 2111853523, 2111853524, 2111853525, 2111853526 ], "ancestor_names" : [ "g111", "g22", "g3", "g4", "g5" ] }
状态码
状态码 |
描述 |
---|---|
200 |
仓库最近推送事件 |
错误码
请参见错误码。