@gradientedge/cdk-utils 4.6.4 → 4.7.0

package/dist/src/lib/construct/api-to-eventbridge-target/main.d.ts

@@ -1,4 +1,3 @@
-import * as apig from 'aws-cdk-lib/aws-apigateway';
 import * as secretsmanager from 'aws-cdk-lib/aws-secretsmanager';
 import { Construct } from 'constructs';
 import { CommonConstruct } from '../../common';
@@ -32,7 +31,6 @@ export declare class ApiToEventBridgeTarget extends CommonConstruct {
     apiDestinedLambda: types.ApiDestinedLambdaType;
     apiEvent: types.ApiDestinationEventType;
     apiDestinedRestApi: types.ApiDestinedRestApiType;
-    apiDestinedBasePathMappings: apig.BasePathMapping[];
     apiResource: string;
     constructor(parent: Construct, id: string, props: types.ApiToEventBridgeTargetProps);
     protected initResources(): void;
@@ -97,6 +95,13 @@ export declare class ApiToEventBridgeTarget extends CommonConstruct {
     protected createApiDestinationRuleFailure(): void;
     protected createApiDestinedTopicRole(): void;
     protected createApiDestinedTopic(): void;
+    protected createApiDestinedIntegrationRequestParameters(): void;
+    protected createApiDestinedIntegrationRequestTemplates(): void;
+    protected createApiDestinedIntegrationResponse(): void;
+    protected createApiDestinedIntegrationErrorResponse(): void;
+    protected createApiDestinedIntegration(): void;
+    protected createApiDestinedMethodResponse(): void;
+    protected createApiDestinedMethodErrorResponse(): void;
     /**
      * @summary Method to create rest restApi for Api
      * @protected
@@ -105,13 +110,6 @@ export declare class ApiToEventBridgeTarget extends CommonConstruct {
     protected createApiDestinedResponseModel(): void;
     protected createApiDestinedErrorResponseModel(): void;
     protected createApiDestinedResource(): void;
-    protected createApiDestinedIntegrationRequestParameters(): void;
-    protected createApiDestinedIntegrationRequestTemplates(): void;
-    protected createApiDestinedIntegrationResponse(): void;
-    protected createApiDestinedIntegrationErrorResponse(): void;
-    protected createApiDestinedIntegration(): void;
-    protected createApiDestinedMethodResponse(): void;
-    protected createApiDestinedMethodErrorResponse(): void;
     protected createApiDestinedResourceMethod(): void;
     /**
      * @summary Method to create custom restApi domain for Api API

package/dist/src/lib/construct/api-to-eventbridge-target/main.js

@@ -20,6 +20,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiToEventBridgeTarget = void 0;
+const cdk = __importStar(require("aws-cdk-lib"));
 const apig = __importStar(require("aws-cdk-lib/aws-apigateway"));
 const eventstargets = __importStar(require("aws-cdk-lib/aws-events-targets"));
 const iam = __importStar(require("aws-cdk-lib/aws-iam"));
@@ -61,7 +62,6 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
     apiEvent;
     /* rest restApi related resources */
     apiDestinedRestApi;
-    apiDestinedBasePathMappings = [];
     apiResource;
     constructor(parent, id, props) {
         super(parent, id, props);
@@ -95,15 +95,15 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         /* restApi related resources */
         this.createApiDestinedTopicRole();
         this.createApiDestinedTopic();
-        this.createApiDestinedRestApi();
-        this.createApiDestinedResponseModel();
-        this.createApiDestinedErrorResponseModel();
-        this.createApiDestinedResource();
         this.createApiDestinedIntegrationRequestParameters();
         this.createApiDestinedIntegrationRequestTemplates();
         this.createApiDestinedIntegrationResponse();
         this.createApiDestinedIntegrationErrorResponse();
         this.createApiDestinedIntegration();
+        this.createApiDestinedRestApi();
+        this.createApiDestinedResource();
+        this.createApiDestinedResponseModel();
+        this.createApiDestinedErrorResponseModel();
         this.createApiDestinedMethodResponse();
         this.createApiDestinedMethodErrorResponse();
         this.createApiDestinedResourceMethod();
@@ -131,6 +131,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     resolveCertificate() {
+        if (this.props.api.useExisting)
+            return;
         if (this.props.api.certificate.useExistingCertificate &&
             this.props.api.certificate.certificateSsmName &&
             this.props.api.certificate.certificateRegion) {
@@ -143,6 +145,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinedLambdaPolicy() {
+        if (this.props.api.useExisting)
+            return;
         this.apiDestinedLambda.policy = new iam.PolicyDocument({
             statements: [this.iamManager.statementForReadSecrets(this), this.iamManager.statementForPutEvents()],
         });
@@ -152,6 +156,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinedLambdaRole() {
+        if (this.props.api.useExisting)
+            return;
         this.apiDestinedLambda.role = this.iamManager.createRoleForLambda(`${this.id}-lambda-destined-role`, this, this.apiDestinedLambda.policy);
     }
     /**
@@ -159,6 +165,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinedLambdaEnvironment() {
+        if (this.props.api.useExisting)
+            return;
         this.apiDestinedLambda.environment = {
             NODE_ENV: this.props.nodeEnv,
             LOG_LEVEL: this.props.logLevel,
@@ -171,6 +179,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinedLambdaLayers() {
+        if (this.props.api.useExisting)
+            return;
         const layers = [];
         if (this.props.lambda.layerSource) {
             layers.push(this.lambdaManager.createLambdaLayer(`${this.id}-lambda-destined-layer`, this, this.props.lambda.layerSource));
@@ -182,6 +192,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinedLambdaDestinations() {
+        if (this.props.api.useExisting)
+            return;
         this.apiDestinedLambda.destinationSuccess = new destinations.EventBridgeDestination(this.apiEvent.eventBus);
         this.apiDestinedLambda.destinationFailure = new destinations.EventBridgeDestination(this.apiEvent.eventBus);
     }
@@ -190,6 +202,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinedLambdaFunction() {
+        if (this.props.api.useExisting)
+            return;
         if (!this.props.lambda.source)
             throw 'Api Destined Lambda props undefined';
         this.apiDestinedLambda.function = this.lambdaManager.createLambdaFunction(`${this.id}-lambda-destined`, this, {
@@ -201,11 +215,15 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         }, this.apiDestinedLambda.role, this.apiDestinedLambda.layers, this.props.lambda.source, this.props.lambda.handler ?? 'lambda.handler', this.apiDestinedLambda.environment);
     }
     createApiDestinedEventBus() {
+        if (this.props.api.useExisting)
+            return;
         this.apiEvent.eventBus = this.eventManager.createEventBus(`${this.id}-destined-event-bus`, this, {
             eventBusName: `${this.props.event.eventBusName}`,
         });
     }
     createApiDestinationLogGroupSuccess() {
+        if (this.props.api.useExisting)
+            return;
         this.apiEvent.logGroupSuccess = this.logManager.createLogGroup(`${this.id}-destination-success-log`, this, {
             ...{
                 logGroupName: `/${this.id}/events/api-destination-success`,
@@ -218,6 +236,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinationRuleSuccess() {
+        if (this.props.api.useExisting)
+            return;
         this.props.event.ruleSuccess = {
             ...{
                 ruleName: `${this.id}-api-destination-success`,
@@ -238,6 +258,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         this.apiEvent.ruleSuccess = this.eventManager.createRule(`${this.id}-api-destination-rule-success`, this, this.props.event.ruleSuccess, this.apiEvent.eventBus, [new eventstargets.CloudWatchLogGroup(this.apiEvent.logGroupSuccess)]);
     }
     createApiDestinationLogGroupFailure() {
+        if (this.props.api.useExisting)
+            return;
         this.apiEvent.logGroupFailure = this.logManager.createLogGroup(`${this.id}-destination-failure-log`, this, {
             ...{
                 logGroupName: `/${this.id}/events/api-destination-failure`,
@@ -250,6 +272,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDestinationRuleFailure() {
+        if (this.props.api.useExisting)
+            return;
         this.props.event.ruleFailure = {
             ...{
                 ruleName: `${this.id}-api-destination-failure`,
@@ -271,76 +295,13 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         });
     }
     createApiDestinedTopic() {
+        if (!this.props.api.withResource)
+            return;
         this.apiDestinedRestApi.topic = this.snsManager.createLambdaNotificationService(`${this.id}-destined-topic`, this, {
             topicName: `${this.id}-destined-topic`,
         }, this.apiDestinedLambda.function);
         this.apiDestinedRestApi.topic.grantPublish(this.apiDestinedRestApi.topicRole);
     }
-    /**
-     * @summary Method to create rest restApi for Api
-     * @protected
-     */
-    createApiDestinedRestApi() {
-        this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
-            ...{
-                deployOptions: {
-                    dataTraceEnabled: true,
-                    description: `${this.id} - ${this.props.stage} stage`,
-                    loggingLevel: apig.MethodLoggingLevel.INFO,
-                    metricsEnabled: true,
-                    stageName: this.props.stage,
-                },
-                endpointConfiguration: {
-                    types: [apig.EndpointType.REGIONAL],
-                },
-                defaultCorsPreflightOptions: {
-                    allowOrigins: apig.Cors.ALL_ORIGINS,
-                    allowMethods: ['POST'],
-                    allowHeaders: apig.Cors.DEFAULT_HEADERS,
-                },
-                restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
-            },
-            ...this.props.api,
-        });
-    }
-    createApiDestinedResponseModel() {
-        this.apiDestinedRestApi.responseModel = this.apiDestinedRestApi.api.addModel(`${this.id}-response-model`, {
-            ...{
-                contentType: 'application/json',
-                modelName: 'ResponseModel',
-                schema: {
-                    schema: apig.JsonSchemaVersion.DRAFT4,
-                    title: 'pollResponse',
-                    type: apig.JsonSchemaType.OBJECT,
-                    properties: { message: { type: apig.JsonSchemaType.STRING } },
-                },
-            },
-            ...this.props.api.responseModel,
-        });
-    }
-    createApiDestinedErrorResponseModel() {
-        this.apiDestinedRestApi.errorResponseModel = this.apiDestinedRestApi.api.addModel(`${this.id}-error-response-model`, {
-            ...{
-                contentType: 'application/json',
-                modelName: 'ErrorResponseModel',
-                schema: {
-                    schema: apig.JsonSchemaVersion.DRAFT4,
-                    title: 'errorResponse',
-                    type: apig.JsonSchemaType.OBJECT,
-                    properties: {
-                        state: { type: apig.JsonSchemaType.STRING },
-                        message: { type: apig.JsonSchemaType.STRING },
-                    },
-                },
-            },
-            ...this.props.api.errorResponseModel,
-        });
-    }
-    createApiDestinedResource() {
-        if (!this.props.api.withResource)
-            return;
-        this.apiDestinedRestApi.resource = this.apiDestinedRestApi.api.root.addResource(this.props.api.resource ?? this.apiResource);
-    }
     createApiDestinedIntegrationRequestParameters() {
         if (!this.props.api.withResource)
             return;
@@ -453,6 +414,98 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             ...this.props.api.methodErrorResponse,
         };
     }
+    /**
+     * @summary Method to create rest restApi for Api
+     * @protected
+     */
+    createApiDestinedRestApi() {
+        if (this.props.api.useExisting && this.props.api.importedRestApiRef) {
+            this.apiDestinedRestApi.api = apig.RestApi.fromRestApiId(this, `${this.id}-sns-rest-api`, cdk.Fn.importValue(this.props.api.importedRestApiRef));
+            return;
+        }
+        this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
+            ...{
+                defaultIntegration: this.apiDestinedRestApi.integration,
+                defaultMethodOptions: {
+                    methodResponses: [this.apiDestinedRestApi.methodResponse, this.apiDestinedRestApi.methodErrorResponse],
+                },
+                deployOptions: {
+                    dataTraceEnabled: true,
+                    description: `${this.id} - ${this.props.stage} stage`,
+                    loggingLevel: apig.MethodLoggingLevel.INFO,
+                    metricsEnabled: true,
+                    stageName: this.props.stage,
+                },
+                endpointConfiguration: {
+                    types: [apig.EndpointType.REGIONAL],
+                },
+                defaultCorsPreflightOptions: {
+                    allowOrigins: apig.Cors.ALL_ORIGINS,
+                    allowMethods: ['POST'],
+                    allowHeaders: apig.Cors.DEFAULT_HEADERS,
+                },
+                restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
+            },
+            ...this.props.api,
+        });
+        this.addCfnOutput(`${this.id}-restApiId`, this.apiDestinedRestApi.api.restApiId);
+        this.addCfnOutput(`${this.id}-restApiRootResourceId`, this.apiDestinedRestApi.api.root.resourceId);
+    }
+    createApiDestinedResponseModel() {
+        if (!this.props.api.withResource)
+            return;
+        this.apiDestinedRestApi.responseModel = new apig.Model(this, `${this.id}-response-model`, {
+            restApi: this.apiDestinedRestApi.api,
+            ...{
+                contentType: 'application/json',
+                modelName: 'ResponseModel',
+                schema: {
+                    schema: apig.JsonSchemaVersion.DRAFT4,
+                    title: 'pollResponse',
+                    type: apig.JsonSchemaType.OBJECT,
+                    properties: { message: { type: apig.JsonSchemaType.STRING } },
+                },
+            },
+            ...this.props.api.responseModel,
+        });
+    }
+    createApiDestinedErrorResponseModel() {
+        if (!this.props.api.withResource)
+            return;
+        this.apiDestinedRestApi.errorResponseModel = new apig.Model(this, `${this.id}-error-response-model`, {
+            restApi: this.apiDestinedRestApi.api,
+            ...{
+                contentType: 'application/json',
+                modelName: 'ErrorResponseModel',
+                schema: {
+                    schema: apig.JsonSchemaVersion.DRAFT4,
+                    title: 'errorResponse',
+                    type: apig.JsonSchemaType.OBJECT,
+                    properties: {
+                        state: { type: apig.JsonSchemaType.STRING },
+                        message: { type: apig.JsonSchemaType.STRING },
+                    },
+                },
+            },
+            ...this.props.api.errorResponseModel,
+        });
+    }
+    createApiDestinedResource() {
+        if (!this.props.api.withResource)
+            return;
+        let rootResource;
+        if (this.props.api.withResource && this.props.api.importedRestApiRootResourceRef) {
+            rootResource = apig.Resource.fromResourceAttributes(this, `${this.id}-root-resource`, {
+                resourceId: cdk.Fn.importValue(this.props.api.importedRestApiRootResourceRef),
+                restApi: this.apiDestinedRestApi.api,
+                path: '/',
+            });
+        }
+        else {
+            rootResource = this.apiDestinedRestApi.api.root;
+        }
+        this.apiDestinedRestApi.resource = rootResource.addResource(this.props.api.resource ?? this.apiResource);
+    }
     createApiDestinedResourceMethod() {
         if (!this.props.api.withResource)
             return;
@@ -465,6 +518,8 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiDomain() {
+        if (this.props.api.useExisting)
+            return;
         this.apiDestinedRestApi.domain = this.apiManager.createApiDomain(`${this.id}-api-domain`, this, this.isProductionStage()
             ? `${this.props.apiSubDomain}.${this.fullyQualifiedDomainName}`
             : `${this.props.apiSubDomain}-${this.props.stage}.${this.fullyQualifiedDomainName}`, this.apiDestinedRestApi.certificate);
@@ -474,23 +529,22 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiBasePathMapping() {
-        const apiRootPaths = this.props.apiRootPaths;
-        if (apiRootPaths && apiRootPaths.length > 0) {
-            apiRootPaths.forEach((apiRootPath) => {
-                this.apiDestinedBasePathMappings.push(new apig.BasePathMapping(this, `${this.id}-base-bath-mapping-${apiRootPath}`, {
-                    basePath: this.props.api.resource,
-                    domainName: this.apiDestinedRestApi.domain,
-                    restApi: this.apiDestinedRestApi.api,
-                    stage: this.apiDestinedRestApi.api.deploymentStage,
-                }));
-            });
-        }
+        if (this.props.api.useExisting)
+            return;
+        new apig.BasePathMapping(this, `${this.id}-base-bath-mapping`, {
+            basePath: '',
+            domainName: this.apiDestinedRestApi.domain,
+            restApi: this.apiDestinedRestApi.api,
+            stage: this.apiDestinedRestApi.api.deploymentStage,
+        });
     }
     /**
      * @summary Method to create route53 records for Api API
      * @protected
      */
     createApiRouteAssets() {
+        if (this.props.api.useExisting)
+            return;
         this.route53Manager.createApiGatewayARecord(`${this.id}-custom-domain-a-record`, this, this.props.apiSubDomain, this.apiDestinedRestApi.domain, this.apiDestinedRestApi.hostedZone);
     }
 }

package/dist/src/lib/manager/aws/sns-manager.d.ts

@@ -36,7 +36,7 @@ export declare class SnsManager {
      * @param {string} id scoped id of the resource
      * @param {common.CommonConstruct} scope scope in which this resource is defined
      * @param {types.SubscriptionProps} props
-     * @param {lambda.Function} lambdaFunction
+     * @param {lambda.IFunction} lambdaFunction
      */
-    createLambdaNotificationService(id: string, scope: common.CommonConstruct, props: types.SubscriptionProps, lambdaFunction: lambda.Function): sns.Topic;
+    createLambdaNotificationService(id: string, scope: common.CommonConstruct, props: types.SubscriptionProps, lambdaFunction: lambda.IFunction): sns.Topic;
 }

package/dist/src/lib/manager/aws/sns-manager.js

@@ -71,7 +71,7 @@ class SnsManager {
      * @param {string} id scoped id of the resource
      * @param {common.CommonConstruct} scope scope in which this resource is defined
      * @param {types.SubscriptionProps} props
-     * @param {lambda.Function} lambdaFunction
+     * @param {lambda.IFunction} lambdaFunction
      */
     createLambdaNotificationService(id, scope, props, lambdaFunction) {
         if (!props)

package/dist/src/lib/types/aws/index.d.ts

@@ -170,7 +170,7 @@ export interface ApiDestinationEventType {
  * @subcategory Types
  */
 export interface ApiDestinedRestApiType {
-    api: apig.RestApi;
+    api: apig.IRestApi;
     certificate: acm.ICertificate;
     domain: apig.DomainName;
     errorResponseModel: apig.Model;
@@ -189,7 +189,7 @@ export interface ApiDestinedRestApiType {
     methodResponse: apig.MethodResponse;
     resource: apig.Resource;
     responseModel: apig.Model;
-    topic: sns.Topic;
+    topic: sns.ITopic;
     topicRole: iam.Role;
 }
 /**
@@ -200,7 +200,7 @@ export interface ApiDestinedLambdaType {
     destinationFailure: destinations.EventBridgeDestination;
     destinationSuccess: destinations.EventBridgeDestination;
     environment: types.ApiDestinedLambdaEnvironment;
-    function: lambda.Function;
+    function: lambda.IFunction;
     layers: lambda.LayerVersion[];
     layerSource?: lambda.AssetCode;
     policy: iam.PolicyDocument;
@@ -212,7 +212,6 @@ export interface ApiDestinedLambdaType {
  * @subcategory Properties
  */
 export interface ApiToEventBridgeTargetRestApiProps {
-    withResource?: boolean;
     certificate: AcmProps;
     integrationResponse?: apig.IntegrationResponse;
     integrationErrorResponse?: apig.IntegrationResponse;
@@ -223,6 +222,10 @@ export interface ApiToEventBridgeTargetRestApiProps {
     errorResponseModel?: apig.ModelOptions;
     responseModel?: apig.ModelOptions;
     restApi?: apig.RestApiProps;
+    importedRestApiRef?: string;
+    importedRestApiRootResourceRef?: string;
+    useExisting: boolean;
+    withResource?: boolean;
 }
 /**
  * @category cdk-utils.api-to-eventbridge-target

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils",
-  "version": "4.6.4",
+  "version": "4.7.0",
   "description": "Utilities for AWS CDK provisioning",
   "main": "dist/index.js",
   "engines": {
@@ -50,7 +50,7 @@
     "app-root-path": "^3.0.0",
     "aws-cdk-lib": "^2.12.0",
     "aws-sdk": "^2.1074.0",
-    "constructs": "^10.0.62",
+    "constructs": "^10.0.63",
     "lodash": "^4.17.21",
     "moment": "^2.29.1",
     "nconf": "^0.11.3",

package/src/lib/construct/api-to-eventbridge-target/main.ts

@@ -1,3 +1,4 @@
+import * as cdk from 'aws-cdk-lib'
 import * as apig from 'aws-cdk-lib/aws-apigateway'
 import * as eventstargets from 'aws-cdk-lib/aws-events-targets'
 import * as iam from 'aws-cdk-lib/aws-iam'
@@ -48,7 +49,6 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
 
   /* rest restApi related resources */
   apiDestinedRestApi: types.ApiDestinedRestApiType
-  apiDestinedBasePathMappings: apig.BasePathMapping[] = []
   apiResource: string
 
   constructor(parent: Construct, id: string, props: types.ApiToEventBridgeTargetProps) {
@@ -91,15 +91,15 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     /* restApi related resources */
     this.createApiDestinedTopicRole()
     this.createApiDestinedTopic()
-    this.createApiDestinedRestApi()
-    this.createApiDestinedResponseModel()
-    this.createApiDestinedErrorResponseModel()
-    this.createApiDestinedResource()
     this.createApiDestinedIntegrationRequestParameters()
     this.createApiDestinedIntegrationRequestTemplates()
     this.createApiDestinedIntegrationResponse()
     this.createApiDestinedIntegrationErrorResponse()
     this.createApiDestinedIntegration()
+    this.createApiDestinedRestApi()
+    this.createApiDestinedResource()
+    this.createApiDestinedResponseModel()
+    this.createApiDestinedErrorResponseModel()
     this.createApiDestinedMethodResponse()
     this.createApiDestinedMethodErrorResponse()
     this.createApiDestinedResourceMethod()
@@ -134,6 +134,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected resolveCertificate() {
+    if (this.props.api.useExisting) return
     if (
       this.props.api.certificate.useExistingCertificate &&
       this.props.api.certificate.certificateSsmName &&
@@ -159,6 +160,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinedLambdaPolicy() {
+    if (this.props.api.useExisting) return
     this.apiDestinedLambda.policy = new iam.PolicyDocument({
       statements: [this.iamManager.statementForReadSecrets(this), this.iamManager.statementForPutEvents()],
     })
@@ -169,6 +171,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinedLambdaRole() {
+    if (this.props.api.useExisting) return
     this.apiDestinedLambda.role = this.iamManager.createRoleForLambda(
       `${this.id}-lambda-destined-role`,
       this,
@@ -181,6 +184,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinedLambdaEnvironment() {
+    if (this.props.api.useExisting) return
     this.apiDestinedLambda.environment = {
       NODE_ENV: this.props.nodeEnv,
       LOG_LEVEL: this.props.logLevel,
@@ -194,6 +198,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinedLambdaLayers() {
+    if (this.props.api.useExisting) return
     const layers: lambda.LayerVersion[] = []
     if (this.props.lambda.layerSource) {
       layers.push(
@@ -209,6 +214,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinedLambdaDestinations() {
+    if (this.props.api.useExisting) return
     this.apiDestinedLambda.destinationSuccess = new destinations.EventBridgeDestination(this.apiEvent.eventBus)
     this.apiDestinedLambda.destinationFailure = new destinations.EventBridgeDestination(this.apiEvent.eventBus)
   }
@@ -218,6 +224,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinedLambdaFunction() {
+    if (this.props.api.useExisting) return
     if (!this.props.lambda.source) throw 'Api Destined Lambda props undefined'
 
     this.apiDestinedLambda.function = this.lambdaManager.createLambdaFunction(
@@ -239,12 +246,14 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
   }
 
   protected createApiDestinedEventBus() {
+    if (this.props.api.useExisting) return
     this.apiEvent.eventBus = this.eventManager.createEventBus(`${this.id}-destined-event-bus`, this, {
       eventBusName: `${this.props.event.eventBusName}`,
     })
   }
 
   protected createApiDestinationLogGroupSuccess() {
+    if (this.props.api.useExisting) return
     this.apiEvent.logGroupSuccess = this.logManager.createLogGroup(`${this.id}-destination-success-log`, this, {
       ...{
         logGroupName: `/${this.id}/events/api-destination-success`,
@@ -258,6 +267,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinationRuleSuccess() {
+    if (this.props.api.useExisting) return
     this.props.event.ruleSuccess = {
       ...{
         ruleName: `${this.id}-api-destination-success`,
@@ -285,6 +295,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
   }
 
   protected createApiDestinationLogGroupFailure() {
+    if (this.props.api.useExisting) return
     this.apiEvent.logGroupFailure = this.logManager.createLogGroup(`${this.id}-destination-failure-log`, this, {
       ...{
         logGroupName: `/${this.id}/events/api-destination-failure`,
@@ -298,6 +309,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDestinationRuleFailure() {
+    if (this.props.api.useExisting) return
     this.props.event.ruleFailure = {
       ...{
         ruleName: `${this.id}-api-destination-failure`,
@@ -327,6 +339,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
   }
 
   protected createApiDestinedTopic() {
+    if (!this.props.api.withResource) return
     this.apiDestinedRestApi.topic = this.snsManager.createLambdaNotificationService(
       `${this.id}-destined-topic`,
       this,
@@ -339,80 +352,6 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     this.apiDestinedRestApi.topic.grantPublish(this.apiDestinedRestApi.topicRole)
   }
 
-  /**
-   * @summary Method to create rest restApi for Api
-   * @protected
-   */
-  protected createApiDestinedRestApi() {
-    this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
-      ...{
-        deployOptions: {
-          dataTraceEnabled: true,
-          description: `${this.id} - ${this.props.stage} stage`,
-          loggingLevel: apig.MethodLoggingLevel.INFO,
-          metricsEnabled: true,
-          stageName: this.props.stage,
-        },
-        endpointConfiguration: {
-          types: [apig.EndpointType.REGIONAL],
-        },
-        defaultCorsPreflightOptions: {
-          allowOrigins: apig.Cors.ALL_ORIGINS,
-          allowMethods: ['POST'],
-          allowHeaders: apig.Cors.DEFAULT_HEADERS,
-        },
-        restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
-      },
-      ...this.props.api,
-    })
-  }
-
-  protected createApiDestinedResponseModel() {
-    this.apiDestinedRestApi.responseModel = this.apiDestinedRestApi.api.addModel(`${this.id}-response-model`, {
-      ...{
-        contentType: 'application/json',
-        modelName: 'ResponseModel',
-        schema: {
-          schema: apig.JsonSchemaVersion.DRAFT4,
-          title: 'pollResponse',
-          type: apig.JsonSchemaType.OBJECT,
-          properties: { message: { type: apig.JsonSchemaType.STRING } },
-        },
-      },
-      ...this.props.api.responseModel,
-    })
-  }
-
-  protected createApiDestinedErrorResponseModel() {
-    this.apiDestinedRestApi.errorResponseModel = this.apiDestinedRestApi.api.addModel(
-      `${this.id}-error-response-model`,
-      {
-        ...{
-          contentType: 'application/json',
-          modelName: 'ErrorResponseModel',
-          schema: {
-            schema: apig.JsonSchemaVersion.DRAFT4,
-            title: 'errorResponse',
-            type: apig.JsonSchemaType.OBJECT,
-            properties: {
-              state: { type: apig.JsonSchemaType.STRING },
-              message: { type: apig.JsonSchemaType.STRING },
-            },
-          },
-        },
-        ...this.props.api.errorResponseModel,
-      }
-    )
-  }
-
-  protected createApiDestinedResource() {
-    if (!this.props.api.withResource) return
-
-    this.apiDestinedRestApi.resource = this.apiDestinedRestApi.api.root.addResource(
-      this.props.api.resource ?? this.apiResource
-    )
-  }
-
   protected createApiDestinedIntegrationRequestParameters() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.integrationRequestParameters = {
@@ -525,6 +464,104 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     }
   }
 
+  /**
+   * @summary Method to create rest restApi for Api
+   * @protected
+   */
+  protected createApiDestinedRestApi() {
+    if (this.props.api.useExisting && this.props.api.importedRestApiRef) {
+      this.apiDestinedRestApi.api = apig.RestApi.fromRestApiId(
+        this,
+        `${this.id}-sns-rest-api`,
+        cdk.Fn.importValue(this.props.api.importedRestApiRef)
+      )
+      return
+    }
+    this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
+      ...{
+        defaultIntegration: this.apiDestinedRestApi.integration,
+        defaultMethodOptions: {
+          methodResponses: [this.apiDestinedRestApi.methodResponse, this.apiDestinedRestApi.methodErrorResponse],
+        },
+        deployOptions: {
+          dataTraceEnabled: true,
+          description: `${this.id} - ${this.props.stage} stage`,
+          loggingLevel: apig.MethodLoggingLevel.INFO,
+          metricsEnabled: true,
+          stageName: this.props.stage,
+        },
+        endpointConfiguration: {
+          types: [apig.EndpointType.REGIONAL],
+        },
+        defaultCorsPreflightOptions: {
+          allowOrigins: apig.Cors.ALL_ORIGINS,
+          allowMethods: ['POST'],
+          allowHeaders: apig.Cors.DEFAULT_HEADERS,
+        },
+        restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
+      },
+      ...this.props.api,
+    })
+    this.addCfnOutput(`${this.id}-restApiId`, this.apiDestinedRestApi.api.restApiId)
+    this.addCfnOutput(`${this.id}-restApiRootResourceId`, this.apiDestinedRestApi.api.root.resourceId)
+  }
+
+  protected createApiDestinedResponseModel() {
+    if (!this.props.api.withResource) return
+    this.apiDestinedRestApi.responseModel = new apig.Model(this, `${this.id}-response-model`, {
+      restApi: this.apiDestinedRestApi.api,
+      ...{
+        contentType: 'application/json',
+        modelName: 'ResponseModel',
+        schema: {
+          schema: apig.JsonSchemaVersion.DRAFT4,
+          title: 'pollResponse',
+          type: apig.JsonSchemaType.OBJECT,
+          properties: { message: { type: apig.JsonSchemaType.STRING } },
+        },
+      },
+      ...this.props.api.responseModel,
+    })
+  }
+
+  protected createApiDestinedErrorResponseModel() {
+    if (!this.props.api.withResource) return
+    this.apiDestinedRestApi.errorResponseModel = new apig.Model(this, `${this.id}-error-response-model`, {
+      restApi: this.apiDestinedRestApi.api,
+      ...{
+        contentType: 'application/json',
+        modelName: 'ErrorResponseModel',
+        schema: {
+          schema: apig.JsonSchemaVersion.DRAFT4,
+          title: 'errorResponse',
+          type: apig.JsonSchemaType.OBJECT,
+          properties: {
+            state: { type: apig.JsonSchemaType.STRING },
+            message: { type: apig.JsonSchemaType.STRING },
+          },
+        },
+      },
+      ...this.props.api.errorResponseModel,
+    })
+  }
+
+  protected createApiDestinedResource() {
+    if (!this.props.api.withResource) return
+
+    let rootResource
+    if (this.props.api.withResource && this.props.api.importedRestApiRootResourceRef) {
+      rootResource = apig.Resource.fromResourceAttributes(this, `${this.id}-root-resource`, {
+        resourceId: cdk.Fn.importValue(this.props.api.importedRestApiRootResourceRef),
+        restApi: this.apiDestinedRestApi.api,
+        path: '/',
+      })
+    } else {
+      rootResource = this.apiDestinedRestApi.api.root
+    }
+
+    this.apiDestinedRestApi.resource = rootResource.addResource(this.props.api.resource ?? this.apiResource)
+  }
+
   protected createApiDestinedResourceMethod() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.method = this.apiDestinedRestApi.resource.addMethod(
@@ -541,6 +578,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiDomain() {
+    if (this.props.api.useExisting) return
     this.apiDestinedRestApi.domain = this.apiManager.createApiDomain(
       `${this.id}-api-domain`,
       this,
@@ -556,19 +594,13 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiBasePathMapping() {
-    const apiRootPaths = this.props.apiRootPaths
-    if (apiRootPaths && apiRootPaths.length > 0) {
-      apiRootPaths.forEach((apiRootPath: string) => {
-        this.apiDestinedBasePathMappings.push(
-          new apig.BasePathMapping(this, `${this.id}-base-bath-mapping-${apiRootPath}`, {
-            basePath: this.props.api.resource,
-            domainName: this.apiDestinedRestApi.domain,
-            restApi: this.apiDestinedRestApi.api,
-            stage: this.apiDestinedRestApi.api.deploymentStage,
-          })
-        )
-      })
-    }
+    if (this.props.api.useExisting) return
+    new apig.BasePathMapping(this, `${this.id}-base-bath-mapping`, {
+      basePath: '',
+      domainName: this.apiDestinedRestApi.domain,
+      restApi: this.apiDestinedRestApi.api,
+      stage: this.apiDestinedRestApi.api.deploymentStage,
+    })
   }
 
   /**
@@ -576,6 +608,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiRouteAssets() {
+    if (this.props.api.useExisting) return
     this.route53Manager.createApiGatewayARecord(
       `${this.id}-custom-domain-a-record`,
       this,

package/src/lib/manager/aws/sns-manager.ts

@@ -62,13 +62,13 @@ export class SnsManager {
    * @param {string} id scoped id of the resource
    * @param {common.CommonConstruct} scope scope in which this resource is defined
    * @param {types.SubscriptionProps} props
-   * @param {lambda.Function} lambdaFunction
+   * @param {lambda.IFunction} lambdaFunction
    */
   public createLambdaNotificationService(
     id: string,
     scope: common.CommonConstruct,
     props: types.SubscriptionProps,
-    lambdaFunction: lambda.Function
+    lambdaFunction: lambda.IFunction
   ) {
     if (!props) throw `Subscription props undefined`
 

package/src/lib/types/aws/index.ts

@@ -181,7 +181,7 @@ export interface ApiDestinationEventType {
  * @subcategory Types
  */
 export interface ApiDestinedRestApiType {
-  api: apig.RestApi
+  api: apig.IRestApi
   certificate: acm.ICertificate
   domain: apig.DomainName
   errorResponseModel: apig.Model
@@ -196,7 +196,7 @@ export interface ApiDestinedRestApiType {
   methodResponse: apig.MethodResponse
   resource: apig.Resource
   responseModel: apig.Model
-  topic: sns.Topic
+  topic: sns.ITopic
   topicRole: iam.Role
 }
 
@@ -208,7 +208,7 @@ export interface ApiDestinedLambdaType {
   destinationFailure: destinations.EventBridgeDestination
   destinationSuccess: destinations.EventBridgeDestination
   environment: types.ApiDestinedLambdaEnvironment
-  function: lambda.Function
+  function: lambda.IFunction
   layers: lambda.LayerVersion[]
   layerSource?: lambda.AssetCode
   policy: iam.PolicyDocument
@@ -221,7 +221,6 @@ export interface ApiDestinedLambdaType {
  * @subcategory Properties
  */
 export interface ApiToEventBridgeTargetRestApiProps {
-  withResource?: boolean
   certificate: AcmProps
   integrationResponse?: apig.IntegrationResponse
   integrationErrorResponse?: apig.IntegrationResponse
@@ -232,6 +231,10 @@ export interface ApiToEventBridgeTargetRestApiProps {
   errorResponseModel?: apig.ModelOptions
   responseModel?: apig.ModelOptions
   restApi?: apig.RestApiProps
+  importedRestApiRef?: string
+  importedRestApiRootResourceRef?: string
+  useExisting: boolean
+  withResource?: boolean
 }
 
 /**