134 lines
3.3 KiB
Python
134 lines
3.3 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright: (c) 2018, Dag Wieers (@dagwieers) <dag@wieers.com>
|
|
# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'community'}
|
|
|
|
DOCUMENTATION = r'''
|
|
---
|
|
module: mso_schema
|
|
short_description: Manage schemas
|
|
description:
|
|
- Manage schemas on Cisco ACI Multi-Site.
|
|
author:
|
|
- Dag Wieers (@dagwieers)
|
|
options:
|
|
schema:
|
|
description:
|
|
- The name of the schema.
|
|
type: str
|
|
aliases: [ name ]
|
|
state:
|
|
description:
|
|
- Use C(absent) for removing.
|
|
- Use C(query) for listing an object or multiple objects.
|
|
type: str
|
|
choices: [ absent, query ]
|
|
default: query
|
|
notes:
|
|
- Due to restrictions of the MSO REST API this module cannot create empty schemas (i.e. schemas without templates).
|
|
Use the M(cisco.mso.mso_schema_template) to automatically create schemas with templates.
|
|
seealso:
|
|
- module: cisco.mso.mso_schema_site
|
|
- module: cisco.mso.mso_schema_template
|
|
extends_documentation_fragment: cisco.mso.modules
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
- name: Remove schemas
|
|
cisco.mso.mso_schema:
|
|
host: mso_host
|
|
username: admin
|
|
password: SomeSecretPassword
|
|
schema: Schema 1
|
|
state: absent
|
|
delegate_to: localhost
|
|
|
|
- name: Query a schema
|
|
cisco.mso.mso_schema:
|
|
host: mso_host
|
|
username: admin
|
|
password: SomeSecretPassword
|
|
schema: Schema 1
|
|
state: query
|
|
delegate_to: localhost
|
|
register: query_result
|
|
|
|
- name: Query all schemas
|
|
cisco.mso.mso_schema:
|
|
host: mso_host
|
|
username: admin
|
|
password: SomeSecretPassword
|
|
state: query
|
|
delegate_to: localhost
|
|
register: query_result
|
|
'''
|
|
|
|
RETURN = r'''
|
|
'''
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible_collections.cisco.mso.plugins.module_utils.mso import MSOModule, mso_argument_spec
|
|
|
|
|
|
def main():
|
|
argument_spec = mso_argument_spec()
|
|
argument_spec.update(
|
|
schema=dict(type='str', aliases=['name']),
|
|
# messages=dict(type='dict'),
|
|
# associations=dict(type='list'),
|
|
# health_faults=dict(type='list'),
|
|
# references=dict(type='dict'),
|
|
# policy_states=dict(type='list'),
|
|
state=dict(type='str', default='query', choices=['absent', 'query']),
|
|
)
|
|
|
|
module = AnsibleModule(
|
|
argument_spec=argument_spec,
|
|
supports_check_mode=True,
|
|
required_if=[
|
|
['state', 'absent', ['schema']],
|
|
],
|
|
)
|
|
|
|
schema = module.params.get('schema')
|
|
state = module.params.get('state')
|
|
|
|
mso = MSOModule(module)
|
|
|
|
schema_id = None
|
|
path = 'schemas'
|
|
|
|
# Query for existing object(s)
|
|
if schema:
|
|
mso.existing = mso.get_obj(path, displayName=schema)
|
|
if mso.existing:
|
|
schema_id = mso.existing.get('id')
|
|
path = 'schemas/{id}'.format(id=schema_id)
|
|
else:
|
|
mso.existing = mso.query_objs(path)
|
|
|
|
if state == 'query':
|
|
pass
|
|
|
|
elif state == 'absent':
|
|
mso.previous = mso.existing
|
|
if mso.existing:
|
|
if module.check_mode:
|
|
mso.existing = {}
|
|
else:
|
|
mso.existing = mso.request(path, method='DELETE')
|
|
|
|
mso.exit_json()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|