AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::Lambda::Url

CfnUrl

The `AWS::Lambda::Url` resource creates a function URL with the specified configuration parameters. A [function URL](https://docs.aws.amazon.com/lambda/latest/dg/lambda-urls.html) is a dedicated HTTP(S) endpoint that you can use to invoke your function.

Import

import { CfnUrl } from 'aws-cdk-lib/aws-lambda';

Or use the module namespace:

import * as lambda from 'aws-cdk-lib/aws-lambda';
// lambda.CfnUrl

Properties

Configuration passed to the constructor as CfnUrlProps.

authTypeRequired
string

The type of authentication that your function URL uses. Set to `AWS_IAM` if you want to restrict access to authenticated users only. Set to `NONE` if you want to bypass IAM authentication to create a public endpoint. For more information, see [Security and auth model for Lambda function URLs](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html) .

targetFunctionArnRequired
string | IFunctionRef

The name of the Lambda function. **Name formats** - *Function name* - `my-function` . - *Function ARN* - `lambda: : :function:my-function` . - *Partial ARN* - `:function:my-function` . The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

corsOptional
IResolvable | CorsProperty

The [Cross-Origin Resource Sharing (CORS)](https://docs.aws.amazon.com/https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings for your function URL.

invokeModeOptional
string

Use one of the following options:. - `BUFFERED` – This is the default option. Lambda invokes your function using the `Invoke` API operation. Invocation results are available when the payload is complete. The maximum payload size is 6 MB. - `RESPONSE_STREAM` – Your function streams payload results as they become available. Lambda invokes your function using the `InvokeWithResponseStream` API operation. The maximum response payload size is 200 MB.

qualifierOptional
string

The alias name.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

Get the AWS Lambda Cheat Sheet

Everything you need to know about AWS Lambda on one page. HD quality, print-friendly.

Download Free Infographic