Skip to main content

Query Audit Logs for Tenant (v2.1)

Query the audit logs for a given tenant as per specified query filters.

Path Parameters
    tenant_id string required

    The tenant ID.

Request Body

Query fields

    aggregate Aggregate

    The aggregate number of queries.

    data AggregateData[] required

    The details of the aggregate data.

  • Array [
  • value number required

    Value of the aggregate data.

    view object required

    View the aggregate date.

  • ]
  • field string


    name string required

    The name of the query response.

    operator string

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


    statistic string required

    QoS application aggregate statistics.

    unit string required

    The unit.

    dest_page int32

    The destination page.

    getDeleted boolean

    The number of queried deleted for a time frame.

    group_by string[]

    Group the queries.

    id string

    List the query 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.


Successful Operation

    count int32

    The number of responses.

    id string

    The ID of the response.

    tenant_id string

    The ID of the tenant.

    items AuditLogV2N1[]
  • Array [
  • esp_tenant_id string

    The audit log MSP tenant ID. Supported characters; = ^[a-z0-9]{1,50}$).

    id string

    The audit log ID.

    operator_id string

    The audit log operator ID. Supported characters; = ^[a-z0-9]{1,50}$).

    operator_tenant_id string

    The audit log tenant ID. Supported characters; = ^[a-z0-9]{1,50}$).

    request_body string

    The audit log request body.

    request_content_length int32

    The request content length.

    request_id string required

    The audit log request ID.

    request_ts int64

    Request Ts

    request_type string required

    The audit log request type (GET|POST|PUT|DELETE|PATCH)$).

    request_uri string required

    The audit log request URL.

    resource_etag int64

    The audit log request Etag.

    resource_id string

    The audit log resource ID. Max length = 50.

    resource_key string

    The audit log resource key. Max length = 128.

    resource_version string

    The audit log resource version.

    response_body string

    The audit log response body.

    response_code int32

    Response Code

    response_content_length int32

    The audit log response content length.

    response_ts int64

    Response Ts

    sdwanapp_id string

    The SD-WAN app ID. Max length = 128.

    session_key_c string

    The audit log session key C. Max length = 128.

    source_ip string

    The audit log source IP address. Max length = 128.

    tenant_id string required

    The tenant ID.

    time_ms int64

    Time Ms

  • ]