VPCLink - Amazon API Gateway

VPCLink

Represents a VPC link. A VPC link enables you to create integrations with private resources in a VPC.

/v2/vpclinks/vpcLinkId

Operation ID: GetVpcLink

Gets a VPC link.

Path parameters
NameTypeRequiredDescription
vpcLinkIdStringTrue

The ID of the VPC link.

Responses
Status codeResponse modelDescription
200VpcLink

Success

404NotFoundException

The resource specified in the request was not found.

429LimitExceededException

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

Operation ID: DeleteVpcLink

Deletes a VPC link.

Path parameters
NameTypeRequiredDescription
vpcLinkIdStringTrue

The ID of the VPC link.

Responses
Status codeResponse modelDescription
202None

202 response

404NotFoundException

The resource specified in the request was not found.

429LimitExceededException

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

Operation ID: UpdateVpcLink

Updates a VPC link.

Path parameters
NameTypeRequiredDescription
vpcLinkIdStringTrue

The ID of the VPC link.

Responses
Status codeResponse modelDescription
200VpcLink

200 response

400BadRequestException

One of the parameters in the request is invalid.

404NotFoundException

The resource specified in the request was not found.

429LimitExceededException

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

{ "name": "string" }
{ "vpcLinkId": "string", "name": "string", "subnetIds": [ "string" ], "securityGroupIds": [ "string" ], "tags": { }, "createdDate": "string", "vpcLinkStatus": enum, "vpcLinkStatusMessage": "string", "vpcLinkVersion": enum }
{ "message": "string" }
{ "message": "string", "resourceType": "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

string

False

Describes the error encountered.

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

PropertyTypeRequiredDescription

string

False

The limit type.

string

False

Describes the error encountered.

The resource specified in the request was not found. See the message field for more information.

PropertyTypeRequiredDescription

string

False

Describes the error encountered.

string

False

The resource type.

Represents a collection of tags associated with the resource.

PropertyTypeRequiredDescription

*

string

False

Represents the input parameters for an UpdateVpcLink request.

PropertyTypeRequiredDescription

string

False

The name of the VPC link.

Represents a VPC link.

PropertyTypeRequiredDescription

string

Format: date-time

False

The timestamp when the VPC link was created.

string

True

The name of the VPC link.

Array of type string

True

A list of security group IDs for the VPC link.

Array of type string

True

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

Tags

False

Tags for the VPC link.

string

True

The ID of the VPC link.

VpcLinkStatus

False

The status of the VPC link.

string

False

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

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

For more information about using this API in one of the language-specific AWS SDKs and references, see the following: