ansible.builtin.aws_direct_connect_connection (v2.4.4.0-1) — module

Install Ansible via pip

Install with pip install ansible==2.4.4.0.post1

Description

Create, update, or delete a Direct Connect connection between a network and a specific AWS Direct Connect location. Upon creation the connection may be added to a link aggregation group or established as a standalone connection. The connection may later be associated or disassociated with a link aggregation group.

Requirements

• boto3
• botocore

Inputs

    
name:
    description:
    - The name of the Direct Connect connection. This is required to create a new connection.
      To recreate or delete a connection I(name) or I(connection_id) is required.

state:
    choices:
    - present
    - absent
    description:
    - The state of the Direct Connect connection.

location:
    description:
    - Where the Direct Connect connection is located. Required when I(state=present).

bandwidth:
    choices:
    - 1Gbps
    - 10Gbps
    description:
    - The bandwidth of the Direct Connect connection. Required when I(state=present).

force_update:
    description:
    - To modify bandwidth or location the connection will need to be deleted and recreated.
      By default this will not happen - this option must be set to True.

connection_id:
    description:
    - The ID of the Direct Connect connection. I(name) or I(connection_id) is required
      to recreate or delete a connection. Modifying attributes of a connection with I(force_update)
      will result in a new Direct Connect connection ID.

link_aggregation_group:
    description:
    - The ID of the link aggregation group you want to associate with the connection.
      This is optional in case a stand-alone connection is desired.

Outputs

connection:
  contains:
    aws_device:
      description: The endpoint which the physical connection terminates on.
    bandwidth:
      description: The bandwidth of the connection.
    connection_id:
      description: ID of the Direct Connect connection.
    connection_state:
      description: The state of the connection.
    location:
      description: Where the connection is located.
    owner_account:
      description: The owner of the connection.
    region:
      description: The region in which the connection exists.
  description:
  - The attributes of the Direct Connect connection
  returned: I(state=present)
  type: complex