CreateDirectConnectGatewayAssociationProposal - Amazon Direct Connect
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 (PDF).

CreateDirectConnectGatewayAssociationProposal

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

You can associate a Direct Connect gateway and virtual private gateway or transit gateway that is owned by any Amazon Web Services account.

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 Amazon Web Services 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 Amazon SDKs, see the following: