�
�Udac @` sk d d l m Z m Z m Z e Z i d d 6d g d 6d d 6Z d Z d Z d
Z d d l
m Z d d l m
Z
d d
l m Z m Z d d l m Z m Z d Z d Z d Z d Z d Z i Z i i d d 6e 6i d d 6e 6i d d 6e 6i d d 6e 6Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z! d � Z" d! � Z# e$ d" k rge# � n d# S($ i ( t absolute_importt divisiont print_functions 1.1t metadata_versiont previewt statust communityt supported_bys1
---
module: ome_device_info
short_description: Retrieves the information about Device.
version_added: "2.9"
description:
- This module retrieves the list of all devices information with the exhaustive inventory of each
device.
options:
hostname:
description:
- Target IP Address or hostname.
type: str
required: True
username:
description:
- Target username.
type: str
required: True
password:
description:
- Target user password.
type: str
required: True
port:
description:
- Target HTTPS port.
type: int
default: 443
fact_subset:
description:
- C(basic_inventory) returns the list of the devices.
- C(detailed_inventory) returns the inventory details of specified devices.
- C(subsystem_health) returns the health status of specified devices.
type: str
choices: [basic_inventory, detailed_inventory, subsystem_health ]
default: basic_inventory
system_query_options:
description:
- I(system_query_options) applicable for the choices of the fact_subset. Either I(device_id) or I(device_service_tag)
is mandatory for C(detailed_inventory) and C(subsystem_health) or both can be applicable.
type: dict
suboptions:
device_id:
description:
- A list of unique identifier is applicable
for C(detailed_inventory) and C(subsystem_health).
type: list
device_service_tag:
description:
- A list of service tags are applicable for C(detailed_inventory)
and C(subsystem_health).
type: list
inventory_type:
description:
- For C(detailed_inventory), it returns details of the specified inventory type.
type: str
filter:
description:
- For C(basic_inventory), it filters the collection of devices.
I(filter) query format should be aligned with OData standards.
type: str
requirements:
- "python >= 2.7.5"
author: "Sajna Shetty(@Sajna-Shetty)"
s
---
- name: Retrieve basic inventory of all devices.
ome_device_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
- name: Retrieve basic inventory for devices identified by IDs 33333 or 11111 using filtering.
ome_device_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
fact_subset: "basic_inventory"
system_query_options:
filter: "Id eq 33333 or Id eq 11111"
- name: Retrieve inventory details of specified devices identified by IDs 11111 and 22222.
ome_device_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
fact_subset: "detailed_inventory"
system_query_options:
device_id:
- 11111
- 22222
- name: Retrieve inventory details of specified devices identified by service tags MXL1234 and MXL4567.
ome_device_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
fact_subset: "detailed_inventory"
system_query_options:
device_service_tag:
- MXL1234
- MXL4567
- name: Retrieve details of specified inventory type of specified devices identified by ID and service tags.
ome_device_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
fact_subset: "detailed_inventory"
system_query_options:
device_id:
- 11111
device_service_tag:
- MXL1234
- MXL4567
inventory_type: "serverDeviceCards"
- name: Retrieve subsystem health of specified devices identified by service tags.
ome_device_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
fact_subset: "subsystem_health"
system_query_options:
device_service_tag:
- MXL1234
- MXL4567
s�
---
msg:
type: str
description: Over all device information status.
returned: on error
sample: "Failed to fetch the device information"
device_info:
type: dict
description: Returns the information collected from the Device.
returned: success
sample: {
"value": [
{
"Actions": null,
"AssetTag": null,
"ChassisServiceTag": null,
"ConnectionState": true,
"DeviceManagement": [
{
"DnsName": "dnsname.host.com",
"InstrumentationName": "MX-12345",
"MacAddress": "11:10:11:10:11:10",
"ManagementId": 12345,
"ManagementProfile": [
{
"HasCreds": 0,
"ManagementId": 12345,
"ManagementProfileId": 12345,
"ManagementURL": "https://192.168.0.1:443",
"Status": 1000,
"StatusDateTime": "2019-01-21 06:30:08.501"
}
],
"ManagementType": 2,
"NetworkAddress": "192.168.0.1"
}
],
"DeviceName": "MX-0003I",
"DeviceServiceTag": "MXL1234",
"DeviceSubscription": null,
"LastInventoryTime": "2019-01-21 06:30:08.501",
"LastStatusTime": "2019-01-21 06:30:02.492",
"ManagedState": 3000,
"Model": "PowerEdge MX7000",
"PowerState": 17,
"SlotConfiguration": {},
"Status": 4000,
"SystemId": 2031,
"Type": 2000
}
]
}
( t
AnsibleModule( t RestOME( t URLErrort HTTPError( t ConnectionErrort SSLValidationErrort detailed_inventoryt subsystem_healtht inventory_typet basic_inventorys HTTP Error 404: Not Founds DeviceService/Devicest resources, DeviceService/Devices({Id})/InventoryDetailss? DeviceService/Devices({Id})/InventoryDetails('{InventoryType}')s+ DeviceService/Devices({Id})/SubSystemHealthc
C` s y� t t d } | j d | � } | j r� | j d } i } x= | D]5 } | d | k rF | j i | d | d 6� qF qF W| j � } t t | � t | � � } t j t
d � | D� � � n t | j � � Wn+ t t
t t t t f k
r} | � n X| S( s�
Get device ids from device service tag
Returns :dict : device_id to service_tag map
:arg service_tags: service tag
:arg rest_obj: RestOME class object in case of request with session.
:returns: dict eg: {1345:"MXL1245"}
R t GETt valuet DeviceServiceTagt Idc s` s | ] } | t f Vq d S( N( t DESC_HTTP_ERROR( t .0t tag( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pys <genexpr>� s ( t DEVICE_RESOURCE_COLLECTIONt DEVICE_LISTt invoke_requestt successt json_datat updatet valuest listt sett device_fact_error_reportt dictt
ValueErrorR
R R
R t TypeError(
t service_tagst rest_objt patht respt devices_listt service_tag_dictt itemt available_service_tagst not_available_service_tagt err( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt _get_device_id_from_service_tags� s
# !
c C` s+ y t | � t SWn t k
r& t SXd S( s5 check when device_id numeric represented value is intN( t intt TrueR% t False( t val( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt is_int s
c C` s� | r� g | D]$ } | r
t | � r
t | � ^ q
} t t | � t | j � � @� } x9 | D]. } t j i d j | � | | 6� | | =q` Wn d S( s� If service_tag is duplicate of device_id, then updates the message as Duplicate report
:arg1: device_id_list : list of device_id
:arg2: service_tag_id_dict: dictionary of device_id to service tag maps" Duplicate report of device_id: {0}N( R6 R2 R! R" t keysR# R t format( t device_id_listR, t device_idt device_id_represents_intt
common_val( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt _check_duplicate_device_id s 1"
c C` s� | j d � } i } | d k r� | j d � } | j d � } | rt t d � t t | � � D� � } | | d <n | r� t | | � } t | | � | | d <q� n | S( s�
Builds the identifiers mapping
:returns: the dict of device_id to server_tag map
eg: {"device_id":{1234: None},"device_service_tag":{1345:"MXL1234"}}t system_query_optionsR: t device_service_tagc s` s | ] } | d f Vq d S( N( t None( R R: ( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pys <genexpr># s N( t getR@ R$ R! R" R1 R= ( t
module_paramsR( t system_query_options_paramt device_id_service_tag_dictR9 t device_service_tag_listt device_id_dictR, ( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt _get_device_identifier_map s "
c C` sG | j d � } d } | rC | j d � } | rC i | d 6} qC n | S( s�
Builds query parameter
:returns: dictionary, which is applicable builds the query format
eg : {"$filter":"Type eq 2000"}
R> t filters $filterN( RA R@ ( RB RC t query_parametert
filter_by_val( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt _get_query_parameters. s c C` s' | d } i } | t k rd } t | | � } | t k r^ | j d � } | j t � } n | rj t n | } x� | j � D]� \ } } i | | <xj | j � D]\ \ }
} | d k r� | n |
} t | d j d |
d | � }
| | j i |
| 6� q� Wq} Wn | j i t t d t 6� | S( s0
Identifies the resource path by different states
:returns: dictionary containing identifier with respective resource path
eg:{"device_id":{1234:""DeviceService/Devices(1234)/InventoryDetails"},
"device_service_tag":{"MXL1234":"DeviceService/Devices(1345)/InventoryDetails"}}
t fact_subsetR> R? R R t
InventoryTypeN(
R R@ RG t DEVICES_INVENTORY_DETAILSRA t DEVICES_INVENTORY_TYPEt itemsR R8 R ( RB R( RL t path_dictR RD R> t path_identifiert identifier_typet identifier_dictR: t service_tagt key_identifierR) ( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt _get_resource_parameters= s$
# c ` sc | j d � � � d k sD � d k r_ t � f d � | D� � r_ t d j | | � � � n d S( s� "
Throws error if arguments detailed_inventory, subsystem_health
not exists with qualifier device_id or device_service_tagR> c 3` s | ] } � j | � Vq d S( N( RA ( R t qualifier( RC ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pys <genexpr>_ s s, One of the following {0} is required for {1}N( RA R@ t anyR% R8 ( R5 RB t
required_args( ( RC s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt# _check_mutually_inclusive_argumentsY s c C` s3 | d } | d k r/ t | | d d g � n d S( s validates input parametersRL R R: R? N( R[ ( RB RL ( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt _validate_inputsc s
c
C` s� i d d 6t d 6i i d d 6d 6i d d 6d 6i d d 6d 6i d d 6t d 6d 6d
6} t d i i t d 6d d 6d 6i t d 6d d 6d
6i t d 6d d 6t d 6d 6i t d 6d d 6d d 6d 6i t d 6d d 6d d d g d 6d 6| d 6d d d d g g d d d g g g d t � } y�t | j � t | j d t ��C} t | j | � } g } | j d � r�t | j � } | j d | d d | �} | j
} | j | j � n� x� | j
� D]� \ } } xu | j
� D]g \ } }
y/ | j d |
� } | j
} | j | j � Wn t k
r9} t | � } n X| | | <q�Wq�Wt t � r�d | k rx| d j t � q�t | d <n Wd QXd | k r�| j d | � n | j d! d" � Wn; t t t t t t f k
r�} | j d! t | � � n Xd S(# NR$ t typet requiredR! R: R? t strR RH t optionst
argument_spect hostnamet usernamet no_logt passwordi� t defaultR2 t portR R R t choicesRL R> t required_ift supports_check_modet req_sessionR t query_parami� t device_infot msgs& Failed to fetch the device information( R4 R R3 R\ t paramsR RW RA RK R R t appendt status_codeRP R R_ RY R# R t exit_jsont fail_jsonR
R
R R& R% (
R> t moduleR( t device_factst resp_statusRl R* RS t
path_dict_mapt
identifierR) t dataR0 ( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt mainj sZ
!t __main__N(% t
__future__R R R R] t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNt ansible.module_utils.basicR t2 ansible.module_utils.remote_management.dellemc.omeR t+ ansible.module_utils.six.moves.urllib.errorR
R t ansible.module_utils.urlsR R
RN t DEVICES_SUBSYSTEM_HEALTHRO R R R# R R1 R6 R= RG RK RW R[ R\ Rz t __name__( ( ( s] /usr/lib/python2.7/site-packages/ansible/modules/remote_management/dellemc/ome_device_info.pyt <module> sB
DB7
7
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]
Anons79 Mini Shell