Help Center/ Distributed Message Service for RabbitMQ/ User Guide/ Modifying Instance Specifications/ Automatically Expanding the Storage Space of a RabbitMQ Instance
Updated on 2025-11-20 GMT+08:00
View PDF
Share

Automatically Expanding the Storage Space of a RabbitMQ Instance

For a RabbitMQ 3.x.x instance, if the remaining disk space is less than 5 GB, the high disk watermark is triggered, blocking publishers. To avoid these situations, you can enable automatic disk expansion.

Notes and Constraints

  • Unavailable for old instances. See the console.
  • This function may not be completed before the disk usage reaches the threshold when the disk usage increases rapidly.
  • Services will not be affected.

Prerequisite

Expanding the storage space of a RabbitMQ instance will incur fees. Ensure that your account has sufficient balance. For details about the pricing, see Product Pricing Details.

Authorizing RabbitMQ

Permission DMS BSSAccess is required. Otherwise, the automatic expansion fails.

  1. Log in to the RabbitMQ console as the tenant account or a subaccount in user group admin.
  2. Click in the upper left corner to select a region.
  3. Choose Service Authorization.
  4. Check BSS and click Update Authorization.
  5. Once the operation succeeds, agency dms_admin_trust is created in IAM.

    Once the dms_admin_trust is created, do not modify or delete it.

Enabling Automatic Storage Space Expansion

  1. Log in to the RabbitMQ console.
  2. Click in the upper left corner to select the region where your instance is located.
  3. Click a RabbitMQ instance name to go to the instance overview page.
  4. In Disk Autoscaling in the Instance Information area, click . The Disk Autoscaling dialog box is displayed.
  5. Click and set the parameters described in Table 1.

    Table 1 Disk autoscaling parameters

    Parameter

    Description

    Threshold

    Threshold for triggering automatic disk scaling. The value range is 20% to 80%.

    When the disk usage of any node in a RabbitMQ instance reaches this threshold, the disk is automatically expanded.

    Increase By

    Proportion of the storage space to be expanded to the total storage space of the instance. The value range is 10% to 100%. The minimum increase is 100 GB. If the storage space to be expanded is not a multiple of 100, the value will be rounded up to 100.

    For example, when the total storage space of an instance is 300 GB and the increase is 10%, if the storage space to be expanded is 300 × 10% = 30 GB, it will be rounded up to 100 GB.

    Upper Limit

    The upper limit of the storage space. After the total storage space of an instance reaches this limit, the instance will not automatically expand the storage space.

  6. Click OK.

    Later, check that Disk Autoscaling is changed to Enabled in the Instance Information area on the RabbitMQ instance overview page.

Disabling Automatic Storage Space Expansion

  1. Log in to the RabbitMQ console.
  2. Click in the upper left corner to select the region where your instance is located.
  3. Click a RabbitMQ instance name to go to the instance overview page.
  4. In Disk Autoscaling in the Instance Information area, click . The Disk Autoscaling dialog box is displayed.
  5. In the Disk Autoscaling row, click and click OK.

    Later, check that Disk Autoscaling is changed to Disabled in the Instance Information area on the RabbitMQ instance overview page.

Parent Topic: Modifying Instance Specifications