更新时间:2022-05-09 GMT+08:00
分享

查询租户配额

功能介绍

查询租户默认可以创建的实例数和总内存的配额限制,以及可以申请配额的最大值和最小值。不同的租户在不同的区域配额可能不同。

调试

您可以在API Explorer中调试该接口,并获取该接口关联的CLI示例: hcloud DCS ShowQuotaOfTenant

URI

GET /v2/{project_id}/quota

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

quotas

quotas object

配额信息。

表3 quotas

参数

参数类型

描述

resources

Array of Resources objects

配额列表。

表4 Resources

参数

参数类型

描述

unit

String

资源的计数单位。

  • 当type为instance时,无单位。

  • 当type为ram时,单位为GB。

min

Integer

  • 当type为instance时,表示可申请实例配额的最小值。

  • 当type为ram时,表示可申请内存配额的最小值。

max

Integer

  • 当type为instance时,表示可申请实例配额的最大值。

  • 当type为ram时,表示可申请内存配额的最大值。

quota

Integer

可以创建的实例最大数和总内存的配额限制。

used

Integer

已创建的实例个数和已使用的内存配额。

type

String

支持instance、ram两种。

  • instance表示实例配额。

  • ram表示内存配额。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

状态码: 500

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

请求示例

GET https://{dcs_endpoint}/v2/{project_id}/quota

响应示例

状态码: 200

查询租户配额成功。

{
  "quotas" : {
    "resources" : [ {
      "unit" : { },
      "min" : 1,
      "max" : 10,
      "quota" : 10,
      "used" : 3,
      "type" : "instance"
    }, {
      "unit" : "GB",
      "min" : 1,
      "max" : 800,
      "quota" : 800,
      "used" : 22,
      "type" : "ram"
    } ]
  }
}

状态码

状态码

描述

200

查询租户配额成功。

400

非法请求。

500

内部服务错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读