/mgmtconfig/v1/admin/customers/{customerId}/connector/bulkDelete

Parameters

Name
Description
bulkDeleteResource *required
object
(body)
The resource for bulk deleting the App Connectors.

Parameters content type:

customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.
Responses
Response content type:
Code
200
Description
OK
Code
201
Description
Created
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
Code
404
Description
Not Found
/mgmtconfig/v1/admin/customers/{customerId}/connector/{connectorId}

Parameters

Name
Description
connectorId *required
integer($int64)
(path)
The unique identifier of the App Connector.
customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.

applicationStartTime
integer($int64)
The start time of the App Connector.
appConnectorGroupId
string
The unique identifier of the App Connector Group.
appConnectorGroupName
string
The name of the App Connector Group.
controlChannelStatus
string
The status of the control channel. This field has read-only properties and is ignored in PUT and POST requests.
[
...
]
creationTime
integer($int32)
The time the App Connector is created.
ctrlBrokerName
string
The name of the Control Public Service Edge. This field has read-only properties and is ignored in PUT and POST requests.
currentVersion
string
The current version of the App Connector. This field has read-only properties and is ignored in PUT and POST requests.
description
string
The description of the App Connector.
enabled
boolean
Whether this App Connector is enabled or not.
expectedUpgradeTime
integer($int64)
The expected upgrade time for the App Connector. This field has read-only properties and is ignored in PUT and POST requests.
expectedVersion
string
The expected version of the App Connector. This field has read-only properties and is ignored in PUT and POST requests.
fingerprint
string
The hardware fingerprint associated with the App Connector.
id
integer($int64)
The unique identifier of the App Connector.
ipAcl
array[string]
The IP Access List (IP ACL) to allow App Connectors on a specific IP or subnet.
issuedCertId
integer($int64)
The unique identifier of the issued certificate.
lastBrokerConnectTime
integer($int64)
The time the ZPA Public Service Edge last connected. This field has read-only properties and is ignored in PUT and POST requests.
lastBrokerConnectTimeDuration
string
The duration of time when the ZPA Public Service Edge last connected. This field has read-only properties and is ignored in PUT and POST requests.
lastBrokerDisconnectTime
integer($int64)
The time the ZPA Public Service Edge last disconnected. This field has read-only properties and is ignored in PUT and POST requests.
lastBrokerDisconnectTimeDuration
string
The duration of time when the ZPA Public Service Edge last disconnected. This field has read-only properties and is ignored in PUT and POST requests.
lastUpgradeTime
integer($int64)
The time the App Connector last upgraded.
latitude
number($double)
The latitude of the App Connector. This field has read-only properties and is ignored in PUT and POST requests.
location
string
The location of the App Connector.
longitude
number($double)
The longitude of the App Connector.
modifiedBy
integer($int64)
The unique identifier of the tenant who modified the App Connector.
modifiedTime
integer($int32)
The time the App Connector is modified.
name*
string
The name of the App Connector.
provisioningKeyId
integer($int64)
The unique identifier of the provisioning key.
provisioningKeyName
string
The name of the provisioning key.
platform
string
The host OS the App Connector is deployed on.
platformDetail
string
The platform the App Connector is deployed on.
previousVersion
string
The previous version of the App Connector. This field has read-only properties and is ignored in PUT and POST requests.
privateIp
string
The private IP of the App Connector.
publicIp
string
The public IP of the App Connector.
runtimeOS
string
The run time OS on which the App Connector is running.
sargeVersion
string
The manager version of the App Connector.
microtenantId
integer($int64)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.
microtenantName
string
The name of the Microtenant.
enrollmentCert
The enrollment certificate for the App Connector.
{
   < * >: string
}
upgradeAttempt
integer($int32)
The number of attempts the App Connector takes to upgrade. This field has read-only properties and is ignored in PUT and POST requests.
upgradeStatus
string
The status of the App Connector upgrade. Only applicable in a GET request. This field has read-only properties and is ignored in PUT and POST requests.
[
...
]
zpnSubModuleUpgradeList
Responses
Response content type:
Code
200
Description
OK
Example Value
{
  "applicationStartTime": 0,
  "appConnectorGroupId": "string",
  "appConnectorGroupName": "string",
  "controlChannelStatus": "UNKNOWN",
  "creationTime": 0,
  "ctrlBrokerName": "string",
  "currentVersion": "string",
  "description": "string",
  "enabled": true,
  "expectedUpgradeTime": 0,
  "expectedVersion": "string",
  "fingerprint": "string",
  "id": 0,
  "ipAcl": [
    "string"
  ],
  "issuedCertId": 0,
  "lastBrokerConnectTime": 0,
  "lastBrokerConnectTimeDuration": "string",
  "lastBrokerDisconnectTime": 0,
  "lastBrokerDisconnectTimeDuration": "string",
  "lastUpgradeTime": 0,
  "latitude": 0,
  "location": "string",
  "longitude": 0,
  "modifiedBy": 0,
  "modifiedTime": 0,
  "name": "string",
  "provisioningKeyId": 0,
  "provisioningKeyName": "string",
  "platform": "string",
  "platformDetail": "string",
  "previousVersion": "string",
  "privateIp": "string",
  "publicIp": "string",
  "runtimeOS": "string",
  "sargeVersion": "string",
  "microtenantId": 0,
  "microtenantName": "string",
  "enrollmentCert": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "upgradeAttempt": 0,
  "upgradeStatus": "COMPLETE",
  "zpnSubModuleUpgradeList": [
    {
      "creationTime": 0,
      "currentVersion": "string",
      "entityGid": 0,
      "entityType": "ASSISTANT",
      "expectedVersion": "string",
      "id": 0,
      "modifiedBy": 0,
      "modifiedTime": 0,
      "previousVersion": "string",
      "role": "ASSISTANT",
      "upgradeStatus": "COMPLETE",
      "upgradeTime": 0
    }
  ]
}
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
Code
404
Description
Not Found
/mgmtconfig/v1/admin/customers/{customerId}/connector/{connectorId}

Parameters

Name
Description
connector *required
object
(body)
The object of the App Connector.

Parameters content type:

connectorId *required
integer($int64)
(path)
The unique identifier of the App Connector.
customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.
Responses
Response content type:
Code
201
Description
Created
Code
204
Description
No Content
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
Code
404
Description
Not Found
/mgmtconfig/v1/admin/customers/{customerId}/connector/{connectorId}

Parameters

Name
Description
connectorId *required
integer($int64)
(path)
The unique identifier of the App Connector.
customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.
Responses
Response content type:
Code
204
Description
No Content
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
/mgmtconfig/v1/admin/customers/{customerId}/connector

Parameters

Name
Description
customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
page
integer($int32)
(query)
Specifies the page number.
Example : 1
pagesize
integer($int32)
(query)
Specifies the page size. If not provided, the default page size is 20. The max page size is 500.
Example : 20
microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.
search
string
(query)
The search string used to support search by features and fields for the API.

list
The total list of App Connectors.
totalCount
integer($int64)
The total count of resources per the search feature.
totalPages
integer($int32)
The total number of pages per the pagination attribute.
Responses
Response content type:
Code
200
Description
OK
Example Value
{
  "list": [
    {
      "applicationStartTime": 0,
      "appConnectorGroupId": "string",
      "appConnectorGroupName": "string",
      "controlChannelStatus": "UNKNOWN",
      "creationTime": 0,
      "ctrlBrokerName": "string",
      "currentVersion": "string",
      "description": "string",
      "enabled": true,
      "expectedUpgradeTime": 0,
      "expectedVersion": "string",
      "fingerprint": "string",
      "id": 0,
      "ipAcl": [
        "string"
      ],
      "issuedCertId": 0,
      "lastBrokerConnectTime": 0,
      "lastBrokerConnectTimeDuration": "string",
      "lastBrokerDisconnectTime": 0,
      "lastBrokerDisconnectTimeDuration": "string",
      "lastUpgradeTime": 0,
      "latitude": 0,
      "location": "string",
      "longitude": 0,
      "modifiedBy": 0,
      "modifiedTime": 0,
      "name": "string",
      "provisioningKeyId": 0,
      "provisioningKeyName": "string",
      "platform": "string",
      "platformDetail": "string",
      "previousVersion": "string",
      "privateIp": "string",
      "publicIp": "string",
      "runtimeOS": "string",
      "sargeVersion": "string",
      "microtenantId": 0,
      "microtenantName": "string",
      "enrollmentCert": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "upgradeAttempt": 0,
      "upgradeStatus": "COMPLETE",
      "zpnSubModuleUpgradeList": [
        {
          "creationTime": 0,
          "currentVersion": "string",
          "entityGid": 0,
          "entityType": "ASSISTANT",
          "expectedVersion": "string",
          "id": 0,
          "modifiedBy": 0,
          "modifiedTime": 0,
          "previousVersion": "string",
          "role": "ASSISTANT",
          "upgradeStatus": "COMPLETE",
          "upgradeTime": 0
        }
      ]
    }
  ],
  "totalCount": 0,
  "totalPages": 0
}
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
Code
404
Description
Not Found
/mgmtconfig/v1/admin/customers/{customerId}/connectorSchedule/{id}

Parameters

Name
Description
customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
id *required
integer($int64)
(path)
The unique identifier for the App Connector auto deletion configuration for a customer. This field is only required for the PUT request to update the frequency of the App Connector Settings.
scheduledConfigDTO *required
object
(body)
The scheduled frequency and interval at which the disconnected App Connectors are deleted. For example, 14d is equial to 14 days.

Parameters content type:

microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.
Responses
Response content type:
Code
201
Description
Created
Code
204
Description
No Content
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
Code
404
Description
Not Found
/mgmtconfig/v1/admin/customers/{customerId}/connectorSchedule

Parameters

Name
Description
customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.

customerId
integer($int64)
The unqiue identifier of the ZPA tenant.
deleteDisabled
boolean
Indicates if the App Connectors are included for deletion if they are in a disconnected state based on the frequencyInterval and frequency values.
enabled
boolean
Indicates if the setting for deleting App Connectors is enabled or disabled.
frequency
string
The scheduled frequency at which the disconnected App Connectors are deleted.
frequencyInterval
integer($int32)
The interval for the configured frequency value. The minimum supported value is 5.
id
integer($int64)
The unique identifier for the App Connector auto deletion configuration for a customer. This field is only required for the PUT request to update the frequency of the App Connector Settings.
readonly: true
Responses
Response content type:
Code
200
Description
OK
Example Value
{
  "customerId": 0,
  "deleteDisabled": true,
  "enabled": true,
  "frequency": "string",
  "frequencyInterval": 0,
  "id": 0
}
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
Code
404
Description
Not Found
/mgmtconfig/v1/admin/customers/{customerId}/connectorSchedule

Parameters

Name
Description
customerId *required
integer($int64)
(path)
The unique identifier of the ZPA tenant.
scheduledConfigDTO *required
object
(body)
The scheduled frequency and interval at which the disconnected App Connectors are deleted. For example, 14d is equial to 14 days.

Parameters content type:

microtenantId
integer($int64)
(query)
The unique identifier of the Microtenant for the ZPA tenant. If you are within the Default Microtenant, pass microtenantId as 0 when making requests to retrieve data from the Default Microtenant. Pass microtenantId as null to retrieve data from all customers associated with the tenant.

customerId
integer($int64)
The unqiue identifier of the ZPA tenant.
deleteDisabled
boolean
Indicates if the App Connectors are included for deletion if they are in a disconnected state based on the frequencyInterval and frequency values.
enabled
boolean
Indicates if the setting for deleting App Connectors is enabled or disabled.
frequency
string
The scheduled frequency at which the disconnected App Connectors are deleted.
frequencyInterval
integer($int32)
The interval for the configured frequency value. The minimum supported value is 5.
id
integer($int64)
The unique identifier for the App Connector auto deletion configuration for a customer. This field is only required for the PUT request to update the frequency of the App Connector Settings.
readonly: true
Responses
Response content type:
Code
201
Description
Created
Code
204
Description
No Content
Example Value
{
  "customerId": 0,
  "deleteDisabled": true,
  "enabled": true,
  "frequency": "string",
  "frequencyInterval": 0,
  "id": 0
}
Code
401
Description
Unauthorized
Code
403
Description
Forbidden
Code
404
Description
Not Found