NetworkManager / Client / create_link

create_link#

NetworkManager.Client.create_link(**kwargs)#

Creates a new link for a specified site.

Request Syntax

response = client.create_link(
    GlobalNetworkId='string',
    Description='string',
    Type='string',
    Bandwidth={
        'UploadSpeed': 123,
        'DownloadSpeed': 123
    },
    Provider='string',
    SiteId='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)

Parameters:

GlobalNetworkId (string) –
[REQUIRED]

The ID of the global network.
Description (string) –
A description of the link.

Constraints: Maximum length of 256 characters.
Type (string) –
The type of the link.

Constraints: Maximum length of 128 characters. Cannot include the following characters: | ^
Bandwidth (dict) –
[REQUIRED]

The upload speed and download speed in Mbps.
- UploadSpeed (integer) –
  
  Upload speed in Mbps.
- DownloadSpeed (integer) –
  
  Download speed in Mbps.
Provider (string) –
The provider of the link.

Constraints: Maximum length of 128 characters. Cannot include the following characters: | ^
SiteId (string) –
[REQUIRED]

The ID of the site.
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

{
    'Link': {
        'LinkId': 'string',
        'LinkArn': 'string',
        'GlobalNetworkId': 'string',
        'SiteId': 'string',
        'Description': 'string',
        'Type': 'string',
        'Bandwidth': {
            'UploadSpeed': 123,
            'DownloadSpeed': 123
        },
        'Provider': 'string',
        'CreatedAt': datetime(2015, 1, 1),
        'State': 'PENDING'|'AVAILABLE'|'DELETING'|'UPDATING',
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

(dict) –
- Link (dict) –
  
  Information about the link.
  - LinkId (string) –
    
    The ID of the link.
  - LinkArn (string) –
    
    The Amazon Resource Name (ARN) of the link.
  - GlobalNetworkId (string) –
    
    The ID of the global network.
  - SiteId (string) –
    
    The ID of the site.
  - Description (string) –
    
    The description of the link.
  - Type (string) –
    
    The type of the link.
  - Bandwidth (dict) –
    
    The bandwidth for the link.
    - UploadSpeed (integer) –
      
      Upload speed in Mbps.
    - DownloadSpeed (integer) –
      
      Download speed in Mbps.
  - Provider (string) –
    
    The provider of the link.
  - CreatedAt (datetime) –
    
    The date and time that the link was created.
  - State (string) –
    
    The state of the link.
  - Tags (list) –
    
    The tags for the link.
    - (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.

create_link#

Request Syntax

Response Syntax

Response Structure

Exceptions