NetworkManager / Client / create_connect_peer

create_connect_peer#

NetworkManager.Client.create_connect_peer(**kwargs)#

Creates a core network Connect peer for a specified core network connect attachment between a core network and an appliance. The peer address and transit gateway address must be the same IP address family (IPv4 or IPv6).

See also: AWS API Documentation

Request Syntax

response = client.create_connect_peer(
    ConnectAttachmentId='string',
    CoreNetworkAddress='string',
    PeerAddress='string',
    BgpOptions={
        'PeerAsn': 123
    },
    InsideCidrBlocks=[
        'string',
    ],
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    ClientToken='string',
    SubnetArn='string'
)
Parameters:
  • ConnectAttachmentId (string) –

    [REQUIRED]

    The ID of the connection attachment.

  • CoreNetworkAddress (string) – A Connect peer core network address. This only applies only when the protocol is GRE.

  • PeerAddress (string) –

    [REQUIRED]

    The Connect peer address.

  • BgpOptions (dict) –

    The Connect peer BGP options. This only applies only when the protocol is GRE.

    • PeerAsn (integer) –

      The Peer ASN of the BGP.

  • InsideCidrBlocks (list) –

    The inside IP addresses used for BGP peering.

    • (string) –

  • Tags (list) –

    The tags associated with the peer request.

    • (dict) –

      Describes a tag.

      • Key (string) –

        The tag key.

        Constraints: Maximum length of 128 characters.

      • Value (string) –

        The tag value.

        Constraints: Maximum length of 256 characters.

  • ClientToken (string) –

    The client token associated with the request.

    This field is autopopulated if not provided.

  • SubnetArn (string) – The subnet ARN for the Connect peer. This only applies only when the protocol is NO_ENCAP.

Return type:

dict

Returns:

Response Syntax

{
    'ConnectPeer': {
        'CoreNetworkId': 'string',
        'ConnectAttachmentId': 'string',
        'ConnectPeerId': 'string',
        'EdgeLocation': 'string',
        'State': 'CREATING'|'FAILED'|'AVAILABLE'|'DELETING',
        'CreatedAt': datetime(2015, 1, 1),
        'Configuration': {
            'CoreNetworkAddress': 'string',
            'PeerAddress': 'string',
            'InsideCidrBlocks': [
                'string',
            ],
            'Protocol': 'GRE'|'NO_ENCAP',
            'BgpConfigurations': [
                {
                    'CoreNetworkAsn': 123,
                    'PeerAsn': 123,
                    'CoreNetworkAddress': 'string',
                    'PeerAddress': 'string'
                },
            ]
        },
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ],
        'SubnetArn': 'string',
        'LastModificationErrors': [
            {
                'Code': 'EDGE_LOCATION_NO_FREE_IPS'|'EDGE_LOCATION_PEER_DUPLICATE'|'SUBNET_NOT_FOUND'|'IP_OUTSIDE_SUBNET_CIDR_RANGE'|'INVALID_INSIDE_CIDR_BLOCK'|'NO_ASSOCIATED_CIDR_BLOCK',
                'Message': 'string',
                'ResourceArn': 'string',
                'RequestId': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) –

    • ConnectPeer (dict) –

      The response to the request.

      • CoreNetworkId (string) –

        The ID of a core network.

      • ConnectAttachmentId (string) –

        The ID of the attachment to connect.

      • ConnectPeerId (string) –

        The ID of the Connect peer.

      • EdgeLocation (string) –

        The Connect peer Regions where edges are located.

      • State (string) –

        The state of the Connect peer.

      • CreatedAt (datetime) –

        The timestamp when the Connect peer was created.

      • Configuration (dict) –

        The configuration of the Connect peer.

        • CoreNetworkAddress (string) –

          The IP address of a core network.

        • PeerAddress (string) –

          The IP address of the Connect peer.

        • InsideCidrBlocks (list) –

          The inside IP addresses used for a Connect peer configuration.

          • (string) –

        • Protocol (string) –

          The protocol used for a Connect peer configuration.

        • BgpConfigurations (list) –

          The Connect peer BGP configurations.

          • (dict) –

            Describes a core network BGP configuration.

            • CoreNetworkAsn (integer) –

              The ASN of the Coret Network.

            • PeerAsn (integer) –

              The ASN of the Connect peer.

            • CoreNetworkAddress (string) –

              The address of a core network.

            • PeerAddress (string) –

              The address of a core network Connect peer.

      • Tags (list) –

        The list of key-value tags associated with the Connect peer.

        • (dict) –

          Describes a tag.

          • Key (string) –

            The tag key.

            Constraints: Maximum length of 128 characters.

          • Value (string) –

            The tag value.

            Constraints: Maximum length of 256 characters.

      • SubnetArn (string) –

        The subnet ARN for the Connect peer. This only applies only when the protocol is NO_ENCAP.

      • LastModificationErrors (list) –

        Describes the error associated with the attachment request.

        • (dict) –

          Describes an error associated with a Connect peer request

          • Code (string) –

            The error code for the Connect peer request.

          • Message (string) –

            The message associated with the error code.

          • ResourceArn (string) –

            The ARN of the requested Connect peer resource.

          • RequestId (string) –

            The ID of the Connect peer request.

Exceptions

  • NetworkManager.Client.exceptions.ValidationException

  • NetworkManager.Client.exceptions.AccessDeniedException

  • NetworkManager.Client.exceptions.ResourceNotFoundException

  • NetworkManager.Client.exceptions.ConflictException

  • NetworkManager.Client.exceptions.ThrottlingException

  • NetworkManager.Client.exceptions.InternalServerException