Migrazione alla versione 4 di AWS SDK per .NET

Aggiungi il AWSSDK.Extensions.Logging.Log4NetAdaptor NuGet pacchetto e chiama il ConfigureAWSSDKLogging metodo statico da. 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));

Aggiungere il AWSSDK.Extensions.Logging.ILoggerAdaptor NuGet pacchetto e chiamare il metodo di estensione dall'ConfigureAWSSDKLogginginterfaccia. ILoggerFactory

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

Le modifiche alla V4 all'SDK per DynamoDB risolvono alcuni problemi relativi alla testabilità, ma riguardano principalmente le librerie di alto livello:

Per informazioni dettagliate su queste modalità di programmazione, DynamoDB consulta questa guida.

Modello di documento: eccezione aggiornata per l'interfaccia IAmazonDynamoDB simulata

Nel modello di documento precedente alla V4 dell'SDK, se una tabella veniva inizializzata con un'interfaccia DynamoDB IAmazon simulata, veniva restituita. NullReferenceException Viene invece restituita la V4 dell'SDK. InvalidOperationException TableI metodi asincroni dovrebbero funzionare con un client simulato, ma potresti comunque vedere delle eccezioni quando chiami metodi sincroni da. .NET/Core/Standard

Per ulteriori informazioni su questa modifica, vedere PR 3388 su. GitHub

Modello di documento: FromJson e metodi ToJson

ToJsonI metodi FromJson and della classe Document ora vengono utilizzati System.Text.Json al posto della LitJson serializzazione e sono LitJson stati rimossi dalla versione 4 dell'SDK. Un vantaggio dell'utilizzo System.Text.Json è che questo parser supporta l'utilizzo del Decimal tipo.NET, che supporta una maggiore precisione per le proprietà numeriche a virgola mobile.

Object Persistence Model: la classe DynamoDBOperationConfig

Nel modello di persistenza degli oggetti, sono state apportate le seguenti modifiche alla classe condivisa Dynamo DBOperation Config:

Modello di persistenza degli oggetti: polimorfismo

La DynamoDBPolymorphicTypeAttribute classe è stata aggiunta al modello di persistenza degli oggetti. Questa classe abilita il supporto per la serializzazione e la deserializzazione di tipi polimorfici. Per ulteriori informazioni, vedere PR 3643 su. GitHub

Modello di documento e modello di persistenza degli oggetti: operazioni mockabili

Sono state aggiunte nuove interfacce specifiche per le operazioni che consentono ai clienti di simulare le operazioni di DynamoDB. I metodi di fabbrica sull'IDynamoDBContextinterfaccia sono stati aggiornati per restituire le nuove interfacce.

Per ulteriori informazioni su questa modifica, vedere PR 3450 su. GitHub

Modello di documento e modello di persistenza degli oggetti: supporto per AOT nativo

Una limitazione di Native AOT è il supporto per i tipi.NET annidati. In alcuni casi, questi tipi annidati potrebbero passare inosservati al componente di taglio del compilatore.NET. In questo caso, potresti ricevere un'eccezione come: "» System.InvalidOperationException: Type <type> is unsupported, it cannot be instantiated.

È possibile aggirare questa limitazione aggiungendo il percorso del codice DynamicDependency da qualche parte nel percorso del codice che informa il trimmer sulla dipendenza dal sottotipo. È probabile che venga salvato il costruttore del tipo.NET di primo livello. Il seguente esempio di codice mostra come utilizzare l'DynamicDependencyattributo:

[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 è stato rimosso dal AWSSDKpacchetto.DynamoDB ed è disponibile nel suo NuGet pacchetto, AWSSDK.Dynamo DBStreams, e ha il proprio spazio dei nomi,. Amazon.DynamoDBStreams

Consenti la rimozione TableNamePrefix del valore

È ora possibile rimuovere il valore della TableNamePrefix proprietà nella classe Dynamo DBContext Config a livello di singola operazione. Per ulteriori informazioni su questa modifica, vedere PR 3476 su. GitHub

RetrieveDateTimeInUtc property

Per la classe Dynamo DBContext Config, il valore predefinito della RetrieveDateTimeInUtc proprietà è stato modificato in. true

DynamoDBContextTableNamePrefix property

Rimossa la DynamoDBContextTableNamePrefix proprietà dalla classe AWSConfigsDynamoDB. Gli utenti devono chiamare invece AWSConfigsDynamoDB.Context.TableNamePrefix di

GetDecryptedPassword

L'GetDecryptedPasswordestensione per Amazon EC2 è stata spostata in un pacchetto di estensione separato chiamato AWSSDK.Extensions. EC2. DecryptPassword. Questa modifica prevede il supporto di OpenSSL 3 e la dipendenza da.Cryptography. BouncyCastle

Il codice sorgente di questo pacchetto è disponibile all'indirizzo. GitHub https://github.com/aws/aws-sdk-net/tree/v4-release/extensions/src/AWSSDK.Extensions.EC2.DecryptPassword

Support per Amazon EC2 IMDSv1

Il supporto per Instance Metadata Service Version 1 (IMDSv1) è stato rimosso. La versione 4 dell'SDK utilizza sempre Instance Metadata Service versione 2 (IMDSv2) per recuperare credenziali e altri metadati dall'IMDS. Per ulteriori informazioni sull'IMDS, consulta Use the IMDS nella Amazon EC2 User Guide.

Elementi di programmazione che sono stati modificati o rimossi

Regione AWS us-east-1

I client di servizio Amazon S3 configurati per la us-east-1 regione non possono più accedere ai bucket in altre regioni. È necessario accedere ai bucket con i client di servizio S3 configurati per la regione in cui si trova il bucket.

Client di crittografia S3

Il client di crittografia Amazon S3, definito nello spazio dei Amazon.S3.Encryption nomi, è stato rimosso dal pacchetto.S3. AWSSDK Questo client è stato spostato nel suo pacchetto chiamato Amazon.Extensions.S3.Encryption e la relativa documentazione è disponibile all'indirizzo. https://aws.github.io/amazon-s3-encryption-client-dotnet/api/Amazon.Extensions.S3.Encryption.html Per informazioni sulla migrazione, consulta. Migrazione del client di crittografia Amazon S3 Per ulteriori informazioni sulla crittografia S3, consulta Algoritmi di crittografia supportati nella Amazon S3 Encryption Client Developer Guide.

Direttiva di tagging S3 per CopyObject

La TaggingDirective proprietà è stata esposta come proprietà pubblica della CopyObjectRequestclasse, utilizzata dai AmazonS3Client.CopyObject metodi. Questa proprietà corrisponde al x-amz-tagging-directive parametro Amazon S3, come definito nell'azione CopyObject.

La direttiva di etichettatura non è più impostata automaticamente su COPY. Se uno sviluppatore non specifica una direttiva di tagging, il backend S3 presume automaticamente che sia COPY, ma se uno sviluppatore imposta esplicitamente la proprietà su null, il valore non viene impostato affatto.

La proprietà per la configurazione di S3 UseArnRegion

La UseArnRegion proprietà della classe amazon.s3.amazonS3Config è stata aggiornata in modo tale che la variabile di AWS_S3_USE_ARN_REGION ambiente abbia la precedenza sull'impostazione nel file condiviso. s3_use_arn_region AWS config Per ulteriori informazioni su queste variabili e impostazioni, consulta il riferimento alle impostazioni nella and Tools Reference Guide.AWS SDKs

Barre iniziali per i metodi CopyObject and CopyPart

Le barre iniziali non verranno più tagliate per Amazon S3 e i metodi. CopyObject CopyPart La DisableTrimmingLeadingSlash proprietà è stata rimossa dalle classi and. CopyObjectRequestCopyPartRequest

I DoesS3BucketExist... metodi

I DoesS3BucketExistAsync metodi obsoleti DoesS3BucketExist sono stati rimossi dalla classe AmazonS3Util, che implementa l'interfaccia AmazonS3. ICore Questi metodi sono stati rimossi perché utilizzano sempre HTTP. Utilizzate invece DoEss3 BucketExist V2 e BucketExistDoESS3 V2Async.

SDK utilizza sempre SigV4

La versione 4 di utilizza AWS SDK per .NET sempre la versione 4 della AWS firma (SigV4) per la firma delle richieste. Questa modifica comporta le seguenti modifiche correlate:

I PutACL metodi GetACL e

I PutACL metodi GetACL and della classe AmazonS3Client sono stati contrassegnati come obsoleti. Per accedere alle funzionalità di questi metodi, utilizza invece i seguenti nuovi metodi:GetBucketACL,, e. PutBucketACL GetObjectACL PutObjectACL

Elementi di programmazione obsoleti rimossi

Diversi elementi di programmazione dell'implementazione di Amazon S3 sono stati rimossi dalla versione 4 dell'SDK, inclusi valori di enumerazione, tipi, metodi, namespace, ecc. Questi sono elencati di seguito, se non sono già stati trattati in precedenza, insieme ai potenziali passaggi che è possibile adottare per facilitarne la rimozione.

Lo spazio dei nomi Amazon.Auth.AccessControlPolicy.ActionIdentifiers

Amazon.Auth. AccessControlPolicy. ActionIdentifierslo spazio dei nomi è stato rimosso. Ciò include gli identificatori di azione IAM, che sono stati definiti nella classe. IdentityandAccessManagementActionIdentifiers Il codice che utilizza questi identificatori di azione deve essere modificato per utilizzare i valori di stringa del nome dell'azione.

Per ulteriori informazioni, consulta la sezione Creazione di policy gestite da IAM da JSON Panoramica delle policy JSON nella IAM User Guide.

La classe ClientConfig

Amazon.Runtime. ClientConfigclass è la classe base delle classi di configurazione dei client di servizio come AmazonS3Config. I seguenti elementi di programmazione sono stati rimossi da questa classe.

Lo spazio dei nomi Amazon.Runtime

Lo spazio dei nomi Amazon.Runtime è stato aggiornato come segue:

BouncyCastle

La copia sorgente di BouncyCastle è stata rimossa dalla V4 dell'SDK.

La classe StoredProfileSAMLCredentials

La StoredProfileSAMLCredentials classe obsoleta in Amazon. SecurityTokenLo spazio dei nomi.SAML è stato rimosso. Utilizzate invece la AWSCredentials classe Federated nello spazio dei nomi Amazon.Runtime.

La classe AWSSDKUtils

I seguenti metodi sono stati rimossi dalla classe:, e. AWSSDKUtilsResolveResourcePathProtectEncodedSlashUrlEncodeConvertToUnixEpochMilliSeconds

La classe ProfileManager

La ProfileManager classe obsoleta è stata rimossa dallo spazio dei nomi Amazon.Util. Utilizza il file o la classe Net di Amazon.Runtime SDKCredentials. SharedCredentialsFile CredentialManagementnamespace invece.

La classe AWSConfigs

Le seguenti proprietà obsolete sono state rimosse dalla AWSConfigsclasse:Logging, ResponseLogging e. LogMetrics Va invece utilizzata la proprietà LoggingConfig.

La classe ConditionFactory

Il metodo con la seguente firma è stato rimosso dalla ConditionFactoryclasse:NewCondition(ConditionFactory.DateComparisonType, DateTime). Usa invece il NewConditionUtcmetodo.

CloudFront Utilità Amazon

Lo spazio dei Amazon.CloudFront.Util nomi e la AmazonCloudFrontUtil classe obsoleti sono stati rimossi.

AWS IoT

Nella ListPrincipalThingsResponseclasse, una personalizzazione precedente per un NextToken override è stata rimossa a favore dell'impaginazione.

AWS Lambda

I seguenti Invoke... metodi della AmazonLambdaClientclasse sono stati rimossi perché i nomi erano confusi.

SageMaker Runtime di Amazon

I costruttori obsoleti per la PayloadPartclasse sono stati rimossi.