doc-exports/docs/ims/api-ref/en-us_topic_0020091556.html
Zaoxu, Li fdf6843d7a ims_api1226
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com>
Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
2024-01-11 14:47:14 +00:00

577 lines
35 KiB
HTML

<a name="EN-US_TOPIC_0020091556"></a><a name="EN-US_TOPIC_0020091556"></a>
<h1 class="topictitle1">Querying an Image List Schema (Native OpenStack API)</h1>
<div id="body42007851"><div class="section" id="EN-US_TOPIC_0020091556__section29906272"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0020091556__p47192740">This API is used to query an image list schema, which allows you to know details about and the data structure of the image list.</p>
</div>
<div class="section" id="EN-US_TOPIC_0020091556__section720995"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0020091556__p66760059111743">GET /v2/schemas/images</p>
</div>
<div class="section" id="EN-US_TOPIC_0020091556__section6488958"><h4 class="sectiontitle">Request</h4><p id="EN-US_TOPIC_0020091556__p9349154718525">Request parameters</p>
<p id="EN-US_TOPIC_0020091556__p232053453512">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0020091556__section1034265218413"><h4 class="sectiontitle">Example Request</h4><p id="EN-US_TOPIC_0020091556__p10585104213521">Querying an image list schema</p>
<pre class="screen" id="EN-US_TOPIC_0020091556__screen182263557412">GET https://{Endpoint}/v2/schemas/images</pre>
</div>
<div class="section" id="EN-US_TOPIC_0020091556__section58400626"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0020091556__ul10123156162755"><li id="EN-US_TOPIC_0020091556__li3051031511442">Response parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020091556__table4863803311445" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0020091556__row3629282211445"><th align="left" class="cellrowborder" valign="top" width="31.540000000000003%" id="mcps1.3.5.2.1.1.1.4.1.1"><p id="EN-US_TOPIC_0020091556__p5403745111445">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23.02%" id="mcps1.3.5.2.1.1.1.4.1.2"><p id="EN-US_TOPIC_0020091556__p5399240419951">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.440000000000005%" id="mcps1.3.5.2.1.1.1.4.1.3"><p id="EN-US_TOPIC_0020091556__p1495742511445">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0020091556__row3527303211445"><td class="cellrowborder" valign="top" width="31.540000000000003%" headers="mcps1.3.5.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0020091556__p3854335911445">name</p>
</td>
<td class="cellrowborder" valign="top" width="23.02%" headers="mcps1.3.5.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0020091556__p4358420519951">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.440000000000005%" headers="mcps1.3.5.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0020091556__p3500440311445">Specifies the schema name.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row4660417511445"><td class="cellrowborder" valign="top" width="31.540000000000003%" headers="mcps1.3.5.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0020091556__p1684183211445">links</p>
</td>
<td class="cellrowborder" valign="top" width="23.02%" headers="mcps1.3.5.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0020091556__p4065973219951">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="45.440000000000005%" headers="mcps1.3.5.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0020091556__p2201118611445">Specifies the URL for accessing the schema.</p>
<p id="EN-US_TOPIC_0020091556__p123432895413">For details, see <a href="#EN-US_TOPIC_0020091556__table15641103183416">Table 1</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row6388295311445"><td class="cellrowborder" valign="top" width="31.540000000000003%" headers="mcps1.3.5.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0020091556__p713670311445">properties</p>
</td>
<td class="cellrowborder" valign="top" width="23.02%" headers="mcps1.3.5.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0020091556__p510402419951">Object</p>
</td>
<td class="cellrowborder" valign="top" width="45.440000000000005%" headers="mcps1.3.5.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0020091556__p8616104025420">Describes basic image attributes, including the type and usage of each attribute.</p>
<p id="EN-US_TOPIC_0020091556__p4120204111445">For details about the parameters, see <a href="en-us_topic_0020091562.html">Image Attributes</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0020091556__table15641103183416"></a><a name="table15641103183416"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020091556__table15641103183416" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Data structure description of the links field</caption><thead align="left"><tr id="EN-US_TOPIC_0020091556__row136411132345"><th align="left" class="cellrowborder" valign="top" width="30.646935306469352%" id="mcps1.3.5.2.1.2.2.4.1.1"><p id="EN-US_TOPIC_0020091556__p136411433347">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.127587241275872%" id="mcps1.3.5.2.1.2.2.4.1.2"><p id="EN-US_TOPIC_0020091556__p12641193183412">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.22547745225477%" id="mcps1.3.5.2.1.2.2.4.1.3"><p id="EN-US_TOPIC_0020091556__p164120311348">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0020091556__row4641634345"><td class="cellrowborder" valign="top" width="30.646935306469352%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0020091556__p126411432347">href</p>
</td>
<td class="cellrowborder" valign="top" width="24.127587241275872%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0020091556__p1864133173419">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.22547745225477%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0020091556__p16411373420">Specifies the domain name.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row146411238348"><td class="cellrowborder" valign="top" width="30.646935306469352%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="EN-US_TOPIC_0020091556__p156421039346">rel</p>
</td>
<td class="cellrowborder" valign="top" width="24.127587241275872%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="EN-US_TOPIC_0020091556__p196421736343">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.22547745225477%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="EN-US_TOPIC_0020091556__p1164263163416">Specifies the domain name description.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0020091556__li7084168162755">Example response<pre class="codeblock" id="EN-US_TOPIC_0020091556__codeblock27264038214942">STATUS CODE 200</pre>
<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0020091556__screen3460783421492"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224</pre></div></td><td class="code"><div class="highlight"><pre><span></span><span class="p">{</span>
<span class="s">&quot;name&quot;</span><span class="p">:</span> <span class="s">&quot;images&quot;</span><span class="p">,</span>
<span class="s">&quot;links&quot;</span><span class="p">:</span> <span class="o">[</span>
<span class="p">{</span>
<span class="s">&quot;href&quot;</span><span class="p">:</span> <span class="s">&quot;{first}&quot;</span><span class="p">,</span>
<span class="s">&quot;rel&quot;</span><span class="p">:</span> <span class="s">&quot;first&quot;</span>
<span class="p">},</span>
<span class="p">{</span>
<span class="s">&quot;href&quot;</span><span class="p">:</span> <span class="s">&quot;{next}&quot;</span><span class="p">,</span>
<span class="s">&quot;rel&quot;</span><span class="p">:</span> <span class="s">&quot;next&quot;</span>
<span class="p">},</span>
<span class="p">{</span>
<span class="s">&quot;href&quot;</span><span class="p">:</span> <span class="s">&quot;{schema}&quot;</span><span class="p">,</span>
<span class="s">&quot;rel&quot;</span><span class="p">:</span> <span class="s">&quot;describedby&quot;</span>
<span class="p">}</span>
<span class="o">]</span><span class="p">,</span>
<span class="s">&quot;properties&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;images&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;items&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;additionalProperties&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;String&quot;</span>
<span class="p">},</span>
<span class="s">&quot;name&quot;</span><span class="p">:</span> <span class="s">&quot;image&quot;</span><span class="p">,</span>
<span class="s">&quot;links&quot;</span><span class="p">:</span> <span class="o">[</span>
<span class="p">{</span>
<span class="s">&quot;href&quot;</span><span class="p">:</span> <span class="s">&quot;{self}&quot;</span><span class="p">,</span>
<span class="s">&quot;rel&quot;</span><span class="p">:</span> <span class="s">&quot;self&quot;</span>
<span class="p">},</span>
<span class="p">{</span>
<span class="s">&quot;href&quot;</span><span class="p">:</span> <span class="s">&quot;{file}&quot;</span><span class="p">,</span>
<span class="s">&quot;rel&quot;</span><span class="p">:</span> <span class="s">&quot;enclosure&quot;</span>
<span class="p">},</span>
<span class="p">{</span>
<span class="s">&quot;href&quot;</span><span class="p">:</span> <span class="s">&quot;{schema}&quot;</span><span class="p">,</span>
<span class="s">&quot;rel&quot;</span><span class="p">:</span> <span class="s">&quot;describedby&quot;</span>
<span class="p">}</span>
<span class="o">]</span><span class="p">,</span>
<span class="s">&quot;properties&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;status&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;enum&quot;</span><span class="p">:</span> <span class="o">[</span>
<span class="s">&quot;queued&quot;</span><span class="p">,</span>
<span class="s">&quot;saving&quot;</span><span class="p">,</span>
<span class="s">&quot;active&quot;</span><span class="p">,</span>
<span class="s">&quot;killed&quot;</span><span class="p">,</span>
<span class="s">&quot;deleted&quot;</span><span class="p">,</span>
<span class="s">&quot;pending_delete&quot;</span>
<span class="o">]</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Status of the image (READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;tags&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;items&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;maxLength&quot;</span><span class="p">:</span> <span class="mi">255</span>
<span class="p">},</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;array&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;List of strings related to the image&quot;</span>
<span class="p">},</span>
<span class="s">&quot;kernel_id&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;pattern&quot;</span><span class="p">:</span> <span class="s">&quot;^([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}$&quot;</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;ID of image stored in Glance that should be used as the kernel when booting an AMI-style image.&quot;</span><span class="p">,</span>
<span class="s">&quot;is_base&quot;</span><span class="p">:</span> <span class="kc">false</span>
<span class="p">},</span>
<span class="s">&quot;container_format&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;enum&quot;</span><span class="p">:</span> <span class="o">[</span>
<span class="s">&quot;ami&quot;</span><span class="p">,</span>
<span class="s">&quot;ari&quot;</span><span class="p">,</span>
<span class="s">&quot;aki&quot;</span><span class="p">,</span>
<span class="s">&quot;bare&quot;</span><span class="p">,</span>
<span class="s">&quot;ovf&quot;</span><span class="p">,</span>
<span class="s">&quot;ova&quot;</span>
<span class="o">]</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Format of the container&quot;</span>
<span class="p">},</span>
<span class="s">&quot;min_ram&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;integer&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Amount of ram (in MB) required to boot image.&quot;</span>
<span class="p">},</span>
<span class="s">&quot;ramdisk_id&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;pattern&quot;</span><span class="p">:</span> <span class="s">&quot;^([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}$&quot;</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;ID of image stored in Glance that should be used as the ramdisk when booting an AMI-style image.&quot;</span><span class="p">,</span>
<span class="s">&quot;is_base&quot;</span><span class="p">:</span> <span class="kc">false</span>
<span class="p">},</span>
<span class="s">&quot;locations&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;items&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;required&quot;</span><span class="p">:</span> <span class="o">[</span>
<span class="s">&quot;url&quot;</span><span class="p">,</span>
<span class="s">&quot;metadata&quot;</span>
<span class="o">]</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;object&quot;</span><span class="p">,</span>
<span class="s">&quot;properties&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;url&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;maxLength&quot;</span><span class="p">:</span> <span class="mi">255</span>
<span class="p">},</span>
<span class="s">&quot;metadata&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;object&quot;</span>
<span class="p">}</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;array&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;A set of URLs to access the image file kept in external store&quot;</span>
<span class="p">},</span>
<span class="s">&quot;visibility&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;enum&quot;</span><span class="p">:</span> <span class="o">[</span>
<span class="s">&quot;public&quot;</span><span class="p">,</span>
<span class="s">&quot;private&quot;</span>
<span class="o">]</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Scope of image accessibility&quot;</span>
<span class="p">},</span>
<span class="s">&quot;updated_at&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Date and time of the last image modification (READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;owner&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Owner of the image&quot;</span><span class="p">,</span>
<span class="s">&quot;maxLength&quot;</span><span class="p">:</span> <span class="mi">255</span>
<span class="p">},</span>
<span class="s">&quot;file&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;(READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;min_disk&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;integer&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Amount of disk space (in GB) required to boot image.&quot;</span>
<span class="p">},</span>
<span class="s">&quot;virtual_size&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;integer&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Virtual size of image in bytes (READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;id&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;pattern&quot;</span><span class="p">:</span> <span class="s">&quot;^([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}$&quot;</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;An identifier for the image&quot;</span>
<span class="p">},</span>
<span class="s">&quot;size&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;integer&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Size of image file in bytes (READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;instance_uuid&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;ID of instance used to create this image.&quot;</span><span class="p">,</span>
<span class="s">&quot;is_base&quot;</span><span class="p">:</span> <span class="kc">false</span>
<span class="p">},</span>
<span class="s">&quot;os_distro&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Common name of operating system distribution as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html&quot;</span><span class="p">,</span>
<span class="s">&quot;is_base&quot;</span><span class="p">:</span> <span class="kc">false</span>
<span class="p">},</span>
<span class="s">&quot;name&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Descriptive name for the image&quot;</span><span class="p">,</span>
<span class="s">&quot;maxLength&quot;</span><span class="p">:</span> <span class="mi">255</span>
<span class="p">},</span>
<span class="s">&quot;checksum&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;md5 hash of image contents. (READ-ONLY)&quot;</span><span class="p">,</span>
<span class="s">&quot;maxLength&quot;</span><span class="p">:</span> <span class="mi">32</span>
<span class="p">},</span>
<span class="s">&quot;created_at&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Date and time of image registration (READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;disk_format&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;enum&quot;</span><span class="p">:</span> <span class="o">[</span>
<span class="s">&quot;ami&quot;</span><span class="p">,</span>
<span class="s">&quot;ari&quot;</span><span class="p">,</span>
<span class="s">&quot;aki&quot;</span><span class="p">,</span>
<span class="s">&quot;vhd&quot;</span><span class="p">,</span>
<span class="s">&quot;vmdk&quot;</span><span class="p">,</span>
<span class="s">&quot;raw&quot;</span><span class="p">,</span>
<span class="s">&quot;qcow2&quot;</span><span class="p">,</span>
<span class="s">&quot;vdi&quot;</span><span class="p">,</span>
<span class="s">&quot;iso&quot;</span>
<span class="o">]</span><span class="p">,</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Format of the disk&quot;</span>
<span class="p">},</span>
<span class="s">&quot;os_version&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Operating system version as specified by the distributor&quot;</span><span class="p">,</span>
<span class="s">&quot;is_base&quot;</span><span class="p">:</span> <span class="kc">false</span>
<span class="p">},</span>
<span class="s">&quot;protected&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;boolean&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;If true, image will not be deletable.&quot;</span>
<span class="p">},</span>
<span class="s">&quot;architecture&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;Operating system architecture as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html&quot;</span><span class="p">,</span>
<span class="s">&quot;is_base&quot;</span><span class="p">:</span> <span class="kc">false</span>
<span class="p">},</span>
<span class="s">&quot;direct_url&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;URL to access the image file kept in external store (READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;self&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;(READ-ONLY)&quot;</span>
<span class="p">},</span>
<span class="s">&quot;schema&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span><span class="p">,</span>
<span class="s">&quot;description&quot;</span><span class="p">:</span> <span class="s">&quot;(READ-ONLY)&quot;</span>
<span class="p">}</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;array&quot;</span>
<span class="p">},</span>
<span class="s">&quot;schema&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span>
<span class="p">},</span>
<span class="s">&quot;next&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span>
<span class="p">},</span>
<span class="s">&quot;first&quot;</span><span class="p">:</span> <span class="p">{</span>
<span class="s">&quot;type&quot;</span><span class="p">:</span> <span class="s">&quot;string&quot;</span>
<span class="p">}</span>
<span class="p">}</span>
<span class="p">}</span>
</pre></div>
</td></tr></table></div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0020091556__section55843593"><h4 class="sectiontitle">Returned Values</h4><ul id="EN-US_TOPIC_0020091556__ul12698356"><li id="EN-US_TOPIC_0020091556__li47176343">Normal<p id="EN-US_TOPIC_0020091556__p21933905"><a name="EN-US_TOPIC_0020091556__li47176343"></a><a name="li47176343"></a>200</p>
</li><li id="EN-US_TOPIC_0020091556__li63187419">Abnormal
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020091556__table512644917454" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0020091556__row5075107217454"><th align="left" class="cellrowborder" valign="top" width="46.54%" id="mcps1.3.6.2.2.1.1.3.1.1"><p id="EN-US_TOPIC_0020091556__p1719616917454">Returned Value</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53.459999999999994%" id="mcps1.3.6.2.2.1.1.3.1.2"><p id="EN-US_TOPIC_0020091556__p5071248317454">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0020091556__row1407048617454"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091556__p6596756117454">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091556__p4177219617454">Request error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row4040544817454"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091556__p5161589217454">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091556__p2013769117454">Authentication failed.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row4702149717454"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091556__p5064493517454">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091556__p859904517454">You do not have the rights to perform the operation.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row27405030192213"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091556__p15819393192215">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091556__p6302489192215">The requested resource was not found.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row1028254117454"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091556__p2757951117454">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091556__p1934790917454">Internal service error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020091556__row3991345717454"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091556__p1176460917454">503 Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091556__p1340929017454">The service is unavailable.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0020091554.html">Image Schema (Native OpenStack APIs)</a></div>
</div>
</div>