feat(lambda): function URLs

[ayush987goyal]

feat(aws-lambda): Add support for function URL

closes #19798

Refs:

1. https://docs.aws.amazon.com/lambda/latest/dg/urls-configuration.html#urls-cfn
2. https://docs.aws.amazon.com/lambda/latest/dg/API_CreateFunctionUrlConfig.html

---

All Submissions:

• Have you followed the guidelines in our Contributing guide?

Adding new Unconventional Dependencies:

• This PR adds new unconventional dependencies following the process described here

New Features

• Have you added the new feature to an integration test?
  • Did you use cdk-integ to deploy the infrastructure and generate the snapshot (i.e. cdk-integ without --dry-run)?

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[gitpod-io]

[rix0rrr]

Thanks for the submission! This will be an exciting feature.

Pull request has been modified.

[jogold]

Two comments/questions:

1. I see now that the CFN resource is named AWS::Lambda::Url not AWS::Lambda::FunctionUrl, how about dropping the function prefix everywhere in the code (and filename). I think this is more inline with the code base.
2. more important: I see that updating the TargetFunctionArn and/or Qualifier can be done (CFN) without interruption (= no replacement). This is very useful because it means you can keep the same url when changing the function or qualifier behind it. With the current implementation, the URL is created in the scope of the function/qualifier, so if the function/qualifier changes the URL will always be recreated. I think we need to revert the relation here = have a mapTo() function in the URL resource:

const myApiUrl = new Url(this, 'MyApiUrl', { authType: FunctionUrlAuthType.NONE });
myApiUrl.mapTo(myFn);

(making some tests now with CFN to confirm this)

@rix0rrr wdyt?

[jogold]

2. more important: I see that updating the TargetFunctionArn and/or Qualifier can be done (CFN) without interruption (= no replacement). This is very useful because it means you can keep the same url when changing the function or qualifier behind it. With the current implementation, the URL is created in the scope of the function/qualifier, so if the function/qualifier changes the URL will always be recreated. I think we need to revert the relation here = have a mapTo() function in the URL resource:

Unfortunately the doc is incorrect here...

VS

😢

[ayush987goyal]

@jogold Regarding the FunctionUrl nomenclature, the Lambda documentation and console refer to them as Function URLs instead of just URLs. Also, there might be cases where just URL might be confused with URL from the default node engine modules.

@rix0rrr @kaizen3031593 Can we please try to merge this change?

[rix0rrr]

const myApiUrl = new Url(this, 'MyApiUrl', { authType: FunctionUrlAuthType.NONE });
myApiUrl.mapTo(myFn);

Isn't this effectively the same as:

new Url(this, 'MyApiUrl', { 
  authType: ...,
  function: myFn,
});

? Which you can already do?

[jogold]

const myApiUrl = new Url(this, 'MyApiUrl', { authType: FunctionUrlAuthType.NONE });
myApiUrl.mapTo(myFn);

Isn't this effectively the same as:

new Url(this, 'MyApiUrl', { 
  authType: ...,
  function: myFn,
});

? Which you can already do?

Yes

[rix0rrr]

I would also like to see a grantInvokeUrl method. It should probably be both on IFunction as well as on FunctionUrl, so it will be wherever people think to look.

Can we also add in documentation to say what the response object of the Lambda should be? ({ statusCode, body, [headers, cookies, isBase64Encoded] })

Pull request has been modified.

[mergify]

Thank you for contributing! Your pull request will be updated from master and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

Pull request has been modified.

[mergify]

Thank you for contributing! Your pull request will be updated from master and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

[aws-cdk-automation]

AWS CodeBuild CI Report

• CodeBuild project: AutoBuildProject89A8053A-LhjRyN9kxr8o
• Commit ID: bd6704c
• Result: SUCCEEDED
• Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

[mergify]

Thank you for contributing! Your pull request will be updated from master and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).