6.1.5. Information sur Bugzilla
Ces méthodes sont utilisées pour obtenir des informations de configuration générale sur cette instance de Bugzilla.
6.1.5.1. Version
Renvoie la version courante de Bugzilla. Normalement sous la forme X.X ou
X.X.X. Par exemple, 4.4 pour la version initiale d’une nouvelle branche. Ou
4.4.6 pour une version mineure de la même branche.
Requête
GET /rest/version
Réponse
{
"version": "4.5.5+"
}
nom |
type |
description |
|---|---|---|
version |
string |
La version courante de ce Bugzilla. |
6.1.5.2. Extensions
Obtient des informations sur les extensions installées et activées dans ce Bugzilla.
Requête
GET /rest/extensions
Réponse
{
"extensions": {
"Voting": {
"version": "4.5.5+"
},
"BmpConvert": {
"version": "1.0"
}
}
}
nom |
type |
description |
|---|---|---|
extensions |
object |
Un objet contenant les extensions activées sous forme de clés. Chaque objet d’extension contient les clés suivantes :
|
6.1.5.3. Fuseau horaire
Renvoie le fuseau horaire dans lequel Bugzilla s’attend à recevoir les dates et heures dans l’API. Actuellement codé en dur en UTC (« +0000 »). Cela ne sera probablement pas changé.
Requête
GET /rest/timezone
{
"timezone": "+0000"
}
Réponse
nom |
type |
description |
|---|---|---|
timezone |
string |
Le décalage du fuseau horaire sous forme de chaîne au format (RFC 2822) : (+/-)XXXX. |
6.1.5.4. Heure
Obtient l’information sur l’heure que Bugzilla pense qu’il est et le fuseau horaire dans lequel il s’exécute.
Requête
GET /rest/time
Réponse
{
"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"
}
nom |
type |
description |
|---|---|---|
db_time |
string |
L’heure courante en UTC, selon le serveur de base de données de Bugzilla. Veuillez noter que Bugzilla suppose que le serveur de base de données et le serveur Web fonctionnent dans le même fuseau horaire. Cependant, si le serveur Web et le serveur de base de données ne sont pas synchronisés, ceci est l’heure sur laquelle vous devez vous basez pour faire des recherches ou des saisies via le WebService. |
web_time |
string |
Ceci est l’heure courante en UTC, selon le serveur Web de Bugzilla. Ceci pourrait différer d’une seconde par rapport à
|
web_time_utc |
string |
Identique à |
tz_name |
string |
La chaîne littérale |
tz_short_name |
string |
La chaîne littérale |
tz_offset |
string |
La chaîne littérale |
6.1.5.5. Paramètres
Renvoie les valeurs des paramètres actuellement utilisées dans ce Bugzilla.
Requête
GET /rest/parameters
Réponse
Exemple de réponse pour un utilisateur anonyme :
{
"parameters" : {
"maintainer" : "admin@example.com",
"requirelogin" : "0"
}
}
Exemple de réponse pour un utilisateur authentifié :
{
"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",
}
}
Un utilisateur non connecté ne peut accéder qu’aux paramètres maintainer et requirelogin.
Un utilisateur authentifié peut accéder aux paramètres suivants (classés alphabétiquement) :
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
Un utilisateur membre du groupe tweakparams peut accéder à tous les paramètres existants.
De nouveaux paramètres peuvent apparaître et des paramètres obsolètes disparaître en fonction
de la version de Bugzilla et des extensions installées.
La liste des paramètres renvoyés par cette méthode n’est pas stable et ne le sera
jamais.
6.1.5.6. Heure du dernier audit
Récupère les horodatages les plus récents parmi tous les événements enregistrés dans la table audit_log.
Requête
Pour obtenir les horodatages les plus récents pour toutes les classes :
GET /rest/last_audit_time
Pour obtenir les horodatages les plus récents pour la classe Bugzilla::Product :
GET /rest/last_audit_time?class=Bugzilla::Product
nom |
type |
description |
|---|---|---|
class |
array |
Les noms des classes sont définis ainsi : |
Réponse
{
"last_audit_time": "2014-09-23T18:03:38Z"
}
nom |
type |
description |
|---|---|---|
last_audit_time |
string |
Le maximum de at_time de audit_log. |
Cette documentation contient très probablement des bogues ; si vous en découvrez, veuillez les signaler ici.