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

JSON 
{
    "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.