pureport.pureport.aws_direct_connect_connection (0.0.9) — module

Install collection

Install with ansible-galaxy collection install pureport.pureport:==0.0.9

Add to requirements.yml

  collections:
    - name: pureport.pureport
      version: 0.0.9

Description

Create, update or delete an AWS Direct Connect connection

Requirements

• pureport-client

Inputs

    
id:
    description:
    - The id of the existing connection.
    required: false
    type: str

name:
    description:
    - The name of the connection.
    required: true
    type: str

speed:
    choices:
    - 50
    - 100
    - 200
    - 300
    - 400
    - 500
    - 1000
    - 10000
    description:
    - The speed of the connection (Mbps).
    required: true
    type: int

state:
    choices:
    - present
    - absent
    default: present
    description:
    - The state of the object, where 'present' indicates it should should
    - exist and 'absent' indicates it should not exist.
    required: false
    type: str

api_key:
    description:
    - The pre-configured API Key for a Pureport Account.
    - Users should provide either the 'api_key' and 'api_secret' or the obtained 'api_access_token'.
    required: false
    type: str

api_secret:
    description:
    - The pre-configured API Secret for a Pureport Account.
    - Users should provide either the 'api_key' and 'api_secret' or the obtained 'api_access_token'.
    required: false
    type: str

aws_region:
    description:
    - The AWS region associated with the connection
    required: true
    type: str

description:
    description:
    - A description for the connection.
    required: false
    type: str

nat_enabled:
    default: false
    description:
    - If NAT should be enabled
    type: bool

api_base_url:
    description:
    - The host url for the Pureport API.
    required: false
    type: str

billing_term:
    choices:
    - HOURLY
    description:
    - The billing term for the connection.
    required: true
    type: str

customer_asn:
    description:
    - A customer Public/Private ASN for the connection.
    required: false
    type: long

nat_mappings:
    description:
    - A list of CIDR's (a.b.c.d/n) addresses that should be mapped with NAT.
    - This should likely reference the customer_networks supplied on the connection.
    required: false
    type: list

network_href:
    description:
    - The Pureport Network object.
    - This should be the full 'href' path to the Network ReST object (e.g /networks/abc).
    required: true
    type: str

peering_type:
    choices:
    - PRIVATE
    - PUBLIC
    default: PRIVATE
    description:
    - The peering type of the connection.
    required: false
    type: str

location_href:
    description:
    - The Pureport location to connect to.
    - This should be the full 'href' path to the Location ReST object (e.g /locations/abc).
    required: true
    type: dict

aws_account_id:
    description:
    - The AWS account Id associated with the connection
    required: true
    type: str

wait_for_server:
    description:
    - These create/update/delete calls are typically async.  If you wish to wait until
      the
    - server has completed it's task, set this to True.
    required: false
    type: bool

api_access_token:
    description:
    - The access token to use with Pureport API.  This can be obtained from
    - the `pureport_access_token_fact` module.
    - Users should provide either the 'api_key' and 'api_secret' or the obtained 'api_access_token'.
    type: str

resolve_existing:
    default: true
    description:
    - If an id was not provided, attempt to resolve the existing item using the name.
    required: false
    type: bool

customer_networks:
    default: []
    description:
    - A list of Connection Customer Networks (e.g dict(address=str, name=str)).
    required: false
    suboptions:
      address:
        description:
        - A CIDR (a.b.c.d/n) address representing a subnet behind this connection.
        required: true
        type: str
      name:
        description:
        - A name to give this subnet CIDR.
    type: list

high_availability:
    description:
    - If the connection should be high available (2 gateways).
    required: false
    type: bool

cloud_service_hrefs:
    default: []
    description:
    - A list of cloud services for the connection
    - This should be the full 'href' path to the CloudService ReST object (e.g /cloudServices/abc).
    required: false
    type: list

Outputs

connection:
  description: the created, updated, or deleted connection
  type: Connection