Obtaining Version Profile Details Using API

This article provides information for managing Zscaler Private Access (ZPA) version profiles using APIs. All APIs are rate limited. To learn more, see Understanding Rate Limiting.

Getting Details of All Version Profiles

To get details of all version profiles:

  1. Send a GET request to the endpoint /mgmtconfig/v1/admin/customers/{customerId}/visible/versionProfiles in the customer-version-profile-controller.
  2. Provide the customerId, the ZPA tenant ID of the customer, in the request endpoint. For example: /mgmtconfig/v1/admin/customers/72057594037927936/visible/versionProfiles.
  • {
    "totalPages": "1",
    "list": [
    {
    "id": "0",
    "modifiedTime": "1626626015",
    "modifiedBy": "72057594037939756",
    "name": "Default",
    "upgradePriority": "WEEK",
    "visibilityScope": "ALL",
    "customerId": "72057594037927936"
    },
    {
    "id": "1",
    "modifiedTime": "1629892276",
    "creationTime": "1624262913",
    "modifiedBy": "72057594037988570",
    "name": "Previous Default",
    "description": "Cloud wide previous stable/default build. Provides roll-back ability",
    "upgradePriority": "FORCE_NOW",
    "visibilityScope": "ALL",
    "customerId": "72057594037927936"
    },
    {
    "id": "2",
    "modifiedTime": "1631705841",
    "creationTime": "1624262914",
    "modifiedBy": "72057594037939756",
    "name": "New Release",
    "upgradePriority": "WEEK",
    "visibilityScope": "ALL",
    "customerId": "72057594037927936"
    }
    Close

A successful response returns code 200. To learn more, see API Response Codes and Error Messages.

This API supports pagination. To get a paginated response:

  1. Send a GET request to the endpoint /mgmtconfig/v1/admin/customers/{customerId}/visible/versionProfiles?page=1&pagesize=20.
  2. Provide the following in the request endpoint:
  • customerId: The ZPA tenant ID of the customer.
  • Valid values for page and page size parameters.

For example: /mgmtconfig/v1/admin/customers/144118148382065089/server?page=1&pagesize=2.

  • {
      "totalPages": "2",
      "list": [
        {
          "id": "0",
          "modifiedTime": "1644938687",
          "creationTime": "1475127781",
          "modifiedBy": "72057594037928187",
          "name": "Default",
          "upgradePriority": "WEEK",
          "visibilityScope": "ALL",
          "customerId": "72057594037927936"
        },
        {
          "id": "1",
          "modifiedTime": "1634285256",
          "creationTime": "1631577657",
          "modifiedBy": "72057594037928193",
          "name": "Previous Default",
          "upgradePriority": "DAY",
          "visibilityScope": "ALL",
          "customerId": "72057594037927936"
        }
      ]
    }
    Close

If not provided, the default page size is 20. The maximum page size is 500.

A successful response returns code 200. To learn more, see API Response Codes and Error Messages.