Understanding the AWS 3 to 4 Upgrade Guide - `aws_s3_bucket_object`

Hi,

I wanted to make sure I understand the AWS 4 upgrade guide properly. I see for this:

https://registry.terraform.io/providers/hashicorp/aws/latest/docs/guides/version-4-upgrade#resource-aws_s3_bucket_object

Version 4.x deprecates the aws_s3_bucket_object and maintainers will remove it in a future version. Use aws_s3_object instead, where new features and fixes will be added.

when the guide says “deprecates”, does this mean that through version 4.9, the aws_s3_bucket_object will still be available and not break, and the aws_s3_bucket_object will only break on major version 5?

Any other nuisances that are key to understanding the upgrade guide are appreciated as well.

My basic concern is, what in the guide indicates that at some point in version 4.x, something will actually break / no longer be available as a resource ( or whatever else could be breaking) at some point and it isn’t known when exactly when in version 4

Hi @aaa,

The word “deprecated” in guides like these typically means that the feature is still available but either already generates a deprecation warning or will begin generating a deprecation warning in some future version.

The word “removed”, on the other hand, means that the feature is no longer available at all and so trying to use it will produce an error.

Since I’m not an AWS provider developer I can’t promise anything stronger than this, but I would share your assumption (based on the typical meaning of major vs. minor releases) that “remove it in a future version” means “remove it in a future major release”, meaning that it would remain present throughout the 4.x series of minor releases.

1 Like

thanks @apparentlymart! That makes sense for it to not be removed until a future major release. Noted.