获取项目使用数据 - ShowProjectUsage
功能介绍
获取项目使用数据,包括项目数量、存储大小、仓库大小等。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
当前API调用无需身份策略权限。
URI
GET /v4/projects/{project_id}/usage
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目的32位uuid,项目唯一标识,通过查询项目列表接口查询项目列表获取。 取值范围: 字符串长度32。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| project_count | Integer | 参数解释: 项目数量。 约束限制: 不涉及。 默认取值: 0。 取值范围: 0~2147483647 |
| storage_size | Double | 参数解释: 存储大小,单位为MB。 约束限制: 不涉及。 默认取值: 0。 取值范围: 0.0~1024000.0 |
| repository_size | Double | 参数解释: 仓库大小,单位为MB。 约束限制: 不涉及。 默认取值: 0。 取值范围: 0.0~1024000.0 |
| lfs_objects_size | Double | 参数解释: Git LFS对象大小,单位为MB。 约束限制: 不涉及。 默认取值: 0。 取值范围: 0.0~1024000.0 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 |
| error_msg | String | 参数解释: 错误信息。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 |
| error_msg | String | 参数解释: 错误信息。 |
请求示例
GET /v4/projects/41bcec7bf2c84efea690e987ca98ee40/usage
响应示例
状态码:200
OK
{
"project_count" : 5,
"storage_size" : 512.28,
"repository_size" : 256.17,
"lfs_objects_size" : 128.39
} 状态码:401
Unauthorized
{
"error_code" : "DEV.00000003",
"error_msg" : "认证信息过期"
} 状态码:403
Bad Request
{
"error_code" : "CH.004403",
"error_msg" : "您没有操作权限,请升级权限后重试。"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 401 | Unauthorized |
| 403 | Bad Request |
错误码
请参见错误码。