의 버전 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 V4를 참조하세요.

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 암호화 클라이언트 개발자 안내서의 지원되는 암호화 알고리즘을 참조하세요.

에 대한 S3 태그 지정 지시문 CopyObject

TaggingDirective 속성은 AmazonS3Client.CopyObject 메서드에서 사용하는 CopyObjectRequest 클래스의 퍼블릭 속성으로 노출되었습니다. 이 속성은 CopyObject 작업에 정의된 Amazon S3 x-amz-tagging-directive 파라미터에 해당합니다.

태그 지정 지시문은 더 이상 COPY로 자동 설정되지 않습니다. 개발자가 태그 지정 지시문을 지정하지 않으면 S3 백엔드는 자동으로 COPY라고 가정하지만, 개발자가 속성을 null로 명시적으로 설정하면 값이 전혀 설정되지 않습니다.

S3 구성의 UseArnRegion 속성

AWS_S3_USE_ARN_REGION 환경 변수가 공유 AWS config 파일의 s3_use_arn_region 설정보다 우선하도록 Amazon.S3.AmazonS3Config 클래스의 UseArnRegion 속성이 업데이트되었습니다. 이러한 변수 및 설정에 대한 자세한 내용은 SDK 및 도구 참조 안내서의 설정 참조를 참조하세요. AWS SDKs

CopyObject 및 CopyPart 메서드의 선행 슬래시

Amazon S3 CopyObject 및 CopyPart 메서드에 대해 선행 슬래시가 더 이상 잘리지 않습니다. CopyObjectRequest 및 CopyPartRequest CopyPartRequest 클래스에서 DisableTrimmingLeadingSlash 속성이 제거되었습니다.

DoesS3BucketExist... 메서드

더 이상 사용되지 않는 DoesS3BucketExist 및 DoesS3BucketExistAsync 메서드는 ICoreAmazonS33 인터페이스를 구현하는 AmazonS3Util 클래스에서 제거되었습니다. 이러한 메서드는 항상 HTTP를 사용하기 때문에 제거되었습니다. 대신 DoesS3BucketExistV2 및 DoesS3BucketExistV2Async를 사용합니다.

SDK는 항상 SigV4를 사용합니다.

의 버전 4는 요청에 서명하기 위해 AWS SDK for .NET 항상 AWS 서명 버전 4(SigV4)를 사용합니다. 이 변경으로 인해 다음과 같은 관련 변경 사항이 발생합니다.

GetACL 및 PutACL 메서드

AmazonS3Client 클래스의 GetACL 및 PutACL 메서드가 더 이상 사용되지 않는 것으로 표시되었습니다. 이러한 메서드의 기능에 액세스하려면 대신 , GetBucketACL, 및 새 메서드를 사용합니다PutBucketACLGetObjectACLPutObjectACL.

더 이상 사용되지 않는 프로그래밍 요소 제거됨

열거 값, 유형, 메서드, 네임스페이스 등을 포함하여 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 클래스를 사용합니다. CredentialManagement

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 클래스에 대한 더 이상 사용되지 않는 생성자가 제거되었습니다.