Migration vers la version 4 du AWS SDK pour .NET

Ajoutez le AWSSDK.Extensions.Logging.Log4NetAdaptor NuGet package et appelez la ConfigureAWSSDKLogging méthode statique à partir deLog4NetAWSExtensions.

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

Ajoutez le AWSSDK.Extensions.Logging.ILoggerAdaptor NuGet package et appelez la méthode d'ConfigureAWSSDKLoggingextension depuis l'ILoggerFactoryinterface.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

Les modifications apportées à la version 4 du SDK pour DynamoDB résolvent certains problèmes liés à la testabilité, mais concernent principalement les bibliothèques de haut niveau :

Pour obtenir des informations détaillées sur ces modes de programmation, consultez DynamoDB ce guide.

Modèle de document : exception mise à jour pour l'interface simulée IAmazonDynamoDB

Dans le modèle de document antérieur à la version V4 du SDK, si une table était initialisée avec une interface IAmazonDynamoDB simulée, elle retournait. NullReferenceException La version V4 du SDK revient à la InvalidOperationException place. TableLes méthodes asynchrones devraient fonctionner avec un client simulé, mais il se peut que vous rencontriez des exceptions lorsque vous appelez des méthodes synchrones depuis. .NET/Core/Standard

Pour plus d'informations sur cette modification, consultez le PR 3388 sur GitHub.

Modèle de document : FromJson et ToJson méthodes

Les ToJson méthodes FromJson et de la classe Document sont désormais utilisées à la System.Text.Json place LitJson de la sérialisation et ont LitJson été supprimées de la version 4 du SDK. L'un des avantages de son utilisation System.Text.Json est que cet analyseur prend en charge l'utilisation du Decimal type .NET, qui permet une plus grande précision pour les propriétés numériques à virgule flottante.

Modèle de persistance des objets : la DynamoDBOperationConfig classe

Dans le modèle de persistance des objets, les modifications suivantes ont été apportées à la classe Dynamo DBOperation Config partagée :

Modèle de persistance des objets : polymorphisme

La DBPolymorphic TypeAttribute classe Dynamo a été ajoutée au modèle de persistance des objets. Cette classe permet de prendre en charge la sérialisation et la désérialisation des types polymorphes. Pour plus d'informations, consultez le PR 3643 sur GitHub.

Modèle de document et modèle de persistance des objets : opérations simulables

De nouvelles interfaces spécifiques aux opérations ont été ajoutées pour permettre aux clients de simuler des opérations DynamoDB. Les méthodes d'usine de l'IDynamoDBContextinterface ont été mises à jour pour renvoyer les nouvelles interfaces.

Pour plus d'informations sur cette modification, voir PR 3450 on GitHub.

Modèle de document et modèle de persistance des objets : Support de l'AOT natif

L'une des limites de l'AOT natif est la prise en charge des types .NET imbriqués. Dans certains cas, ces types imbriqués peuvent passer inaperçus par le composant de découpage du compilateur .NET. Dans ce cas, il se peut que vous receviez une exception telle que : « System.InvalidOperationException: Type <type> is unsupported, it cannot be instantiated. »

Vous pouvez contourner cette limitation en ajoutant un élément dans DynamicDependency le chemin du code qui informe le trimmer de la dépendance à l'égard du sous-type. Le constructeur du type .NET de niveau supérieur en cours d'enregistrement est un endroit probable. L'exemple de code suivant montre comment utiliser l'DynamicDependencyattribut :

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

Dynamo DBStreams

Dynamo DBStreams a été supprimé du package AWSSDK.DynamoDB et est disponible dans son propre NuGet package, AWSSDK.Dynamo, et possède son propre espace de noms DBStreams,. Amazon.DynamoDBStreams

Autoriser la suppression de la TableNamePrefix valeur

Vous pouvez désormais supprimer la valeur de la TableNamePrefix propriété dans la classe Dynamo DBContext Config au niveau de l'opération individuelle. Pour plus d'informations sur cette modification, consultez le PR 3476 sur GitHub.

propriété RetrieveDateTimeInUtc

Pour la classe Dynamo DBContext Config, la valeur par défaut de la RetrieveDateTimeInUtc propriété a été modifiée entrue.

propriété DynamoDBContextTableNamePrefix

La DynamoDBContextTableNamePrefix propriété a été supprimée de la AWSConfigsclasse DynamoDB. Les utilisateurs doivent appeler AWSConfigsDynamoDB.Context.TableNamePrefix au lieu de

GetDecryptedPassword

L'GetDecryptedPasswordextension pour Amazon EC2 a été déplacée vers un package d'extension distinct appelé AWSSDK.Extensions. EC2. DecryptPassword. Ce changement vise à prendre en charge OpenSSL 3 et à devenir dépendant de .Cryptography. BouncyCastle

Le code source de ce package se trouve GitHub surhttps://github.com/aws/aws-sdk-net/tree/main/extensions/src/AWSSDK.Extensions.EC2.DecryptPassword.

Support pour Amazon EC2 IMDSv1

Support pour le service de métadonnées d'instance version 1 (IMDSv1) a été supprimé. La version 4 du SDK utilise toujours le service de métadonnées d'instance version 2 (IMDSv2) lors de la récupération des informations d'identification et d'autres métadonnées à partir de l'IMDS. Pour plus d'informations sur l'IMDS, consultez la section Utiliser l'IMDS dans le guide de EC2 l'utilisateur Amazon.

Éléments de programmation qui ont été modifiés ou supprimés

Région AWS us-east-1

Les clients du service Amazon S3 configurés pour la us-east-1 région ne peuvent plus accéder aux compartiments des autres régions. Les compartiments doivent être accessibles avec des clients du service S3 configurés pour la région dans laquelle se trouve le compartiment.

Pour plus d'informations sur cette modification, consultez le billet de blog Preview 4 of AWS SDK pour .NET V4.

Client de chiffrement S3

Le client de chiffrement Amazon S3, défini dans l'espace de Amazon.S3.Encryption noms, a été supprimé du package AWSSDK.S3. Ce client a été déplacé vers son propre package appelé Amazon.Extensions.S3.Encryption, et sa documentation se trouve à l'adresse. https://aws.github.io/amazon-s3-encryption-client-dotnet/api/Amazon.Extensions.S3.Encryption.html Pour plus d'informations sur la migration, consultezMigration du client de chiffrement Amazon S3. Pour plus d'informations sur le chiffrement S3, consultez la section Algorithmes de chiffrement pris en charge dans le manuel Amazon S3 Encryption Client Developer Guide.

Directive de balisage S3 pour CopyObject

La TaggingDirective propriété a été exposée en tant que propriété publique de la CopyObjectRequestclasse, qui est utilisée par AmazonS3Client.CopyObject les méthodes. Cette propriété correspond au x-amz-tagging-directive paramètre Amazon S3, tel que défini dans l'CopyObjectaction.

La directive de balisage n'est plus automatiquement définie sur COPY. Si un développeur ne spécifie pas de directive de balisage, le backend S3 suppose automatiquement qu'il s'agit de COPY, mais si un développeur définit explicitement la propriété sur null, la valeur n'est pas définie du tout.

La UseArnRegion propriété pour la configuration S3

La UseArnRegion propriété de la classe Amazon.S3.AmazonS3Config a été mise à jour de telle sorte que la variable d'AWS_S3_USE_ARN_REGIONenvironnement a priorité sur le paramètre du fichier partagé. s3_use_arn_region AWS config Pour plus d'informations sur ces variables et paramètres, consultez la section Référence des paramètres dans le Guide de référence des outils AWS SDKs et des outils.

Principales barres obliques pour les méthodes et CopyObjectCopyPart

Les barres obliques en tête ne seront plus supprimées pour Amazon S3 CopyObject et ses méthodes. CopyPart La DisableTrimmingLeadingSlash propriété a été supprimée des CopyPartRequestclasses CopyObjectRequestet.

Les DoesS3BucketExist... méthodes

Les DoesS3BucketExistAsync méthodes DoesS3BucketExist et méthodes obsolètes ont été supprimées de la classe AmazonS3Util, qui implémente l'interface AmazonS3. ICore Ces méthodes ont été supprimées car elles utilisent toujours le protocole HTTP. Utilisez plutôt DoESS3 BucketExist V2 et DoESS3 V2Async BucketExist.

Le SDK utilise toujours SigV4

La version 4 du utilise AWS SDK pour .NET toujours la version 4 de AWS Signature (SigV4) pour les demandes de signature. Cette modification entraîne les modifications connexes suivantes :

Les PutACL méthodes GetACL et

Les PutACL méthodes GetACL et de la classe AmazonS3Client ont été marquées comme obsolètes. Pour accéder aux fonctionnalités de ces méthodes, utilisez plutôt les nouvelles méthodes suivantes : GetBucketACLPutBucketACL,GetObjectACL, etPutObjectACL.

Éléments de programmation obsolètes supprimés

Un certain nombre d'éléments de programmation de l'implémentation d'Amazon S3 ont été supprimés de la version V4 du SDK, notamment les valeurs d'énumération, les types, les méthodes, les espaces de noms, etc. Ils sont énumérés ci-dessous, s'ils ne l'ont pas déjà été, ainsi que les mesures que vous pouvez prendre pour faciliter leur suppression.

L'espace de noms Amazon.Auth.AccessControlPolicy.ActionIdentifiers

L'Amazon.Auth.AccessControlPolicy.ActionIdentifiersespace de noms a été supprimé. Cela inclut les identifiants d'action IAM, qui ont été définis dans la IdentityandAccessManagementActionIdentifiers classe. Le code qui utilise ces identificateurs d'action doit être modifié pour utiliser les valeurs de chaîne du nom de l'action.

Pour plus d'informations, consultez la section Présentation Création de politiques gérées par IAM à partir de JSON des politiques JSON dans le guide de l'utilisateur IAM.

La classe ClientConfig

L'Amazon.Runtime. ClientConfigclass est la classe de base des classes de configuration des clients de service telles que AmazonS3Config. Les éléments de programmation suivants ont été supprimés de cette classe.

L'espace de noms Amazon.Runtime

L'espace de noms Amazon.Runtime a été mis à jour comme suit :

BouncyCastle

La copie source de BouncyCastle a été supprimée de la version V4 du SDK.

La classe StoredProfileSAMLCredentials

La StoredProfileSAMLCredentials classe obsolète d'Amazon. SecurityTokenL'espace de noms .SAML a été supprimé. Utilisez plutôt la AWSCredentials classe Federated dans l'espace de noms Amazon.Runtime.

La classe AWSSDKUtils

Les méthodes suivantes ont été supprimées de la AWSSDKUtilsclasse : ResolveResourcePathProtectEncodedSlashUrlEncode, etConvertToUnixEpochMilliSeconds.

La classe ProfileManager

La ProfileManager classe obsolète a été supprimée de l'espace de noms Amazon.Util. Utilisez le SDKCredentialsfichier réseau ou la SharedCredentialsFileclasse d'Amazon.Runtime. CredentialManagementespace de noms à la place.

La classe AWSConfigs

Les propriétés obsolètes suivantes ont été supprimées de la AWSConfigsclasse :Logging,ResponseLogging, etLogMetrics. Utilisez plutôt la propriété LoggingConfig.

La classe ConditionFactory

La méthode avec la signature suivante a été supprimée de la ConditionFactoryclasse :NewCondition(ConditionFactory.DateComparisonType, DateTime). Utilisez plutôt la NewConditionUtcméthode.

CloudFront Utilitaires Amazon

L'espace de Amazon.CloudFront.Util noms et la AmazonCloudFrontUtil classe obsolètes ont été supprimés.

AWS IoT

Dans le ListPrincipalThingsResponsecours, une ancienne personnalisation pour une NextToken dérogation a été supprimée au profit de la pagination.

AWS Lambda

Les Invoke... méthodes suivantes de la AmazonLambdaClientclasse ont été supprimées car les noms prêtaient à confusion.

Amazon SageMaker Runtime

Les constructeurs obsolètes de la PayloadPartclasse ont été supprimés.