The SDK v2 does not provide a Regions enum like v1 used to (was: Missing us-east-1 in BucketLocationConstraint)

Describe the bug

We are using BucketLocationConstraint to bind application properties to a valid S3 Region.

Related : https://github.com/aws/aws-sdk-java-v2/issues/1324

Expected Behavior

The object s3Region is instantiated.

Current Behavior

java.lang.IllegalArgumentException: No enum constant software.amazon.awssdk.services.s3.model.BucketLocationConstraint.us-east-1

Reproduction Steps

demo.s3.region: "us-east-1"

@ConfigurationProperties("demo")
public class S3Properties {
    BucketLocationConstraint s3Region;
}

Possible Solution

Add the missing value(s) to service-2.json

Additional Information/Context

Note: this value is then passed to the S3Client builder like so :

S3Client.builder()
    .region(Region.of(s3Properties.getRegion().toString()))

We looked into using a Region enum directly, but we could not find an equivalent of the Regions enum from AWS SDK v1.

AWS Java SDK version used

2.17.246

JDK version used

17.0.4

Operating System and version

macOS Monterey 12.5

[pybeaudouin]

@maciejwalkowiak Thank you for your help.

This is not a Spring Boot issue. In fact, it is able to bind Strings to Regions without a converter.

The issue is that Region allows building objects with invalid region identifiers, such as “first”.

Using the AWS SDK for Java v1, one can use the enum Regions and get type safety.

Using the AWS SDK for Java v2, I ended up building my own wrapper :

// Lombok imports
@Getter
@FieldDefaults(level = AccessLevel.PRIVATE)
public static class S3BucketRegion {
  String id;

  /** This constructor is used by Spring to bind properties. */
  public S3BucketRegion(String id) {
    if ("us-east-1".equals(id)) {
      this.id = id;
      return;
    }

    final var bucketLocation = BucketLocationConstraint.fromValue(id);
    if (bucketLocation != null && bucketLocation != UNKNOWN_TO_SDK_VERSION) {
      this.id = id;
      return;
    }

    throw new IllegalArgumentException("Unsupported AWS S3 region id : " + id);
  }
}

[github-actions[bot]]

⚠️COMMENT VISIBILITY WARNING⚠️

Comments on closed issues are hard for our team to see. If you need more assistance, please open a new issue that references this one. If you wish to keep having a conversation with other community members under this issue feel free to do so.