---

name: aws-v2 description: > Migrate from AWS SDK for Java v1 (com.amazonaws) to v2 (software.amazon.awssdk). Use when projects need to move away from deprecated AWS SDK v1 to the modern v2 API. compatibility: Java projects using Gradle with AWS SDK dependencies metadata: version: "1.0.0" technology: java category: modernization tags: - aws - sdk - migration - dependencies

AWS SDK v2 Migration

Migrate Java projects from AWS SDK v1 (com.amazonaws) to v2 (software.amazon.awssdk).

When to Use

• Project uses deprecated AWS SDK v1 (com.amazonaws.* imports)
• Dependabot/security scans flag v1 vulnerabilities
• Need features only available in v2 (async clients, HTTP/2, etc.)

Skill Contents

Sections

• When to Use (L22-L27)
• Critical: MSK IAM Authentication (L47-L59)
• Migration Strategy (Priority Order) (L60-L68)
• Quick Start (L69-L108)
• References (L109-L114)
• Related Command (L115-L118)
• Related Resources (L119-L122)

Available Resources

📚 references/ - Detailed documentation

• migration patterns

---

Critical: MSK IAM Authentication

When migrating to AWS SDK v2, also update aws-msk-iam-auth if using Kafka with MSK IAM.

Error after migration:

CopyNoClassDefFoundError: com/amazonaws/auth/AWSCredentialsProvider

Fix: Update aws-msk-iam-auth to 2.3.5 (AWS SDK v2 compatible).

See references/migration-patterns.md for details.

Migration Strategy (Priority Order)

Quick Start

1. Identify v1 Usages

Copy# Find all files with v1 imports
grep -r "import com.amazonaws" --include="*.java" . | grep -v "/build/"

# Check dependency tree
./gradlew dependencies --configuration runtimeClasspath | grep -B5 "com.amazonaws"

2. Apply Migration

See references/migration-patterns.md for detailed code migration patterns.

Dependency Substitution (in root build.gradle):

Copyallprojects {
    configurations.configureEach {
        resolutionStrategy.dependencySubstitution {
            substitute module("com.amazonaws:aws-java-sdk-s3")
                using module("software.amazon.awssdk:s3:${libs.versions.aws.sdk.v2.get()}")
                because "Migrate to AWS SDK v2"
        }
    }
}

3. Validate

Copy# Verify no v1 imports remain
grep -r "import com.amazonaws" --include="*.java" . | grep -v "/build/"

# Build and test
./gradlew clean build test

References

Related Command

This skill is referenced by: /upgrade-to-aws-sdk-v2

Related Resources

• AWS SDK v2 Developer Guide
• AWS SDK v2 Migration Guide