# 查询项目存储空间状态

`GET` `/api/storageSpace/status`

查询当前登录用户或当前应用身份主体的项目存储空间开放和开通状态。身份主体由服务端鉴权结果自动确定，调用方无需也不能传入其他主体ID。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | StorageSpaceView | 响应数据 |
|     featureAvailable | boolean | 当前租户是否已开放项目存储空间功能 |
|     spaceId | string | 长期空间ID；未创建或功能未开放时为空 |
|     status | string | 空间状态；可选值：NOT_CREATED、PROVISIONING、READY、FAILED、DELETING |
|     usageAvailable | boolean | 当前是否可以获取容量和文件数用量 |
|     sizeLimitBytes | integer | 空间容量上限，单位为字节 |
|     sizeUsedBytes | integer | 空间已使用容量，单位为字节 |
|     fileCountLimit | integer | 空间文件数上限 |
|     fileCountUsed | integer | 空间已使用文件数 |
|     lastErrorCode | string | 最近一次开通或删除失败的错误码 |
|     lastErrorMessage | string | 最近一次开通或删除失败的错误说明 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |