zpa_pra_portal_controller_info.yml

---
# zpa_pra_portal_controller_info.yml - Get details (ID and/or Name) of a PRA Portal.
#
# Description
# ===========
#
# Quick examples of how to use the 'zpa_pra_portal_controller_info' module to retrieve  details of a PRA Portal in the ZPA Cloud.
#
# This playbook requires proper API credentials to be passed statically or via environment variables connection
# to the ZPA Cloud 'client_id', 'client_secret', customer_id and 'cloud'. These may be defined as host variables
# (see `host_vars/zpa_cloud.yml` for an example) or extra vars.
#
# Modules Used
# ============
#
# zpa_pra_portal_controller_info - https://zscaler.github.io/zpacloud-ansible/modules/zpa_pra_portal_controller_info_module.html
#
# Usage
# =====
#
#  $ ansible-playbook zpa_pra_portal_controller_info.yml

- name: Gather Details of PRA Portals
  hosts: localhost
  connection: local

  vars:
    zpa_cloud:
      client_id: "{{ client_id }}"
      client_secret: "{{ client_secret | default(omit) }}"
      customer_id: "{{ customer_id | default(omit) }}"
      cloud: "{{ cloud | default(omit) }}"

  tasks:
    - name: Get Detail Information of All PRA Credentials
      zscaler.zpacloud.zpa_pra_portal_controller_info:
        provider: "{{ zpa_cloud }}"
      register: all_portals

    - name: All PRA Portals Details
      ansible.builtin.debug:
        msg: "{{ all_portals }}"

    - name: Get Details of a PRA Portal by Name
      zscaler.zpacloud.zpa_pra_portal_controller_info:
        provider: "{{ zpa_cloud }}"
        name: "Example"
      register: portal_name

    - name: PRA Portal Details By Name
      ansible.builtin.debug:
        msg: "{{ portal_name }}"

    - name: Get Details of a PRA Credential by ID
      zscaler.zpacloud.zpa_pra_portal_controller_info:
        provider: "{{ zpa_cloud }}"
        id: "216196257331291969"
      register: portal_id

    - name: PRA Credential Details By ID
      ansible.builtin.debug:
        msg: "{{ portal_id }}"