Vh\0LdZdZdZddlZ ddlmZddlmZddlm Z ddl m Z dd l m Z dd l m Z dd l mZdd lmZdd lmZddddgdZdZddZdZdZej2diedZdZej2diedZdZedk(reyy#e$rYwxYw)a --- module: directconnect_connection version_added: 1.0.0 short_description: Creates, deletes, modifies a DirectConnect connection 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. - Prior to release 5.0.0 this module was called C(community.aws.aws_direct_connect_connection). The usage did not change. author: - "Sloane Hertel (@s-hertel)" options: state: description: - The state of the Direct Connect connection. choices: - present - absent type: str required: true name: description: - The name of the Direct Connect connection. This is required to create a new connection. - One of I(connection_id) or I(name) must be specified. type: str connection_id: description: - The ID of the Direct Connect connection. - Modifying attributes of a connection with I(forced_update) will result in a new Direct Connect connection ID. - One of I(connection_id) or I(name) must be specified. type: str location: description: - Where the Direct Connect connection is located. - Required when I(state=present). type: str bandwidth: description: - The bandwidth of the Direct Connect connection. - Required when I(state=present). choices: - 1Gbps - 10Gbps type: str link_aggregation_group: description: - The ID of the link aggregation group you want to associate with the connection. - This is optional when a stand-alone connection is desired. type: str forced_update: description: - To modify I(bandwidth) or I(location) the connection needs to be deleted and recreated. - By default this will not happen. This option must be explicitly set to C(true) to change I(bandwith) or I(location). type: bool default: false extends_documentation_fragment: - amazon.aws.common.modules - amazon.aws.region.modules - amazon.aws.boto3 a # create a Direct Connect connection - community.aws.directconnect_connection: name: ansible-test-connection state: present location: EqDC2 link_aggregation_group: dxlag-xxxxxxxx bandwidth: 1Gbps register: dc # disassociate the LAG from the connection - community.aws.directconnect_connection: state: present connection_id: dc.connection.connection_id location: EqDC2 bandwidth: 1Gbps # replace the connection with one with more bandwidth - community.aws.directconnect_connection: state: present name: ansible-test-connection location: EqDC2 bandwidth: 10Gbps forced_update: true # delete the connection - community.aws.directconnect_connection: state: absent name: ansible-test-connection a5 connection: description: The attributes of the direct connect connection. type: complex returned: I(state=present) contains: aws_device: description: The endpoint which the physical connection terminates on. returned: when the requested state is no longer 'requested' type: str sample: EqDC2-12pmo7hemtz1z bandwidth: description: The bandwidth of the connection. returned: always type: str sample: 1Gbps connection_id: description: The ID of the connection. returned: always type: str sample: dxcon-ffy9ywed connection_name: description: The name of the connection. returned: always type: str sample: ansible-test-connection connection_state: description: The state of the connection. returned: always type: str sample: pending loa_issue_time: description: The issue time of the connection's Letter of Authorization - Connecting Facility Assignment. returned: when the LOA-CFA has been issued (the connection state will no longer be 'requested') type: str sample: '2018-03-20T17:36:26-04:00' location: description: The location of the connection. returned: always type: str sample: EqDC2 owner_account: description: The account that owns the direct connect connection. returned: always type: str sample: '123456789012' region: description: The region in which the connection exists. returned: always type: str sample: us-east-1 N) BotoCoreError) ClientError)camel_dict_to_snake_dict)DirectConnectError)associate_connection_and_lagdelete_connection)disassociate_connection_and_lag)AWSRetry)AnsibleCommunityAWSModule g333333?DirectConnectClientException)retriesdelaybackoffcatch_extra_error_codesc t||ddS)NF) connection_idconnection_nameverify)connection_exists)clientrs z/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/aws/plugins/modules/directconnect_connection.pyconnection_statusrs V=RV_d eeci}|r||d< tjd it|jd i|}g}g} t|jdgdk(r>|r<|dddd k7r.|j|ddd| j|d|jdgD]9} || d k(s | dd k7s|j| d| j| ;|rt|dk(r|dS|ry t| dk(rd | diSd iiS#tt f$r/}|rd|}nd}t |tj|d}~wwxYw)N connectionIdz$Failed to describe DirectConnect ID z,Failed to describe DirectConnect connectionsmsglast_traceback exception connectionsrconnectionStatedeletedconnectionNameF connection) r jittered_backoff retry_paramsdescribe_connectionsrrr traceback format_exclengetappendextend) rrrrparamsresponseer matchr(conns rrrs F!.~^Y<8,,<|O9PT]9] LLn- .   d #$ #e*/Qx  ZA jm,, " = ; '^ 8HC@C S9M9M9O[\]] ^s/DE(*EEc|s td|||d}|r||d< tjdit|jdi|}|dS#t t f$r(}td|tj|d}~wwxYw) NzX..>>v?W?WXb[ab  n %% ; '  |jj dr#|j d|jdd|dk(rt|||jj d|jj d|jj d|jj d|jj d\}}t||}n|dk(rt||}i}|j ddity#t$ry}|jrG|j d|j|jdt|jjn|j |jYd}~d}~wwxYw)NTpresentabsent)requiredchoices1Gbps10Gbps)rRboolF)typedefault)stater>r:r;link_aggregation_grouprrJ)rr>)rXrO)r:r;) argument_specrequired_one_of required_if directconnectrXrr>)rrzThe Direct Connect connection z does not exist.r9r:r;rYrJ)rrr:r;r?rJ)r r"rGr))dictAnsibleAWSModulerr3r0r fail_jsonrLrrKrr!r rr"r4 exit_json)rZmoduler(rXrrGr4r5s rmainrc(s/D9h*?@ V23#vf6M#23DEF /J MM  g &E() fmm&7&7&HZ`ZgZgZkZklrZs !2!2?!C   4V]]?5S4TTde   I %3+ & 1 1& 9**:6 --++K8}}(()AB$mm//@& "G])]CH h #J >GHFKWK(@(JK (   F   EE** +1;;+?+?@      '(sD7G)) I+2A/I&&I+__main__)NNTr)) DOCUMENTATIONEXAMPLESRETURNr-botocore.exceptionsrr ImportError0ansible.module_utils.common.dict_transformationsrBansible_collections.amazon.aws.plugins.module_utils.direct_connectrrr r ;ansible_collections.amazon.aws.plugins.module_utils.retriesr >ansible_collections.community.aws.plugins.module_utils.modulesr r_r+rrr=rDr*rHrLrKrc__name__r)rrros> @ @3 j 1/Vak`nPxcWuVvw f$N&,J*\*+ 2*\*+5Lp zF  s BB#"B#