AWS::ApiGatewayV2::VpcLink - AWS CloudFormation
SyntaxPropertiesReturn values

This is the new AWS CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::ApiGatewayV2::VpcLink

The AWS::ApiGatewayV2::VpcLink resource creates a VPC link. Supported only for HTTP APIs. The VPC link status must transition from PENDING to AVAILABLE to successfully create a VPC link, which can take up to 10 minutes. To learn more, see Working with VPC Links for HTTP APIs in the API Gateway Developer Guide.

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

{
  "Type" : "AWS::ApiGatewayV2::VpcLink",
  "Properties" : {
      "Name" : String,
      "SecurityGroupIds" : [ String, ... ],
      "SubnetIds" : [ String, ... ],
      "Tags" : {Key: Value, ...}
    }
}

Type: AWS::ApiGatewayV2::VpcLink
Properties:
  Name: String
  SecurityGroupIds: 
    - String
  SubnetIds: 
    - String
  Tags: 
    Key: Value

The name of the VPC link.

Required: Yes

Type: String

Update requires: No interruption

A list of security group IDs for the VPC link.

Required: No

Type: Array of String

Update requires: Replacement

A list of subnet IDs to include in the VPC link.

Required: Yes

Type: Array of String

Update requires: Replacement

The collection of tags. Each tag element is associated with a given resource.

Required: No

Type: Object of String

Pattern: .*

Update requires: No interruption

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the VPC link's ID, such as abcde1.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic 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::GetAtt intrinsic function, see Fn::GetAtt.

VpcLinkId

The VPC link ID.