The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @ egi.eu.
Difference between revisions of "GOCDB/PI/get downtime method"
Jump to navigation
Jump to search
m (→parameters) |
|||
| Line 29: | Line 29: | ||
| 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 | | 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 | ||
|- valign="top" | |- valign="top" | ||
| windowstart/windowend || limit results to downtimes that cross the time window (includes downtimes | | windowstart/windowend || limit results to downtimes that cross into the time window (includes downtimes <br> that start before or end after window) || date in YYY-MM-DD format || 1970-01-01/2024-12-31 || ?method=get_downtime&windowstart=2008-12-08&windowend=2008-12-15 | ||
|- | |- | ||
| scope | | scope | ||
Revision as of 12:42, 4 November 2014
| 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 downtimes that cross into the time window (includes downtimes that start before or end after window) |
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 |
| site_extensions | Limits downtime results by the key pairs of the affected site | See Extensions Mechanism | none | ?method=get_downtime&site_extensions=(KeyName=KeyValue) |
| service_extensions | Limits downtime results by the key pairs of the affected services | See Extensions Mechanism | none | ?method=get_downtime&service_extensions=(KeyName=KeyValue) |
| page | Limits the number of returned results to the page limit (1000) | Postive integer (increment and re-issue query for next page of results) | none | ?method=get_downtime&page=1 |
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>