遷移至 第 4 版 適用於 .NET 的 AWS SDK

新增 AWSSDK.Extensions.Logging.Log4NetAdaptor NuGet 套件，並從 呼叫靜態ConfigureAWSSDKLogging方法Log4NetAWSExtensions。

using Amazon.DynamoDBv2;
using Amazon.Extensions.Logging.Log4NetAdaptor;
using log4net;

[assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config")]

Log4NetAWSExtensions.ConfigureAWSSDKLogging();
var logger = LogManager.GetLogger(typeof(Program));

新增 AWSSDK.Extensions.Logging.ILoggerAdaptor NuGet 套件，並從 ILoggerFactory 界面呼叫ConfigureAWSSDKLogging擴充功能方法。

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.Services.GetRequiredService<ILoggerFactory>()
    .ConfigureAWSSDKLogging();

適用於 DynamoDB 的 SDK 中的 V4 變更解決了有關可測試性的一些問題，但主要以高階程式庫為中心：

如需這些程式設計模式的詳細資訊，請參閱本指南DynamoDB中的 。

文件模型：更新模擬IAmazonDynamoDB界面的例外狀況

在開發套件 V4 之前的文件模型中，如果資料表是使用模擬 IAmazonDynamoDB 介面初始化，則會傳回 NullReferenceException。開發套件的 V4 InvalidOperationException會改為傳回。非同步Table方法應與模擬用戶端搭配使用，但當您從 呼叫同步方法時，仍可能會看到例外狀況.NET/Core/Standard。

如需此變更的詳細資訊，請參閱 GitHub 上的 PR 3388。

文件模型： FromJson和 ToJson方法

文件類別的 FromJson和 ToJson方法現在使用 System.Text.Json而非 LitJson 進行序列化，而且 LitJson 已從 SDK 的 V4 中移除。使用 的好處System.Text.Json是此剖析器支援使用 .NET Decimal類型，它支援數值浮點屬性的更高精確度。

物件持久性模型： DynamoDBOperationConfig類別

在物件持久性模型中，已對共用的 DynamoDBOperationConfig 類別進行下列變更：

物件持久性模型：多形性

DynamoDBPolymorphicTypeAttribute 類別已新增至物件持久性模型。此類別支援多態類型的序列化和還原序列化。如需詳細資訊，請參閱 GitHub 上的 PR 3643。

文件模型和物件持久性模型：模擬操作

已新增新的操作特定界面，允許客戶模擬 DynamoDB 操作。IDynamoDBContext 界面上的原廠方法已更新，以傳回新的界面。

如需此變更的詳細資訊，請參閱 GitHub 上的 PR 3450。

文件模型和物件持久性模型：支援原生 AOT

原生 AOT 的限制支援巢狀 .NET 類型。在某些情況下，.NET 編譯器的修剪元件可能會忽略這些巢狀類型。在這種情況下，您可能會收到例外狀況，例如："System.InvalidOperationException: Type <type> is unsupported, it cannot be instantiated."

您可以藉由在程式碼路徑中新增 DynamicDependency 來解決此限制，通知修剪器有關子類型的相依性。儲存的最上層 .NET 類型的建構函式可能是 位置。下列程式碼範例示範如何使用 DynamicDependency 屬性：

[DynamoDBTable("TestTable")]
class TypeWithNestedTypeProperty
{
    [DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(SubType))]
    public TypeWithNestedTypeProperty()
    {

    }

    [DynamoDBHashKey]
    public string Id { get; set; }
    public string Name { get; set; }

    public SubType SubType { get; set; }
}

class SubType
{
    public string SubName { get; set; }
}

DynamoDBStreams

DynamoDBStreams 已從 AWSSDK.DynamoDB NuGet 套件中移除，並可在自己的套件 AWSSDK.DynamoDBStreams 中使用，並有自己的命名空間 Amazon.DynamoDBStreams。

允許移除 TableNamePrefix值

您現在可以在個別操作層級的 DynamoDBContextConfig 類別中移除 TableNamePrefix 屬性的值。如需此變更的詳細資訊，請參閱 GitHub 上的 PR 3476。

RetrieveDateTimeInUtc 屬性

對於 DynamoDBContextConfig 類別， RetrieveDateTimeInUtc 屬性的預設值已變更為 true。

DynamoDBContextTableNamePrefix 屬性

從 AWSConfigsDynamoDB 類別移除 DynamoDBContextTableNamePrefix 屬性。使用者應呼叫 AWSConfigsDynamoDB.Context.TableNamePrefix，而不是

GetDecryptedPassword

Amazon EC2 的GetDecryptedPassword擴充功能已移至名為 AWSSDK.Extensions.EC2.DecryptPassword 的個別擴充功能套件。此變更是為了支援 OpenSSL 3，並對 BouncyCastle.Cryptography 採取相依性。

此套件的原始碼位於 GitHub，網址為 https://github.com/aws/aws-sdk-net/tree/main/extensions/src/AWSSDK.Extensions.EC2.DecryptPassword。

支援 Amazon EC2 IMDSv1

執行個體中繼資料服務第 1 版 (IMDSv1) 的支援已移除。從 IMDS 擷取登入資料和其他中繼資料時，軟體開發套件的 V4 一律使用執行個體中繼資料服務第 2 版 (IMDSv2)。IMDSv2 如需 IMDS 的詳細資訊，請參閱《Amazon EC2 使用者指南》中的使用 IMDS。 Amazon EC2

已變更或移除的程式設計元素

AWS 區域 us-east-1

為 us-east-1區域設定的 Amazon S3 服務用戶端無法再存取其他區域中的儲存貯體。必須使用為儲存貯體所在的區域設定的 S3 服務用戶端來存取儲存貯體。

如需此變更的其他資訊，請參閱 V4 適用於 .NET 的 AWS SDK 的部落格文章預覽 V4。

S3 加密用戶端

Amazon.S3.Encryption 命名空間中定義的 Amazon S3 加密用戶端已從 AWSSDK.S3 套件中移除。此用戶端已移至自己的套件，稱為 Amazon.Extensions.S3.Encryption，其文件位於 https://aws.github.io/amazon-s3-encryption-client-dotnet/api/Amazon.Extensions.S3.Encryption.html。如需遷移的相關資訊，請參閱 S3 加密用戶端遷移 (V1 至 V2)。如需 S3 加密的詳細資訊，請參閱《Amazon S3 加密用戶端開發人員指南》中的支援的加密演算法。

的 S3 標記指令 CopyObject

TaggingDirective 屬性已公開為 CopyObjectRequest 類別的公有屬性，由 AmazonS3Client.CopyObject 方法使用。此屬性對應至 CopyObject 動作中定義的 Amazon S3 x-amz-tagging-directive 參數。

標記指令不會再自動設定為 COPY。如果開發人員未指定標記指令，S3 後端會自動假設它是 COPY，但如果開發人員明確將 屬性設定為 null，則完全不會設定該值。

S3 組態的 UseArnRegion 屬性

Amazon.S3.AmazonS3Config 類別的 UseArnRegion 屬性已更新，因此AWS_S3_USE_ARN_REGION環境變數優先於共用 AWS config檔案中s3_use_arn_region的設定。如需這些變數和設定的詳細資訊，請參閱 SDK 和工具參考指南中的設定參考。 AWS SDKs

CopyObject 和 CopyPart方法的正斜線

Amazon S3 CopyObject和 CopyPart方法不會再修剪正斜線。DisableTrimmingLeadingSlash 屬性已從 CopyObjectRequest 和 CopyPartRequest 類別中移除。

DoesS3BucketExist... 方法

已將淘汰的 DoesS3BucketExist和 DoesS3BucketExistAsync方法從 AmazonS3Util 類別中移除，該類別實作 ICoreAmazonS3 介面。這些方法已移除，因為它們一律使用 HTTP。請改用 DoesS3BucketExistV2 和 DoesS3BucketExistV2Async。

SDK 一律使用 SigV4

第 4 版 適用於 .NET 的 AWS SDK 一律使用 AWS Signature 第 4 版 (SigV4) 簽署請求。此變更會導致下列相關變更：

GetACL 和 PutACL方法

AmazonS3Client 類別的 GetACL和 PutACL方法已標記為已過時。若要存取這些方法的功能，請改用下列新方法：GetBucketACL、GetObjectACL、 PutBucketACL和 PutObjectACL。

已移除過時的程式設計元素

Amazon S3 實作的許多程式設計元素已從 SDK 的 V4 中移除，包括列舉值、類型、方法、命名空間等。如果先前尚未涵蓋這些項目，以及您可以採取以適應其移除的潛在步驟，則會列出如下。

Amazon.Auth.AccessControlPolicy.ActionIdentifiers 命名空間

Amazon.Auth.AccessControlPolicy.ActionIdentifiers 命名空間已移除。這包括在 IdentityandAccessManagementActionIdentifiers類別中定義的 IAM 動作識別符。使用這些動作識別符的程式碼應變更為使用動作名稱的字串值。

如需詳細資訊，請參閱《IAM 使用者指南》中的 從 JSON 建立 IAM 受管政策和 JSON 政策概觀。

ClientConfig 類別

Amazon.Runtime.ClientConfig 類別是服務用戶端組態類別的基本類別，例如 AmazonS3Config。已從此類別中移除下列程式設計元素。

Amazon.Runtime 命名空間

Amazon.Runtime 命名空間已更新，如下所示：

BouncyCastle

BouncyCastle 的來源副本已從 SDK 的 V4 中移除。

StoredProfileSAMLCredentials 類別

Amazon.SecurityToken.SAML 命名空間中的淘汰StoredProfileSAMLCredentials類別已移除。請改用 Amazon.Runtime 命名空間中的 FederatedAWSCredentials 類別。

AWSSDKUtils 類別

下列方法已從 AWSSDKUtils 類別中移除：ProtectEncodedSlashUrlEncode、 ResolveResourcePath和 ConvertToUnixEpochMilliSeconds。

ProfileManager 類別

已將淘汰的ProfileManager類別從 Amazon.Util 命名空間中移除。請改用 Amazon.Runtime.CredentialManagementCredentialManagement 命名空間中的 NetSDKCredentialsFile 或 SharedCredentialsFile 類別。

AWSConfigs 類別

下列淘汰屬性已從 AWSConfigs 類別中移除：ResponseLogging、 Logging和 LogMetrics。請改用 LoggingConfig 屬性。

ConditionFactory 類別

具有下列簽章的 方法已從 ConditionFactory 類別中移除：NewCondition(ConditionFactory.DateComparisonType, DateTime)。請改用 NewConditionUtc 方法。

Amazon CloudFront 公用程式

已移除過時的Amazon.CloudFront.Util命名空間和AmazonCloudFrontUtil類別。

AWS IoT

在 ListPrincipalThingsResponse 類別中，NextToken覆寫的舊版自訂已移除，有利於分頁。

AWS Lambda

AmazonLambdaClient 類別的下列Invoke...方法已移除，因為名稱令人混淆。

Amazon SageMaker 執行期

已移除已淘汰的 PayloadPart 類別建構函數。