associate_customer_gateway

associate_customer_gateway(**kwargs)

Associates a customer gateway with a device and optionally, with a link. If you specify a link, it must be associated with the specified device.

You can only associate customer gateways that are connected to a VPN attachment on a transit gateway or core network registered in your global network. When you register a transit gateway or core network, customer gateways that are connected to the transit gateway are automatically included in the global network. To list customer gateways that are connected to a transit gateway, use the DescribeVpnConnections EC2 API and filter by transit-gateway-id .

You cannot associate a customer gateway with more than one device and link.

See also: AWS API Documentation

Request Syntax

response = client.associate_customer_gateway(
    CustomerGatewayArn='string',
    GlobalNetworkId='string',
    DeviceId='string',
    LinkId='string'
)
Parameters
  • CustomerGatewayArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the customer gateway.

  • GlobalNetworkId (string) --

    [REQUIRED]

    The ID of the global network.

  • DeviceId (string) --

    [REQUIRED]

    The ID of the device.

  • LinkId (string) -- The ID of the link.
Return type

dict

Returns

Response Syntax

{
    'CustomerGatewayAssociation': {
        'CustomerGatewayArn': 'string',
        'GlobalNetworkId': 'string',
        'DeviceId': 'string',
        'LinkId': 'string',
        'State': 'PENDING'|'AVAILABLE'|'DELETING'|'DELETED'
    }
}

Response Structure

  • (dict) --

    • CustomerGatewayAssociation (dict) --

      The customer gateway association.

      • CustomerGatewayArn (string) --

        The Amazon Resource Name (ARN) of the customer gateway.

      • GlobalNetworkId (string) --

        The ID of the global network.

      • DeviceId (string) --

        The ID of the device.

      • LinkId (string) --

        The ID of the link.

      • State (string) --

        The association state.

Exceptions

  • NetworkManager.Client.exceptions.ValidationException
  • NetworkManager.Client.exceptions.ServiceQuotaExceededException
  • NetworkManager.Client.exceptions.AccessDeniedException
  • NetworkManager.Client.exceptions.ResourceNotFoundException
  • NetworkManager.Client.exceptions.ConflictException
  • NetworkManager.Client.exceptions.ThrottlingException
  • NetworkManager.Client.exceptions.InternalServerException