VhO) d dl mZmZmZ eZdZdZdZd dl m
Z
m Z d dl m
c mZ d dlmZ d dlmZ dd Zdd
Zd Zd Zd
Zd Zd Zd Ze dk( r e yy) )absolute_importdivisionprint_functiona
module: spectrum_device
short_description: Creates/deletes devices in CA Spectrum
description:
- This module allows you to create and delete devices in CA Spectrum U(https://www.ca.com/us/products/ca-spectrum.html).
- Tested on CA Spectrum 9.4.2, 10.1.1 and 10.2.1.
author: "Renato Orgito (@orgito)"
extends_documentation_fragment:
- community.general.attributes
attributes:
check_mode:
support: full
diff_mode:
support: none
options:
device:
type: str
aliases: [host, name]
required: true
description:
- IP address of the device.
- If a hostname is given, it will be resolved to the IP address.
community:
type: str
description:
- SNMP community used for device discovery.
- Required when O(state=present).
required: true
landscape:
type: str
required: true
description:
- Landscape handle of the SpectroServer to which add or remove the device.
state:
type: str
description:
- On V(present) creates the device when it does not exist.
- On V(absent) removes the device when it exists.
choices: ['present', 'absent']
default: 'present'
url:
type: str
aliases: [oneclick_url]
required: true
description:
- HTTP, HTTPS URL of the Oneclick server in the form V((http|https\)://host.domain[:port]).
url_username:
type: str
aliases: [oneclick_user]
required: true
description:
- Oneclick user name.
url_password:
type: str
aliases: [oneclick_password]
required: true
description:
- Oneclick user password.
use_proxy:
description:
- If V(false), it will not use a proxy, even if one is defined in an environment variable on the target hosts.
default: true
type: bool
validate_certs:
description:
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using
self-signed certificates.
default: true
type: bool
agentport:
type: int
required: false
description:
- UDP port used for SNMP discovery.
default: 161
notes:
- The devices will be created inside the I(Universe) container of the specified landscape.
- All the operations will be performed only on the specified landscape.
aV
- name: Add device to CA Spectrum
local_action:
module: spectrum_device
device: '{{ ansible_host }}'
community: secret
landscape: '0x100000'
oneclick_url: http://oneclick.example.com:8080
oneclick_user: username
oneclick_password: password
state: present
- name: Remove device from CA Spectrum
local_action:
module: spectrum_device
device: '{{ ansible_host }}'
landscape: '{{ landscape_handle }}'
oneclick_url: http://oneclick.example.com:8080
oneclick_user: username
oneclick_password: password
use_proxy: false
state: absent
z
device:
description: Device data when O(state=present).
returned: success
type: dict
sample: {'model_handle': '0x1007ab', 'landscape': '0x100000', 'address': '10.10.5.1'}
)
gethostbynamegaierrorN)
AnsibleModule) fetch_urlc
ddd}t j d dz | z }t t ||||d \ }}|d dk( rt j d
|d d vrt j |d
|j S )
Nzapplication/xml)z Content-TypeAccept oneclick_urlz/spectrum/restful/- )datamethodheaderstimeoutstatusi z)failed to authenticate to Oneclick servermsg) r )moduleparamsr fail_jsonread)resourcexmlr r urlresponseinfos u/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/spectrum_device.pyrequestr" s )#G
--
'*>
>
IC vsVW^`aNHd H~ HI H~_,T%[) ==? c t | |d S )NPOSTr r r" )r r s r! postr( s 8V 44r# c t | d d S )NDELETEr& r' )r s r! deleter+ s 8h 77r# c t t j j d } | S # t $ r: t j dt j j d z Y S w xY w)Ndevicez,failed to resolve device ip address for '%s'r )r r r getr r ) device_ips r! get_ipr0 si k!&--"3"3H"=> k KfmmN_N_`hNi ij ks (, ?A/.A/c d}dt t j j d d z }dt t j j d d dz z }dj | || }t || }t
j | }|j d d
k( ry t d
}|j d| j d| }|j d r(t j d|j d z |j d } |j d j }
dt t | d dz dz z } t | |
| } | S )z2Query OneClick for the device using the IP Addressz/models0x%x landscape a$
SearchManager
{mh_min}
{mh_max}
FIND_DEV_MODELS_BY_IP
{search_ip}
) search_ipmh_minmh_max)r z total-models0N2http://www.ca.com/spectrum/restful/schema/responsecazca:model-responsesca:modelerrorzerror checking device: %sr mhz./*[@id="0x12d7f"] model_handleaddressr3 ) intr r r. formatr( ET
fromstringdictfindr text)
r/ r
landscape_min
landscape_maxr resultroot namespacemodelrA
model_addressmodel_landscaper- s
r!
get_devicerR sR HS !2!2;!? DDMc&--"3"3K"@" E PQM$ H
FY}]F SI L (
$F
== D xx 3&LMI
II*I 6 ; ;J RE yy 8599W;M MN 99T?LJJ 3499M s3|R#8H#Dx#O PPO
! !#F
Mr# c
t } t | }|rt j d| t j rOt d | dt
t j j d d z }t j d| d| z d z t j j d
z }|d t j j d z z
}t j j d d r/|d
t t j j d d z z
}t | }t j | }|j d dk7 r%t j |j d t d }|j d| }|j d }dt
t
|d dz dz z }t || | }t j d| y )NF)changedr- r2 r3 r4 r@ Tzmodel?ipaddress=z &commstring= communityz
&landscapeid= agentportz &agentport= r> Successz
error-messager r: r; r= r? r5 )r0 rR r exit_json
check_moderG rC r r. strr( rE rF r rH ) r/ r- r rL rM rN rO rA rQ s r!
add_devicer\ s I
"F
v6
s6==#4#4[#A2 FFH f5!I-> ARARS^A__H &--"3"3K"@@@H
}}d+MC
(9(9+s(K$LLL
(^F
== D xxI%TXXo 67LMI IIj) ,E99T?L s3|R#8H#Dx#O PPO
!!F T&1r# c t } t | }|t j d t j rt j d d|d z }t | }t
j | }t d }|j d| j }|d k7 r7|j d
| j }t j |d | t j d y )
NF)rT Tz/model/rA r: r; zca:errorrX zca:error-message r ) r0 rR r rY rZ r+ rE rF rG rH rI r )r/ r- r rL rM rN r>
error_messages r!
remove_devicer` s I
"F
~'
&6.11H
H
F
== DLMI IIj) , 1 1E "4i@EE
} =>
T"r# c t t t dddg t d t ddgd t dd t d
d t dd
g t ddg t dddg t dd t dd
dddgfgd at j j d dk( r t y t
y )NThostname)requiredaliases)rd presentabsent)choicesdefault)rd no_logrC rW )typeri r
oneclick_useroneclick_password)rd rj re bool)
r- r3 staterU rV r url_username url_password use_proxyvalidate_certsro rU )
argument_spec required_ifsupports_check_mode)r rG r r r. r\ r` r# r! mainrx 5 s
/?@D) 8 4iHD6s3d^,<= to5FG tDCVBWX5 VT:
y;-89 F" }}!Y. r# __main__)NN)N)
__future__r r r rk
__metaclass__
DOCUMENTATIONEXAMPLESRETURNsocketr r xml.etree.ElementTreeetree ElementTreerE ansible.module_utils.basicr ansible.module_utils.urlsr r" r( r+ r0 rR r\ r` rx __name__rw r# r! r sz A @
N
` 2
+ " " 4 /&58HV&2R#22 zF r#