ansible / ansible.builtin / v2.9.13 / module / mso_site Manage sites | "added in version" 2.8 of ansible.builtin" Authors: Dag Wieers (@dagwieers) preview | supported by communityansible.builtin.mso_site (v2.9.13) — module
pip
Install with pip install ansible==2.9.13
Manage sites on Cisco ACI Multi-Site.
- name: Add a new site mso_site: host: mso_host username: admin password: SomeSecretPassword site: north_europe description: North European Datacenter apic_username: mso_admin apic_password: AnotherSecretPassword apic_site_id: 12 urls: - 10.2.3.4 - 10.2.4.5 - 10.3.5.6 labels: - NEDC - Europe - Diegem location: latitude: 50.887318 longitude: 4.447084 state: present delegate_to: localhost
- name: Remove a site mso_site: host: mso_host username: admin password: SomeSecretPassword site: north_europe state: absent delegate_to: localhost
- name: Query a site mso_site: host: mso_host username: admin password: SomeSecretPassword site: north_europe state: query delegate_to: localhost register: query_result
- name: Query all sites mso_site: host: mso_host username: admin password: SomeSecretPassword state: query delegate_to: localhost register: query_result
host: aliases: - hostname description: - IP Address or hostname of the ACI Multi Site Orchestrator host. required: true type: str port: description: - Port number to be used for the REST connection. - The default value depends on parameter `use_ssl`. type: int site: aliases: - name description: - The name of the site. required: true type: str urls: description: - A list of URLs to reference the APICs. type: list state: choices: - absent - present - query default: present description: - Use C(present) or C(absent) for adding or removing. - Use C(query) for listing an object or multiple objects. type: str labels: description: - The labels for this site. - Labels that do not already exist will be automatically created. type: list timeout: default: 30 description: - The socket level timeout in seconds. type: int use_ssl: default: true description: - If C(no), an HTTP connection will be used instead of the default HTTPS connection. type: bool location: description: - Location of the site. suboptions: latitude: description: - The latitude of the location of the site. type: float longitude: description: - The longitude of the location of the site. type: float password: description: - The password to use for authentication. - This option is mutual exclusive with C(private_key). If C(private_key) is provided too, it will be used instead. required: true type: str username: default: admin description: - The username to use for authentication. type: str use_proxy: default: true description: - If C(no), it will not use a proxy, even if one is defined in an environment variable on the target hosts. type: bool apic_site_id: description: - The site ID of the APICs. required: true type: str login_domain: description: - The login domain name to use for authentication. - The default value is Local. type: str output_level: choices: - debug - info - normal default: normal description: - Influence the output of this ACI module. - C(normal) means the standard output, incl. C(current) dict - C(info) adds informational output, incl. C(previous), C(proposed) and C(sent) dicts - C(debug) adds debugging output, incl. C(filter_string), C(method), C(response), C(status) and C(url) information type: str apic_password: description: - The password for the APICs. required: true type: str apic_username: default: admin description: - The username for the APICs. required: true type: str validate_certs: default: true description: - If C(no), SSL certificates will not be validated. - This should only set to C(no) when used on personally controlled sites using self-signed certificates. type: bool