のバージョン 4 への移行 AWS SDK for .NET

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();

SDK for DynamoDB の V4 の変更は、テスト可能性に関するいくつかの問題に対処しますが、主に高レベルライブラリを中心にしています。

これらのプログラミングモードの詳細については、このガイドDynamoDBの「」を参照してください。

ドキュメントモデル: モックIAmazonDynamoDBインターフェイスの例外を更新

SDK の V4 より前のドキュメントモデルでは、テーブルがモックされた IAmazonDynamoDB インターフェイスで初期化された場合、 が返されますNullReferenceException。InvalidOperationException 代わりに SDK の V4 が返されます。非同期Tableメソッドはモッククライアントで動作しますが、 から同期メソッドを呼び出すと例外が表示される場合があります.NET/Core/Standard。

この変更の詳細については、GitHub の「PR 3388」を参照してください。

ドキュメントモデル: FromJsonメソッドとToJsonメソッド

ドキュメントクラスの FromJsonおよび ToJsonメソッドは、シリアル化に LitJson System.Text.Jsonの代わりに を使用するようになり、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) のサポートが削除されました。SDK の V4 は、IMDS から認証情報やその他のメタデータを取得するときに、常にインスタンスメタデータサービスバージョン 2 (IMDSv2) を使用します。IMDS の詳細については、Amazon EC2 ユーザーガイド」の「IMDS の使用」を参照してください。

変更または削除された要素のプログラミング

AWS リージョン us-east-1

us-east-1 リージョン用に設定された Amazon S3 サービスクライアントは、他のリージョンのバケットにアクセスできなくなります。バケットには、バケットがあるリージョン用に設定された S3 サービスクライアントを使用してアクセスする必要があります。

この変更の詳細については、ブログ記事「V4 の AWS SDK for .NET プレビュー 4」を参照してください。

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。移行の詳細については、「」を参照してくださいAmazon S3 暗号化クライアントの移行。S3 暗号化の詳細については、「Amazon S3 暗号化クライアントデベロッパーガイド」の「サポートされている暗号化アルゴリズムAmazon S3」を参照してください。

の S3 タグ付けディレクティブ CopyObject

TaggingDirective プロパティは、 AmazonS3Client.CopyObjectメソッドで使用される CopyObjectRequest クラスのパブリックプロパティとして公開されています。このプロパティは、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メソッドは、ICoreAmazonS33 インターフェイスを実装する AmazonS3Util クラスから削除されました。これらのメソッドは常に HTTP を使用するため、削除されました。代わりに DoesS3BucketExistV2 と DoesS3BucketExistV2Async を使用します。

SDK は常に SigV4 を使用します

のバージョン 4 では、署名リクエストに AWS SDK for .NET 常に AWS 署名バージョン 4 (SigV4) が使用されます。この変更により、以下の関連する変更が行われます。

GetACL および PutACLメソッド

AmazonS3Client クラスの GetACLおよび PutACLメソッドは廃止とマークされています。これらのメソッドの機能にアクセスするには、代わりに GetBucketACL、、PutBucketACL、GetObjectACLおよび の新しいメソッドを使用しますPutObjectACL。

廃止されたプログラミング要素の削除

列挙値、型、メソッド、名前空間など、Amazon S3 実装の多くのプログラミング要素が SDK の V4 から削除されました。これらは、以前に説明されていない場合は、削除に対応するために実行できる潜在的な手順とともに、以下に一覧表示されます。

Amazon.Auth.AccessControlPolicy.ActionIdentifiers​ 名前空間

Amazon.Auth.AccessControlPolicy.ActionIdentifiers 名前空間は削除されました。これには、 IdentityandAccessManagementActionIdentifiers クラスで定義された IAM アクション識別子が含まれます。これらのアクション識別子を使用するコードは、アクション名の文字列値を使用するように変更する必要があります。

詳細については、「IAM ユーザーガイド」のJSON からの IAM マネージドポリシーの作成「」および「JSON ポリシーの概要」を参照してください。 https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json

ClientConfig クラス

Amazon.Runtime.ClientConfig クラスは、AmazonS3Config などのサービスクライアント設定クラスのベースクラスです。このクラスから次のプログラミング要素が削除されました。

Amazon.Runtime​ 名前空間

Amazon.Runtime 名前空間が次のように更新されました。

BouncyCastle

BouncyCastle のソースコピーが SDK の V4 から削除されました。

StoredProfileSAMLCredentials クラス

Amazon.SecurityToken.SAML 名前空間の古いStoredProfileSAMLCredentialsクラスは削除されました。代わりに、Amazon.Runtime 名前空間で FederatedAWSCredentials クラスを使用します。

AWSSDKUtils クラス

AWSSDKUtils クラスから、ResolveResourcePath、ProtectEncodedSlashUrlEncode、および メソッドが削除されましたConvertToUnixEpochMilliSeconds。

ProfileManager クラス

古いProfileManagerクラスが Amazon.Util 名前空間から削除されました。代わりに、Amazon.Runtime.CredentialManagement 名前空間の NetSDKCredentialsFile または SharedCredentialsFile クラスを使用します。

AWSConfigs クラス

次の古いプロパティが AWSConfigs クラスから削除されました: Logging、ResponseLogging、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 クラスの古いコンストラクタが削除されました。