AWS::Lambda::Url - AWS CloudFormation


The AWS::Lambda::Url resource creates a function URL with the specified configuration parameters. A function URL is a dedicated HTTP(S) endpoint that you can use to invoke your function.


To declare this entity in your AWS CloudFormation template, use the following syntax:


{ "Type" : "AWS::Lambda::Url", "Properties" : { "AuthType" : String, "Cors" : Cors, "InvokeMode" : String, "Qualifier" : String, "TargetFunctionArn" : String } }


Type: AWS::Lambda::Url Properties: AuthType: String Cors: Cors InvokeMode: String Qualifier: String TargetFunctionArn: 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.

Required: Yes

Type: String

Allowed values: AWS_IAM | NONE

Update requires: No interruption


The Cross-Origin Resource Sharing (CORS) settings for your function URL.

Required: No

Type: Cors

Update requires: No interruption


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 20 MB, however, you can request a quota increase.

Required: No

Type: String


Update requires: No interruption


The alias name.

Required: No

Type: String

Update requires: Replacement


The name of the Lambda function.

Name formats
  • Function name - my-function.

  • Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • Partial ARN - 123456789012: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.

Required: Yes

Type: String

Update requires: Replacement

Return values


When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns the resource name.

For more information about using the Reffunction, see Ref.


The Fn::GetAttintrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAttintrinsic function, see Fn::GetAtt.


The Amazon Resource Name (ARN) of the function.


The HTTP URL endpoint for your function.