Migrando para a versão 4 do AWS SDK para .NET

Adicione o AWSSDK.Extensions.Logging.Log4NetAdaptor NuGet pacote e chame o ConfigureAWSSDKLogging método estático 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));

Adicione o AWSSDK.Extensions.Logging.ILoggerAdaptor NuGet pacote e chame o método de ConfigureAWSSDKLogging extensão a partir da ILoggerFactory interface.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

As mudanças da V4 no SDK para DynamoDB abordam alguns problemas relacionados à testabilidade, mas se concentram principalmente nas bibliotecas de alto nível:

Para obter informações detalhadas sobre esses modos de programação, consulte DynamoDB este guia.

Modelo de documento: exceção atualizada para interface simulada IAmazonDynamoDB

No modelo de documento anterior à V4 do SDK, se uma tabela fosse inicializada com uma interface simulada do DynamoDBIAmazon, ela retornaria. NullReferenceException Em vez disso, a V4 do SDK retornaInvalidOperationException. TableOs métodos assíncronos devem funcionar com um cliente simulado, mas você ainda pode ver exceções ao chamar métodos síncronos de. .NET/Core/Standard

Para obter mais informações sobre essa alteração, consulte PR 3388 em. GitHub

Modelo de documento: FromJson e ToJson métodos

Os ToJson métodos FromJson e da classe Document agora são usados System.Text.Json em vez de LitJson para serialização e LitJson foram removidos da V4 do SDK. Uma vantagem do uso System.Text.Json é que esse analisador suporta o uso do Decimal tipo.NET, que oferece maior precisão para propriedades numéricas de ponto flutuante.

Modelo de persistência de objetos: a classe DynamoDBOperationConfig

No modelo de persistência de objetos, as seguintes alterações foram feitas na classe compartilhada do Dynamo Config: DBOperation

Modelo de persistência de objetos: polimorfismo

A DBPolymorphic TypeAttribute classe Dynamo foi adicionada ao modelo de persistência de objetos. Essa classe permite suporte para serialização e desserialização de tipos polimórficos. Para obter mais informações, consulte PR 3643 em. GitHub

Modelo de documento e modelo de persistência de objetos: operações simuláveis

Novas interfaces específicas de operação foram adicionadas para permitir que os clientes simulem as operações do DynamoDB. Os métodos de fábrica na IDynamoDBContextinterface foram atualizados para retornar as novas interfaces.

Para obter mais informações sobre essa alteração, consulte PR 3450 on GitHub.

Modelo de documento e modelo de persistência de objetos: Support for native AOT

Uma limitação do AOT nativo é o suporte para tipos.NET aninhados. Em alguns casos, esses tipos aninhados podem passar despercebidos pelo componente de corte do compilador.NET. Nesse caso, você pode receber uma exceção, como: "System.InvalidOperationException: Type <type> is unsupported, it cannot be instantiated.”

Você pode contornar essa limitação adicionando DynamicDependency algum lugar no caminho do código que informa ao trimmer sobre a dependência do subtipo. O construtor do tipo.NET de nível superior que está sendo salvo é um lugar provável. O exemplo de código a seguir mostra como usar o DynamicDependency atributo:

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

Dínamo DBStreams

O Dynamo DBStreams foi removido do pacote AWSSDK.DynamoDB e está disponível em seu próprio NuGet pacote, AWSSDK.Dynamo, e tem seu próprio DBStreams namespace,. Amazon.DynamoDBStreams

Permitir a remoção do TableNamePrefix valor

Agora você pode remover o valor da TableNamePrefix propriedade na classe Dynamo DBContext Config no nível de operação individual. Para obter mais informações sobre essa alteração, consulte PR 3476 em GitHub.

a propriedade RetrieveDateTimeInUtc

Para a classe Dynamo DBContext Config, o valor padrão RetrieveDateTimeInUtc da propriedade foi alterado para. true

a propriedade DynamoDBContextTableNamePrefix

A DynamoDBContextTableNamePrefix propriedade foi removida da classe AWSConfigsDynamoDB. Os usuários devem ligar AWSConfigsDynamoDB.Context.TableNamePrefix em vez de

GetDecryptedPassword

A GetDecryptedPassword extensão da Amazon EC2 foi movida para um pacote de extensão separado chamado AWSSDK.Extensions. EC2. DecryptPassword. Essa alteração é para oferecer suporte ao OpenSSL 3 e depender do .Cryptography. BouncyCastle

O código-fonte desse pacote está GitHub emhttps://github.com/aws/aws-sdk-net/tree/main/extensions/src/AWSSDK.Extensions.EC2.DecryptPassword.

Support para Amazon EC2 IMDSv1

O suporte para o Instance Metadata Service versão 1 (IMDSv1) foi removido. A V4 do SDK sempre usa o Instance Metadata Service Version 2 (IMDSv2) ao buscar credenciais e outros metadados do IMDS. Para obter mais informações sobre o IMDS, consulte Usar o IMDS no Guia EC2 do usuário da Amazon.

Elementos de programação que foram alterados ou removidos

Região da AWS us-east-1

Os clientes do serviço Amazon S3 configurados para a us-east-1 região não podem mais acessar buckets em outras regiões. Os buckets devem ser acessados com clientes de serviço do S3 configurados para a região em que o bucket está.

Cliente de criptografia S3

O cliente de criptografia Amazon S3, definido no Amazon.S3.Encryption namespace, foi removido do pacote.S3. AWSSDK Esse cliente foi movido para seu próprio pacote chamado Amazon.Extensions.S3.Encryption, e a documentação para ele está em. https://aws.github.io/amazon-s3-encryption-client-dotnet/api/Amazon.Extensions.S3.Encryption.html Para obter informações sobre migração, consulteMigração de cliente de criptografia Amazon S3. Para obter mais informações sobre a criptografia S3, consulte Algoritmos de criptografia compatíveis no Guia do desenvolvedor do Amazon S3 Encryption Client.

Diretiva de marcação S3 para CopyObject

A TaggingDirective propriedade foi exposta como uma propriedade pública da CopyObjectRequestclasse, que é usada por AmazonS3Client.CopyObject métodos. Essa propriedade corresponde ao x-amz-tagging-directive parâmetro Amazon S3, conforme definido na CopyObjectação.

A diretiva de marcação não é mais definida automaticamente como COPY. Se um desenvolvedor não especificar uma diretiva de marcação, o back-end do S3 assumirá automaticamente que é COPY, mas se um desenvolvedor definir explicitamente a propriedade como nula, o valor não será definido de forma alguma.

A UseArnRegion propriedade para a configuração do S3

A UseArnRegion propriedade da classe Amazon.s3.amazons3Config foi atualizada para que a variável de AWS_S3_USE_ARN_REGION ambiente tenha precedência sobre a configuração no arquivo compartilhado. s3_use_arn_region AWS config Para obter mais informações sobre essas variáveis e configurações, consulte Referência de configurações no Guia AWS SDKs de referência de ferramentas.

Barras iniciais para os métodos CopyObject e CopyPart

As barras iniciais não serão mais cortadas para o Amazon CopyObject CopyPart S3 e os métodos. A DisableTrimmingLeadingSlash propriedade foi removida das CopyPartRequestclasses CopyObjectRequeste.

Os DoesS3BucketExist... métodos

O obsoleto DoesS3BucketExist e DoesS3BucketExistAsync os métodos foram removidos da classe AmazonS3Util, que implementa a interface AmazonS3. ICore Esses métodos foram removidos porque sempre usam HTTP. Em vez disso, use DoeSS3 BucketExist V2 e BucketExistDoesS3 V2Async.

O SDK sempre usa SigV4

A versão 4 do AWS SDK para .NET sempre usa a AWS Signature Version 4 (SigV4) para assinar solicitações. Essa alteração resulta nas seguintes alterações relacionadas:

Os PutACL métodos GetACL e

Os PutACL métodos GetACL e da classe Amazons3Client foram marcados como obsoletos. Para acessar a funcionalidade desses métodos, use os seguintes novos métodos em vez disso: GetBucketACL PutBucketACLGetObjectACL,, PutObjectACL e.

Elementos de programação obsoletos removidos

Vários elementos de programação da implementação do Amazon S3 foram removidos da V4 do SDK, incluindo valores de enumeração, tipos, métodos, namespaces etc. Eles estão listados abaixo, se ainda não foram abordados anteriormente, junto com as possíveis etapas que você pode tomar para acomodar sua remoção.

O namespace Amazon.Auth.AccessControlPolicy.ActionIdentifiers.

O Amazon.Auth.AccessControlPolicy.ActionIdentifiers namespace foi removido. Isso inclui identificadores de ação do IAM, que foram definidos na IdentityandAccessManagementActionIdentifiers classe. O código que usa esses identificadores de ação deve ser alterado para usar valores de string do nome da ação.

Para obter mais informações, consulte Criar políticas gerenciadas pelo IAM a partir do JSON a Visão geral das políticas de JSON no Guia do usuário do IAM.

A classe ClientConfig

O Amazon.Runtime. ClientConfigclass é a classe base das classes de configuração do cliente de serviço, como AmazonS3Config. Os seguintes elementos de programação foram removidos dessa classe.

O namespace Amazon.Runtime.

O namespace Amazon.Runtime foi atualizado da seguinte forma:

BouncyCastle

A cópia de origem do BouncyCastle foi removida da V4 do SDK.

A classe StoredProfileSAMLCredentials

A StoredProfileSAMLCredentials classe obsoleta na Amazon. SecurityTokenO namespace.SAML foi removido. Em vez disso, use a AWSCredentials classe Federated no namespace Amazon.Runtime.

A classe AWSSDKUtils

Os métodos a seguir foram removidos da AWSSDKUtilsclasse: ResolveResourcePathProtectEncodedSlashUrlEncode, ConvertToUnixEpochMilliSeconds e.

A classe ProfileManager

A ProfileManager classe obsoleta foi removida do namespace Amazon.Util. Use o SDKCredentialsarquivo de rede ou a SharedCredentialsFileclasse do Amazon.Runtime. CredentialManagementem vez disso, namespace.

A classe AWSConfigs

As seguintes propriedades obsoletas foram removidas da AWSConfigsclasse: LoggingResponseLogging, LogMetrics e. Use a propriedade LoggingConfig.

A classe ConditionFactory

O método com a seguinte assinatura foi removido da ConditionFactoryclasse:NewCondition(ConditionFactory.DateComparisonType, DateTime). Em vez disso, use o NewConditionUtcmétodo.

CloudFront Utilitários da Amazon

O Amazon.CloudFront.Util namespace e a AmazonCloudFrontUtil classe obsoletos foram removidos.

AWS IoT

Na ListPrincipalThingsResponseclasse, uma personalização antiga para uma NextToken substituição foi removida em favor da paginação.

AWS Lambda

Os Invoke... métodos da AmazonLambdaClientclasse a seguir foram removidos porque os nomes eram confusos.

Amazon SageMaker Runtime

Os construtores obsoletos da PayloadPartclasse foram removidos.