Difference between revisions of "GOCDB/PI/get site method"
(→parameters) |
(→Output Example) |
||
(11 intermediate revisions by 3 users not shown) | |||
Line 14: | Line 14: | ||
=== Entry point === | === Entry point === | ||
− | * https://goc.egi.eu/gocdbpi/ | + | * https://goc.egi.eu/gocdbpi/public/?method=get_site |
* https://goc.egi.eu/gocdbpi_v4/private/?method=get_site (alias) | * https://goc.egi.eu/gocdbpi_v4/private/?method=get_site (alias) | ||
Line 64: | Line 64: | ||
|- | |- | ||
| scope | | scope | ||
− | | Show only sites with the requested scope-tags | + | | Show only sites with the requested scope-tags - a list of currently supported scope tags can be found [https://goc.egi.eu/portal/index.php?Page_Type=Scope_Help here] |
| A comma separated list of scope-tag values or an empty value to return all scopes, i.e. '&scope=' | | A comma separated list of scope-tag values or an empty value to return all scopes, i.e. '&scope=' | ||
| EGI | | EGI | ||
Line 80: | Line 80: | ||
| none | | none | ||
| ?method=get_site&extensions=(KeyName=KeyValue) | | ?method=get_site&extensions=(KeyName=KeyValue) | ||
+ | |- | ||
+ | | Docs for cursor params coming soon. | ||
+ | | Limit results and use cursor paging to iterate over all results | ||
+ | | [https://wiki.egi.eu/wiki/GOCDB/notifications#Optional_Cursor_Paging_on_Read_API See here for info] | ||
+ | | | ||
+ | | | ||
|- | |- | ||
|} | |} | ||
Line 90: | Line 96: | ||
=== Output Example === | === Output Example === | ||
− | + | <Source lang="XML"> | |
− | + | <?xml version="1.0" encoding="UTF-8"?> | |
− | + | <results> | |
− | <SITE ID=" | + | <SITE ID="335" PRIMARY_KEY="123G0" NAME="GRIDOPS-GOCDB"> |
− | + | <PRIMARY_KEY>123G0</PRIMARY_KEY> | |
− | + | <SHORT_NAME>GRIDOPS-GOCDB</SHORT_NAME> | |
− | + | <OFFICIAL_NAME>Grid Operations Center Database Portal and Web Services</OFFICIAL_NAME> | |
− | < | + | <SITE_DESCRIPTION>The GOCDB (v 5.5) stores Grid topology and resource information for EGI including sites, services, downtimes and contact information.</SITE_DESCRIPTION> |
− | + | <GOCDB_PORTAL_URL>https://goc.egi.eu/portal/index.php?Page_Type=Site&id=335</GOCDB_PORTAL_URL> | |
− | + | <HOME_URL>https://goc.egi.eu</HOME_URL> | |
− | + | <CONTACT_EMAIL>gocdb-admins@mailman.egi.eu</CONTACT_EMAIL> | |
− | + | <CONTACT_TEL>+44 01925 603762, +44 01235 44 5010</CONTACT_TEL> | |
− | + | <COUNTRY_CODE>GB</COUNTRY_CODE> | |
− | + | <COUNTRY>United Kingdom</COUNTRY> | |
− | + | <ROC>EGI.eu</ROC> | |
− | + | <PRODUCTION_INFRASTRUCTURE>Production</PRODUCTION_INFRASTRUCTURE> | |
− | + | <CERTIFICATION_STATUS>Certified</CERTIFICATION_STATUS> | |
− | + | <TIMEZONE>Europe/London</TIMEZONE> | |
− | + | <CSIRT_EMAIL>gocdb-admins@mailman.egi.eu</CSIRT_EMAIL> | |
− | + | <NOTIFICATIONS>FALSE</NOTIFICATIONS> | |
− | + | <DOMAIN> | |
− | + | <DOMAIN_NAME>goc.egi.eu</DOMAIN_NAME> | |
− | + | </DOMAIN> | |
− | + | <SITE_IP>0.0.0.0/255.255.255.254</SITE_IP> | |
− | + | <SCOPES> | |
− | + | <SCOPE>EGI</SCOPE> | |
− | + | </SCOPES> | |
− | + | <EXTENSIONS> | |
− | + | <EXTENSION> | |
− | + | <LOCAL_ID>371</LOCAL_ID> | |
+ | <KEY>P4U_Pilot_Storage_Use_Cloud</KEY> | ||
+ | <VALUE>1</VALUE> | ||
+ | </EXTENSION> | ||
+ | </EXTENSIONS> | ||
</SITE> | </SITE> | ||
− | + | </results> | |
+ | </Source> | ||
[[GOCDB/PI/Technical_Documentation|Back to GOCDB technical Documentation main page]] | [[GOCDB/PI/Technical_Documentation|Back to GOCDB technical Documentation main page]] |
Latest revision as of 15:32, 27 October 2017
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_site - GOCDB4
Description | Returns site information including contacts, grouped by site |
Protection Level | Protected (level 2) |
Entry point
- https://goc.egi.eu/gocdbpi/public/?method=get_site
- https://goc.egi.eu/gocdbpi_v4/private/?method=get_site (alias)
parameters
parameter | effect | format/value(s) | default | example |
---|---|---|---|---|
sitename | Only return infos for site with specified site name | any sitename | all | ?method=get_site&sitename=RAL-LCG2 |
roc (ngi) | Limit results to sites belonging to given NGI | any NGI name | all | ?method=get_site&roc=NGI_DE |
country | Limit results to sites belonging to given country | any country | all | ?method=get_site&country=Poland |
certification_status | Limit results to sites with given certification status | one of "Candidate", "Uncertified", "Certified", "Closed", Suspended" | all | ?method=get_site&certification_status=Certified |
exclude_certification_status | Exclude from results sites with given certification status | one of "Candidate", "Uncertified", "Certified", "Closed", Suspended" | none | ?method=get_site&exclude_certification_status=Closed |
production_status | Limit results to sites within given production infrastructure | one of "Production", "Test" |
all | ?method=get_site&production_status=Production |
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_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 |
extensions | Limit results by one or many key value pairs | See Extensions Mechanism | none | ?method=get_site&extensions=(KeyName=KeyValue) |
Docs for cursor params coming soon. | Limit results and use cursor paging to iterate over all results | See here for info |
Output Example
<?xml version="1.0" encoding="UTF-8"?>
<results>
<SITE ID="335" PRIMARY_KEY="123G0" NAME="GRIDOPS-GOCDB">
<PRIMARY_KEY>123G0</PRIMARY_KEY>
<SHORT_NAME>GRIDOPS-GOCDB</SHORT_NAME>
<OFFICIAL_NAME>Grid Operations Center Database Portal and Web Services</OFFICIAL_NAME>
<SITE_DESCRIPTION>The GOCDB (v 5.5) stores Grid topology and resource information for EGI including sites, services, downtimes and contact information.</SITE_DESCRIPTION>
<GOCDB_PORTAL_URL>https://goc.egi.eu/portal/index.php?Page_Type=Site&id=335</GOCDB_PORTAL_URL>
<HOME_URL>https://goc.egi.eu</HOME_URL>
<CONTACT_EMAIL>gocdb-admins@mailman.egi.eu</CONTACT_EMAIL>
<CONTACT_TEL>+44 01925 603762, +44 01235 44 5010</CONTACT_TEL>
<COUNTRY_CODE>GB</COUNTRY_CODE>
<COUNTRY>United Kingdom</COUNTRY>
<ROC>EGI.eu</ROC>
<PRODUCTION_INFRASTRUCTURE>Production</PRODUCTION_INFRASTRUCTURE>
<CERTIFICATION_STATUS>Certified</CERTIFICATION_STATUS>
<TIMEZONE>Europe/London</TIMEZONE>
<CSIRT_EMAIL>gocdb-admins@mailman.egi.eu</CSIRT_EMAIL>
<NOTIFICATIONS>FALSE</NOTIFICATIONS>
<DOMAIN>
<DOMAIN_NAME>goc.egi.eu</DOMAIN_NAME>
</DOMAIN>
<SITE_IP>0.0.0.0/255.255.255.254</SITE_IP>
<SCOPES>
<SCOPE>EGI</SCOPE>
</SCOPES>
<EXTENSIONS>
<EXTENSION>
<LOCAL_ID>371</LOCAL_ID>
<KEY>P4U_Pilot_Storage_Use_Cloud</KEY>
<VALUE>1</VALUE>
</EXTENSION>
</EXTENSIONS>
</SITE>
</results>