Query Element Security Zones (v2.0)

POST 
/v2.0/api/tenants/:tenant_id/elementsecurityzones/query

Query the element security zones.

Request

Path Parameters

tenant_id stringrequired

The tenant ID.

application/json

Body

Details for Element Security Zone Query

aggregate Aggregate

The aggregate number of element security zones that match the query parameters.

data AggregateData[]required

The details of the aggregate data.

Array [

value numberrequired

Value of the aggregate data.

view objectrequired

View the aggregate date.

]

field string

Field

name stringrequired

The name of the query response.

operator string

Possible values: [max, count, min, avg, sum]

Operator

statistic stringrequired

QoS application aggregate statistics.

unit stringrequired

The unit.

dest_page int32

The destination page.

getDeleted boolean

The number of element security zones deleted for a time frame.

group_by string[]

Group the element security zones for the query.

id string

Lists the element security zones by ID.

last_query_ts int64

Return the ID of a specified query in the current session.

limit int32

The query limit.

next_query object

The limit.

query_params object
retrieved_fields string[]

Retrieve information from a field.

retrieved_fields_mask boolean

List the fields to query.

sort_params object
total_count int64

The total number of query parameters.

Responses

200

Successful Operation

application/json

Schema

Schema

count int32

The count of the query list.

deleted_count int64

The deleted number of queries.

deleted_ids string[]

The deleted query IDs.

description

Description of the query. Max size = 256.

id string

The ID.

next_query object

Details of the next query.

tenant_id string

The tenant ID.

total_count int64

Total number of queries.

items ElementSecurityZoneQueryFilter[]
Array [
element_id string
The ID of the element configured for the security zone.
id string
The ID of the security zone.
interface_ids string[]
The element security zones interface IDs.
lannetwork_ids string[]
The element security zones LAN network IDs.
site_id stringrequired
The site ID configured for the element security zone.
tenant_id stringrequired
Tenant Id: NotNull Digits(fraction = 0, integer = 20, TENANT_ID_INVALID_0001)
waninterface_ids string[]
The element security zones WAN interface IDs.
wanoverlay_ids string[]
The element security zones WAN overlay IDs.
zone_id stringrequired
The element security zone ID.
]

Example (from schema)

{
  "count": 0,
  "deleted_count": 0,
  "deleted_ids": [
    "string"
  ],
  "id": "string",
  "next_query": {},
  "tenant_id": "string",
  "total_count": 0,
  "items": [
    {
      "element_id": "string",
      "id": "string",
      "interface_ids": [
        "string"
      ],
      "lannetwork_ids": [
        "string"
      ],
      "site_id": "string",
      "tenant_id": "string",
      "waninterface_ids": [
        "string"
      ],
      "wanoverlay_ids": [
        "string"
      ],
      "zone_id": "string"
    }
  ]
}

400

Bad Request

application/json

Schema

Schema

_error ErrorResponse[]
Array [
code string
message string
]

Example (from schema)

{
  "_error": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "value": {
    "_error": [
      {
        "code": "BAD_REQUEST"
      }
    ]
  }
}

Loading...