6.1.5. Bugzilla Information
These methods are used to get general configuration information about this Bugzilla instance.
6.1.5.1. Version
Returns the current version of Bugzilla. Normally in the format of X.X
or
X.X.X
. For example, 4.4
for the initial release of a new branch. Or
4.4.6
for a minor release on the same branch.
Request
GET /rest/version
Response
{
"version": "4.5.5+"
}
name |
type |
description |
---|---|---|
version |
string |
The current version of this Bugzilla |
6.1.5.2. Extensions
Gets information about the extensions that are currently installed and enabled in this Bugzilla.
Request
GET /rest/extensions
Response
{
"extensions": {
"Voting": {
"version": "4.5.5+"
},
"BmpConvert": {
"version": "1.0"
}
}
}
name |
type |
description |
---|---|---|
extensions |
object |
An object containing the extensions enabled as keys. Each extension object contains the following keys:
|
6.1.5.3. Timezone
Returns the timezone in which Bugzilla expects to receive dates and times on the API. Currently hard-coded to UTC (“+0000”). This is unlikely to change.
Request
GET /rest/timezone
{
"timezone": "+0000"
}
Response
name |
type |
description |
---|---|---|
timezone |
string |
The timezone offset as a string in (+/-)XXXX (RFC 2822) format. |
6.1.5.4. Time
Gets information about what time the Bugzilla server thinks it is, and what timezone it’s running in.
Request
GET /rest/time
Response
{
"web_time_utc": "2014-09-26T18:01:30Z",
"db_time": "2014-09-26T18:01:30Z",
"web_time": "2014-09-26T18:01:30Z",
"tz_offset": "+0000",
"tz_short_name": "UTC",
"tz_name": "UTC"
}
name |
type |
description |
---|---|---|
db_time |
string |
The current time in UTC, according to the Bugzilla database server. Note that Bugzilla assumes that the database and the webserver are running in the same time zone. However, if the web server and the database server aren’t synchronized or some reason, this is the time that you should rely on or doing searches and other input to the WebService. |
web_time |
string |
This is the current time in UTC, according to Bugzilla’s web server. This might be different by a second from |
web_time_utc |
string |
Identical to |
tz_name |
string |
The literal string |
tz_short_name |
string |
The literal string |
tz_offset |
string |
The literal string |
6.1.5.5. Parameters
Returns parameter values currently used in this Bugzilla.
Request
GET /rest/parameters
Response
Example response for anonymous user:
{
"parameters" : {
"maintainer" : "admin@example.com",
"requirelogin" : "0"
}
}
Example response for authenticated user:
{
"parameters" : {
"allowemailchange" : "1",
"attachment_base" : "http://bugzilla.example.com/",
"commentonchange_resolution" : "0",
"commentonduplicate" : "0",
"cookiepath" : "/",
"createemailregexp" : ".*",
"defaultopsys" : "",
"defaultplatform" : "",
"defaultpriority" : "--",
"defaultseverity" : "normal",
"duplicate_or_move_bug_status" : "RESOLVED",
"emailregexp" : "^[\\w\\.\\+\\-=']+@[\\w\\.\\-]+\\.[\\w\\-]+$",
"emailsuffix" : "",
"letsubmitterchoosemilestone" : "1",
"letsubmitterchoosepriority" : "1",
"mailfrom" : "bugzilla-daemon@example.com",
"maintainer" : "admin@example.com",
"maxattachmentsize" : "1000",
"maxlocalattachment" : "0",
"musthavemilestoneonaccept" : "0",
"noresolveonopenblockers" : "0",
"password_complexity" : "no_constraints",
"rememberlogin" : "on",
"requirelogin" : "0",
"urlbase" : "http://bugzilla.example.com/",
"use_see_also" : "1",
"useclassification" : "1",
"usemenuforusers" : "0",
"useqacontact" : "1",
"usestatuswhiteboard" : "1",
"usetargetmilestone" : "1",
}
}
A logged-out user can only access the maintainer
and requirelogin
parameters.
A logged-in user can access the following parameters (listed alphabetically):
allowemailchange
attachment_base
commentonchange_resolution
commentonduplicate
cookiepath
defaultopsys
defaultplatform
defaultpriority
defaultseverity
duplicate_or_move_bug_status
emailregexpdesc
emailsuffix
letsubmitterchoosemilestone
letsubmitterchoosepriority
mailfrom
maintainer
maxattachmentsize
maxlocalattachment
musthavemilestoneonaccept
noresolveonopenblockers
password_complexity
rememberlogin
requirelogin
search_allow_no_criteria
urlbase
use_see_also
useclassification
usemenuforusers
useqacontact
usestatuswhiteboard
usetargetmilestone
A user in the tweakparams group can access all existing parameters. New parameters can appear or obsolete parameters can disappear depending on the version of Bugzilla and on extensions being installed. The list of parameters returned by this method is not stable and will never be stable.
6.1.5.6. Last Audit Time
Gets the most recent timestamp among all of the events recorded in the audit_log table.
Request
To get most recent audit timestamp for all classes:
GET /rest/last_audit_time
To get the the most recent audit timestamp for the Bugzilla::Product
class:
GET /rest/last_audit_time?class=Bugzilla::Product
name |
type |
description |
---|---|---|
class |
array |
The class names are defined as |
Response
{
"last_audit_time": "2014-09-23T18:03:38Z"
}
name |
type |
description |
---|---|---|
last_audit_time |
string |
The maximum of the at_time from the audit_log. |
This documentation undoubtedly has bugs; if you find some, please file them here.