AWS no longer releases V3 of the AWS SDK for .NET (the AWSSDK.* packages) or AWS Tools for PowerShell V4, not even security fixes. Here is what that means and how to move to V4.
| Date | What happened |
|---|---|
| April 28, 2025 | SDK V4.0 generally available |
| June 23, 2025 | AWS Tools for PowerShell V5, built on SDK V4, generally available |
| August 19, 2025 | End of support announced for SDK V3 and Tools for PowerShell V4 |
| March 1, 2026 | Both in maintenance mode: critical bug and security fixes only |
| June 1, 2026 | End of support for both |
| November 11, 2026 | SDK 4.1: builds for .NET 11, 10 and 8, .NET Standard 2.0 and .NET Framework 4.7.2; .NET Core 3.1 dropped |
| November 2027 (planned) | SDK 4.2 drops .NET 8 (may slip to December) |
AWS says V3 and V4 packages can't be mixed in one app, so all references move together. List them per solution:
# .NET 10 SDK or later
dotnet package list --include-transitive --format json > packages.json
# .NET 9 SDK or earlier
dotnet list package --include-transitive
# What pulls in AWSSDK.Core? (.NET 8.0.4xx SDK or later)
dotnet nuget why AWSSDK.Core
Also search repositories for AWSSDK. to catch packages.config files and checked-in DLLs. Libraries on the SDK have their own versions; these are from AWS's V4 tracker, with the first stable V4-based version on NuGet (check third-party ones there too):
| Package | First on V4 |
|---|---|
| AWS.Logger.Core and AWS.Logger.* providers | 4.0.0 |
| Amazon. | 7.0.0 |
| Amazon. | 4.0.0 |
| AWSSDK. | 2.0.0 |
| Amazon. | 3.0.0 |
| Amazon. | 2.0.0 |
| Amazon. | 3.0.0 |
| OpenTelemetry. | 1.12.0 |
Build breaks. Value-type properties on requests and responses become nullable (bool?, int?, long?, double?, float?, DateTime?); where code doesn't recompile, AWS suggests .Value or GetValueOrDefault(). Removed APIs:
| Removed in V4 | Use instead |
|---|---|
| STSAssumeRoleAWSCredentials | AssumeRoleAWSCredentials |
| StoredProfileAWSCredentials, StoredProfileCredentials, ProfileManager | NetSDKCredentialsFile or SharedCredentialsFile |
| ECSTaskCredentials | GenericContainerCredentials |
| AmazonS3Util. | DoesS3BucketExistV2(Async) |
| S3 encryption client, CloudFront signers, EC2 GetDecryptedPassword | Amazon. |
| DynamoDB Streams in AWSSDK.DynamoDBv2 | AWSSDK.DynamoDBStreams |
| Lambda InvokeAsync(InvokeAsyncRequest), InvokeAsyncAsync | Invoke or InvokeAsync(InvokeRequest) |
| DefaultClientConfig. | AWSConfigs.HttpClientFactory |
| UTC twins such as StartTimeUtc | The original name (StartTime), now UTC |
Behavior changes.
NullReferenceException; AWS expects this to be the most challenging change. Empty collections you set on requests are now sent.ConfigureAWSSDKLogging().// Null when no messages came back (V3: empty list)
foreach (var message in response.Messages ?? new List<Message>())
await HandleAsync(message);
// Stop-gap V3 behavior, costs V4's performance gains; set once at startup
// (AWS: not thread safe)
Amazon.AWSConfigs.InitializeCollections = true;
warning : The target framework 'net6.0' is no longer supported by the AWS SDK for .NET. This project has fallen back to the .NET Standard 2.0 assemblies of the SDK, which do not include the features and optimizations available on supported targets.SuppressTfmSupportBuildWarnings to true silences it. The .NET 8 target leaves with 4.2.Get-Module -ListAvailable -Name AWS.Tools.*, AWSPowerShell* | Select-Object Name, Version
Update-AWSToolsModule # AWS.Tools modules; V5 is the default
In V5 the legacy AWSPowerShell module needs PowerShell 5.1 and .NET Framework 4.7.2 or later. Script changes:
$null where V4 showed 0, $false or 0001-01-01, and some empty collections are $null.Set-AWSAutoIterationMode -IterationMode v4 restores V4's behavior.$AWSHistory and -PassThru are gone; use -Select * or -Select ^ParameterName.Key and KeyPrefix values aren't cleaned unless you add -EnableLegacyKeyCleaning.AWS_PROFILE, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY and AWS_SESSION_TOKEN, in a changed resolution order.AWSConfigs.InitializeCollections (default true in late V3 releases) to false to find null-collection bugs.-eq 0, -eq $false, $AWSHistory and -PassThru.