cisco.nxos.nxos_aaa_server_host (7.0.0) — module

Install collection

Install with ansible-galaxy collection install cisco.nxos:==7.0.0

Add to requirements.yml

  collections:
    - name: cisco.nxos
      version: 7.0.0

Description

Manages AAA server host-specific configuration.

Usage examples

Scanned by Steampunk Spotter

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

# Radius Server Host Basic settings
- name: Radius Server Host Basic settings
  cisco.nxos.nxos_aaa_server_host:
    state: present
    server_type: radius
    address: 1.2.3.4
    acct_port: 2084
    host_timeout: 10

Scanned by Steampunk Spotter

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

# Radius Server Host Key Configuration
- name: Radius Server Host Key Configuration
  cisco.nxos.nxos_aaa_server_host:
    state: present
    server_type: radius
    address: 1.2.3.4
    key: hello
    encrypt_type: 7

Scanned by Steampunk Spotter

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

# TACACS Server Host Configuration
- name: Tacacs Server Host Configuration
  cisco.nxos.nxos_aaa_server_host:
    state: present
    server_type: tacacs
    tacacs_port: 89
    host_timeout: 10
    address: 5.6.7.8

Inputs

    
key:
    description:
    - Shared secret for the specified host or keyword 'default'.
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Manage the state of the resource.
    type: str

address:
    description:
    - Address or name of the radius or tacacs host.
    required: true
    type: str

acct_port:
    description:
    - Alternate UDP port for RADIUS accounting or keyword 'default'.
    type: str

auth_port:
    description:
    - Alternate UDP port for RADIUS authentication or keyword 'default'.
    type: str

server_type:
    choices:
    - radius
    - tacacs
    description:
    - The server type is either radius or tacacs.
    required: true
    type: str

tacacs_port:
    description:
    - Alternate TCP port TACACS Server or keyword 'default'.
    type: str

encrypt_type:
    choices:
    - '0'
    - '7'
    description:
    - The state of encryption applied to the entered key. O for clear text, 7 for encrypted.
      Type-6 encryption is not supported.
    type: str

host_timeout:
    description:
    - Timeout period for specified host, in seconds or keyword 'default. Range is 1-60.
    type: str

Outputs

changed:
  description: check to see if a change was made on the device
  returned: always
  sample: true
  type: bool
end_state:
  description: k/v pairs of configuration after module execution
  returned: always
  sample:
    address: 1.2.3.4
    auth_port: '2084'
    host_timeout: '10'
    server_type: radius
  type: dict
existing:
  description:
  - k/v pairs of existing configuration
  returned: always
  sample: {}
  type: dict
proposed:
  description: k/v pairs of parameters passed into module
  returned: always
  sample:
    address: 1.2.3.4
    auth_port: '2084'
    host_timeout: '10'
    server_type: radius
  type: dict
updates:
  description: command sent to the device
  returned: always
  sample:
  - radius-server host 1.2.3.4 auth-port 2084 timeout 10
  type: list