+ + +
+ +
+

netscaler.adc.save_config module – Login to a NetScaler ADC node.

+
+

Note

+

This module is part of the netscaler.adc collection (version 2.2.0).

+

It is not included in ansible-core. +To check whether it is installed, run ansible-galaxy collection list.

+

To install it, use: ansible-galaxy collection install netscaler.adc.

+

To use it in a playbook, specify: netscaler.adc.save_config.

+
+

New in netscaler.adc 2.2.0

+ +
+

Synopsis

+
    +
  • Configuration for logging in to a NetScaler ADC node.

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

all

+

boolean

+

Use this option to do saveconfig for all partitions

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

api_path

+

string

+

Base NITRO API path.

+

Define only in case of an ADM service proxy call

+

Default: "nitro/v1/config"

+
+

nitro_auth_token

+

string

+

added in netscaler.adc 2.6.0

+

The authentication token provided by a login operation.

+
+

nitro_pass

+

string

+

The password with which to authenticate to the NetScaler ADC node.

+
+

nitro_protocol

+

string

+

Which protocol to use when accessing the nitro API objects.

+

Choices:

+
    +
  • "http"

  • +
  • "https" ← (default)

  • +
+
+

nitro_user

+

string

+

The username with which to authenticate to the NetScaler ADC node.

+
+

nsip

+

string / required

+

The ip address of the NetScaler ADC appliance where the nitro API calls will be made.

+

The port can be specified with the colon (:). E.g. 192.168.1.1:555.

+
+

save_config

+

boolean

+

If true the module will save the configuration on the NetScaler ADC node if it makes any changes.

+

The module will not save the configuration on the NetScaler ADC node if it made no changes.

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

state

+

string

+

The state of the resource being configured by the module on the NetScaler ADC node.

+

When present the resource will be created if needed and configured according to the module’s parameters.

+

Choices:

+
    +
  • "present" ← (default)

  • +
+
+

validate_certs

+

boolean

+

If false, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Notes

+
+

Note

+ +
+
+
+

Examples

+
---
+- name: Sample save config
+  hosts: demo_netscalers
+
+  gather_facts: false
+
+  tasks:
+    - name: V2 | Sample Task | Save config
+      delegate_to: localhost
+      netscaler.adc.save_config:
+        # nsip: 10.0.0.1 # This can also be given via NETSCALER_NSIP environment variable
+        # nitro_protocol: https # This can also be given via NETSCALER_NITRO_PROTOCOL environment variable
+        # validate_certs: false # This can also be given via NETSCALER_VALIDATE_CERTS environment variable
+        # save_config: false # This can also be given via NETSCALER_SAVE_CONFIG environment variable
+
+
+    - name: V2 | Sample Task | Save config for all partitions
+      delegate_to: localhost
+      netscaler.adc.save_config:
+        # nsip: 10.0.0.1 # This can also be given via NETSCALER_NSIP environment variable
+        # nitro_protocol: https # This can also be given via NETSCALER_NITRO_PROTOCOL environment variable
+        # validate_certs: false # This can also be given via NETSCALER_VALIDATE_CERTS environment variable
+        # save_config: false # This can also be given via NETSCALER_SAVE_CONFIG environment variable
+        all: true
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + +

Key

Description

+

changed

+

boolean

+

Indicates if any change is made by the module. `save_config` module always returns `true` unless it fails.

+

Returned: always

+

Sample: true

+
+

failed

+

boolean

+

Indicates if the module failed or not

+

Returned: always

+

Sample: false

+
+

loglines

+

list / elements=string

+

list of logged messages by the module

+

Returned: always

+

Sample: ["message 1", "message 2"]

+
+
+

Authors

+
    +
  • Sumanth Lingappa (@sumanth-lingappa)

  • +
+
+ +
+
+ + +
+