Palo Alto Networks · Schema

list_users_in_particular_group

Retrieve specific attributes for users belonging to a particular group, filtered using the group-based filter.

Cloud SecurityCybersecurityFirewallNetwork SecuritySASESOARThreat IntelligenceXDR

Properties

Name Type Description
filter object Group-based filter.
attrs array user attributes part of the response
View JSON Schema on GitHub

JSON Schema

cloud-identity-engine-api-list_users_in_particular_group-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "list_users_in_particular_group",
  "description": "Retrieve specific attributes for users belonging to a particular group, filtered using the group-based filter.",
  "$id": "https://raw.githubusercontent.com/api-evangelist/palo-alto-networks/refs/heads/main/json-schema/cloud-identity-engine-api-list_users_in_particular_group-schema.json",
  "properties": {
    "filter": {
      "type": "object",
      "description": "Group-based filter.",
      "required": [
        "type",
        "name",
        "level"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "group"
          ]
        },
        "name": {
          "type": "object",
          "description": "Attribute-based filter.",
          "required": [
            "attrName",
            "attrValue",
            "match"
          ],
          "properties": {
            "attrName": {
              "description": "Attribute name",
              "type": "string",
              "enum": [
                "User Principal Name",
                "Common-Name",
                "Name",
                "Distinguished Name",
                "SAM Account Name",
                "Unique Identifier"
              ],
              "example": "Distinguished Name"
            },
            "attrValue": {
              "description": "Attribute value",
              "type": "string",
              "example": "CN=Jack,UID=Park,DC=example,DC=com"
            },
            "match": {
              "description": "Value you want to match.",
              "type": "string",
              "enum": [
                "equal",
                "textSearch"
              ],
              "example": "equal"
            }
          }
        },
        "level": {
          "type": "string",
          "enum": [
            "immediate",
            "recursive"
          ]
        }
      }
    },
    "attrs": {
      "type": "array",
      "description": "user attributes part of the response",
      "items": {
        "type": "string"
      },
      "example": [
        "Common-Name",
        "Mail",
        "Unique Identifier",
        "Manager",
        "User Principal Name",
        "Name",
        "Distinguished Name",
        "SAM Account Name"
      ]
    }
  },
  "required": [
    "filter"
  ],
  "allOf": [
    {
      "type": "object",
      "description": "Domain name for a specific directory.",
      "required": [
        "domain"
      ],
      "properties": {
        "domain": {
          "type": "string",
          "description": "Domain name of the target directory.",
          "example": "paloaltonetworks.com"
        }
      }
    },
    {
      "type": "object",
      "description": "Optional pagination parameters.",
      "properties": {
        "pageNum": {
          "type": "integer",
          "description": "Page number to retrieve (starting from page 1).",
          "example": 1
        },
        "pageSz": {
          "type": "integer",
          "description": "Number of records per page (max is 1000 per page).",
          "example": 500
        }
      }
    }
  ],
  "type": "object"
}