zscaler.zpacloud.zpa_app_connector_controller module – Manages App Connector Controllers in the ZPA Cloud.

Note

This module is part of the zscaler.zpacloud collection (version 1.4.2).

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 zscaler.zpacloud. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: zscaler.zpacloud.zpa_app_connector_controller.

New in zscaler.zpacloud 1.0.0

Synopsis

  • This module Update/delete an App Connector Controller in the ZPA Cloud.

Requirements

The below requirements are needed on the host that executes this module.

Parameters

Parameter

Comments

client_id

string

The ZPA API client ID generated from the ZPA console.

client_secret

string

The ZPA API client secret generated from the ZPA console.

cloud

string

The ZPA cloud provisioned for your organization.

Choices:

  • "PRODUCTION"

  • "BETA"

  • "QA"

  • "QA2"

  • "GOV"

  • "GOVUS"

  • "PREVIEW"

  • "ZPATWO"

customer_id

string

The ZPA tenant ID found in the Administration Company menu in the ZPA console.

description

string

The description of the App Connector.

enabled

boolean

Whether this App Connector is enabled or not.

Choices:

  • false

  • true

id

string

The unique identifier of the App Connector.

ids

list / elements=string

The unique identifiers of the bulk delete resources.

name

string

Name of the App Connector.

provider

dictionary

A dict object containing authentication details.

client_id

string

The ZPA API client ID generated from the ZPA console.

client_secret

string

The ZPA API client secret generated from the ZPA console.

cloud

string

The ZPA cloud provisioned for your organization.

Choices:

  • "PRODUCTION"

  • "BETA"

  • "QA"

  • "QA2"

  • "GOV"

  • "GOVUS"

  • "PREVIEW"

  • "ZPATWO"

customer_id

string

The ZPA tenant ID found in the Administration Company menu in the ZPA console.

state

string

The state.

Choices:

  • "present" ← (default)

  • "absent"

Notes

Note

  • Check mode is supported.

Examples

- name: Gather information about all App Connector Controllers
  zscaler.zpacloud.zpa_app_connector_controller_info:
  register: result

- name: Extract App Connector IDs
  set_fact:
    app_connector_ids: "{{ result.connectors | map(attribute='id') | list }}"

- name: Bulk delete App Connector Controllers
  zscaler.zpacloud.zpa_app_connector_controller:
    ids: "{{ app_connector_ids }}"

- name: Update Service Edge Controller Description
  zscaler.zpacloud.zpa_app_connector_controller:
    name: 'AppConnectorController01'
    description: 'Update App Connector Controller 01'
  register: result

Authors

  • William Guilherme (@willguibr)