GOCDB Programmatic Interface - Read
Method: get_downtime_nested_services
Entry point
/gocdbpi/public/?method=get_downtime_nested_services&ongoing_only=yes
Description |
Protection Level |
Returns a list of service downtimes with affected services nested as children of the downtime. |
Public (level 1) |
Parameters |
Effect |
Format/Value(s) |
Default |
Example |
topentity |
Limit results to downtimes below given entity |
any NGI (ROC), country, site name or node hostname |
none |
?method=get_downtime&topentity=RAL-LCG2 |
ongoing_only |
Limit results to current ongoing downtimes |
yes or no |
no |
?method=get_downtime&ongoing_only=yes |
startdate |
Limit results to downtimes that start after specified date |
date in YYYY-MM-DD format |
none |
?method=get_downtime&startdate=2021-12-08 |
enddate |
Limit results to downtimes that end before specified date |
date in YYYY-MM-DD format |
none |
?method=get_downtime&enddate=2021-12-14 |
windowstart /windowend |
Limit results to downtimes that cross into the time window (includes downtimes that start before or end after window) |
dates in YYYY-MM-DD format |
none |
?method=get_downtime&windowstart=2021-12-08&windowend=2021-12-15 |
scope |
Show only sites with the requested scope tags |
A comma separated list of scope-tag values or an empty value to return all scopes, i.e. &scope= |
instance dependant |
?method=get_site&scope=Local |
scope_match |
Match all or any of the specified scope-tags |
all or any |
all |
?method=get_site&scope=Local,EGI&scope_match=any |
site_extensions |
Limit results by one or many key value pairs |
See Extensions Mechanism |
none |
?method=get_site&site_extensions=(KeyName=KeyValue) |
service_extensions |
Limit results by one or many key value pairs |
See Extensions Mechanism |
none |
?method=get_site&service_extensions=(KeyName=KeyValue) |
Paging
This method optionally supports paging, to iterate over all results,
see here for info.
Example Output
<?xml version="1.0" encoding="UTF-8"?>
<results>
<DOWNTIME ID="32578" PRIMARY_KEY="113653G0" CLASSIFICATION="SCHEDULED">
<SEVERITY>WARNING</SEVERITY>
<DESCRIPTION>The service will be at risk</DESCRIPTION>
<INSERT_DATE>1656137042</INSERT_DATE>
<START_DATE>1656288000</START_DATE>
<END_DATE>1688169600</END_DATE>
<FORMATED_START_DATE>2022-06-27 00:00</FORMATED_START_DATE>
<FORMATED_END_DATE>2023-07-01 00:00</FORMATED_END_DATE>
<GOCDB_PORTAL_URL>/index.php?Page_Type=Downtime&id=32578</GOCDB_PORTAL_URL>
<SERVICES>
<SERVICE>
<PRIMARY_KEY>119G0</PRIMARY_KEY>
<HOSTNAME>bdii.ipb.ac.rs</HOSTNAME>
<SERVICE_TYPE>Top-BDII</SERVICE_TYPE>
<ENDPOINT>gocdb.bdii.ipb.ac.rs</ENDPOINT>
<HOSTED_BY>Izola MRF</HOSTED_BY>
<AFFECTED_ENDPOINTS/>
</SERVICE>
<SERVICE>
<PRIMARY_KEY>119G0</PRIMARY_KEY>
<HOSTNAME>voms.ipb.ac.rs</HOSTNAME>
<SERVICE_TYPE>VOMS</SERVICE_TYPE>
<ENDPOINT>gocdb.voms.ipb.ac.rs</ENDPOINT>
<HOSTED_BY>Izola MRF</HOSTED_BY>
<AFFECTED_ENDPOINTS/>
</SERVICE>
</SERVICES>
</DOWNTIME>
</results>