NetworkManager / Client / create_connection

create_connection#

NetworkManager.Client.create_connection(**kwargs)#

Creates a connection between two devices. The devices can be a physical or virtual appliance that connects to a third-party appliance in a VPC, or a physical appliance that connects to another physical appliance in an on-premises network.

See also: AWS API Documentation

Request Syntax

response = client.create_connection(
    GlobalNetworkId='string',
    DeviceId='string',
    ConnectedDeviceId='string',
    LinkId='string',
    ConnectedLinkId='string',
    Description='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters:
  • GlobalNetworkId (string) –

    [REQUIRED]

    The ID of the global network.

  • DeviceId (string) –

    [REQUIRED]

    The ID of the first device in the connection.

  • ConnectedDeviceId (string) –

    [REQUIRED]

    The ID of the second device in the connection.

  • LinkId (string) – The ID of the link for the first device.

  • ConnectedLinkId (string) – The ID of the link for the second device.

  • Description (string) –

    A description of the connection.

    Length Constraints: Maximum length of 256 characters.

  • Tags (list) –

    The tags to apply to the resource during creation.

    • (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.

Return type:

dict

Returns:

Response Syntax

{
    'Connection': {
        'ConnectionId': 'string',
        'ConnectionArn': 'string',
        'GlobalNetworkId': 'string',
        'DeviceId': 'string',
        'ConnectedDeviceId': 'string',
        'LinkId': 'string',
        'ConnectedLinkId': 'string',
        'Description': 'string',
        'CreatedAt': datetime(2015, 1, 1),
        'State': 'PENDING'|'AVAILABLE'|'DELETING'|'UPDATING',
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) –

    • Connection (dict) –

      Information about the connection.

      • ConnectionId (string) –

        The ID of the connection.

      • ConnectionArn (string) –

        The Amazon Resource Name (ARN) of the connection.

      • GlobalNetworkId (string) –

        The ID of the global network.

      • DeviceId (string) –

        The ID of the first device in the connection.

      • ConnectedDeviceId (string) –

        The ID of the second device in the connection.

      • LinkId (string) –

        The ID of the link for the first device in the connection.

      • ConnectedLinkId (string) –

        The ID of the link for the second device in the connection.

      • Description (string) –

        The description of the connection.

      • CreatedAt (datetime) –

        The date and time that the connection was created.

      • State (string) –

        The state of the connection.

      • Tags (list) –

        The tags for the connection.

        • (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.

Exceptions

  • NetworkManager.Client.exceptions.ValidationException

  • NetworkManager.Client.exceptions.ServiceQuotaExceededException

  • NetworkManager.Client.exceptions.AccessDeniedException

  • NetworkManager.Client.exceptions.ConflictException

  • NetworkManager.Client.exceptions.ThrottlingException

  • NetworkManager.Client.exceptions.InternalServerException