Migrasi ke versi 4 AWS SDK untuk .NET

Tambahkan AWSSDK.Extensions.Logging.Log4NetAdaptor NuGet paket dan panggil ConfigureAWSSDKLogging metode statis dariLog4NetAWSExtensions.

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

Tambahkan AWSSDK.Extensions.Logging.ILoggerAdaptor NuGet paket dan panggil metode ConfigureAWSSDKLogging ekstensi dari ILoggerFactory antarmuka.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

Perubahan V4 dalam SDK untuk DynamoDB mengatasi beberapa masalah seputar stabilitas pengujian, tetapi terutama berpusat di sekitar pustaka tingkat tinggi:

Untuk informasi rinci tentang mode pemrograman ini, lihat DynamoDB di panduan ini.

Model Dokumen: Pengecualian yang diperbarui untuk antarmuka yang diejek IAmazonDynamoDB

Dalam model dokumen sebelum V4 SDK, jika Tabel diinisialisasi dengan antarmuka DynamoDB IAmazon tiruan, itu akan kembali. NullReferenceException V4 dari SDK kembali InvalidOperationException sebagai gantinya. TableMetode asinkron harus bekerja dengan klien tiruan tetapi Anda mungkin masih melihat pengecualian saat memanggil metode sinkron dari. .NET/Core/Standard

Untuk informasi lebih lanjut tentang perubahan ini, lihat PR 3388 di. GitHub

Model Dokumen: FromJson dan ToJson metode

ToJsonMetode FromJson dan kelas Document sekarang digunakan System.Text.Json bukan LitJson untuk serialisasi, dan LitJson telah dihapus dari V4 SDK. Manfaat menggunakan System.Text.Json adalah bahwa parser ini mendukung penggunaan Decimal tipe.NET, yang mendukung presisi yang lebih tinggi untuk properti floating point numerik.

Model Persistensi Objek: Kelas DynamoDBOperationConfig

Dalam model persistensi objek, perubahan berikut telah dilakukan pada kelas Dynamo Config DBOperation bersama:

Model Persistensi Objek: Polimorfisme

DBPolymorphicTypeAttributeKelas Dynamo ditambahkan ke model ketekunan objek. Kelas ini memungkinkan dukungan untuk serialisasi dan deserialisasi tipe polimorfik. Untuk informasi lebih lanjut, lihat PR 3643 di GitHub.

Model Dokumen dan Model Persistensi Objek: Operasi Mockable

Antarmuka khusus operasi baru telah ditambahkan yang memungkinkan pelanggan untuk mengejek operasi DynamoDB. Metode pabrik pada IDynamoDBContextantarmuka telah diperbarui untuk mengembalikan antarmuka baru.

Untuk informasi lebih lanjut tentang perubahan ini, lihat PR 3450 di GitHub.

Model Dokumen dan Model Persistensi Objek: Dukungan untuk AOT Asli

Batasan Native AOT adalah dukungan untuk tipe.NET bersarang. Dalam beberapa kasus, tipe bersarang ini mungkin luput dari perhatian oleh komponen pemangkasan dari kompiler.NET. Dalam hal ini, Anda mungkin menerima pengecualian seperti: "System.InvalidOperationException: Type <type> is unsupported, it cannot be instantiated.”

Anda dapat mengatasi batasan ini dengan menambahkan DynamicDependency suatu tempat di jalur kode yang memberi tahu pemangkas tentang ketergantungan pada sub-tipe. Konstruktor tipe.NET tingkat atas yang disimpan adalah tempat yang mungkin. Contoh kode berikut menunjukkan cara menggunakan DynamicDependency atribut:

[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; }
}

Dinamo DBStreams

Dynamo DBStreams telah dihapus dari AWSSDKpaket.DynamoDB dan tersedia dalam NuGet paketnya sendiri, AWSSDK.Dynamo, dan memiliki namespace sendiriDBStreams,. Amazon.DynamoDBStreams

Izinkan penghapusan TableNamePrefix nilai

Anda sekarang dapat menghapus nilai TableNamePrefix properti di kelas Dynamo DBContext Config pada tingkat operasi individu. Untuk informasi lebih lanjut tentang perubahan ini, lihat PR 3476 di GitHub.

RetrieveDateTimeInUtcproperti

Untuk kelas Dynamo DBContext Config, nilai default properti telah diubah menjadi. RetrieveDateTimeInUtc true

DynamoDBContextTableNamePrefixproperti

Dihapus DynamoDBContextTableNamePrefix properti dari kelas AWSConfigsDynamoDB. Pengguna harus menelepon AWSConfigsDynamoDB.Context.TableNamePrefix alih-alih

GetDecryptedPassword

GetDecryptedPasswordEkstensi untuk Amazon EC2 telah dipindahkan ke paket ekstensi terpisah yang disebut AWSSDK.Extensions. EC2. DecryptPassword. Perubahan ini untuk mendukung OpenSSL 3 dan mengambil ketergantungan pada .Cryptography. BouncyCastle

Kode sumber untuk paket ini aktif GitHub dihttps://github.com/aws/aws-sdk-net/tree/main/extensions/src/AWSSDK.Extensions.EC2.DecryptPassword.

Support untuk Amazon EC2 IMDSv1

Support for Instance Metadata Service Version 1 (IMDSv1) telah dihapus. V4 SDK selalu menggunakan Instance Metadata Service Version 2 (IMDSv2) saat mengambil kredensyal dan metadata lainnya dari IMDS. Untuk informasi selengkapnya tentang IMDS, lihat Menggunakan IMDS di EC2 Panduan Pengguna Amazon.

Elemen pemrograman yang diubah atau dihapus

Wilayah AWS us-east-1

Klien layanan Amazon S3 yang dikonfigurasi untuk us-east-1 Wilayah tidak dapat lagi mengakses bucket di Wilayah lain. Bucket harus diakses dengan klien layanan S3 yang dikonfigurasi untuk Wilayah tempat bucket berada.

Untuk informasi tambahan tentang perubahan ini, lihat posting blog Pratinjau 4 dari AWS SDK untuk .NET V4.

Klien enkripsi S3

Klien enkripsi Amazon S3, yang didefinisikan dalam Amazon.S3.Encryption namespace, telah dihapus dari paket.S3. AWSSDK Klien ini telah dipindahkan ke paketnya sendiri yang disebut Amazon.Extensions.S3.Encryption, dan dokumentasinya ada di. https://aws.github.io/amazon-s3-encryption-client-dotnet/api/Amazon.Extensions.S3.Encryption.html Untuk informasi tentang migrasi, lihatMigrasi Klien Enkripsi Amazon S3. Untuk informasi selengkapnya tentang enkripsi S3, lihat Algoritma enkripsi yang didukung di Panduan Pengembang Klien Enkripsi Amazon S3.

Arahan penandaan S3 untuk CopyObject

TaggingDirectiveProperti telah diekspos sebagai milik umum CopyObjectRequestkelas, yang digunakan oleh AmazonS3Client.CopyObject metode. Properti ini sesuai dengan x-amz-tagging-directive parameter Amazon S3, seperti yang didefinisikan dalam tindakan. CopyObject

Arahan penandaan tidak lagi secara otomatis diatur ke COPY. Jika pengembang tidak menentukan arahan penandaan, backend S3 secara otomatis mengasumsikan itu adalah COPY, tetapi jika pengembang secara eksplisit menyetel properti ke null, maka nilainya tidak disetel sama sekali.

UseArnRegionProperti untuk konfigurasi S3

UseArnRegionProperti kelas Amazon.s3.amazons3config telah diperbarui sedemikian rupa sehingga variabel AWS_S3_USE_ARN_REGION lingkungan lebih diutamakan daripada pengaturan dalam file bersama. s3_use_arn_region AWS config Untuk informasi selengkapnya tentang variabel dan pengaturan ini, lihat Referensi pengaturan di Panduan Referensi Alat AWS SDKs dan Alat.

garis miring terkemuka untuk metode CopyObject dan CopyPart

garis miring terkemuka tidak akan lagi dipangkas untuk Amazon CopyObject CopyPart S3 dan metode. DisableTrimmingLeadingSlashProperti telah dihapus dari CopyPartRequestkelas CopyObjectRequestdan.

DoesS3BucketExist...Metodenya

Usang DoesS3BucketExist dan DoesS3BucketExistAsync metode telah dihapus dari kelas Amazons3Util, yang mengimplementasikan antarmuka AmazonS3. ICore Metode ini dihapus karena mereka selalu menggunakan HTTP. Gunakan Doess3 BucketExist V2 dan BucketExistDoess3 V2Async sebagai gantinya.

SDK selalu menggunakan SiGv4

Versi 4 AWS SDK untuk .NET selalu menggunakan AWS Signature Version 4 (SiGv4) untuk menandatangani permintaan. Perubahan ini menghasilkan perubahan terkait berikut:

PutACLMetode GetACL dan

PutACLMetode GetACL dan dari kelas Amazons3Client telah ditandai sebagai usang. Untuk mengakses fungsionalitas metode ini, gunakan metode baru berikut sebagai gantinya:GetBucketACL,PutBucketACL,GetObjectACL, danPutObjectACL.

Elemen pemrograman usang dihapus

Sejumlah elemen pemrograman implementasi Amazon S3 telah dihapus dari V4 SDK, termasuk nilai enumerasi, jenis, metode, ruang nama, dll. Ini tercantum di bawah ini, jika belum dibahas sebelumnya, bersama dengan langkah-langkah potensial yang dapat Anda ambil untuk mengakomodasi penghapusan mereka.

Namespace Amazon.Auth.AccessControlPolicy.ActionIdentifiers

Amazon.Auth.AccessControlPolicy.ActionIdentifiersNamespace telah dihapus. Ini termasuk pengidentifikasi tindakan IAM, yang didefinisikan di kelas. IdentityandAccessManagementActionIdentifiers Kode yang menggunakan pengidentifikasi tindakan ini harus diubah untuk menggunakan nilai string dari nama tindakan.

Untuk informasi tambahan, lihat Membuat kebijakan terkelola IAM dari JSON dan Ringkasan kebijakan JSON di Panduan Pengguna IAM.

ClientConfigKelas

Amazon.Runtime. ClientConfigclass adalah kelas dasar dari kelas konfigurasi klien layanan seperti Amazons3config. Elemen pemrograman berikut telah dihapus dari kelas ini.

Namespace Amazon.Runtime

Namespace Amazon.Runtime telah diperbarui sebagai berikut:

BouncyCastle

Salinan sumber BouncyCastle telah dihapus dari V4 SDK.

StoredProfileSAMLCredentialsKelas

StoredProfileSAMLCredentialsKelas usang di Amazon. SecurityTokenNamespace .SALL telah dihapus. Gunakan AWSCredentials kelas Federasi di namespace Amazon.Runtime sebagai gantinya.

AWSSDKUtilsKelas

Metode berikut telah dihapus dari AWSSDKUtilskelas:ResolveResourcePath,ProtectEncodedSlashUrlEncode, danConvertToUnixEpochMilliSeconds.

ProfileManagerKelas

ProfileManagerKelas usang telah dihapus dari namespace Amazon.Util. Gunakan SDKCredentialsFile Net atau SharedCredentialsFilekelas dari Amazon.Runtime. CredentialManagementnamespace sebagai gantinya.

AWSConfigsKelas

Properti usang berikut telah dihapus dari AWSConfigskelas:Logging,ResponseLogging, dan. LogMetrics Gunakan LoggingConfig properti sebagai gantinya.

ConditionFactoryKelas

Metode dengan tanda tangan berikut telah dihapus dari ConditionFactorykelas:NewCondition(ConditionFactory.DateComparisonType, DateTime). Gunakan NewConditionUtcmetode sebagai gantinya.

CloudFront Utilitas Amazon

Amazon.CloudFront.UtilNamespace dan AmazonCloudFrontUtil kelas usang telah dihapus.

AWS IoT

Di ListPrincipalThingsResponsekelas, kustomisasi lama untuk NextToken penggantian telah dihapus demi pagination.

AWS Lambda

Invoke...Metode AmazonLambdaClientkelas berikut telah dihapus karena nama-nama yang membingungkan.

SageMaker Runtime Amazon

Konstruktor usang untuk PayloadPartkelas telah dihapus.