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

put 方法（quota 对象）

说明

设置用户或组的配额信息。

语法

/api/v1/quota/put?principal=a-principal&vdc=controller-name 

参数

vdc

目标虚拟数据中心的名称

principal

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

<名称>

本地用户或组

/<名称>

全局用户或组

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

完全限定的主体名称

其中：

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

说明

任意可打印 ASCII 字符串。 根据 URL 语法，将诸如空格等字符替换为十六进制表示形式 (%hh)。

tags=tag1,tag2,…,tagN

有时用于计费目的的标记的逗号分隔列表。

parent=group-name

父组配额的引用。 因为用户的父组设置为他们的主要组，所以您只能为组设置此参数。

cpu=value

处理器的资源使用限制。

mem=value

内存的资源使用限制（字节）。

bw=value

带宽的资源使用限制（每秒字节数）。

disk=value

磁盘空间的资源使用限制（字节）。

warn=percentage

警告使用阈值（按占可用资源总额的百分比表示），对于考虑的主体。

burst=percentage

爆发资源使用阈值（按占可用资源总额的百分比表示），对于考虑的主体。

事务类型

同步

请求类型

GET

示例

为名为 john 的网格 mygrid 的本地用户设置配额值：

Get http://192.168.123.200/api/v1/quota/put?principal=local:user:john&vdc=mygrid&cpu=4&mem=200000000&bw=1000&disk=100000000000

样例输出

XML：

成功时：

<message></message>
超出配额时：

<opt>
  <error>404.1</error>
  <message>未找到实体－错误: 用户 Daniel 已经达到 100.00 Mbps 的带宽配额。</message>
</opt>

JSON：

{
   "message" : ""
}

HTTP 错误代码

404

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

400.8

用户 principal 已经达到 value 的 resource 配额。

400.7

为 resource 参数指定的值 value 无效。 分配给 warn 或 burst 参数的值超出范围。

404.1

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

400.4

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