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 :

  • version (chaîne) La version de l'extension.

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 à db_time puisqu'elle provient d'une source différente. Si l'écart est supérieur, il y a probablement un problème avec cette instance de Bugzilla. Dans ce cas, vous devez vous basez sur db_time et non sur web_time.

web_time_utc string Identique à web_time. (Existe seulement pour des raisons de compatibilité avec les versions de Bugzilla antérieures à 3.6).
tz_name string La chaîne littérale UTC. (Existe seulement pour des raisons de compatibilité avec les versions de Bugzilla antérieures à 3.6).
tz_short_name string La chaîne littérale UTC. (Existe seulement pour des raisons de compatibilité avec les versions de Bugzilla antérieures à 3.6).
tz_offset string La chaîne littérale +0000. (Existe seulement pour des raisons de compatibilité avec les versions de Bugzilla antérieures à 3.6).

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 : Bugzilla::<class_name>. Par exemple : Bugzilla:Product`` pour produits.

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.