Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

REST-based ASP.NET web services - AWS Prescriptive Guidance

REST-based ASP.NET web services

When you modernize REST-based ASP.NET services on AWS by using the strangler fig pattern, we recommend that you use Amazon API Gateway to establish the proxy that will be used to divert traffic to the new service. You can introduce an API Gateway endpoint as the intermediary between service consumers and the legacy service that is being modernized. If the legacy service is already on AWS, the API Gateway endpoint is configured to route requests to the legacy REST service. If the service is not yet on AWS, it can be migrated as is before establishing the new API Gateway proxy. If that isn’t possible, you can take a hybrid cloud approach by using an AWS connectivity service such as AWS Direct Connect to connect API Gateway to your on-premises data center. The following illustration depicts the ASP.NET REST service and its consumer before and after the introduction of API Gateway as a proxy between the two.

Before the introduction of a proxy:

ASP.NET REST service and its consumer before the introduction of a proxy between the two

After adding API Gateway as a proxy:

ASP.NET REST service and its consumer with API Gateway added as a proxy between the two

When the API Gateway proxy is in place, you can create and deploy the modernized service on AWS by using Amazon ECS, for example, to achieve a highly scalable and available service. When the proxy and newly modernized service have been created and tested, you can reconfigure the API Gateway endpoint to point to the modernized REST API for its implementation.

ASP.NET REST service and its consumer with API Gateway reconfigured to point to the modernized REST API

If the newly modernized service has an API contract that is different from the legacy proxy contract the consuming systems depend on, you can use API Gateway’s data transformation feature. Incoming API requests that are structured using the legacy system’s schema can be mapped and transformed to the new service’s contract.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.