ansible / ansible.builtin / v2.7.9 / module / meraki_admin Manage administrators in the Meraki cloud | "added in version" 2.6 of ansible.builtin" Authors: Kevin Breit (@kbreit) preview | supported by communityansible.builtin.meraki_admin (v2.7.9) — module
pip
Install with pip install ansible==2.7.9
Allows for creation, management, and visibility into administrators within Meraki.
- name: Query information about all administrators associated to the organization meraki_admin: auth_key: abc12345 org_name: YourOrg state: query delegate_to: localhost
- name: Query information about a single administrator by name meraki_admin: auth_key: abc12345 org_id: 12345 state: query name: Jane Doe
- name: Query information about a single administrator by email meraki_admin: auth_key: abc12345 org_name: YourOrg state: query email: jane@doe.com
- name: Create new administrator with organization access meraki_admin: auth_key: abc12345 org_name: YourOrg state: present name: Jane Doe orgAccess: read-only email: jane@doe.com
- name: Create new administrator with organization access meraki_admin: auth_key: abc12345 org_name: YourOrg state: present name: Jane Doe orgAccess: read-only email: jane@doe.com
- name: Create a new administrator with organization access meraki_admin: auth_key: abc12345 org_name: YourOrg state: present name: Jane Doe orgAccess: read-only email: jane@doe.com
- name: Revoke access to an organization for an administrator meraki_admin: auth_key: abc12345 org_name: YourOrg state: absent email: jane@doe.com
host: default: api.meraki.com description: - Hostname for Meraki dashboard. - Can be used to access regional Meraki environments, such as China. type: str name: description: - Name of the dashboard administrator. - Required when creating a new administrator. tags: description: - Tags the administrator has privileges on. - When creating a new administrator, C(org_name), C(network), or C(tags) must be specified. - If C(none) is specified, C(network) or C(tags) must be specified. email: description: - Email address for the dashboard administrator. - Email cannot be updated. - Required when creating or editing an administrator. state: choices: - absent - present - query description: - Create or modify, or delete an organization - If C(state) is C(absent), name takes priority over email if both are specified. required: true org_id: description: - ID of organization. type: str timeout: default: 30 description: - Time to timeout for HTTP requests. type: int auth_key: description: - Authentication key provided by the dashboard. Required if environmental variable C(MERAKI_KEY) is not set. required: true type: str networks: description: - List of networks the administrator has privileges on. - When creating a new administrator, C(org_name), C(network), or C(tags) must be specified. org_name: aliases: - organization description: - Name of organization. - Used when C(name) should refer to another object. - When creating a new administrator, C(org_name), C(network), or C(tags) must be specified. type: str orgAccess: choices: - full - none - read-only description: - Privileges assigned to the administrator in the organization. use_https: default: true description: - If C(no), it will use HTTP. Otherwise it will use HTTPS. - Only useful for internal Meraki developers. type: bool use_proxy: default: false 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 output_level: choices: - debug - normal default: normal description: - Set amount of debug output during module execution. type: str output_format: choices: - snakecase - camelcase default: snakecase description: - Instructs module whether response keys should be snake case (ex. C(net_id)) or camel case (ex. C(netId)). type: str validate_certs: default: true description: - Whether to validate HTTP certificates. type: bool rate_limit_retry_time: default: 165 description: - Number of seconds to retry if rate limiter is triggered. type: int internal_error_retry_time: default: 60 description: - Number of seconds to retry if server returns an internal server error. type: int
data: contains: email: description: Email address of administrator. returned: success sample: your@email.com type: string id: description: Unique identification number of administrator. returned: success sample: 1234567890 type: string name: description: Given name of administrator. returned: success sample: John Doe type: string networks: contains: access: description: Access level of administrator. Options are 'full', 'read-only', or 'none'. returned: when network permissions are set sample: read-only type: string id: description: The network ID. returned: when network permissions are set sample: N_0123456789 type: string description: List of networks administrator has access on. returned: success type: complex orgAccess: description: The privilege of the dashboard administrator on the organization. Options are 'full', 'read-only', or 'none'. returned: success sample: full type: string tags: contains: access: description: Access level of administrator. Options are 'full', 'read-only', or 'none'. returned: when tag permissions are set sample: full type: string tag: description: Tag name. returned: when tag permissions are set sample: production type: string description: Tags the adminsitrator has access on. returned: success type: complex description: List of administrators. returned: success type: complex