Get a Query by ID
get
/api/database/Queries/{id}
Gets the query that matches the specified ID.
Request
Path Parameters
-
id(required): integer(int32)
The query ID.Example:
1
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation
Nested Schema : SuccessfulGetOperation
Type:
Show Source
object
-
message: string
The response message.Example:
Loaded 1 entries
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : type
Type:
Show Source
object
-
data: array
data
The query properties.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : databaseQueriesRead
Type:
Show Source
object
-
Description: string
Description, human label of queryExample:
Devices in catalog with a blank DNS name
-
Owner: string
OwnerExample:
[Public to All Users and Groups]
-
OwnerUserGroupID: integer
Chosen user group ownerExample:
0
-
OwnerUserID: integer
Chosen user ownerExample:
0
-
Query: string
Query SQLExample:
-- Blank DNS -- SELECT D.DeviceID AS 'ID', D.CustomName AS 'Device Name', INET_NTOA(D.IPAddress) AS 'IP Address', FROM_UNIXTIME(D.TimestampAdded) AS 'First Found', FROM_UNIXTIME(D.TimestampLastFound) AS 'Last Found', FROM_UNIXTIME(D.TimestampModified) AS 'Last Modified', DTC.DeviceTypeCategoryName AS 'Category', DZ.DeviceZoneName AS 'Zone' FROM Devices AS D, DeviceTypeCategories AS DTC, DeviceZones AS DZ WHERE D.DeviceTypeCategoryID = DTC.DeviceTypeCategoryID AND D.DeviceZoneID = DZ.DeviceZoneID AND D.DNSName = '' ORDER BY D.CustomName ASC
-
QueryDBName: string
Database SchemaExample:
Assure1
-
QueryID: integer
Query ID specified for individual CRUD operationsExample:
1000
-
QueryName: string
Query NameExample:
Devices Missing DNS
-
QueryShardID: integer
Shard ID, optional defaults to 1Example:
1
-
Tokens: array
Tokens
Optional array of tokens, or placeholders, to be dynamically replaced when the query is used.
-
Viewers: array
Viewers
List of user groups that can view
Nested Schema : Tokens
Type:
array
Optional array of tokens, or placeholders, to be dynamically replaced when the query is used.
Show Source
Nested Schema : items
Type:
Show Source
object
-
DefaultValue: string
Value to replace the token with if no value is provided.Example:
pg-someone.example.com
-
TokenIndex: integer
ID of the token in the Tokens array.Example:
1
-
TokenName: string
Token name to be replaced.Example:
DeviceName
Nested Schema : items
Type:
Show Source
object
-
UserGroupID: integer
The user group ID.
-
UserGroupName: string
The user group name.
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
Nested Schema : items
Type:
object