doc-exports/docs/iam/api-ref/en-us_topic_0057845569.html
zhangyue 3b5a58b1fe IAM API 2.0.38
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2022-10-26 04:31:24 +00:00

165 lines
13 KiB
HTML

<a name="en-us_topic_0057845569"></a><a name="en-us_topic_0057845569"></a>
<h1 class="topictitle1">Querying Keystone API Version Information</h1>
<div id="body1492670576037"><div class="section" id="en-us_topic_0057845569__s412c1f69bf89493b84b4b241cdbc9008"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0057845569__p717084714236">This API is used to obtain the keystone API version information.</p>
</div>
<div class="section" id="en-us_topic_0057845569__s06d21799b5ee48a4ae4757ef4e69b001"><h4 class="sectiontitle">URI</h4><p id="en-us_topic_0057845569__en-us_topic_0035543752_p12138304">GET /</p>
</div>
<div class="section" id="en-us_topic_0057845569__sf38a0d89d61e455da87f7b6d64ae5205"><h4 class="sectiontitle">Request Parameters</h4><p id="en-us_topic_0057845569__p5355143511392">Example request</p>
<pre class="screen" id="en-us_topic_0057845569__sfb4d4ef6c1fa406094498686e2b4b119"><em id="en-us_topic_0057845569__i6101129143610">curl -i -k -X GET https://sample.domain.com</em>/</pre>
</div>
<div class="section" id="en-us_topic_0057845569__sadb04a35c9184f34bb7d75b534f88786"><h4 class="sectiontitle">Response Parameters</h4><ul id="en-us_topic_0057845569__u345d2b77b40d466ca9eeb8a61f96f3dc"><li id="en-us_topic_0057845569__l991625f2a56b466bbb217d9300b5cb28">Response parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845569__en-us_topic_0035543752_table44962972" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845569__en-us_topic_0035543752_row49143529"><th align="left" class="cellrowborder" valign="top" width="21.37%" id="mcps1.3.4.2.1.1.1.5.1.1"><p id="en-us_topic_0057845569__en-us_topic_0035543752_p21202951"><strong id="en-us_topic_0057845569__a3da1b7475f644c07832655d87318eb65">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.72%" id="mcps1.3.4.2.1.1.1.5.1.2"><p id="en-us_topic_0057845569__p182801948151816"><strong id="en-us_topic_0057845569__a105e6ed8c3de4c5a9dde97ae5a71071e_1">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.12%" id="mcps1.3.4.2.1.1.1.5.1.3"><p id="en-us_topic_0057845569__en-us_topic_0035543752_p39717481"><strong id="en-us_topic_0057845569__a66412fa2bf144bc593958cf112b933d9">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="39.79%" id="mcps1.3.4.2.1.1.1.5.1.4"><p id="en-us_topic_0057845569__en-us_topic_0035543752_p62999416"><strong id="en-us_topic_0057845569__b182280254616312">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0057845569__en-us_topic_0035543752_row2679067"><td class="cellrowborder" valign="top" width="21.37%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="en-us_topic_0057845569__aab1cc638a9a04361a245043d6ac69434">versions</p>
</td>
<td class="cellrowborder" valign="top" width="19.72%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="en-us_topic_0057845569__p182801148201814">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.12%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="en-us_topic_0057845569__a2e9403dd87bf457bbe82812db9edf434">Object</p>
</td>
<td class="cellrowborder" valign="top" width="39.79%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="en-us_topic_0057845569__adda3be2c284f40228992db1aad71dcf9">Keystone API version information.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__row27104428164444"><td class="cellrowborder" valign="top" width="21.37%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="en-us_topic_0057845569__p47975060164444">values</p>
</td>
<td class="cellrowborder" valign="top" width="19.72%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="en-us_topic_0057845569__p1528013484185">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.12%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="en-us_topic_0057845569__p60774665164444">Array</p>
</td>
<td class="cellrowborder" valign="top" width="39.79%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="en-us_topic_0057845569__p23800818164444">Keystone API version list.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="en-us_topic_0057845569__li554151518364">Description for the values format
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845569__t6a822d2f816d42978a87fb9bbef76205" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845569__r97d9ad0c317c452f8799bb5ab582ce92"><th align="left" class="cellrowborder" valign="top" width="21.28%" id="mcps1.3.4.2.2.1.1.5.1.1"><p id="en-us_topic_0057845569__aa2c0859a96fc41259e62450184740ed9"><strong id="en-us_topic_0057845569__b295749595246">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.090000000000003%" id="mcps1.3.4.2.2.1.1.5.1.2"><p id="en-us_topic_0057845569__abcf3a01d1b5f455596b0c4516dab6421"><strong id="en-us_topic_0057845569__a105e6ed8c3de4c5a9dde97ae5a71071e_3">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.01%" id="mcps1.3.4.2.2.1.1.5.1.3"><p id="en-us_topic_0057845569__ac11daac4b7d34cf6a84917519cb813c8"><strong id="en-us_topic_0057845569__b4477217395246">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="39.620000000000005%" id="mcps1.3.4.2.2.1.1.5.1.4"><p id="en-us_topic_0057845569__a8adf734076064f95bbaa01dc82bb4a2b"><strong id="en-us_topic_0057845569__b842352706175949">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0057845569__rea6a18e3f80e400cadb8b7984898e1e9"><td class="cellrowborder" valign="top" width="21.28%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845569__ad3d464bc21484966bfc0c9bc85e90874">status</p>
</td>
<td class="cellrowborder" valign="top" width="20.090000000000003%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845569__aa3373e1c45bf4e798ae5b423d1fb9768">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.01%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845569__a9bd260a7475d45ae856b6dbd50f19846">String</p>
</td>
<td class="cellrowborder" valign="top" width="39.620000000000005%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845569__a050e1b3312254249b4e9bcbb24f4040e">Version status.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__ra2fb2e24530b45209d824d0579ea5d3d"><td class="cellrowborder" valign="top" width="21.28%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845569__a2bdcc7582de045c4908485d963435436">updated</p>
</td>
<td class="cellrowborder" valign="top" width="20.090000000000003%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845569__a3313a0741f2e434bafdd8b22e13bd3a1">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.01%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845569__ace409facb32243d8ac9933f731ceb9c6">String</p>
</td>
<td class="cellrowborder" valign="top" width="39.620000000000005%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845569__a698229ec7d4c4b1c88d81ed8b6acd4a3">Last version update time.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__r53bd4f9cfb584d00854734ebe783093c"><td class="cellrowborder" valign="top" width="21.28%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845569__acfbcdab008954ce0995f8c476f962991">media-types</p>
</td>
<td class="cellrowborder" valign="top" width="20.090000000000003%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845569__aea4ed6b668464c7f83b279405b5923b0">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.01%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845569__addb0823c3fb24ff7bed6a1a7db8f6284">Array</p>
</td>
<td class="cellrowborder" valign="top" width="39.620000000000005%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845569__a3fc3cf9365ff4620b15038b747aecd20">Version-supported message format.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__r62a8026ae5c7476b9fba8e0df30dc6df"><td class="cellrowborder" valign="top" width="21.28%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845569__a09b07e17032b468d95057630a7621546">id</p>
</td>
<td class="cellrowborder" valign="top" width="20.090000000000003%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845569__en-us_topic_0035543752_p386591205643">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.01%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845569__a77699d14b9eb4893b164cd433f38afac">String</p>
</td>
<td class="cellrowborder" valign="top" width="39.620000000000005%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845569__aa4c7add4b1254e80b2885140a5bd375c">Version, for example, v3.0.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__rb39d64c1e7a845f59b98084fc32d29a7"><td class="cellrowborder" valign="top" width="21.28%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845569__abb45b631a9b54f1588da62006430d692">links</p>
</td>
<td class="cellrowborder" valign="top" width="20.090000000000003%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845569__en-us_topic_0035543752_p372076171929">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.01%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845569__a5d5e0419bd5546e99543cb8faba19c67">Array</p>
</td>
<td class="cellrowborder" valign="top" width="39.620000000000005%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845569__aea5df04267f447d3a49335e8bb570ade">Version resource link.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="en-us_topic_0057845569__li88444488398">Example response (successful response)<pre class="screen" id="en-us_topic_0057845569__screen432067164351">{
"versions": {
"values": [
{
"media-types": [
{
"type": "application/vnd.openstack.identity-v3+json",
"base": "application/json"
}
],
"links": [
{
"rel": "self",
"href": "https://<em id="en-us_topic_0057845569__i12295122017437">sample.domain.com</em>/v3/"
}
],
"id": "v3.6",
"updated": "2016-04-04T00:00:00Z",
"status": "stable"
}
]
}
}</pre>
</li></ul>
</div>
<div class="section" id="en-us_topic_0057845569__sd26bdff9224841e48283adfdeeb0adba"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845569__en-us_topic_0035543752_table25927028" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845569__en-us_topic_0035543752_row10578662"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.1"><p id="en-us_topic_0057845569__en-us_topic_0035543752_p51565323"><strong id="en-us_topic_0057845569__b842352706104328">Status Code</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.2"><p id="en-us_topic_0057845569__en-us_topic_0035543752_p16041657"><strong id="en-us_topic_0057845569__b5558521095246">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0057845569__en-us_topic_0035543752_row24305815"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845569__en-us_topic_0035543752_p22613965">300</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845569__en-us_topic_0035543752_p19791876">The request is successful.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__en-us_topic_0035543752_row43909159"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845569__en-us_topic_0035543752_p66980994">400</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845569__en-us_topic_0035543752_p56751409">The server failed to process the request.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__re523b3dbf728422f859f70773c174c00"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845569__a69d32f6ad2694b59b8a57e3712a06f1b">404</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845569__a58bd559a77e240da82a8effff45ad230">The requested resource cannot be found.</p>
</td>
</tr>
<tr id="en-us_topic_0057845569__r545c1109f47e4a49a658e4a8ddfc3341"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845569__a1820de5ea0b043adb69e91c408f9e987">503</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845569__a9e57dfbc46874219ac1dc154eb013fdf">Service unavailable.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0057845631.html">Version Information Management</a></div>
</div>
</div>