Network zones API - GET a network zone
Gets information about the specified network zone.
The request produces an application/json
payload.
This request is an Early Adopter release and may be changed in non-compatible way.
GET |
|
Authentication
To execute this request, you need the Read network zones (networkZones.read
) permission assigned to your API token. To learn how to obtain and use it, see Authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
id | string | The ID of the required network zone. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Network | Success |
Response body objects
The NetworkZone
object
Configuration of a network zone.
Element | Type | Description |
---|---|---|
alternativeZones | string[] | A list of alternative network zones. |
numOfOneAgentsUsing | integer | The number of OneAgents that are using ActiveGates in the network zone. |
numOfConfiguredOneAgents | integer | The number of OneAgents that are configured to use the network zone as primary. |
numOfOneAgentsFromOtherZones | integer | The number of OneAgents from other network zones that are using ActiveGates in the network zone. This is a fraction of numOfOneAgentsUsing. One possible reason for switching to another zone is that a firewall is preventing a OneAgent from connecting to any ActiveGate in the preferred network zone. |
numOfConfiguredActiveGates | integer | The number of ActiveGates in the network zone. |
description | string | A short description of the network zone |
id | string | The ID of the network zone |
Response body JSON model
{
"alternativeZones": [
"string"
],
"numOfOneAgentsUsing": 1,
"numOfConfiguredOneAgents": 1,
"numOfOneAgentsFromOtherZones": 1,
"numOfConfiguredActiveGates": 1,
"description": "string",
"id": "string"
}