Query DB for Software Downloads (v2.0)

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

Query the DB for all software downloads done by a tenant.

Request

Path Parameters

tenant_id stringrequired

The ID of the tenant.

application/json

Body

aggregate Aggregate

The aggregate number of software downloads that match the query parameters.

data AggregateData[]

The details of the aggregate data.

Array [

value number

Value of the aggregate data.

view object

View the aggregate date.

]

field string

Field

name string

The name of the query response.

operator string

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

Operator

statistic string

QoS application aggregate statistics.

unit string

The unit.

dest_page int32

The destination page.

getDeleted boolean

The number of software downloads deleted for a time frame.

group_by string[]

Group the software downloads for the query.

id string

Lists the software downloads 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 actual count.

deleted_count int64

The deleted number.

deleted_ids string[]

The deleted 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.

items SoftwareDownloadHistoryQuery[]
Array [
aggregate Aggregate
The aggregate number of software downloads that match the query parameters.
data AggregateData[]
The details of the aggregate data.
Array [
value number
Value of the aggregate data.
view object
View the aggregate date.
]
field string
Field
name string
The name of the query response.
operator string
Possible values: [max, count, min, avg, sum]
Operator
statistic string
QoS application aggregate statistics.
unit string
The unit.
dest_page int32
The destination page.
getDeleted boolean
The number of software downloads deleted for a time frame.
group_by string[]
Group the software downloads for the query.
id string
Lists the software downloads 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.
]

Example (from schema)

{
  "count": 0,
  "deleted_count": 0,
  "deleted_ids": [
    "string"
  ],
  "id": "string",
  "next_query": {},
  "tenant_id": "string",
  "total_count": 0,
  "items": [
    {
      "aggregate": {
        "data": [
          {
            "value": 0,
            "view": {}
          }
        ],
        "field": "string",
        "name": "string",
        "operator": "max",
        "statistic": "string",
        "unit": "string"
      },
      "dest_page": 0,
      "getDeleted": true,
      "group_by": [
        "string"
      ],
      "id": "string",
      "last_query_ts": 0,
      "limit": 0,
      "next_query": {},
      "query_params": {},
      "retrieved_fields": [
        "string"
      ],
      "retrieved_fields_mask": true,
      "sort_params": {},
      "total_count": 0
    }
  ]
}

400

Bad Request

application/json

Schema

Schema

_error ErrorResponse[]
Array [
code string
The error code.
message string
The error message.
]

Example (from schema)

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

Example

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

Loading...