Help Center/ GaussDB(for MySQL)/ API Reference/ APIs (Unavailable Soon)/ Instance Management/ Scaling up Storage of a Yearly/Monthly DB Instance
Updated on 2024-09-11 GMT+08:00

Scaling up Storage of a Yearly/Monthly DB Instance

Function

This API is used to scale up storage space of a yearly/monthly DB instance. Before calling this API:

This API will be unavailable on March 31, 2025. You are advised to switch workloads to the new API (Scaling up Storage of a Yearly/Monthly DB Instance) before then.

URI

  • URI format

    POST https://{endpoint}/mysql/v3/{project_id}/instances/{instance_id}/volume/extend

  • Example

    POST https://{endpoint}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/volume/extend

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

    instance_id

    Yes

    Instance ID, which is compliant with the UUID format.

Request

Table 2 Parameter description

Name

Mandatory

Type

Description

size

Yes

Integer

Storage space after expansion. The value ranges from 40 GB to 128,000 GB. The minimum increment for each scaling is 10 GB.

is_auto_pay

No

String

Whether the order will be automatically paid.

  • true: indicates the order will be automatically paid from your account. The default value is true.
  • false: indicates the order will be manually paid.
  • Request example
    {
    "size":50,
    "is_auto_pay":"true"
    }

Response

  • Normal response
    Table 3 Parameter description

    Name

    Type

    Description

    size

    Integer

    Storage space after expansion.

    order_id

    String

    Order ID.

  • Example normal response
    {
    "size":50,
    "order_id": "CS2006231950I8NQA"
    }

Status Code

For details, see Status Codes.

Error Code

For details, see Error Codes.