GOCDB/PI/get downtime nested services method

From EGIWiki
< GOCDB‎ | PI
Revision as of 14:21, 16 December 2016 by Davidm (talk | contribs) (parameters)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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_nested_services

Description Returns a list of service downtimes with affected services nested as children of the downtime.
Protection Level Public (level 1)

Entry point

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

parameters

parameter effect format/value(s) default examples
topentity Limit results to downtimes below given entity any NGI (ROC), country, sitename or node hostname EGEE ?method=get_downtime_nested_services&topentity=SouthEasternEurope

 ?method=get_downtime_nested_services&topentity=Portugal

 ?method=get_downtime_nested_services&topentity=RAL-LCG2

 ?method=get_downtime_nested_services&topentity=ce.mysite.com
ongoing_only Limit results to current ongoing downtimes yes/no no ?method=get_downtime_nested_services&ongoing_only=yes
startdate Limit results to downtimes that start after specified date date in YYYY-MM-DD format 1970-01-01 ?method=get_downtime_nested_services&startdate=2008-12-08
enddate limit results to downtimes that end before specified date date in YYYY-MM-DD format 2024-12-31 ?method=get_downtime_nested_services&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)
dates in YYYY-MM-DD format 1970-01-01/2024-12-31 ?method=get_downtime_nested_services&windowstart=2008-12-08&windowend=2008-12-15
scope Show only sites with the requested scope-tags - a list of currently supported scope tags can be found here A comma separated list of scope-tag values or an empty value to return all scopes, i.e. '&scope=' EGI  ?method=get_downtime_nested_services&scope=Local
scope_match Match 'all' or 'any' of the specified scope-tags 'all' or 'any' all  ?method=get_downtime_nested_services&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_nested_services&site_extensions=(KeyNameOfSiteExtProp=KeyValue)
service_extensions Limits downtime results by the key pairs of the affected services See Extensions Mechanism none  ?method=get_downtime_nested_services&service_extensions=(KeyNameOfServExtProp=KeyValue)
Docs for cursor params coming soon. Limit results and use cursor paging to iterate over all results See here for info


Output Example

<results>
    <DOWNTIME ID="15853" PRIMARY_KEY="94375G0" CLASSIFICATION="UNSCHEDULED">
        <SEVERITY>WARNING</SEVERITY>
        <DESCRIPTION>test</DESCRIPTION>
        <INSERT_DATE>1422358770</INSERT_DATE>
        <START_DATE>1422358680</START_DATE>
        <END_DATE>1422362280</END_DATE>
        <FORMATED_START_DATE>2015-01-27 11:38</FORMATED_START_DATE>
        <FORMATED_END_DATE>2015-01-27 12:38</FORMATED_END_DATE>
        <GOCDB_PORTAL_URL>
            https://localhost/portal/index.php?Page_Type=Downtime amp; id=15853
        </GOCDB_PORTAL_URL>
        <SERVICES>
            <SERVICE>
                <PRIMARY_KEY>4180G0</PRIMARY_KEY>
                <HOSTNAME>goc.egi.eu</HOSTNAME>
                <SERVICE_TYPE>egi.GOCDB</SERVICE_TYPE>
                <ENDPOINT>goc.egi.euegi.GOCDB</ENDPOINT>
                <HOSTED_BY>GRIDOPS-GOCDB</HOSTED_BY>
                <AFFECTED_ENDPOINTS>
                    <ENDPOINT>
                        <ID>6246</ID>
                        <NAME>Portal endpoint</NAME>
                        <URL>https://gocdb-test.esc.rl.ac.uk/portal</URL>
                        <INTERFACENAME>egi.GOCDB</INTERFACENAME>
                    </ENDPOINT>
                    <ENDPOINT>
                        <ID>6247</ID>
                        <NAME>PI endpoint</NAME>
                        <URL>https://gocdb-test.esc.rl.ac.uk/gocdbpi</URL>
                        <INTERFACENAME>egi.GOCDB</INTERFACENAME>
                    </ENDPOINT>
                </AFFECTED_ENDPOINTS>
            </SERVICE>
        </SERVICES>
    </DOWNTIME>
</results>

Back to GOCDB technical Documentation main page