Updated on 2024-09-11 GMT+08:00

Configuring Resource Quotas

Function

This API is used to configure resource quotas for a specified enterprise project. Before calling this API:

This API will be unavailable on March 31, 2025. You are advised to switch workloads to the new API (Configuring Resource Quotas for a Specified Enterprise Project) before then.

URI

  • URI format

    POST https://{endpoint}/mysql/v3/{project_id}/quotas

  • Example

    POST 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.

    quota_list

    Yes

    Quota details. Up to 10 quota records can be configured at a time.

    For details, see Table 2.

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. Value range: 0–1000. (If there are already instances created, this parameter value must be greater than the number of existing instances.)

    vcpus_quota

    Integer

    Quota of vCPUs. Value range: 0–3600000. (If there are already instances created, this parameter value must be greater than the number of used vCPUs.)

    ram_quota

    Integer

    Memory quota in GB. Value range: 0–19200000. (If there are already instances created, this parameter value must be greater than 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.

    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.

Error Code

For details, see Error Codes.