Vh@:ddlmZmZmZeZdZdZdZdZ ddl Z ddl Z ddl m Z dZ ddlZdZdZ ddlZdd lmZdZdd lmZmZGd d eZdZedk(reyy#e$re j$Zd ZYMwxYw#e$re j$Zd ZdZY^wxYw))absolute_importdivisionprint_functiona module: clc_group short_description: Create/delete Server Groups at Centurylink Cloud description: - Create or delete Server Groups at Centurylink Centurylink Cloud. deprecated: removed_in: 11.0.0 why: > Lumen Public Cloud (formerly known as CenturyLink Cloud) has gone End-of-Life in September 2023. See more at U(https://www.ctl.io/knowledge-base/release-notes/2023/lumen-public-cloud-platform-end-of-life-notice/?). alternative: There is none. extends_documentation_fragment: - community.general.attributes - community.general.clc author: - "CLC Runner (@clc-runner)" attributes: check_mode: support: full diff_mode: support: none options: name: description: - The name of the Server Group. type: str required: true description: description: - A description of the Server Group. type: str required: false parent: description: - The parent group of the server group. If parent is not provided, it creates the group at top level. type: str required: false location: description: - Datacenter to create the group in. If location is not provided, the group gets created in the default datacenter associated with the account. type: str required: false state: description: - Whether to create or delete the group. type: str default: present choices: ['present', 'absent'] wait: description: - Whether to wait for the tasks to finish before returning. type: bool default: true required: false a # Create a Server Group - name: Create Server Group hosts: localhost gather_facts: false connection: local tasks: - name: Create / Verify a Server Group at CenturyLink Cloud community.general.clc_group: name: My Cool Server Group parent: Default Group state: present register: clc - name: Debug ansible.builtin.debug: var: clc # Delete a Server Group - name: Delete Server Group hosts: localhost gather_facts: false connection: local tasks: - name: Delete / Verify Absent a Server Group at CenturyLink Cloud community.general.clc_group: name: My Cool Server Group parent: Default Group state: absent register: clc - name: Debug ansible.builtin.debug: var: clc a group: description: The group information. returned: success type: dict sample: { "changeInfo":{ "createdBy":"service.wfad", "createdDate":"2015-07-29T18:52:47Z", "modifiedBy":"service.wfad", "modifiedDate":"2015-07-29T18:52:47Z" }, "customFields":[ ], "description":"test group", "groups":[ ], "id":"bb5f12a3c6044ae4ad0a03e73ae12cd1", "links":[ { "href":"/v2/groups/wfad", "rel":"createGroup", "verbs":[ "POST" ] }, { "href":"/v2/servers/wfad", "rel":"createServer", "verbs":[ "POST" ] }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1", "rel":"self", "verbs":[ "GET", "PATCH", "DELETE" ] }, { "href":"/v2/groups/wfad/086ac1dfe0b6411989e8d1b77c4065f0", "id":"086ac1dfe0b6411989e8d1b77c4065f0", "rel":"parentGroup" }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/defaults", "rel":"defaults", "verbs":[ "GET", "POST" ] }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/billing", "rel":"billing" }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/archive", "rel":"archiveGroupAction" }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/statistics", "rel":"statistics" }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/upcomingScheduledActivities", "rel":"upcomingScheduledActivities" }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/horizontalAutoscalePolicy", "rel":"horizontalAutoscalePolicyMapping", "verbs":[ "GET", "PUT", "DELETE" ] }, { "href":"/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/scheduledActivities", "rel":"scheduledActivities", "verbs":[ "GET", "POST" ] } ], "locationId":"UC1", "name":"test group", "status":"active", "type":"default" } z ${version}N) LooseVersionTF) CLCException) AnsibleModulemissing_required_libcxeZdZdZdZdZdZedZdZ dZ dZ dZ d Z d Zdd Zd Zd ZedZy)ClcGroupNct|_||_i|_ts*|jj t dtts*|jj t dttjrAttjtdkr|jj d|j|jy)z" Construct module zclc-sdk)msg exceptionrequestsz2.5.0z,requests library version should be >= 2.5.0r N)clc_sdkclcmodule group_dict CLC_FOUND fail_jsonr CLC_IMP_ERRREQUESTS_FOUNDREQUESTS_IMP_ERRr __version__r_set_user_agent)selfrs o/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/clc_group.py__init__zClcGroup.__init__s  KK ! !&:9&EQ\ ! ] KK ! !&::&FRb ! c   L1E1E$FV]I^$^ KK ! !B " D TXX&c|jjjd}|jjjd}|jjjd}|jjjd}|jjjd}|j|j ||_|dk(r+|j ||\}}}|r)|j|n|j||| \}} |j}|jj|| y #t$r|}Y+wxYw) zZ Execute the main code path, and handle the request :return: none locationnameparent descriptionstate) datacenterabsent group_name parent_name)r)r*group_description)changedgroupN) rparamsget_set_clc_credentials_from_env_get_group_tree_for_datacenterr_ensure_group_is_absent_wait_for_requests_to_complete_ensure_group_is_presentdataAttributeError exit_json) rr!r)r*r+r%r,r-rs rprocess_requestzClcGroup.process_requestsJ ;;%%))*5[[''++F3 kk((,,X6  KK..22=A ""&&w/ **,==>! H '+'C'C%;(D(@ $GUH33H=!::%;Rc;eNGU JJE gU; E s) E E! E!c ttdttttdddgtdd}|S) zk Define the argument spec for the ansible module :return: argument spec dictionary T)requiredpresentr')defaultchoicesbool)typer<)r"r$r#r!r%wait)dict) argument_specs r_define_module_argument_specz%ClcGroup._define_module_argument_spec"sF t$6Vy9h2GH640 2 rctj}|jdd}|jdd}|jdd}|jdd}|jdd}|r||jj_|r6|r4||j_d|j_||j_y |r*|r(|jjj||y |jjd S) zk Set the CLC Credentials on the sdk by reading environment variables :return: none CLC_V2_API_TOKENFCLC_V2_API_USERNAMECLC_V2_API_PASSWDCLC_ACCT_ALIASCLC_V2_API_URLT) api_username api_passwdzPYou must set the CLC_V2_API_USERNAME and CLC_V2_API_PASSWD environment variablesrN) osenvironr/rdefaultsENDPOINT_URL_V2_LOGIN_TOKEN_V2 _V2_ENABLEDALIASv2SetCredentialsrr)renv v2_api_tokenv2_api_username v2_api_passwd clc_aliasapi_urls rr0z&ClcGroup._set_clc_credentials_from_env2s jjww159 ''"7? 3U; GG,e4 ''*E2 07DHH   - I'3DHH $#'DHH &DHHN  HHKK & &,( ' *;;((,)- -rcd}g}g}|j||rK|jjs3|j||j |}|j|d}|||fS)a Ensure that group_name is absent by deleting it if necessary :param group_name: string - the name of the clc server group to delete :param parent_name: string - the name of the parent group for group_name :return: changed, group Fr(T) _group_existsr check_modeappend _delete_group)rr)r*r,r-resultsresults rr2z ClcGroup._ensure_group_is_absentNsm     M;;)) Z(++J7v&Gw&&rcd}|jj|\}} |j}|S#t$rA}|jj dj ||jYd}~|Sd}~wwxYw)z Delete the provided server group :param group_name: string - the server group to delete :return: none Nz Failed to delete group :{0}. {1}r)rr/Deleterrrformat response_text)rr)responser-r#exs rr_zClcGroup._delete_groupas ++J7 v ||~H    KK ! !&H&O&OB,,' !    s4 A>6A99A>c|js td||n|jj}|}d}|}|j|d}|j||} |r| r|j|\}}d}||fS|r2| s0|j j s|j|||}d}||fS|j jd|zdz ||fS) a Checks to see if a server group exists, creates it if it doesn't. :param group_name: the name of the group to validate/create :param parent_name: the name of the parent group for group_name :param group_description: a short description of the server group (used when creating) :return: (changed, group) - changed: Boolean- whether a change was made, group: A clc group object for the group z(Implementation Error: Root Group not setNFr()r-r#r$Tzparent group: z does not existr) root_groupAssertionErrorr"r\rrr] _create_groupr) rr)r*r+r#r$r,r- parent_exists child_existss rr4z!ClcGroup._ensure_group_is_presentqs !KL L + 7T__=Q=Q' **f$*O ))!*  \ OOJ7ME6G~<;;))**! ++-G~ KK ! !$!" " # ~rcd}|j|\}} |j||}|S#t$rA}|jj dj ||j Yd}~|Sd}~wwxYw)a) Create the provided server group :param group: clc_sdk.Group - the group to create :param parent: clc_sdk.Parent - the parent group for {group} :param description: string - a text description of the group :return: clc_sdk.Group - the created group N)r"r$z Failed to create group :{0}. {1}r)rCreaterrrrdre)rr-r#r$rf grandparentrgs rrkzClcGroup._create_groups $ 7 *}}%[}IH * KK ! !&H&O&Or''') ! * * *s+ A56A00A5cpd}||jvr%|j|\}}|||jk(rd}|S)z Check to see if a group exists :param group_name: string - the group to check :param parent_name: string - the parent of group_name :return: boolean - whether the group exists FT)rr")rr)r*rar-r#s rr\zClcGroup._group_existssB  ("ooj9OUF"kV[[&@ rc|jjj|j|_|j d|jS)z Walk the tree of groups for a datacenter :param datacenter: string - the datacenter to walk (ex: 'UC1') :return: a dictionary of groups and parents )r!N) parent_group child_group)rrS Datacenter RootGroupri_walk_groups_recursive)rr&s rr1z'ClcGroup._get_group_tree_for_datacentersR ((++001!!* **+) )rct|||fi}|jj}t|dkDr8|D]3}|jdk7r|j |j ||5|S)a. Walk a parent-child tree of groups, starting with the provided child group :param parent_group: clc_sdk.Group - the parent group to start the walk :param child_group: clc_sdk.Group - the child group to start the walk :return: a dictionary of groups and parents rr<)str Subgroupsgroupslenr?updaterw)rrsrtrar{r-s rrwzClcGroup._walk_groups_recursiveswk"[,$?@&&(// v;? O::* d99+uMN  O  rc|jjdsy|D]S}|j|jD]2}|j dk7s|jj d4Uy)z Waits until the CLC requests are complete if the wait argument is True :param requests_lst: The list of CLC request objects :return: none r@N succeededzUnable to process group requestr)rr.WaitUntilCompleterStatusr)r requests_lstrequestrequest_detailss rr3z'ClcGroup._wait_for_requests_to_completest {{!!&) # ?G  % % '#*#3#3 ?"))+{:KK))=*? ? ?rct|drfdtz}tj}|jj d|i|jdxxd|zz cc<|j |yy)NSetRequestsSessionzClcAnsibleModule/z Api-Clientz User-Agent )hasattrrrSessionheadersr}r)r agent_stringsess rrzClcGroup._set_user_agentsh 3, -.rsA@ 7 r" Ha F [ N   IJA(vA(H   zFS +y++-N&)&&(KIGs"A A=A:9A:=BB