GOCDB/PI/get downtime method

From EGIWiki
< GOCDB‎ | PI
Revision as of 15:56, 13 February 2014 by Jamesm (talk | contribs) (parameters)
Jump to: navigation, search
Main EGI.eu operations services Support Documentation Tools Activities Performance Technology Catch-all Services Resource Allocation Security


GOC DB menu: Home Documentation Index


Method: get_downtime

Description Returns a list of service downtimes with each downtime duplicated for each affected service.
Protection Level Public (level 1)

Entry point

https://goc.egi.eu/gocdbpi/public/?method=get_downtime&ongoing_only=yes

parameters

parameter effect format/value(s) default example
topentity Limit results to downtimes below given entity any NGI (ROC), country, sitename or node hostname EGEE ?method=get_downtime&topentity=SouthEasternEurope
 ?method=get_downtime&topentity=Portugal
 ?method=get_downtime&topentity=RAL-LCG2
 ?method=get_downtime&topentity=ce.mysite.com
ongoing_only Limit results to current ongoing downtimes yes/no no ?method=get_downtime&ongoing_only=yes
startdate Limit results to downtimes that start after specified date date in YYY-MM-DD format 1970-01-01 ?method=get_downtime&startdate=2008-12-08
enddate limit results to downtimes that end before specified date date in YYY-MM-DD format 2024-12-31 ?method=get_downtime&enddate=2008-12-14
windowstart/windowend limit results to current time window (including downtimes that
appear in this window, even if they start before or end after)
date in YYY-MM-DD format 1970-01-01/2024-12-31 ?method=get_downtime&windowstart=2008-12-08&windowend=2008-12-15
scope Show only downtimes with the requested scope-tags (Local and EGI are currently the only available scopes) A comma separated list of scope-tag values or an empty value to return all scopes, i.e. '&scope=' EGI  ?method=get_downtime&scope=Local
scope_match Match 'all' or 'any' of the specified scope-tags 'all' or 'any' all  ?method=get_downtime&scope=Local,EGI&scope_match=any
extensions Limit results by one or many key value pairs See Extensions Mechanism none  ?method=get_downtime&extensions=(KeyName=KeyValue)


Output Example

<?xml version="1.0"?>
<results>
  <DOWNTIME ID="12251" PRIMARY_KEY="90753G0" CLASSIFICATION="SCHEDULED">
  <PRIMARY_KEY>90753G0</PRIMARY_KEY>     
  <HOSTNAME>goc.egi.eu</HOSTNAME>
  <SERVICE_TYPE>egi.GOCDB</SERVICE_TYPE>
  <ENDPOINT>goc.egi.euegi.GOCDB</ENDPOINT>   <!-- Legacy, should be renamed to <SERVICE> -->
  <HOSTED_BY>GRIDOPS-GOCDB</HOSTED_BY>   <!-- Parent Site -->
  <GOCDB_PORTAL_URL>https://goc.egi.eu/portal/index.php?Page_Type=Downtimeid=12251</GOCDB_PORTAL_URL>    
  <SEVERITY>OUTAGE</SEVERITY>
  <DESCRIPTION>Oracle DB server upgrade</DESCRIPTION>
  <INSERT_DATE>1384162347</INSERT_DATE>
  <START_DATE>1384336800</START_DATE>
  <END_DATE>1384340400</END_DATE>
  <FORMATED_START_DATE>2013-11-13 10:00</FORMATED_START_DATE>
  <FORMATED_END_DATE>2013-11-13 11:00</FORMATED_END_DATE></DOWNTIME>
</results>

Back to GOCDB technical Documentation main page