gaussdb-mysql/api-ref/source/api/managing_quotas/modifying_resource_quotas.rst

original_name

gaussdb_04_0013.html

Modifying Resource Quotas

Function

This API is used to modify the resource quota of a specified enterprise project.

• Learn how to authorize and authenticate <gaussdb_03_0001> this API before using it.
• Before calling this API, obtain the required region and endpoint <gaussdb_00_0003>.

URI

• URI format

  PUT https://{Endpoint}/mysql/v3/{project_id}/quotas

• Example

  PUT https://{Endpoint}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/quotas

• Parameter description

  Table 1 Parameter description

  Name	Mandatory	Description
  project_id	Yes	Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID <gaussdb_10_0004>.
  quota_list	Yes	Enterprise project resource quotas to be updated. A maximum of 10 quotas can be updated at a time. For details, see Table 2 <gaussdb_04_0013__table1252104315240>.

Request

• Parameter description

  Table 2 quota_list field data structure description

  Name	Type	Description
  enterprise_project_id	String	Enterprise project ID.
  instance_quota	Integer	Quota of the DB instance quantity. The value ranges from 0 to 1000. (If there are already DB instances created, this parameter value must be greater than or equal to the number of existing DB instances.)
  vcpus_quota	Integer	Quota of vCPUs. The value ranges from 0 to 3600000. (If there are already DB instances created, this parameter value must be greater than or equal to the number of used vCPUs.)
  ram_quota	Integer	Memory quota in GB. Memory quota in GB. The value ranges from 0 to 19200000. (If there are already DB instances created, this parameter value must be greater than or equal to the used memory size.)

• Request example

  {
    "quota_list": [
      {
        "enterprise_project_id": "0",
        "instance_quota": 1,
        "vcpus_quota": 4,
        "ram_quota": 8
      }
    ]
  }

Response

• Parameter description

  Table 3 Parameter description

  Name	Type	Description
  quota_list	Array of objects	Configured quota information. For details, see Table 4 <gaussdb_04_0013__table66531170>.

  Table 4 quota_list field data structure description

  Name	Type	Description
  enterprise_project_id	String	Enterprise project ID.
  instance_quota	Integer	Quota of the DB instance quantity.
  vcpus_quota	Integer	Quota of vCPUs.
  ram_quota	Integer	Memory quota in GB.

• Example response

  {
    "quota_list": [
      {
        "enterprise_project_id": "0",
        "instance_quota": 1,
        "vcpus_quota": 4,
        "ram_quota": 8
      }
    ]
  }

Status Code

For details, see Status Codes <gaussdb_10_0002>.

Error Code

For details, see Error Codes <gaussdb_10_0003>.