Create a single VPC Peering connection for the database

POST

/databases/{databaseId}/vpc-peerings

Create a single VPC Peering connection for the database.

Authorizations

• publicOauth2
  update:database

Parameters

Path Parameters

databaseId

required

string

format: uuid

A database ID.

Request Body

Create VPC Peering request

Schema for creating a VPC peering connection

object

vpcId

required

The ID of the VPC to create a peering connection with

string

/^vpc-([0-9a-f]{8}|[0-9a-f]{17})$/

Example:

vpc-0123456789abcdef0

cidrBlock

required

The VPC CIDR block where routing will take place

string

/^\d{1,3}(\.\d{1,3}){3}\/\d{1,2}$/

Example:

192.168.0.0/16

accountId

required

The ID of the account where the VPC is deployed

string

/^\d{12}$/

Example:

123456789012

region

required

Region where the VPC is deployed

string

default: us-east-1

/^[a-z]{2}-[a-z]+-\d+$/

Example:

us-east-1

isSecureConnection

required

Flag to set up tls or non tls vpc peering connection

boolean

default: true

Responses

201

A VPC Peering connection

Response Headers

X-Request-Id

string

Example:

b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Response with information about a VPC peering connection

object

accountId

The ID of the account where the VPC is deployed

string

/^\d{12}$/

Example:

123456789012

vpcId

The ID of the VPC to create a peering connection with

string

/^vpc-([0-9a-f]{8}|[0-9a-f]{17})$/

Example:

vpc-0123456789abcdef0

region

Region where the VPC is deployed

string

default: us-east-1

/^[a-z]{2}-[a-z]+-\d+$/

Example:

us-east-1

status

Status of the VPC peering connection

string

Allowed values:

initiating-request

pending-acceptance

not-operable

provisioning

active

rejected

expired

failed

deleting

deleted

peeringId

The ID of the peering connection

string

Example:

pcx-1410263943e464f4a

cidrBlock

The VPC CIDR block where routing will take place

string

/^\d{1,3}(\.\d{1,3}){3}\/\d{1,2}$/

Example:

192.168.0.0/16

privateHostedZoneId

The ID of the private hosted zone that the VPC should associate with

string

Example:

Z04089311NGVVH0FO3QGG

isSecureConnection

Flag to set up tls or non tls vpc peering connection

boolean

default: true

Example

Content type: application/json

Copied!

{ 

{

"accountId": "123456789012",

"vpcId": "vpc-0123456789abcdef0",

"region": "us-east-1",

"status": "initiating-request",

"peeringId": "pcx-1410263943e464f4a",

"cidrBlock": "192.168.0.0/16",

"privateHostedZoneId": "Z04089311NGVVH0FO3QGG",

"isSecureConnection": "boolean"

}

400

Invalid input

Response Headers

X-Request-Id

string

Example:

b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object

code

Unique (system-wide) error code for an error happened

string

message

required

Developer-friendly message explaining error

string

key

additional properties

any

Example

Content type: application/json

Copied!

{ 

{

"code": "string",

"message": "string"

}

401

Access token is missing or invalid

Response Headers

X-Request-Id

string

Example:

b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object

code

Unique (system-wide) error code for an error happened

string

message

required

Developer-friendly message explaining error

string

key

additional properties

any

Example

Content type: application/json

Copied!

{ 

{

"code": "invalid_token",

"message": "The access token expired."

}

403

Permission denied

Response Headers

X-Request-Id

string

Example:

b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object

code

Unique (system-wide) error code for an error happened

string

message

required

Developer-friendly message explaining error

string

key

additional properties

any

Example

Content type: application/json

Copied!

{ 

{

"code": "string",

"message": "string"

}

404

Resource not found

Response Headers

X-Request-Id

string

Example:

b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object

code

Unique (system-wide) error code for an error happened

string

message

required

Developer-friendly message explaining error

string

key

additional properties

any

Example

Content type: application/json

Copied!

{ 

{

"code": "string",

"message": "string"

}

500

Internal Server Error

Response Headers

X-Request-Id

string

Example:

b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object

code

Unique (system-wide) error code for an error happened

string

message

required

Developer-friendly message explaining error

string

key

additional properties

any

Example

Content type: application/json

Copied!

{ 

{

"code": "string",

"message": "string"

}