forked from docs/doc-exports
weihongmin1
46d24ba358
Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com> Co-authored-by: weihongmin1 <weihongmin1@huawei.com> Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
204 lines
17 KiB
HTML
204 lines
17 KiB
HTML
<a name="en-us_topic_0057845613"></a><a name="en-us_topic_0057845613"></a>
|
|
|
|
<h1 class="topictitle1">Querying Information About Keystone API Version 3.0</h1>
|
|
<div id="body1492670576040"><div class="section" id="en-us_topic_0057845613__s412c1f69bf89493b84b4b241cdbc9008"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0057845613__p033455112235">This API is used to obtain the information about the keystone API version 3.0.</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845613__s06d21799b5ee48a4ae4757ef4e69b001"><h4 class="sectiontitle">URI</h4><p id="en-us_topic_0057845613__p21865108171854">GET /v3</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845613__sf38a0d89d61e455da87f7b6d64ae5205"><h4 class="sectiontitle">Request Parameters</h4><div class="p" id="en-us_topic_0057845613__p127208784113">Example request<pre class="screen" id="en-us_topic_0057845613__sfb4d4ef6c1fa406094498686e2b4b119"><em id="en-us_topic_0057845613__i19778463362">curl -i -k -X GET https://sample.domain.com/v3</em></pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845613__sadb04a35c9184f34bb7d75b534f88786"><h4 class="sectiontitle">Response Parameters</h4><ul id="en-us_topic_0057845613__u345d2b77b40d466ca9eeb8a61f96f3dc"><li id="en-us_topic_0057845613__l991625f2a56b466bbb217d9300b5cb28">Response parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845613__en-us_topic_0035543752_table44962972" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845613__en-us_topic_0035543752_row49143529"><th align="left" class="cellrowborder" valign="top" width="21.740000000000002%" id="mcps1.3.4.2.1.1.1.5.1.1"><p id="en-us_topic_0057845613__en-us_topic_0035543752_p21202951"><strong id="en-us_topic_0057845613__a3da1b7475f644c07832655d87318eb65">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="22.63%" id="mcps1.3.4.2.1.1.1.5.1.2"><p id="en-us_topic_0057845613__p1700142751918"><strong id="en-us_topic_0057845613__a105e6ed8c3de4c5a9dde97ae5a71071e_1">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.990000000000002%" id="mcps1.3.4.2.1.1.1.5.1.3"><p id="en-us_topic_0057845613__en-us_topic_0035543752_p39717481"><strong id="en-us_topic_0057845613__a66412fa2bf144bc593958cf112b933d9">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="34.64%" id="mcps1.3.4.2.1.1.1.5.1.4"><p id="en-us_topic_0057845613__en-us_topic_0035543752_p62999416"><strong id="en-us_topic_0057845613__b1734705850163452">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845613__en-us_topic_0035543752_row2679067"><td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="en-us_topic_0057845613__aab1cc638a9a04361a245043d6ac69434"><a href="#en-us_topic_0057845613__li1228655117364">version</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.63%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="en-us_topic_0057845613__p97001527171917">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.990000000000002%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="en-us_topic_0057845613__a2e9403dd87bf457bbe82812db9edf434">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.64%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="en-us_topic_0057845613__adda3be2c284f40228992db1aad71dcf9">Keystone API version information.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="en-us_topic_0057845613__li1228655117364"><a name="en-us_topic_0057845613__li1228655117364"></a><a name="li1228655117364"></a>version
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845613__t6a822d2f816d42978a87fb9bbef76205" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845613__r97d9ad0c317c452f8799bb5ab582ce92"><th align="left" class="cellrowborder" valign="top" width="21.947805219478052%" id="mcps1.3.4.2.2.1.1.5.1.1"><p id="en-us_topic_0057845613__aa2c0859a96fc41259e62450184740ed9"><strong id="en-us_topic_0057845613__b5159001792651">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="22.47775222477752%" id="mcps1.3.4.2.2.1.1.5.1.2"><p id="en-us_topic_0057845613__abcf3a01d1b5f455596b0c4516dab6421"><strong id="en-us_topic_0057845613__a105e6ed8c3de4c5a9dde97ae5a71071e_3">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.137886211378863%" id="mcps1.3.4.2.2.1.1.5.1.3"><p id="en-us_topic_0057845613__ac11daac4b7d34cf6a84917519cb813c8"><strong id="en-us_topic_0057845613__b5975632492651">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="34.43655634436556%" id="mcps1.3.4.2.2.1.1.5.1.4"><p id="en-us_topic_0057845613__a8adf734076064f95bbaa01dc82bb4a2b"><strong id="en-us_topic_0057845613__b842352706175949">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845613__rea6a18e3f80e400cadb8b7984898e1e9"><td class="cellrowborder" valign="top" width="21.947805219478052%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845613__ad3d464bc21484966bfc0c9bc85e90874">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.47775222477752%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845613__aa3373e1c45bf4e798ae5b423d1fb9768">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.137886211378863%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845613__a9bd260a7475d45ae856b6dbd50f19846">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.43655634436556%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845613__a050e1b3312254249b4e9bcbb24f4040e">Version status.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__ra2fb2e24530b45209d824d0579ea5d3d"><td class="cellrowborder" valign="top" width="21.947805219478052%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845613__a2bdcc7582de045c4908485d963435436">updated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.47775222477752%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845613__a3313a0741f2e434bafdd8b22e13bd3a1">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.137886211378863%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845613__ace409facb32243d8ac9933f731ceb9c6">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.43655634436556%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845613__a698229ec7d4c4b1c88d81ed8b6acd4a3">Last version update time.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__r53bd4f9cfb584d00854734ebe783093c"><td class="cellrowborder" valign="top" width="21.947805219478052%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845613__acfbcdab008954ce0995f8c476f962991"><a href="#en-us_topic_0057845613__li12591143218223">media-types</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.47775222477752%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845613__aea4ed6b668464c7f83b279405b5923b0">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.137886211378863%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845613__addb0823c3fb24ff7bed6a1a7db8f6284">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.43655634436556%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845613__a3fc3cf9365ff4620b15038b747aecd20">Version-supported message format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__r62a8026ae5c7476b9fba8e0df30dc6df"><td class="cellrowborder" valign="top" width="21.947805219478052%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845613__a09b07e17032b468d95057630a7621546">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.47775222477752%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845613__en-us_topic_0035543752_p386591205643">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.137886211378863%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845613__a77699d14b9eb4893b164cd433f38afac">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.43655634436556%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845613__aa4c7add4b1254e80b2885140a5bd375c">Version, for example, v3.0.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__rb39d64c1e7a845f59b98084fc32d29a7"><td class="cellrowborder" valign="top" width="21.947805219478052%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845613__abb45b631a9b54f1588da62006430d692"><a href="#en-us_topic_0057845613__li1673717194228">links</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.47775222477752%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845613__en-us_topic_0035543752_p372076171929">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.137886211378863%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845613__a5d5e0419bd5546e99543cb8faba19c67">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.43655634436556%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845613__aea5df04267f447d3a49335e8bb570ade">Version resource link.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="en-us_topic_0057845613__li1673717194228"><a name="en-us_topic_0057845613__li1673717194228"></a><a name="li1673717194228"></a>version.links
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845613__table213134952114" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845613__row2022249122114"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.3.1.1.4.1.1"><p id="en-us_topic_0057845613__p22294952117">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.3.1.1.4.1.2"><p id="en-us_topic_0057845613__p19221649142119">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.2.3.1.1.4.1.3"><p id="en-us_topic_0057845613__p323204902117">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845613__row1123749142116"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.3.1.1.4.1.1 "><p id="en-us_topic_0057845613__p142354918212">rel</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.3.1.1.4.1.2 "><p id="en-us_topic_0057845613__p12304920214">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.3.1.1.4.1.3 "><p id="en-us_topic_0057845613__p17231049132117">Link type. <strong id="en-us_topic_0057845613__b183310240296">self</strong>: A self link contains the versioned link to the resource. <strong id="en-us_topic_0057845613__b7156203717297">bookmark</strong>: A bookmark link provides a permanent link to a permanent resource. <strong id="en-us_topic_0057845613__b1235814016301">alternate</strong>: An alternate link contains an alternate representation of the resource.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__row3238497217"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.3.1.1.4.1.1 "><p id="en-us_topic_0057845613__p18231149152116">href</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.3.1.1.4.1.2 "><p id="en-us_topic_0057845613__p1023144942118">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.3.1.1.4.1.3 "><p id="en-us_topic_0057845613__p162394942113">Resource link.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="en-us_topic_0057845613__li12591143218223"><a name="en-us_topic_0057845613__li12591143218223"></a><a name="li12591143218223"></a>version.media-types
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845613__table131418491211" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845613__row1323134914219"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.4.1.1.4.1.1"><p id="en-us_topic_0057845613__p62316492219">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.4.1.1.4.1.2"><p id="en-us_topic_0057845613__p172394952116">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.2.4.1.1.4.1.3"><p id="en-us_topic_0057845613__p723049152111">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845613__row182374910217"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.4.1.1.4.1.1 "><p id="en-us_topic_0057845613__p18231649112110">type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.4.1.1.4.1.2 "><p id="en-us_topic_0057845613__p1723124910214">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.4.1.1.4.1.3 "><p id="en-us_topic_0057845613__p13231749142115">Media type.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__row823144992118"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.4.1.1.4.1.1 "><p id="en-us_topic_0057845613__p82374910212">base</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.4.1.1.4.1.2 "><p id="en-us_topic_0057845613__p10237496211">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.4.1.1.4.1.3 "><p id="en-us_topic_0057845613__p3233491217">Base type.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="en-us_topic_0057845613__li1552272218417">Example response (successful response)<pre class="screen" id="en-us_topic_0057845613__screen75221722124113">{
|
|
"version": {
|
|
"status": "stable",
|
|
"updated": "2016-04-04T00:00:00Z",
|
|
"media-types": [
|
|
{
|
|
"base": "application/json",
|
|
"type": "application/vnd.openstack.identity-v3+json"
|
|
}
|
|
],
|
|
"id": "v3.6",
|
|
"links": [
|
|
{
|
|
"href": "https://sample.domain.com/v3/",
|
|
"rel": "self"
|
|
}
|
|
]
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845613__sd26bdff9224841e48283adfdeeb0adba"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845613__en-us_topic_0035543752_table25927028" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845613__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_0057845613__en-us_topic_0035543752_p51565323"><strong id="en-us_topic_0057845613__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_0057845613__en-us_topic_0035543752_p16041657"><strong id="en-us_topic_0057845613__b556796192651">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845613__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_0057845613__en-us_topic_0035543752_p22613965">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845613__en-us_topic_0035543752_p19791876">The request is successful.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__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_0057845613__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_0057845613__en-us_topic_0035543752_p56751409">The server failed to process the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__re523b3dbf728422f859f70773c174c00"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845613__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_0057845613__a58bd559a77e240da82a8effff45ad230">The requested resource cannot be found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845613__r545c1109f47e4a49a658e4a8ddfc3341"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845613__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_0057845613__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>
|
|
|