wwt.ansible_dnac.dnac_device_role (1.1.6) — module

Set the role of the devices in your network.

| "added in version" 2.5 of wwt.ansible_dnac"

Authors: Jeff Andiorio (@jandiorio)

preview | supported by community

Install collection

Install with ansible-galaxy collection install wwt.ansible_dnac:==1.1.6


Add to requirements.yml

  collections:
    - name: wwt.ansible_dnac
      version: 1.1.6

Description

Set the device roles in the DNA Center Inventory Database.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.

- name: update device role
  dnac_device_role:
    host: "{{host}}"
    port: 443
    username: "{{username}}"
    password: "{{password}}"
    device_mgmt_ip: 192.168.200.1
    device_role: "DISTRIBUTION"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: update device role
  dnac_device_role:
    host: "{{host}}"
    port: 443
    username: "{{username}}"
    password: "{{password}}"
    device_name: my_switch_name
    device_role: "DISTRIBUTION"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: update device role
  dnac_device_role:
    host: "{{host}}"
    port: 443
    username: "{{username}}"
    password: "{{password}}"
    device_mgmt_ip: "{{item.key}}"
    device_role: "{{item.value.device_role}}"
  with_dict: "{{roles}}"

Inputs

    
host:
    description:
    - Host is the target Cisco DNA Center controller to execute against.
    required: true

port:
    choices:
    - 80
    - 443
    default: 443
    description:
    - Port is the TCP port for the HTTP connection.
    required: false

state:
    choices:
    - present
    - absent
    default: present
    description:
    - State provides the action to be executed using the terms present, absent, etc.
    required: false

timeout:
    default: 30
    description:
    - The timeout provides a value for how long to wait for the executed command complete.
    required: false

use_ssl:
    choices:
    - true
    - false
    default: true
    description:
    - Enter the boolean value for whether to use SSL or not.
    required: false

password:
    description:
    - Provide the password for connection to the Cisco DNA Center Controller.
    required: true

username:
    description:
    - Provide the username for the connection to the Cisco DNA Center Controller.
    required: true

use_proxy:
    choices:
    - true
    - false
    default: true
    description:
    - Enter a boolean value for whether to use proxy or not.
    required: false

device_name:
    description:
    - name of the device in the inventory database that you would like to update
    required: false

device_role:
    choices:
    - ACCESS
    - DISTRIBUTION
    - CORE
    - BORDER ROUTER
    description:
    - Role of the device
    required: true

device_mgmt_ip:
    description:
    - Management IP Address of the device you would like to update
    required: false

validate_certs:
    choices:
    - true
    - false
    default: true
    description:
    - Specify if verifying the certificate is desired.
    required: false