Skip Navigation

Create zone

Add a zone to a tenant.
Service endpoint
/zones/v2
Optional query string parameters
Example
https://protectapi.cylance.com/zones/v2
Method
HTTP/1.1 POST
Request headers
  • Accept: application/json
  • Authorization: Bearer
    JWT Token returned by Auth API
    with the zone:create scope encoded.
  • Content-Type: application/json

Request

{ "name": "Test Zone", "policy_id": "d5c6d6a3-0599-4fb5-96bc-0fdc7eacb6ea", "criticality": "Normal" }
The policy_id or criticality requests can be removed if they are not needed. If the policy_id is removed, the zone is created with the default policy. If the criticality is removed, the zone is created with the normal criticality.

Response

Please see the Response status codes for more information.

Request JSON schema

Field Name
Description
criticality
This is the value of the zone (low, normal, or high). The default setting, normal, is assigned if a value is not included.
name
This is the name of the zone.  The maximum character limit for a zone name is 255. The following special characters are invalid: &<>. Zone names are case-preserving, but case-insensitive.
policy_id
This is the unique ID for the zone rule created for the zone. Null is displayed if no zone rule exists.

Response JSON schema

Field Name
Description
criticality
This is the value of the zone (low, normal, or high).
date_created
This is the date and time (in UTC) when the zone was created.
id
This is the unique ID for the zone.
name
This is the name of the zone.
policy_id
This is the unique ID for the zone rule created for the zone. Null is displayed if no zone rule exists.