[Docs]: conflicting behaviour for storage autoscaling for RDS

[Kurtyjlee]

Documentation Link

https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/db_instance

Description

max_allocated_storage - (Optional) When configured, the upper limit to which Amazon RDS can automatically scale the storage of the DB instance. Configuring this will automatically ignore differences to allocated_storage. Must be greater than or equal to allocated_storage or 0 to disable Storage Autoscaling.

To enable Storage Autoscaling with instances that support the feature, define the max_allocated_storage argument higher than the allocated_storage argument. Terraform will automatically hide differences with the allocated_storage argument value if autoscaling occurs.

In the docs, it says to max_allocated_storage ≥ allocated_storage || max_allocated_storage == 0 to disable storage autoscaling, however, in another part of the documentation, it says it will enable storage autoscaling. Is this discrepancy expected? if not, what should the actual behaviour be?

References

No response

Would you like to implement a fix?

Yes

[github-actions]

Community Note

Voting for Prioritization

• Please vote on this issue by adding a 👍 reaction to the original post to help the community and maintainers prioritize this request.
• Please see our prioritization guide for information on how we prioritize.
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.

Volunteering to Work on This Issue

• If you are interested in working on this issue, please leave a comment.
• If this would be your first contribution, please review the contribution guide.