接口参考租户与成员
平台配置租户配额上限
PUT /api/v1/tenants/{tenant_id}/quotas,updateQuota 的请求参数和响应结构。
PUT /api/v1/tenants/{tenant_id}/quotas
| 项目 | 内容 |
|---|---|
| 操作标识 | updateQuota |
| 认证 | 登录会话 Cookie |
PostgreSQL 持久化;角色、租户状态与成员资格在每次请求的数据库事务中重新校验。未配置 DATABASE_URL 时返回 503。
会话写请求需要合法的 Origin 和与当前 Cookie 绑定的 X-CSRF-Token。登录成功后应重新获取 CSRF 令牌。具体权限由目标资源归属和当前授权决定,见认证约定。
请求参数
| 名称 | 位置 | 必填 | 类型 | 说明与约束 |
|---|---|---|---|---|
| tenant_id | path | 是 | string | 格式:uuid |
| X-CSRF-Token | header | 是 | string | 先 GET /api/auth/v1/csrf 获取,与当前 Cookie 会话绑定;写请求同时要求 Origin 等于配置的 PUBLIC_ORIGIN。;最短 1 |
请求体
请求体必填。
内容类型:application/json。
| 字段 | 类型 | 必填 | 说明与约束 |
|---|---|---|---|
| instances | integer | 是 | -1 表示不限制;0 表示禁止分配。;格式:int64;最小值 -1;最大值 1000000 |
| vcpu | integer | 是 | -1 表示不限制;0 表示禁止分配。;格式:int64;最小值 -1;最大值 10000000 |
| memory | integer | 是 | -1 表示不限制;0 表示禁止分配。;格式:int64;最小值 -1;最大值 100000000 |
| storage | integer | 是 | -1 表示不限制;0 表示禁止分配。;格式:int64;最小值 -1;最大值 1000000000 |
| public_ips | integer | 是 | -1 表示不限制;0 表示禁止分配。;格式:int64;最小值 -1;最大值 1000000 |
| baremetal_nodes | integer | 否 | -1 为不限制,0 为禁止分配;内存单位 GiB;最小值 -1 |
| baremetal_vcpu | integer | 否 | -1 为不限制,0 为禁止分配;内存单位 GiB;最小值 -1 |
| baremetal_memory | integer | 否 | -1 为不限制,0 为禁止分配;内存单位 GiB;最小值 -1 |
完整请求结构(含引用定义)
{
"$ref": "#/$defs/IAMQuota",
"$defs": {
"IAMQuota": {
"type": "object",
"additionalProperties": false,
"properties": {
"instances": {
"type": "integer",
"format": "int64",
"minimum": -1,
"maximum": 1000000,
"description": "-1 表示不限制;0 表示禁止分配。"
},
"vcpu": {
"type": "integer",
"format": "int64",
"minimum": -1,
"maximum": 10000000,
"description": "-1 表示不限制;0 表示禁止分配。"
},
"memory": {
"type": "integer",
"format": "int64",
"minimum": -1,
"maximum": 100000000,
"description": "-1 表示不限制;0 表示禁止分配。"
},
"storage": {
"type": "integer",
"format": "int64",
"minimum": -1,
"maximum": 1000000000,
"description": "-1 表示不限制;0 表示禁止分配。"
},
"public_ips": {
"type": "integer",
"format": "int64",
"minimum": -1,
"maximum": 1000000,
"description": "-1 表示不限制;0 表示禁止分配。"
},
"baremetal_nodes": {
"type": "integer",
"minimum": -1,
"description": "-1 为不限制,0 为禁止分配;内存单位 GiB"
},
"baremetal_vcpu": {
"type": "integer",
"minimum": -1,
"description": "-1 为不限制,0 为禁止分配;内存单位 GiB"
},
"baremetal_memory": {
"type": "integer",
"minimum": -1,
"description": "-1 为不限制,0 为禁止分配;内存单位 GiB"
}
},
"required": [
"instances",
"vcpu",
"memory",
"storage",
"public_ips"
],
"description": "租户各项配额:-1 表示不限制,0 表示禁止分配,正整数表示上限。"
}
}
}响应
| HTTP 状态 | 含义 |
|---|---|
| 204 | 成功 |
| 400 | 参数错误 |
| 401 | 登录无效或已撤销 |
| 403 | 权限、范围或 CSRF 校验失败 |
| 404 | 记录不存在 |
| 409 | 引用或唯一性冲突 |
| 429 | 请求过于频繁 |
| 503 | 数据库未配置或不可用 |
400 / 401 / 403 / 404 / 409 / 429 / 503 · application/json 响应结构
{
"$ref": "#/$defs/ErrorResponse",
"$defs": {
"ErrorResponse": {
"type": "object",
"additionalProperties": false,
"properties": {
"error": {
"$ref": "#/$defs/ErrorDetail"
},
"request_id": {
"type": "string"
}
},
"required": [
"error",
"request_id"
]
},
"ErrorDetail": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"NOT_IMPLEMENTED",
"NOT_FOUND",
"AUTH_REQUIRED",
"FORBIDDEN",
"VALIDATION_FAILED",
"CONFLICT",
"SERVICE_UNAVAILABLE",
"INTERNAL_ERROR",
"RATE_LIMITED"
]
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"fields": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"required": [
"code",
"message",
"retryable"
]
}
}
}响应中的 request_id 用于排查请求;异步操作以任务最终状态为准。参阅调用约定、异步任务和错误处理。
本页由版本化 OpenAPI 契约生成。通用资源响应允许的任意字段以运行服务为准,不据此推断尚未定义的字段。
