VPCLinks - Amazon API Gateway
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

VPCLinks

Represents your VPC links as a collection. A collection offers a paginated view of your VPC links.

/v2/vpclinks

GET

Operation ID: GetVpcLinks

Gets a collection of VPC links.

Query parameters
NameTypeRequiredDescription
nextTokenStringFalse

The next page of elements from this collection. Not valid for the last element of the collection.

maxResultsStringFalse

The maximum number of elements to be returned for this resource.

Responses
Status codeResponse modelDescription
200VpcLinks

Success

400BadRequestException

One of the parameters in the request is invalid.

429LimitExceededException

The client is sending more than the allowed number of requests per unit of time.

POST

Operation ID: CreateVpcLink

Creates a VPC link.

Responses
Status codeResponse modelDescription
201VpcLink

The request has succeeded and has resulted in the creation of a resource.

400BadRequestException

One of the parameters in the request is invalid.

429LimitExceededException

The client is sending more than the allowed number of requests per unit of time.

{ "name": "string", "subnetIds": [ "string" ], "securityGroupIds": [ "string" ], "tags": { } }
{ "items": [ { "vpcLinkId": "string", "name": "string", "subnetIds": [ "string" ], "securityGroupIds": [ "string" ], "tags": { }, "createdDate": "string", "vpcLinkStatus": enum, "vpcLinkStatusMessage": "string", "vpcLinkVersion": enum } ], "nextToken": "string" }
{ "vpcLinkId": "string", "name": "string", "subnetIds": [ "string" ], "securityGroupIds": [ "string" ], "tags": { }, "createdDate": "string", "vpcLinkStatus": enum, "vpcLinkStatusMessage": "string", "vpcLinkVersion": enum }
{ "message": "string" }
{ "message": "string", "limitType": "string" }

The request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.

PropertyTypeRequiredDescription
message

string

False

Describes the error encountered.

Represents the input parameters for a CreateVpcLink request.

PropertyTypeRequiredDescription
name

string

True

The name of the VPC link.

securityGroupIds

Array of type string

False

A list of security group IDs for the VPC link.

subnetIds

Array of type string

True

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

tags

Tags

False

A list of tags.

A limit has been exceeded. See the accompanying error message for details.

PropertyTypeRequiredDescription
limitType

string

False

The limit type.

message

string

False

Describes the error encountered.

Represents a collection of tags associated with the resource.

PropertyTypeRequiredDescription

*

string

False

Represents a VPC link.

PropertyTypeRequiredDescription
createdDate

string

Format: date-time

False

The timestamp when the VPC link was created.

name

string

True

The name of the VPC link.

securityGroupIds

Array of type string

True

A list of security group IDs for the VPC link.

subnetIds

Array of type string

True

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

tags

Tags

False

Tags for the VPC link.

vpcLinkId

string

True

The ID of the VPC link.

vpcLinkStatus

VpcLinkStatus

False

The status of the VPC link.

vpcLinkStatusMessage

string

False

A message summarizing the cause of the status of the VPC link.

vpcLinkVersion

VpcLinkVersion

False

The version of the VPC link.

The status of the VPC link.

  • PENDING

  • AVAILABLE

  • DELETING

  • FAILED

  • INACTIVE

The version of the VPC link.

  • V2

Represents a collection of VPCLinks.

PropertyTypeRequiredDescription
items

Array of type VpcLink

False

A collection of VPC links.

nextToken

string

False

The next page of elements from this collection. Not valid for the last element of the collection.