集成指南 › Web 服务 API 参考指南 › 有效对象 › quota 对象 › info 方法（quota 对象）

info 方法（quota 对象）

说明

显示指定用户或组的配额信息。

语法

/api/v2/quota/info?principal=a-principal&vdc=controller-name 

参数

vdc

目标虚拟数据中心的名称

principal

要显示其配额信息的用户或组。 主体规范为下列内容之一：

<名称>

本地用户或组

/<名称>

全局用户或组

<范围>:<类型>:<名称>

完全限定的主体名称

其中：

• <scope> 是全局或本地
• <type> 是组或用户
• <name> 是组名或用户名

事务类型

同步

请求类型

GET

示例

显示名为 john@CA.com 的用户的信息。

GET http://192.168.123.200/api/v2/quota/info?principal=local:user:john@ca.com

样例输出

XML：

<quota>
  <burst>90</burst>
  <主体>
    <name>laura@ca.com</name>
    <scope>local</scope>
    <type>user</type>
  </principal>
  <resources allowed>
    <bw>1900000000</bw>
    <cpu>11</cpu>
    <disk>95000000000</disk>
    <mem>19000000000</mem>
  </resources allowed>
  <resources assigned>
    <bw>1000000000</bw>
    <cpu>6</cpu>
    <disk>50000000000</disk>
    <mem>10000000000</mem>
  </resources assigned>
  <warn>80</warn>
</quota>

JSON：

{
   "quota" : {
      "warn" : "80",
      "burst" : "90",
      "principal" : {
         "name" : "laura@ca.com",
         "type" : "user",
         "scope" : "local"
      },
      "resources assigned" : {
         "bw" : "1000000000",
         "cpu" : "6",
         "disk" : "50000000000",
         "mem" : "10000000000"
      },
      "resources allowed" : {
         "bw" : "1900000000",
         "cpu" : "11",
         "disk" : "95000000000",
         "mem" : "19000000000"
      }
   }
}

HTTP 错误代码

404

未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。

404.1

未找到实体－没有与 principal 匹配的主体名称。

400.4

错误请求语法 (URL)－缺少必需的参数（主体）。