AWS Direct Connect
API Reference (API Version 2012-10-25)

CreateDirectConnectGatewayAssociationProposal

Creates a proposal to associate the specified virtual private gateway or transit gateway with the specified Direct Connect gateway.

You can only associate a Direct Connect gateway and virtual private gateway or transit gateway when the account that owns the Direct Connect gateway and the account that owns the virtual private gateway or transit gateway have the same AWS Payer ID.

Request Syntax

{ "addAllowedPrefixesToDirectConnectGateway": [ { "cidr": "string" } ], "directConnectGatewayId": "string", "directConnectGatewayOwnerAccount": "string", "gatewayId": "string", "removeAllowedPrefixesToDirectConnectGateway": [ { "cidr": "string" } ] }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

addAllowedPrefixesToDirectConnectGateway

The Amazon VPC prefixes to advertise to the Direct Connect gateway.

Type: Array of RouteFilterPrefix objects

Required: No

directConnectGatewayId

The ID of the Direct Connect gateway.

Type: String

Required: Yes

directConnectGatewayOwnerAccount

The ID of the AWS account that owns the Direct Connect gateway.

Type: String

Required: Yes

gatewayId

The ID of the virtual private gateway or transit gateway.

Type: String

Required: Yes

removeAllowedPrefixesToDirectConnectGateway

The Amazon VPC prefixes to no longer advertise to the Direct Connect gateway.

Type: Array of RouteFilterPrefix objects

Required: No

Response Syntax

{ "directConnectGatewayAssociationProposal": { "associatedGateway": { "id": "string", "ownerAccount": "string", "region": "string", "type": "string" }, "directConnectGatewayId": "string", "directConnectGatewayOwnerAccount": "string", "existingAllowedPrefixesToDirectConnectGateway": [ { "cidr": "string" } ], "proposalId": "string", "proposalState": "string", "requestedAllowedPrefixesToDirectConnectGateway": [ { "cidr": "string" } ] } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

directConnectGatewayAssociationProposal

Information about the Direct Connect gateway proposal.

Type: DirectConnectGatewayAssociationProposal object

Errors

For information about the errors that are common to all actions, see Common Errors.

DirectConnectClientException

One or more parameters are not valid.

HTTP Status Code: 400

DirectConnectServerException

A server-side error occurred.

HTTP Status Code: 400

See Also

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