Merge lp:~yogesh-srikrishnan/openstack-manuals/yogirackspace into lp:~annegentle/openstack-manuals/trunk
- yogirackspace
- Merge into trunk
Proposed by
Yogeshwar
Status: | Merged |
---|---|
Merge reported by: | Anne Gentle |
Merged at revision: | not available |
Proposed branch: | lp:~yogesh-srikrishnan/openstack-manuals/yogirackspace |
Merge into: | lp:~annegentle/openstack-manuals/trunk |
Diff against target: |
4870 lines (+4800/-1) (has conflicts) 9 files modified
doc/source/docbkx/incubation/keystone/devguide/pom.xml (+32/-1) doc/source/docbkx/incubation/keystone/devguide/src/docbkx/OS-KSEC2-service-devguide.xml (+271/-0) doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSGRP-service-devguide.xml (+300/-0) doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSKEY-service-devguide.xml (+270/-0) doc/source/docbkx/incubation/keystone/devguide/src/docbkx/identity-client-devguide.xml.OTHER (+899/-0) doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-OS-devguide.fo.OTHER (+15/-0) doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-RAX-devguide.fo.OTHER (+12/-0) doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-client-devguide.fo.OTHER (+1297/-0) doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-service-devguide.fo.OTHER (+1704/-0) Text conflict in doc/source/docbkx/incubation/keystone/devguide/pom.xml Contents conflict in doc/source/docbkx/incubation/keystone/devguide/src/docbkx/identity-client-devguide.xml Conflict adding files to doc/source/docbkx/incubation/keystone/devguide/target. Created directory. Conflict because doc/source/docbkx/incubation/keystone/devguide/target is not versioned, but has versioned children. Versioned directory. Conflict adding files to doc/source/docbkx/incubation/keystone/devguide/target/docbkx. Created directory. Conflict because doc/source/docbkx/incubation/keystone/devguide/target/docbkx is not versioned, but has versioned children. Versioned directory. Conflict adding files to doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf. Created directory. Conflict because doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf is not versioned, but has versioned children. Versioned directory. Contents conflict in doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-OS-devguide.fo Contents conflict in doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-RAX-devguide.fo Contents conflict in doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-client-devguide.fo Contents conflict in doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-service-devguide.fo |
To merge this branch: | bzr merge lp:~yogesh-srikrishnan/openstack-manuals/yogirackspace |
Related bugs: |
Reviewer | Review Type | Date Requested | Status |
---|---|---|---|
Anne Gentle | Needs Resubmitting | ||
Review via email: mp+73262@code.launchpad.net |
Commit message
Description of the change
Added documents specific to extensions.
Pl let me know if you want me to make any other changes.These are draft documents and would undergo changes.
To post a comment you must log in.
Preview Diff
[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1 | === modified file 'doc/source/docbkx/incubation/keystone/devguide/pom.xml' |
2 | --- doc/source/docbkx/incubation/keystone/devguide/pom.xml 2011-08-29 16:38:37 +0000 |
3 | +++ doc/source/docbkx/incubation/keystone/devguide/pom.xml 2011-08-29 16:57:23 +0000 |
4 | @@ -178,19 +178,50 @@ |
5 | </copy> |
6 | <!--Moves PDF to the needed placement --> |
7 | <move failonerror="false" |
8 | +<<<<<<< TREE |
9 | file="${basedir}/target/docbkx/pdf/identity-dev-guide.pdf" |
10 | tofile="${basedir}/target/docbkx/webhelp/identity-dev-guide/identity-dev-guide.pdf"/> |
11 | |
12 | +======= |
13 | + file="${basedir}/target/docbkx/pdf/identity-service-devguide.pdf" |
14 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/identity-service-devguide.pdf"/> |
15 | + <move failonerror="false" |
16 | + file="${basedir}/target/docbkx/pdf/identity-client-devguide.pdf" |
17 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/identity-client-devguide.pdf"/> |
18 | + <move failonerror="false" |
19 | + file="${basedir}/target/docbkx/pdf/identity-OS-devguide.pdf" |
20 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/identity-OS-devguide.pdf"/> |
21 | + <move failonerror="false" |
22 | + file="${basedir}/target/docbkx/pdf/identity-RAX-devguide.pdf" |
23 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/identity-RAX-devguide.pdf"/> |
24 | + <move failonerror="false" |
25 | + file="${basedir}/target/docbkx/pdf/RAX-KSKEY-service-devguide.pdf" |
26 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/RAX-KSKEY-service-devguide.pdf"/> |
27 | + <move failonerror="false" |
28 | + file="${basedir}/target/docbkx/pdf/OS-KSEC2-service-devguide.pdf" |
29 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/OS-KSEC2-service-devguide.pdf"/> |
30 | + <move failonerror="false" |
31 | + file="${basedir}/target/docbkx/pdf/OS-KSEC2-service-devguide.pdf" |
32 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/OS-KSEC2-service-devguide.pdf"/> |
33 | + <move failonerror="false" |
34 | + file="${basedir}/target/docbkx/pdf/RAX-KSGRP-service-devguide.pdf" |
35 | + tofile="${basedir}/target/docbkx/webhelp/identitydevguide/RAX-KSGRP-service-devguide.pdf"/> |
36 | +>>>>>>> MERGE-SOURCE |
37 | </postProcess> |
38 | </configuration> |
39 | </execution> |
40 | </executions> |
41 | <configuration> |
42 | - <!-- These parameters apply to pdf and webhelp --> |
43 | + <!-- These parameters apply to pdf and webhelp --> |
44 | <xincludeSupported>true</xincludeSupported> |
45 | <sourceDirectory>src/docbkx</sourceDirectory> |
46 | <includes> |
47 | +<<<<<<< TREE |
48 | identity-dev-guide.xml |
49 | +======= |
50 | + identity-service-devguide.xml,identity-client-devguide.xml,identity-OS-devguide.xml, |
51 | + identity-RAX-devguide.xml,RAX-KSKEY-service-devguide.xml,OS-KSEC2-service-devguide.xml,RAX-KSGRP-service-devguide.xml |
52 | +>>>>>>> MERGE-SOURCE |
53 | </includes> |
54 | <profileSecurity>reviewer</profileSecurity> |
55 | <branding>openstack</branding> |
56 | |
57 | === added file 'doc/source/docbkx/incubation/keystone/devguide/src/docbkx/OS-KSEC2-service-devguide.xml' |
58 | --- doc/source/docbkx/incubation/keystone/devguide/src/docbkx/OS-KSEC2-service-devguide.xml 1970-01-01 00:00:00 +0000 |
59 | +++ doc/source/docbkx/incubation/keystone/devguide/src/docbkx/OS-KSEC2-service-devguide.xml 2011-08-29 16:57:23 +0000 |
60 | @@ -0,0 +1,271 @@ |
61 | +<?xml version="1.0" encoding="UTF-8"?> |
62 | +<!DOCTYPE book [ |
63 | + <!-- Some useful entities borrowed from HTML --> |
64 | + <!ENTITY ndash "–"> |
65 | + <!ENTITY mdash "—"> |
66 | + <!ENTITY hellip "…"> |
67 | + |
68 | + <!-- Useful for describing APIs --> |
69 | + <!ENTITY GET '<command xmlns="http://docbook.org/ns/docbook">GET</command>'> |
70 | + <!ENTITY PUT '<command xmlns="http://docbook.org/ns/docbook">PUT</command>'> |
71 | + <!ENTITY POST '<command xmlns="http://docbook.org/ns/docbook">POST</command>'> |
72 | + <!ENTITY DELETE '<command xmlns="http://docbook.org/ns/docbook">DELETE</command>'> |
73 | + |
74 | + <!ENTITY ARROW '<inlinemediaobject xmlns="http://docbook.org/ns/docbook"> |
75 | + <imageobject> |
76 | + <imagedata fileref="img/Arrow_east.svg" |
77 | + format="SVG" scale="60"/> |
78 | + </imageobject> |
79 | + </inlinemediaobject>'> |
80 | + |
81 | + <!ENTITY CODES 'Normal Response Code(s):'> |
82 | + <!ENTITY ERROR_CODES 'Error Response Code(s):'> |
83 | + |
84 | + <!-- Information about the extension --> |
85 | + <!ENTITY VERSION "v1.0"> |
86 | + <!ENTITY PUB_DATE "2011-08-26"> |
87 | + <!ENTITY ALIAS "OS-KSEC2-service"> |
88 | + <!ENTITY URI_REFHEAD ' |
89 | + <thead xmlns="http://docbook.org/ns/docbook"> |
90 | + <tr> |
91 | + <td colspan="1">Verb</td> |
92 | + <td colspan="1">URI</td> |
93 | + <td colspan="4">Description</td> |
94 | + </tr> |
95 | + </thead>'> |
96 | + <!ENTITY NAMESPACE "http://docs.openstack.org/identity/api/ext/OS-KSEC2/v1.0"> |
97 | + <!ENTITY CURRENTGUIDE "https://github.com/openstack/keystone/raw/master/keystone/content/service/OS-KSEC2-service-devguide.pdf"> |
98 | + <!ENTITY EXTENSIONXSD "https://raw.github.com/openstack/keystone/master/keystone/content/service/xsd/OS-KSEC2-credentials.xsd"> |
99 | + <!ENTITY EC2CREDENTIALSREQUESTXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth_credentials-OS-KSEC2.xml"> |
100 | + <!ENTITY EC2CREDENTIALSREQUESTJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth_credentials-OS-KSEC2.json"> |
101 | + <!ENTITY EC2CREDENTIALSRESPONSEXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth.xml"> |
102 | + <!ENTITY EC2CREDENTIALSRESPONSEJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth.json"> |
103 | + <!ENTITY EXTENSIONQUERYRESPONSEXML "https://raw.github.com/openstack/keystone/master/keystone/contrib/extensions/osec2/extension.xml"> |
104 | + <!ENTITY EXTENSIONQUERYRESPONSEJSON "https://raw.github.com/openstack/keystone/master/keystone/contrib/extensions/osec2/extension.json"> |
105 | + |
106 | + |
107 | +]> |
108 | +<book xmlns="http://docbook.org/ns/docbook" |
109 | + xmlns:xlink="http://www.w3.org/1999/xlink" |
110 | + xmlns:xi="http://www.w3.org/2001/XInclude" |
111 | + xmlns:svg="http://www.w3.org/2000/svg" |
112 | + xmlns:m="http://www.w3.org/1998/Math/MathML" |
113 | + xmlns:html="http://www.w3.org/1999/xhtml" |
114 | + version="5.0" status="draft" xml:id="book-0001"> |
115 | + <title>OpenStack EC2 authentication Extension (Service Operations)</title> |
116 | + <info> |
117 | + <author> |
118 | + <personname> |
119 | + <firstname/> |
120 | + <surname/> |
121 | + </personname> |
122 | + <affiliation> |
123 | + <orgname>OpenStack</orgname> |
124 | + </affiliation> |
125 | + </author> |
126 | + <copyright> |
127 | + <year>2010</year> |
128 | + <year>2011</year> |
129 | + <holder>OpenStack</holder> |
130 | + </copyright> |
131 | + <releaseinfo>EXT v1.0</releaseinfo> |
132 | + <productname>>Keystone - OpenStack Identity</productname> |
133 | + <pubdate>&PUB_DATE;</pubdate> |
134 | + <legalnotice role="apache2"> |
135 | + <annotation> |
136 | + <remark>Copyright details are filled in by the template.</remark> |
137 | + </annotation> |
138 | + </legalnotice> |
139 | + <abstract> |
140 | + <para> |
141 | + This document is intended for client developers interested |
142 | + in using the OpenStack EC2 Authentication Service Extension along with the |
143 | + Keystone - OpenStack Identity |
144 | + (<abbrev>API</abbrev>). |
145 | + </para> |
146 | + </abstract> |
147 | + </info> |
148 | + <chapter xml:id="chapter-0000"> |
149 | + <title>About This Extension</title> |
150 | + <variablelist spacing="compact"> |
151 | + <varlistentry> |
152 | + <term>Name</term> |
153 | + <listitem> |
154 | + <para>OpenStack EC2 authentication Extension</para> |
155 | + </listitem> |
156 | + </varlistentry> |
157 | + <varlistentry> |
158 | + <term>Namespace</term> |
159 | + <listitem> |
160 | + <para>&NAMESPACE;</para> |
161 | + </listitem> |
162 | + </varlistentry> |
163 | + <varlistentry> |
164 | + <term>Alias</term> |
165 | + <listitem> |
166 | + <para>&ALIAS;</para> |
167 | + </listitem> |
168 | + </varlistentry> |
169 | + <varlistentry> |
170 | + <term>Dependencies</term> |
171 | + <listitem> |
172 | + <para>Keystone - OpenStack Identity</para> |
173 | + </listitem> |
174 | + </varlistentry> |
175 | + <varlistentry> |
176 | + <term>Doc Link (PDF)</term> |
177 | + <listitem> |
178 | + <para> |
179 | + <link |
180 | + xlink:href="&CURRENTGUIDE;" |
181 | + > |
182 | + &CURRENTGUIDE; |
183 | + </link> |
184 | + </para> |
185 | + </listitem> |
186 | + </varlistentry> |
187 | + <varlistentry> |
188 | + <term>Doc Link (WADL)</term> |
189 | + <listitem> |
190 | + <para> |
191 | + None, the extension makes no modification to the API WADL. |
192 | + </para> |
193 | + </listitem> |
194 | + </varlistentry> |
195 | + <varlistentry> |
196 | + <term>Doc Link (XSD)</term> |
197 | + <listitem> |
198 | + <para> |
199 | + <link xlink:href="&EXTENSIONXSD;"> |
200 | + &EXTENSIONXSD; |
201 | + </link> |
202 | + </para> |
203 | + </listitem> |
204 | + </varlistentry> |
205 | + <varlistentry> |
206 | + <term>Short Description</term> |
207 | + <listitem> |
208 | + <para> |
209 | + OpenStack EC2 authentication Service Extension to Keystone v2.0 API adds the capability to support EC2 style authentication.. |
210 | + </para> |
211 | + </listitem> |
212 | + </varlistentry> |
213 | + </variablelist> |
214 | + <?hard-pagebreak?> |
215 | + <example> |
216 | + <title>Extension Query Response: XML</title> |
217 | + <programlisting language="xml"><xi:include href="&EXTENSIONQUERYRESPONSEXML;" parse="text"/></programlisting> |
218 | + </example> |
219 | + <example> |
220 | + <title>Extension Query Response: JSON</title> |
221 | + <programlisting language="javascript"><xi:include href="&EXTENSIONQUERYRESPONSEJSON;" parse="text"/></programlisting> |
222 | + </example> |
223 | + <section xml:id="Doc-Change-0001"> |
224 | + <title>Document Change History</title> |
225 | + <informaltable rules='all'> |
226 | + <thead> |
227 | + <tr> |
228 | + <td align="center" colspan="1">Revision Date</td> |
229 | + <td align="center" colspan="4">Summary of Changes</td> |
230 | + </tr> |
231 | + </thead> |
232 | + <tbody> |
233 | + <tr> |
234 | + <td colspan="1" align="center">Aug. 24, 2011</td> |
235 | + <td colspan="4"> |
236 | + <itemizedlist spacing="compact"> |
237 | + <listitem> |
238 | + <para> |
239 | + Initial release. |
240 | + </para> |
241 | + </listitem> |
242 | + </itemizedlist> |
243 | + </td> |
244 | + </tr> |
245 | + </tbody> |
246 | + </informaltable> |
247 | + </section> |
248 | + </chapter> |
249 | + <chapter xml:id="chapter-0001"> |
250 | + <title>Summary of Changes</title> |
251 | + <para> The OpenStack EC2 authentication Service Extension allows |
252 | + authenticate call using ec2Credentials. </para> |
253 | + <section xml:id="NewHeaders-0001"> |
254 | + <title>New Headers</title> |
255 | + <para>None.</para> |
256 | + </section> |
257 | + <section xml:id="NewFaults0001"> |
258 | + <title>New Faults</title> |
259 | + <para>None.</para> |
260 | + </section> |
261 | + <section xml:id="NewResources-0001"> |
262 | + <title>New Resources</title> |
263 | + <para>None.</para> |
264 | + </section> |
265 | + <section xml:id="NewActions0001"> |
266 | + <title>New Actions</title> |
267 | + <para>None.</para> |
268 | + </section> |
269 | + <section xml:id="NewElement0001"> |
270 | + <title>New Element</title> |
271 | + <section xml:id="RackExt-0001"> |
272 | + <title> |
273 | + Openstack extension to Keystone v2.0 API enabling EC2 style authentication. |
274 | + </title> |
275 | + <section xml:id="Authenticate-d1e1166"> |
276 | + <title>Authenticate</title> |
277 | + <para>This extension allows authentication calls to accept new type of credentials <parameter>ec2Credentials</parameter>. |
278 | + These are additional type of credentials defined to support EC2 style authentication. |
279 | + The usage of <parameter>ec2Credentials</parameter> on a existing call to authenticate is illustrated below |
280 | + </para> |
281 | + <informaltable rules="all"> |
282 | + &URI_REFHEAD; |
283 | + <tbody> |
284 | + <tr> |
285 | + <td colspan="1"> &POST; </td> |
286 | + <td colspan="1">/tokens</td> |
287 | + <td colspan="4">Authenticate to generate a token.</td> |
288 | + </tr> |
289 | + </tbody> |
290 | + </informaltable> |
291 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
292 | + <simpara>&ERROR_CODES; unauthorized (<errorcode>401</errorcode>), userDisabled |
293 | + (<errorcode>403</errorcode>), badRequest (<errorcode>400</errorcode>), identityFault |
294 | + (<errorcode>500</errorcode>), serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
295 | + <para> |
296 | + This call will return a token if successful. |
297 | + Clients obtain |
298 | + this token, along with the URL to other service APIs, by first authenticating against the |
299 | + Keystone Service and supplying valid credentials. |
300 | + This extension provides support for Rackspace Style API Key credentials. |
301 | + </para> |
302 | + <para> |
303 | + Client authentication is provided via a ReST interface using the POST method, |
304 | + with v2.0/tokens supplied as the path. A payload of credentials must be included |
305 | + in the body. |
306 | + </para> |
307 | + <para> |
308 | + The Keystone Service is a ReSTful web service. It is the entry point to all service APIs. |
309 | + To access the Keystone Service, you must know URL of the Keystone service. |
310 | + </para> |
311 | + <example> |
312 | + <title>XML Auth Request using EC2CREDENTIALS</title> |
313 | + <programlisting language="xml"><xi:include href="&EC2CREDENTIALSREQUESTXML;" parse="text"/></programlisting> |
314 | + </example> |
315 | + <example> |
316 | + <title>JSON Auth Request using EC2CREDENTIALS</title> |
317 | + <programlisting language="javascript"><xi:include href="&EC2CREDENTIALSREQUESTJSON;" parse="text"/></programlisting> |
318 | + </example> |
319 | + <example> |
320 | + <title>XML Auth Response</title> |
321 | + <programlisting language="xml"><xi:include href="samples/auth.xml" parse="text"/></programlisting> |
322 | + </example> |
323 | + <example> |
324 | + <title>JSON Auth Response</title> |
325 | + <programlisting language="javascript"><xi:include href="&EC2CREDENTIALSRESPONSEJSON;" parse="text"/></programlisting> |
326 | + </example> |
327 | + </section> |
328 | + </section> |
329 | + </section> |
330 | + </chapter> |
331 | +</book> |
332 | |
333 | === added file 'doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSGRP-service-devguide.xml' |
334 | --- doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSGRP-service-devguide.xml 1970-01-01 00:00:00 +0000 |
335 | +++ doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSGRP-service-devguide.xml 2011-08-29 16:57:23 +0000 |
336 | @@ -0,0 +1,300 @@ |
337 | +<?xml version="1.0" encoding="UTF-8"?> |
338 | +<!DOCTYPE book [ |
339 | + <!-- Some useful entities borrowed from HTML --> |
340 | + <!ENTITY ndash "–"> |
341 | + <!ENTITY mdash "—"> |
342 | + <!ENTITY hellip "…"> |
343 | + |
344 | + <!-- Useful for describing APIs --> |
345 | + <!ENTITY GET '<command xmlns="http://docbook.org/ns/docbook">GET</command>'> |
346 | + <!ENTITY PUT '<command xmlns="http://docbook.org/ns/docbook">PUT</command>'> |
347 | + <!ENTITY POST '<command xmlns="http://docbook.org/ns/docbook">POST</command>'> |
348 | + <!ENTITY DELETE '<command xmlns="http://docbook.org/ns/docbook">DELETE</command>'> |
349 | + |
350 | + <!ENTITY ARROW '<inlinemediaobject xmlns="http://docbook.org/ns/docbook"> |
351 | + <imageobject> |
352 | + <imagedata fileref="img/Arrow_east.svg" |
353 | + format="SVG" scale="60"/> |
354 | + </imageobject> |
355 | + </inlinemediaobject>'> |
356 | + |
357 | + <!ENTITY CODES 'Normal Response Code(s):'> |
358 | + <!ENTITY ERROR_CODES 'Error Response Code(s):'> |
359 | + |
360 | + <!-- Information about the extension --> |
361 | + <!ENTITY VERSION "v1.0"> |
362 | + <!ENTITY PUB_DATE "2011-08-26"> |
363 | + <!ENTITY ALIAS "RAX-KSGRP-service"> |
364 | + <!ENTITY URI_REFHEAD ' |
365 | + <thead xmlns="http://docbook.org/ns/docbook"> |
366 | + <tr> |
367 | + <td colspan="1">Verb</td> |
368 | + <td colspan="1">URI</td> |
369 | + <td colspan="4">Description</td> |
370 | + </tr> |
371 | + </thead>'> |
372 | + <!ENTITY NAMESPACE "http://docs.rackspace.com/identity/api/ext/RAX-KSGROUP/v1.0"> |
373 | + <!ENTITY CURRENTGUIDE "https://github.com/openstack/keystone/raw/master/keystone/content/service/RAX-KSGRP-service-devguide.pdf"> |
374 | + <!ENTITY EXTENSIONXSD "https://raw.github.com/openstack/keystone/master/keystone/content/service/xsd/RAX-KSGRP-groups.xsd"> |
375 | + |
376 | + <!ENTITY GROUPSXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/RAX-KSGRP-groups.xml"> |
377 | + <!ENTITY GROUPSJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/RAX-KSGRP-groups.json"> |
378 | + <!ENTITY GROUPXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/RAX-KSGRP-group.xml"> |
379 | + <!ENTITY GROUPJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/RAX-KSGRP-group.json"> |
380 | + |
381 | + <!ENTITY GROUPREQUESTXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth_credentials.xml"> |
382 | + <!ENTITY GROUPREQUESTJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth_credentials.json"> |
383 | + <!ENTITY GROUPRESPONSEXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/authwithgroups.xml"> |
384 | + <!ENTITY GROUPRESPONSEJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/authwithgroups.json"> |
385 | + <!ENTITY EXTENSIONQUERYRESPONSEXML "https://raw.github.com/openstack/keystone/master/keystone/contrib/extensions/raxgrp/extension.xml"> |
386 | + <!ENTITY EXTENSIONQUERYRESPONSEJSON "https://raw.github.com/openstack/keystone/master/keystone/contrib/extensions/raxgrp/extension.json"> |
387 | + |
388 | + |
389 | +]> |
390 | +<book xmlns="http://docbook.org/ns/docbook" |
391 | + xmlns:xlink="http://www.w3.org/1999/xlink" |
392 | + xmlns:xi="http://www.w3.org/2001/XInclude" |
393 | + xmlns:svg="http://www.w3.org/2000/svg" |
394 | + xmlns:m="http://www.w3.org/1998/Math/MathML" |
395 | + xmlns:html="http://www.w3.org/1999/xhtml" |
396 | + version="5.0" status="draft" xml:id="book-0001"> |
397 | + <title>Rackspace Keystone Group Extension(Service Operations)</title> |
398 | + <info> |
399 | + <author> |
400 | + <personname> |
401 | + <firstname/> |
402 | + <surname/> |
403 | + </personname> |
404 | + <affiliation> |
405 | + <orgname>Rackspace Cloud</orgname> |
406 | + </affiliation> |
407 | + </author> |
408 | + <copyright> |
409 | + <year>2011</year> |
410 | + <holder>Rackspace US, Inc.</holder> |
411 | + </copyright> |
412 | + <releaseinfo>EXT v1.0</releaseinfo> |
413 | + <productname>>Keystone - OpenStack Identity</productname> |
414 | + <pubdate>&PUB_DATE;</pubdate> |
415 | + <legalnotice role="rs-api"> |
416 | + <annotation> |
417 | + <remark>Copyright details are filled in by the template.</remark> |
418 | + </annotation> |
419 | + </legalnotice> |
420 | + <abstract> |
421 | + <para> |
422 | + This document is intended for client developers interested |
423 | + in using the Rackspace Keystone Group Extension(Service) along with the |
424 | + Keystone - OpenStack Identity |
425 | + (<abbrev>API</abbrev>). |
426 | + </para> |
427 | + </abstract> |
428 | + </info> |
429 | + <chapter xml:id="chapter-0000"> |
430 | + <title>About This Extension</title> |
431 | + <variablelist spacing="compact"> |
432 | + <varlistentry> |
433 | + <term>Name</term> |
434 | + <listitem> |
435 | + <para>Rackspace Keystone Group Extension</para> |
436 | + </listitem> |
437 | + </varlistentry> |
438 | + <varlistentry> |
439 | + <term>Namespace</term> |
440 | + <listitem> |
441 | + <para>&NAMESPACE;</para> |
442 | + </listitem> |
443 | + </varlistentry> |
444 | + <varlistentry> |
445 | + <term>Alias</term> |
446 | + <listitem> |
447 | + <para>&ALIAS;</para> |
448 | + </listitem> |
449 | + </varlistentry> |
450 | + <varlistentry> |
451 | + <term>Dependencies</term> |
452 | + <listitem> |
453 | + <para>Keystone - OpenStack Identity</para> |
454 | + </listitem> |
455 | + </varlistentry> |
456 | + <varlistentry> |
457 | + <term>Doc Link (PDF)</term> |
458 | + <listitem> |
459 | + <para> |
460 | + <link |
461 | + xlink:href="&CURRENTGUIDE;"> |
462 | + &CURRENTGUIDE; |
463 | + </link> |
464 | + </para> |
465 | + </listitem> |
466 | + </varlistentry> |
467 | + <varlistentry> |
468 | + <term>Doc Link (WADL)</term> |
469 | + <listitem> |
470 | + <para> |
471 | + None, the extension makes no modification to the API WADL. |
472 | + </para> |
473 | + </listitem> |
474 | + </varlistentry> |
475 | + <varlistentry> |
476 | + <term>Doc Link (XSD)</term> |
477 | + <listitem> |
478 | + <para> |
479 | + <link xlink:href="&EXTENSIONXSD;"> |
480 | + &EXTENSIONXSD; |
481 | + </link> |
482 | + </para> |
483 | + </listitem> |
484 | + </varlistentry> |
485 | + <varlistentry> |
486 | + <term>Short Description</term> |
487 | + <listitem> |
488 | + <para> |
489 | + Rackspace extensions to Keystone v2.0 API enabling groups. |
490 | + </para> |
491 | + </listitem> |
492 | + </varlistentry> |
493 | + </variablelist> |
494 | + <?hard-pagebreak?> |
495 | + <example> |
496 | + <title>Extension Query Response: XML</title> |
497 | + <programlisting language="xml"><xi:include href="&EXTENSIONQUERYRESPONSEXML;" parse="text"></xi:include></programlisting> |
498 | + </example> |
499 | + <example> |
500 | + <title>Extension Query Response: JSON</title> |
501 | + <programlisting language="javascript"><xi:include href="&EXTENSIONQUERYRESPONSEJSON;" parse="text"/></programlisting> |
502 | + </example> |
503 | + <section xml:id="Doc-Change-0001"> |
504 | + <title>Document Change History</title> |
505 | + <informaltable rules='all'> |
506 | + <thead> |
507 | + <tr> |
508 | + <td align="center" colspan="1">Revision Date</td> |
509 | + <td align="center" colspan="4">Summary of Changes</td> |
510 | + </tr> |
511 | + </thead> |
512 | + <tbody> |
513 | + <tr> |
514 | + <td colspan="1" align="center">Aug. 24, 2011</td> |
515 | + <td colspan="4"> |
516 | + <itemizedlist spacing="compact"> |
517 | + <listitem> |
518 | + <para> |
519 | + Initial release. |
520 | + </para> |
521 | + </listitem> |
522 | + </itemizedlist> |
523 | + </td> |
524 | + </tr> |
525 | + </tbody> |
526 | + </informaltable> |
527 | + </section> |
528 | + </chapter> |
529 | + <chapter xml:id="chapter-0001"> |
530 | + <title>Summary of Changes</title> |
531 | + <para> |
532 | + Rackspace extensions to Keystone v2.0 API allows authenticate call to also return information about group memberships of the user. |
533 | + </para> |
534 | + <section xml:id="NewHeaders-0001"> |
535 | + <title>New Headers</title> |
536 | + <para>None.</para> |
537 | + </section> |
538 | + <section xml:id="NewFaults0001"> |
539 | + <title>New Faults</title> |
540 | + <para>None.</para> |
541 | + </section> |
542 | + <section xml:id="NewResources-0001"> |
543 | + <title>New Resources</title> |
544 | + <para>None.</para> |
545 | + </section> |
546 | + <section xml:id="NewActions0001"> |
547 | + <title>New Actions</title> |
548 | + <para>None.</para> |
549 | + </section> |
550 | + <section xml:id="NewElement0001"> |
551 | + <title>New Elements</title> |
552 | + <section xml:id="RackExt-0001"> |
553 | + <title> |
554 | + Rackspace extensions to Keystone v2.0 API enabling groups. |
555 | + </title> |
556 | + <section xml:id="New-Elements-details-0002"> |
557 | + |
558 | + <title>New Elements</title> |
559 | + <para> |
560 | + This extension starts returning groups as a part of response when an authenticate call is made. |
561 | + The samples of new elements that are defined as a part of this extension are listed below. |
562 | + </para> |
563 | + <example> |
564 | + <title>Groups Sample XML</title> |
565 | + <programlisting language="xml"><xi:include href="&GROUPSXML;" parse="text"></xi:include></programlisting> |
566 | + </example> |
567 | + <example> |
568 | + <title>Groups Sample JSON</title> |
569 | + <programlisting language="xml"><xi:include href="&GROUPSJSON;" parse="text"></xi:include></programlisting> |
570 | + </example> |
571 | + <example> |
572 | + <title>Group Sample XML</title> |
573 | + <programlisting language="xml"><xi:include href="&GROUPXML;" parse="text"></xi:include></programlisting> |
574 | + </example> |
575 | + <example> |
576 | + <title>Group Sample JSON</title> |
577 | + <programlisting language="xml"><xi:include href="&GROUPJSON;" parse="text"></xi:include></programlisting> |
578 | + </example> |
579 | + </section> |
580 | + <section xml:id="Authenticate-d1e1166"> |
581 | + <title>Authenticate</title> |
582 | + <para>This extension allows authentication calls to also return information about groups. |
583 | + The usage of an existing call to authenticate, where it returns groups is illustrated below |
584 | + </para> |
585 | + <informaltable rules="all"> |
586 | + &URI_REFHEAD; |
587 | + <tbody> |
588 | + <tr> |
589 | + <td colspan="1"> &POST; </td> |
590 | + <td colspan="1">/tokens</td> |
591 | + <td colspan="4">Authenticate to generate a token.</td> |
592 | + </tr> |
593 | + </tbody> |
594 | + </informaltable> |
595 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
596 | + <simpara>&ERROR_CODES; unauthorized (<errorcode>401</errorcode>), userDisabled |
597 | + (<errorcode>403</errorcode>), badRequest (<errorcode>400</errorcode>), identityFault |
598 | + (<errorcode>500</errorcode>), serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
599 | + <para> |
600 | + This call will return a token if successful. Each ReST request against other services (or other |
601 | + calls on Keystone such as the GET /tenants call) |
602 | + requires the inclusion of a specific authorization token HTTP x-header, defined as X-Auth-Token. |
603 | + Clients obtain |
604 | + this token, along with the URL to other service APIs, by first authenticating against the |
605 | + Keystone Service and supplying valid credentials. |
606 | + </para> |
607 | + <para> |
608 | + Client authentication is provided via a ReST interface using the POST method, |
609 | + with v2.0/tokens supplied as the path. A payload of credentials must be included |
610 | + in the body. |
611 | + </para> |
612 | + <para> |
613 | + The Keystone Service is a ReSTful web service. It is the entry point to all service APIs. |
614 | + To access the Keystone Service, you must know URL of the Keystone service. |
615 | + </para> |
616 | + <example> |
617 | + <title>XML Auth Request using passwordCredentials</title> |
618 | + <programlisting language="xml"><xi:include href="&GROUPREQUESTXML;" parse="text"/></programlisting> |
619 | + </example> |
620 | + <example> |
621 | + <title>JSON Auth Request using passwordCredentials</title> |
622 | + <programlisting language="javascript"><xi:include href="&GROUPREQUESTJSON;" parse="text"/></programlisting> |
623 | + </example> |
624 | + <example> |
625 | + <title>XML Auth Response that contains Groups</title> |
626 | + <programlisting language="xml"><xi:include href="&GROUPRESPONSEXML;" parse="text"><xi:fallback>Yet To Be added</xi:fallback></xi:include></programlisting> |
627 | + </example> |
628 | + <example> |
629 | + <title>JSON Auth Response that contains Groups</title> |
630 | + <programlisting language="javascript"><xi:include href="&GROUPRESPONSEJSON;" parse="text"><xi:fallback>Yet To Be added</xi:fallback></xi:include></programlisting> |
631 | + </example> |
632 | + </section> |
633 | + </section> |
634 | + </section> |
635 | + </chapter> |
636 | +</book> |
637 | |
638 | === added file 'doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSKEY-service-devguide.xml' |
639 | --- doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSKEY-service-devguide.xml 1970-01-01 00:00:00 +0000 |
640 | +++ doc/source/docbkx/incubation/keystone/devguide/src/docbkx/RAX-KSKEY-service-devguide.xml 2011-08-29 16:57:23 +0000 |
641 | @@ -0,0 +1,270 @@ |
642 | +<?xml version="1.0" encoding="UTF-8"?> |
643 | +<!DOCTYPE book [ |
644 | + <!-- Some useful entities borrowed from HTML --> |
645 | + <!ENTITY ndash "–"> |
646 | + <!ENTITY mdash "—"> |
647 | + <!ENTITY hellip "…"> |
648 | + |
649 | + <!-- Useful for describing APIs --> |
650 | + <!ENTITY GET '<command xmlns="http://docbook.org/ns/docbook">GET</command>'> |
651 | + <!ENTITY PUT '<command xmlns="http://docbook.org/ns/docbook">PUT</command>'> |
652 | + <!ENTITY POST '<command xmlns="http://docbook.org/ns/docbook">POST</command>'> |
653 | + <!ENTITY DELETE '<command xmlns="http://docbook.org/ns/docbook">DELETE</command>'> |
654 | + |
655 | + <!ENTITY ARROW '<inlinemediaobject xmlns="http://docbook.org/ns/docbook"> |
656 | + <imageobject> |
657 | + <imagedata fileref="img/Arrow_east.svg" |
658 | + format="SVG" scale="60"/> |
659 | + </imageobject> |
660 | + </inlinemediaobject>'> |
661 | + |
662 | + <!ENTITY CODES 'Normal Response Code(s):'> |
663 | + <!ENTITY ERROR_CODES 'Error Response Code(s):'> |
664 | + |
665 | + <!-- Information about the extension --> |
666 | + <!ENTITY VERSION "v1.0"> |
667 | + <!ENTITY PUB_DATE "2011-08-26"> |
668 | + <!ENTITY ALIAS "RAX-KSKEY-service"> |
669 | + <!ENTITY URI_REFHEAD ' |
670 | + <thead xmlns="http://docbook.org/ns/docbook"> |
671 | + <tr> |
672 | + <td colspan="1">Verb</td> |
673 | + <td colspan="1">URI</td> |
674 | + <td colspan="4">Description</td> |
675 | + </tr> |
676 | + </thead>'> |
677 | + <!ENTITY NAMESPACE "http://docs.rackspace.com/identity/api/ext/RAX-KSKEY/v1.0"> |
678 | + <!ENTITY CURRENTGUIDE "https://github.com/openstack/keystone/raw/master/keystone/content/service/RAX-KSKEY-service-devguide.pdf"> |
679 | + <!ENTITY EXTENSIONXSD "https://raw.github.com/openstack/keystone/master/keystone/content/service/xsd/RAX-KSKEY-credentials.xsd"> |
680 | + <!ENTITY APIKEYCREDENTIALSREQUESTXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth_credentials-RAX-KSKEY.xml"> |
681 | + <!ENTITY APIKEYCREDENTIALSREQUESTJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth_credentials-RAX-KSKEY.json"> |
682 | + <!ENTITY APIKEYCREDENTIALSRESPONSEXML "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth.xml"> |
683 | + <!ENTITY APIKEYCREDENTIALSRESPONSEJSON "https://raw.github.com/openstack/keystone/master/keystone/content/common/samples/auth.json"> |
684 | + <!ENTITY EXTENSIONQUERYRESPONSEXML "https://raw.github.com/openstack/keystone/master/keystone/contrib/extensions/raxkey/extension.xml"> |
685 | + <!ENTITY EXTENSIONQUERYRESPONSEJSON "https://raw.github.com/openstack/keystone/master/keystone/contrib/extensions/raxkey/extension.json"> |
686 | + |
687 | + |
688 | +]> |
689 | +<book xmlns="http://docbook.org/ns/docbook" |
690 | + xmlns:xlink="http://www.w3.org/1999/xlink" |
691 | + xmlns:xi="http://www.w3.org/2001/XInclude" |
692 | + xmlns:svg="http://www.w3.org/2000/svg" |
693 | + xmlns:m="http://www.w3.org/1998/Math/MathML" |
694 | + xmlns:html="http://www.w3.org/1999/xhtml" |
695 | + version="5.0" status="draft" xml:id="book-0001"> |
696 | + <title>RAckspace API Key Authentication Extension (Service Operations)</title> |
697 | + <info> |
698 | + <author> |
699 | + <personname> |
700 | + <firstname/> |
701 | + <surname/> |
702 | + </personname> |
703 | + <affiliation> |
704 | + <orgname>Rackspace Cloud</orgname> |
705 | + </affiliation> |
706 | + </author> |
707 | + <copyright> |
708 | + <year>2011</year> |
709 | + <holder>Rackspace US, Inc.</holder> |
710 | + </copyright> |
711 | + <releaseinfo>EXT v1.0</releaseinfo> |
712 | + <productname>>Keystone - OpenStack Identity</productname> |
713 | + <pubdate>&PUB_DATE;</pubdate> |
714 | + <legalnotice role="rs-api"> |
715 | + <annotation> |
716 | + <remark>Copyright details are filled in by the template.</remark> |
717 | + </annotation> |
718 | + </legalnotice> |
719 | + <abstract> |
720 | + <para> |
721 | + This document is intended for client developers interested |
722 | + in using the Rackspace API Key Authentication Service Extension along with the |
723 | + Keystone - OpenStack Identity |
724 | + (<abbrev>API</abbrev>). |
725 | + </para> |
726 | + </abstract> |
727 | + </info> |
728 | + <chapter xml:id="chapter-0000"> |
729 | + <title>About This Extension</title> |
730 | + <variablelist spacing="compact"> |
731 | + <varlistentry> |
732 | + <term>Name</term> |
733 | + <listitem> |
734 | + <para>Rackspace API Key Authentication Service Extension</para> |
735 | + </listitem> |
736 | + </varlistentry> |
737 | + <varlistentry> |
738 | + <term>Namespace</term> |
739 | + <listitem> |
740 | + <para>&NAMESPACE;</para> |
741 | + </listitem> |
742 | + </varlistentry> |
743 | + <varlistentry> |
744 | + <term>Alias</term> |
745 | + <listitem> |
746 | + <para>&ALIAS;</para> |
747 | + </listitem> |
748 | + </varlistentry> |
749 | + <varlistentry> |
750 | + <term>Dependencies</term> |
751 | + <listitem> |
752 | + <para>Keystone - OpenStack Identity</para> |
753 | + </listitem> |
754 | + </varlistentry> |
755 | + <varlistentry> |
756 | + <term>Doc Link (PDF)</term> |
757 | + <listitem> |
758 | + <para> |
759 | + <link |
760 | + xlink:href="&CURRENTGUIDE;"> |
761 | + &CURRENTGUIDE; |
762 | + </link> |
763 | + </para> |
764 | + </listitem> |
765 | + </varlistentry> |
766 | + <varlistentry> |
767 | + <term>Doc Link (WADL)</term> |
768 | + <listitem> |
769 | + <para> |
770 | + None, the extension makes no modification to the API WADL. |
771 | + </para> |
772 | + </listitem> |
773 | + </varlistentry> |
774 | + <varlistentry> |
775 | + <term>Doc Link (XSD)</term> |
776 | + <listitem> |
777 | + <para> |
778 | + <link xlink:href="&EXTENSIONXSD;"> |
779 | + &EXTENSIONXSD; |
780 | + </link> |
781 | + </para> |
782 | + </listitem> |
783 | + </varlistentry> |
784 | + <varlistentry> |
785 | + <term>Short Description</term> |
786 | + <listitem> |
787 | + <para> |
788 | + Rackspace extensions to Keystone v2.0 API enabling API Key authentication. |
789 | + </para> |
790 | + </listitem> |
791 | + </varlistentry> |
792 | + </variablelist> |
793 | + <?hard-pagebreak?> |
794 | + <example> |
795 | + <title>Extension Query Response: XML</title> |
796 | + <programlisting language="xml"><xi:include href="&EXTENSIONQUERYRESPONSEXML;" parse="text"></xi:include></programlisting> |
797 | + </example> |
798 | + <example> |
799 | + <title>Extension Query Response: JSON</title> |
800 | + <programlisting language="javascript"><xi:include href="&EXTENSIONQUERYRESPONSEJSON;" parse="text"/></programlisting> |
801 | + </example> |
802 | + <section xml:id="Doc-Change-0001"> |
803 | + <title>Document Change History</title> |
804 | + <informaltable rules='all'> |
805 | + <thead> |
806 | + <tr> |
807 | + <td align="center" colspan="1">Revision Date</td> |
808 | + <td align="center" colspan="4">Summary of Changes</td> |
809 | + </tr> |
810 | + </thead> |
811 | + <tbody> |
812 | + <tr> |
813 | + <td colspan="1" align="center">Aug. 24, 2011</td> |
814 | + <td colspan="4"> |
815 | + <itemizedlist spacing="compact"> |
816 | + <listitem> |
817 | + <para> |
818 | + Initial release. |
819 | + </para> |
820 | + </listitem> |
821 | + </itemizedlist> |
822 | + </td> |
823 | + </tr> |
824 | + </tbody> |
825 | + </informaltable> |
826 | + </section> |
827 | + </chapter> |
828 | + <chapter xml:id="chapter-0001"> |
829 | + <title>Summary of Changes</title> |
830 | + <para> |
831 | + The Rackspace API Key Authentication Service Extension allows authenticate call to happen using apikeyCredentials. |
832 | + </para> |
833 | + <section xml:id="NewHeaders-0001"> |
834 | + <title>New Headers</title> |
835 | + <para>None.</para> |
836 | + </section> |
837 | + <section xml:id="NewFaults0001"> |
838 | + <title>New Faults</title> |
839 | + <para>None.</para> |
840 | + </section> |
841 | + <section xml:id="NewResources-0001"> |
842 | + <title>New Resources</title> |
843 | + <para>None.</para> |
844 | + </section> |
845 | + <section xml:id="NewActions0001"> |
846 | + <title>New Actions</title> |
847 | + <para>None.</para> |
848 | + </section> |
849 | + <section xml:id="NewElement0001"> |
850 | + <title>New Element</title> |
851 | + <section xml:id="RackExt-0001"> |
852 | + <title> |
853 | + Rackspace extensions to Keystone v2.0 API enabling API Key authentication. |
854 | + </title> |
855 | + <section xml:id="Authenticate-d1e1166"> |
856 | + <title>Authenticate</title> |
857 | + <para>This extension allows authentication calls to accept new type of credentials <parameter>apikeyCredentials</parameter>. |
858 | + These are additional type of credentials defined to support rackspace style authentication. |
859 | + The usage of <parameter>apikeyCredentials</parameter> on a existing call to authenticate is illustrated below |
860 | + </para> |
861 | + <informaltable rules="all"> |
862 | + &URI_REFHEAD; |
863 | + <tbody> |
864 | + <tr> |
865 | + <td colspan="1"> &POST; </td> |
866 | + <td colspan="1">/tokens</td> |
867 | + <td colspan="4">Authenticate to generate a token.</td> |
868 | + </tr> |
869 | + </tbody> |
870 | + </informaltable> |
871 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
872 | + <simpara>&ERROR_CODES; unauthorized (<errorcode>401</errorcode>), userDisabled |
873 | + (<errorcode>403</errorcode>), badRequest (<errorcode>400</errorcode>), identityFault |
874 | + (<errorcode>500</errorcode>), serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
875 | + <para> |
876 | + This call will return a token if successful. |
877 | + Clients obtain |
878 | + this token, along with the URL to other service APIs, by first authenticating against the |
879 | + Keystone Service and supplying valid credentials. |
880 | + This extension provides support for Rackspace Style API Key credentials. |
881 | + </para> |
882 | + <para> |
883 | + Client authentication is provided via a ReST interface using the POST method, |
884 | + with v2.0/tokens supplied as the path. A payload of credentials must be included |
885 | + in the body. |
886 | + </para> |
887 | + <para> |
888 | + The Keystone Service is a ReSTful web service. It is the entry point to all service APIs. |
889 | + To access the Keystone Service, you must know URL of the Keystone service. |
890 | + </para> |
891 | + <example> |
892 | + <title>XML Auth Request using apikeyCredentials</title> |
893 | + <programlisting language="xml"><xi:include href="&APIKEYCREDENTIALSREQUESTXML;" parse="text"/></programlisting> |
894 | + </example> |
895 | + <example> |
896 | + <title>JSON Auth Request using apikeyCredentials</title> |
897 | + <programlisting language="javascript"><xi:include href="&APIKEYCREDENTIALSREQUESTJSON;" parse="text"/></programlisting> |
898 | + </example> |
899 | + <example> |
900 | + <title>XML Auth Response</title> |
901 | + <programlisting language="xml"><xi:include href="&APIKEYCREDENTIALSRESPONSEXML;" parse="text"/></programlisting> |
902 | + </example> |
903 | + <example> |
904 | + <title>JSON Auth Response</title> |
905 | + <programlisting language="javascript"><xi:include href="&APIKEYCREDENTIALSRESPONSEJSON;" parse="text"/></programlisting> |
906 | + </example> |
907 | + </section> |
908 | + </section> |
909 | + </section> |
910 | + </chapter> |
911 | +</book> |
912 | |
913 | === added file 'doc/source/docbkx/incubation/keystone/devguide/src/docbkx/identity-client-devguide.xml.OTHER' |
914 | --- doc/source/docbkx/incubation/keystone/devguide/src/docbkx/identity-client-devguide.xml.OTHER 1970-01-01 00:00:00 +0000 |
915 | +++ doc/source/docbkx/incubation/keystone/devguide/src/docbkx/identity-client-devguide.xml.OTHER 2011-08-29 16:57:23 +0000 |
916 | @@ -0,0 +1,899 @@ |
917 | +<?xml version='1.0' encoding='UTF-8'?> |
918 | +<!DOCTYPE book [<!-- Some useful entities borrowed from HTML --> |
919 | + <!ENTITY ndash "–"> |
920 | + <!ENTITY mdash "—"> |
921 | + <!ENTITY hellip "…"> |
922 | + |
923 | + <!-- Useful for describing APIs --> |
924 | + <!ENTITY GET '<command xmlns="http://docbook.org/ns/docbook">GET</command>'> |
925 | + <!ENTITY PUT '<command xmlns="http://docbook.org/ns/docbook">PUT</command>'> |
926 | + <!ENTITY POST '<command xmlns="http://docbook.org/ns/docbook">POST</command>'> |
927 | + <!ENTITY DELETE '<command xmlns="http://docbook.org/ns/docbook">DELETE</command>'> |
928 | + |
929 | + |
930 | + <!ENTITY CHECK '<inlinemediaobject xmlns="http://docbook.org/ns/docbook"> |
931 | + <imageobject> |
932 | + <imagedata fileref="img/Check_mark_23x20_02.svg" |
933 | + format="SVG" scale="60"/> |
934 | + </imageobject> |
935 | + </inlinemediaobject>'> |
936 | + <!ENTITY CODES 'Normal Response Code(s):'> |
937 | + <!ENTITY ERROR_CODES 'Error Response Code(s):'> |
938 | + <!ENTITY NO_REQUEST '<para xmlns="http://docbook.org/ns/docbook"> |
939 | + This operation does not require a request body.</para>'> |
940 | + <!ENTITY LONG_URI_REFHEAD ' |
941 | + <thead xmlns="http://docbook.org/ns/docbook"> |
942 | + <tr> |
943 | + <td colspan="1">Verb</td> |
944 | + <td colspan="4">URI</td> |
945 | + <td colspan="3">Description</td> |
946 | + </tr> |
947 | + </thead>'> |
948 | + <!ENTITY URI_REFHEAD ' |
949 | + <thead xmlns="http://docbook.org/ns/docbook"> |
950 | + <tr> |
951 | + <td colspan="1">Verb</td> |
952 | + <td colspan="1">URI</td> |
953 | + <td colspan="4">Description</td> |
954 | + </tr> |
955 | + </thead>'> |
956 | +]> |
957 | +<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" |
958 | + xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:svg="http://www.w3.org/2000/svg" |
959 | + xmlns:m="http://www.w3.org/1998/Math/MathML" xmlns:html="http://www.w3.org/1999/xhtml" |
960 | + xmlns:db="http://docbook.org/ns/docbook" version="5.0" status="draft" xml:id="Book-100001"> |
961 | + <title xml:id="ClientDevloperGuide-100001">Keystone Developer Guide</title> |
962 | + <info> |
963 | + <author> |
964 | + <personname> |
965 | + <firstname/> |
966 | + <surname/> |
967 | + </personname> |
968 | + <affiliation> |
969 | + <orgname>OpenStack</orgname> |
970 | + </affiliation> |
971 | + </author> |
972 | + <copyright> |
973 | + <year>2010</year> |
974 | + <year>2011</year> |
975 | + <holder>OpenStack</holder> |
976 | + </copyright> |
977 | + <releaseinfo>API v2.0</releaseinfo> |
978 | + <productname>Keystone - OpenStack Identity</productname> |
979 | + <pubdate>2011-08-23</pubdate> |
980 | + <legalnotice role="apache2"> |
981 | + <annotation> |
982 | + <remark>Copyright details are filled in by the template.</remark> |
983 | + </annotation> |
984 | + </legalnotice> |
985 | + <abstract> |
986 | + <para>This document is intended for client developers who want to consume any OpenStack |
987 | + service that uses the Keystone Identity Service for authentication.</para> |
988 | + </abstract> |
989 | + </info> |
990 | + <chapter xml:id="Overview-d1e62"> |
991 | + <title>Overview</title> |
992 | + <para>The Keystone Identity Service allows clients to obtain tokens that can be used to access |
993 | + OpenStack cloud services. This document is intended for software developers interested in |
994 | + developing applications that utilize the Keystone Identity Service API for authentication. |
995 | + </para> |
996 | + <para>This Guide assumes the reader is familiar with RESTful web services, HTTP/1.1, and JSON |
997 | + and/or XML serialization formats. </para> |
998 | + </chapter> |
999 | + <chapter xml:id="Concepts-d1e74"> |
1000 | + <title>Concepts</title> |
1001 | + <para> |
1002 | + The Keystone Identity Service has several key concepts which are |
1003 | + important to understand: |
1004 | + </para> |
1005 | + <section xml:id="User-d1e103"> |
1006 | + <title>User</title> |
1007 | + <para> |
1008 | + A digital representation of a person, system, or service who uses OpenStack cloud services. |
1009 | + Keystone authentication services will validate that incoming request are being made by the user |
1010 | + who claims to be making the call. Users have a login and may be assigned tokens to access |
1011 | + resources. Users may be directly assigned to a particular tenant and |
1012 | + behave as if they are contained in that tenant. |
1013 | + </para> |
1014 | + </section> |
1015 | + <section xml:id="Credentials-d1e103b"> |
1016 | + <title>Credentials</title> |
1017 | + <para> |
1018 | + Data that belongs to, is owned by, and generally only known by a user that the user can present |
1019 | + to prove they are who they are (since nobody else should know that data). |
1020 | + </para> |
1021 | + <para>Examples are: |
1022 | + <itemizedlist> |
1023 | + <listitem><para>a matching username and password</para></listitem> |
1024 | + <listitem><para>a matching username and API key</para></listitem> |
1025 | + <listitem><para>yourself and a driver's license with a picture of you</para></listitem> |
1026 | + <listitem><para>a token that was issued to you that nobody else knows of</para></listitem> |
1027 | + </itemizedlist> |
1028 | + </para> |
1029 | + </section> |
1030 | + <section xml:id="Authentication-d1e103a"> |
1031 | + <title>Authentication</title> |
1032 | + <para> |
1033 | + In the context of Keystone, authentication is the act of confirming the identity of a |
1034 | + user or the truth of a claim. |
1035 | + Keystone will confirm that incoming request are being made by the user |
1036 | + who claims to be making the call by validating a set of claims that the user is making. |
1037 | + These claims are intially in the form of a set of credentials (username & password, |
1038 | + or username and API key). After initial confirmation, Keystone will issue the user a token |
1039 | + which the user can then provide to demonstrate that their identity has been authenticated |
1040 | + when making subsequent requests. |
1041 | + </para> |
1042 | + </section> |
1043 | + <section xml:id="Token-d1e82"> |
1044 | + <title>Token</title> |
1045 | + <para> |
1046 | + A token is an arbitrary bit of text that is used to access |
1047 | + resources. Each token has a scope which describes which |
1048 | + resources are accessible with it. A token may be |
1049 | + revoked at anytime and is valid for a finite duration. |
1050 | + </para> |
1051 | + <para> |
1052 | + While Keystone supports token-based authentication in this release, |
1053 | + the intention is for it to support additional protocols in the |
1054 | + future. The intent is for it to be an integration service foremost, and not |
1055 | + a aspire to be a full-fledged identity store and management solution. |
1056 | + </para> |
1057 | + </section> |
1058 | + <section xml:id="Tenant-d1e94"> |
1059 | + <title>Tenant</title> |
1060 | + <para> |
1061 | + A container used to group or isolate resources and/or identity |
1062 | + objects. Depending on the service operator, a tenant may map to a customer, |
1063 | + account, organization, or project. |
1064 | + </para> |
1065 | + </section> |
1066 | + <section xml:id="Service-d1e104"> |
1067 | + <title>Service</title> |
1068 | + <para> |
1069 | + An OpenStack service (such as Nova, Swift, or Glance). A service provides |
1070 | + onr or more endpoints through which users can access resources and perform |
1071 | + (presumably useful) operations. |
1072 | + </para> |
1073 | + </section> |
1074 | + <section xml:id="Endpoint-d1e122"> |
1075 | + <title>Endpoint</title> |
1076 | + <para> |
1077 | + An network-accessible address, usually described by URL, where a service may be accessed. |
1078 | + </para> |
1079 | + </section> |
1080 | + <section xml:id="Role-d1e131"> |
1081 | + <title>Role</title> |
1082 | + <para> A personality that a user assumes when performing a specific set of operations. |
1083 | + A role includes a set of right and priviledges. A user assuming that role inherits |
1084 | + those rights and priviledges. |
1085 | + </para><para> |
1086 | + In Keystone, a token that is issued to a user includes the list of roles that user |
1087 | + can assume. Services that are being called by that user determine how they interpret the set |
1088 | + of roles a user has and which operations or resources each roles grants access to. |
1089 | + </para> |
1090 | + </section> |
1091 | + </chapter> |
1092 | + <chapter xml:id="General_API_Information-d1e141"> |
1093 | + <title>General API Information</title> |
1094 | + <para>The Keystone API is implemented using a RESTful web service interface. All requests to |
1095 | + authenticate and operate against the Keystone API should be performed using SSL over HTTP |
1096 | + (HTTPS) on TCP port 443.</para> |
1097 | + <section xml:id="Request_Response_Types-d1e149"> |
1098 | + <title>Request/Response Types</title> |
1099 | + <para> The Keystone API supports both the JSON and XML data serialization formats. The request |
1100 | + format is specified using the <code>Content-Type</code> header and is required for |
1101 | + operations that have a request body. The response format can be specified in requests using |
1102 | + either the <code>Accept</code> header or adding an <code>.xml</code> or <code>.json</code> |
1103 | + extension to the request URI. Note that it is possible for a response to be serialized using |
1104 | + a format different from the request (see example below). If no response format is specified, |
1105 | + JSON is the default. If conflicting formats are specified using both an <code>Accept</code> |
1106 | + header and a query extension, the query extension takes precedence.</para> |
1107 | + <table rules="all"> |
1108 | + <caption>Response Types</caption> |
1109 | + <thead> |
1110 | + <tr> |
1111 | + <td>Format</td> |
1112 | + <td>Accept Header</td> |
1113 | + <td>Query Extension</td> |
1114 | + <td>Default</td> |
1115 | + </tr> |
1116 | + </thead> |
1117 | + <tbody> |
1118 | + <tr> |
1119 | + <td>JSON</td> |
1120 | + <td>application/json</td> |
1121 | + <td>.json</td> |
1122 | + <td>Yes</td> |
1123 | + </tr> |
1124 | + <tr> |
1125 | + <td>XML</td> |
1126 | + <td>application/xml</td> |
1127 | + <td>.xml</td> |
1128 | + <td>No</td> |
1129 | + </tr> |
1130 | + </tbody> |
1131 | + </table> |
1132 | + <example> |
1133 | + <title>JSON Request with Headers</title> |
1134 | + <programlisting language="xml"> |
1135 | +<xi:include href="samples/samplerequestheader.txt" parse="text"/> |
1136 | +</programlisting> |
1137 | + <programlisting language="xml"> |
1138 | +<xi:include href="samples/auth_credentials.json" parse="text"/> |
1139 | +</programlisting> |
1140 | + </example> |
1141 | + <example> |
1142 | + <title>XML Response with Headers</title> |
1143 | + <programlisting language="xml"> |
1144 | +<xi:include href="samples/sampleresponseheader.txt" parse="text"/> |
1145 | +</programlisting> |
1146 | + <programlisting language="xml"> |
1147 | +<xi:include href="samples/auth.xml" parse="text"/> |
1148 | +</programlisting> |
1149 | + </example> |
1150 | + </section> |
1151 | + <section xml:id="Content_Compression-d1e262"> |
1152 | + <title>Content Compression</title> |
1153 | + <para>Request and response body data my be encoded with gzip compression in order to |
1154 | + accelerate interactive performance of API calls and responses. This is controlled using the |
1155 | + <code>Accept-Encoding</code> header on the request from the client and indicated by the |
1156 | + <code>Content-Encoding</code> header in the server response. Unless the header is |
1157 | + explicitly set, encoding defaults to disabled.</para> |
1158 | + <table rules="all"> |
1159 | + <caption>Compression Headers</caption> |
1160 | + <thead> |
1161 | + <tr> |
1162 | + <td>Header Type</td> |
1163 | + <td>Name</td> |
1164 | + <td>Value</td> |
1165 | + </tr> |
1166 | + </thead> |
1167 | + <tbody> |
1168 | + <tr> |
1169 | + <td>HTTP/1.1 Request</td> |
1170 | + <td>Accept-Encoding</td> |
1171 | + <td>gzip</td> |
1172 | + </tr> |
1173 | + <tr> |
1174 | + <td>HTTP/1.1 Response</td> |
1175 | + <td>Content-Encoding</td> |
1176 | + <td>gzip</td> |
1177 | + </tr> |
1178 | + </tbody> |
1179 | + </table> |
1180 | + </section> |
1181 | + <section xml:id="Paginated_Collections-d1e325"> |
1182 | + <title>Paginated Collections</title> |
1183 | + <para> |
1184 | + To reduce load on the service, list operations will |
1185 | + return a maximum number of items at a time. The |
1186 | + maximum number of items returned is determined by the |
1187 | + Identity provider. To navigate the collection, the |
1188 | + parameters <parameter>limit</parameter> and |
1189 | + <parameter>marker</parameter> can be set in the URI |
1190 | + (e.g.?<parameter>limit</parameter>=100&<parameter>marker</parameter>=1234). |
1191 | + The <parameter>marker</parameter> parameter is the ID |
1192 | + of the last item in the previous list. Items are |
1193 | + sorted by update time. When an update time is not |
1194 | + available they are sorted by ID. The |
1195 | + <parameter>limit</parameter> parameter sets the page |
1196 | + size. Both parameters are optional. If the client |
1197 | + requests a <parameter>limit</parameter> beyond that |
1198 | + which is supported by the deployment an overLimit |
1199 | + (<errorcode>413</errorcode>) fault may be thrown. A |
1200 | + marker with an invalid ID will return an itemNotFound |
1201 | + (<errorcode>404</errorcode>) fault. |
1202 | + </para> |
1203 | + <note> |
1204 | + <para> |
1205 | + Paginated collections never return itemNotFound |
1206 | + (<errorcode>404</errorcode>) faults when the |
1207 | + collection is empty — clients should expect |
1208 | + an empty collection. |
1209 | + </para> |
1210 | + </note> |
1211 | + <para> |
1212 | + For convenience, collections contain atom "next" and |
1213 | + "previous" links. The first page in the list will not |
1214 | + contain a "previous" link, the last page in the list |
1215 | + will not contain a "next" link. The following examples |
1216 | + illustrate three pages in a collection of tenants. The |
1217 | + first page was retrieved via a &GET; to |
1218 | + http://identity.api.openstack.org/v2.0/1234/tenants?limit=1. |
1219 | + In these examples, the <parameter>limit</parameter> |
1220 | + parameter sets the page size to a single item. |
1221 | + Subsequent "next" and "previous" links will honor the |
1222 | + initial page size. Thus, a client may follow links to |
1223 | + traverse a paginated collection without having to |
1224 | + input the <parameter>marker</parameter> parameter. |
1225 | + </para> |
1226 | + <example> |
1227 | + <title>Tenant Collection, First Page: XML</title> |
1228 | + <programlisting language="xml"> |
1229 | + <xi:include href="samples/tenants-1.xml" parse="text"/> |
1230 | + </programlisting> |
1231 | + </example> |
1232 | + <example> |
1233 | + <title>Tenant Collection, First Page: JSON</title> |
1234 | + <programlisting language="javascript"><xi:include |
1235 | + href="samples/tenants-1.json" parse="text"/></programlisting> |
1236 | + </example> |
1237 | + <example> |
1238 | + <title>Tenant Collection, Second Page: XML</title> |
1239 | + <programlisting language="xml"> |
1240 | +<xi:include href="samples/tenants-2.xml" parse="text"/> |
1241 | + </programlisting> |
1242 | + </example> |
1243 | + <example> |
1244 | + <title>Tenant Collection, Second Page: JSON</title> |
1245 | + <programlisting language="javascript"><xi:include |
1246 | + href="samples/tenants-2.json" parse="text"/></programlisting> |
1247 | + </example> |
1248 | + <example> |
1249 | + <title>Tenant Collection, Last Page: XML</title> |
1250 | + <programlisting language="xml"> |
1251 | +<xi:include href="samples/tenants-3.xml" parse="text"/> |
1252 | + </programlisting> |
1253 | + </example> |
1254 | + <example> |
1255 | + <title>Tenant Collection, Last Page: JSON</title> |
1256 | + <programlisting language="javascript"><xi:include |
1257 | + href="samples/tenants-3.json" parse="text"/></programlisting> |
1258 | + </example> |
1259 | + <para> |
1260 | + In the JSON representation, paginated collections contain |
1261 | + a <property>values</property> property that contains the |
1262 | + items in the collections. Links are accessed via the |
1263 | + <property>links</property> property. The approach allows |
1264 | + for extensibility of both the collection members and of |
1265 | + the paginated collection itself. It also allows |
1266 | + collections to be embedded in other objects as illustrated |
1267 | + below. Here, a subset of grups are presented within a |
1268 | + user. Clients must follow the "next" link to continue to |
1269 | + retrive additonal groups belonging to a user. |
1270 | + </para> |
1271 | + <example> |
1272 | + <title>Paginated Roles in a User: XML</title> |
1273 | + <programlisting language="xml"> |
1274 | +<xi:include href="samples/getuser-1.xml" parse="text"/> |
1275 | + </programlisting> |
1276 | + </example> |
1277 | + <example> |
1278 | + <title>Paginated Roles in an User: JSON</title> |
1279 | + <programlisting language="javascript"><xi:include |
1280 | + href="samples/getuser-1.json" parse="text"/></programlisting> |
1281 | + </example> |
1282 | + </section> |
1283 | + <section xml:id="Versions-d1e472"> |
1284 | + <title>Versions</title> |
1285 | + <para> |
1286 | + The OpenStack Identity API uses both a URI and a MIME |
1287 | + type versioning scheme. In the URI scheme, the first |
1288 | + element of the path contains the target version |
1289 | + identifier (e.g. https://identity.api.openstack.org/ |
1290 | + v2.0/…). The MIME type versioning scheme uses |
1291 | + HTTP content negotiation where the <code>Accept</code> |
1292 | + or <code>Content-Type</code> headers contains a MIME |
1293 | + type that includes the version ID as a parameter |
1294 | + (application/vnd.openstack.identity+xml;version=1.1). A |
1295 | + version MIME type is always linked to a base MIME type |
1296 | + (application/xml or application/json). If conflicting |
1297 | + versions are specified using both an HTTP header and a |
1298 | + URI, the URI takes precedence. |
1299 | + </para> |
1300 | + <example> |
1301 | + <title>Request with MIME type versioning</title> |
1302 | + <literallayout class="monospaced"> |
1303 | +GET /tenants HTTP/1.1 |
1304 | +Host: identity.api.openstack.org |
1305 | +Accept: application/vnd.openstack.identity+xml;version=1.1 |
1306 | +X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb |
1307 | + </literallayout> |
1308 | + </example> |
1309 | + <example> |
1310 | + <title>Request with URI versioning</title> |
1311 | + <literallayout class="monospaced"> |
1312 | +GET /v1.1/tenants HTTP/1.1 |
1313 | +Host: identity.api.openstack.org |
1314 | +Accept: application/xml |
1315 | +X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb |
1316 | + </literallayout> |
1317 | + </example> |
1318 | + <note> |
1319 | + <para> |
1320 | + The MIME type versioning approach allows for the |
1321 | + creating of permanent links, because the version |
1322 | + scheme is not specified in the URI path: |
1323 | + https://api.identity.openstack.org/tenants/12234. |
1324 | + </para> |
1325 | + </note> |
1326 | + <para> |
1327 | + If a request is made without a version specified in |
1328 | + the URI or via HTTP headers, then a multiple-choices |
1329 | + response (<returnvalue>300</returnvalue>) will follow |
1330 | + providing links and MIME types to available versions. |
1331 | + </para> |
1332 | + <example> |
1333 | + <title>Multiple Choices Response: XML</title> |
1334 | + <programlisting language="xml"> |
1335 | +<xi:include href="samples/choices.xml" parse="text"/> |
1336 | + </programlisting> |
1337 | + </example> |
1338 | + <example> |
1339 | + <title>Multiple Choices Response: JSON</title> |
1340 | + <programlisting language="javascript"><xi:include |
1341 | + href="samples/choices.json" parse="text"/></programlisting> |
1342 | + </example> |
1343 | + <para> |
1344 | + New features and functionality that do not break |
1345 | + API-compatibility will be introduced in the current |
1346 | + version of the API as extensions (see below) and the |
1347 | + URI and MIME types will remain unchanged. Features or |
1348 | + functionality changes that would necessitate a break |
1349 | + in API-compatibility will require a new version, which |
1350 | + will result in URI and MIME type version being updated |
1351 | + accordingly. When new API versions are released, older |
1352 | + versions will be marked as |
1353 | + <code>DEPRECATED</code>. Providers should work with |
1354 | + developers and partners to ensure there is adequate |
1355 | + time to migrate to the new version before deprecated |
1356 | + versions are discontinued. |
1357 | + </para> |
1358 | + <para> |
1359 | + Your application can programmatically determine |
1360 | + available API versions by performing a &GET; on the |
1361 | + root URL (i.e. with the version and everything to the |
1362 | + right of it truncated) returned from the |
1363 | + authentication system. Note that an Atom |
1364 | + representation of the versions resources is supported |
1365 | + when issuing a request with the <code>Accept</code> |
1366 | + header containing application/atom+xml or by adding a |
1367 | + .atom to the request URI. This allows standard Atom |
1368 | + clients to track version changes. |
1369 | + </para> |
1370 | + <example> |
1371 | + <title>Versions List Request</title> |
1372 | + <literallayout class="monospaced"> |
1373 | +GET HTTP/1.1 |
1374 | +Host: identity.api.openstack.org |
1375 | + </literallayout> |
1376 | + </example> |
1377 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
1378 | + <simpara>&ERROR_CODES; badRequest |
1379 | + (<errorcode>400</errorcode>), identityFault |
1380 | + (<errorcode>500</errorcode>), |
1381 | + serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
1382 | + &NO_REQUEST; |
1383 | + <example> |
1384 | + <title>Versions List Response: XML</title> |
1385 | + <programlisting language="xml"> |
1386 | +<xi:include href="samples/versions.xml" parse="text"/> |
1387 | + </programlisting> |
1388 | + </example> |
1389 | + <example> |
1390 | + <title>Versions List Response: Atom</title> |
1391 | + <programlisting language="xml"> |
1392 | +<xi:include href="samples/versions-atom.xml" parse="text"/> |
1393 | + </programlisting> |
1394 | + </example> |
1395 | + <example> |
1396 | + <title>Versions List Response: JSON</title> |
1397 | + <programlisting language="javascript"><xi:include |
1398 | + href="samples/versions.json" parse="text"/></programlisting> |
1399 | + </example> |
1400 | + <para> |
1401 | + You can also obtain additional information about a |
1402 | + specific version by performing a &GET; on the base |
1403 | + version URL |
1404 | + (e.g. https://identity.api.openstack.org/v1.1/). |
1405 | + Version request URLs should always end with a trailing |
1406 | + slash (/). If the slash is omitted, the server may |
1407 | + respond with a <returnvalue>302</returnvalue> |
1408 | + redirection request. Format extensions may be placed |
1409 | + after the slash |
1410 | + (e.g. https://identity.api.openstack.org/v1.1/.xml). Note |
1411 | + that this is a special case that does not hold true |
1412 | + for other API requests. In general, requests such as |
1413 | + /tenants.xml and /tenants/.xml are handled |
1414 | + equivalently. |
1415 | + </para> |
1416 | + <example> |
1417 | + <title>Version Details Request</title> |
1418 | + <literallayout class="monospaced"> |
1419 | +GET HTTP/1.1 |
1420 | +Host: identity.api.openstack.org/v1.1/ |
1421 | + </literallayout> |
1422 | + </example> |
1423 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
1424 | + <simpara>&ERROR_CODES; badRequest |
1425 | + (<errorcode>400</errorcode>), identityFault |
1426 | + (<errorcode>500</errorcode>), |
1427 | + serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
1428 | + &NO_REQUEST; |
1429 | + <example> |
1430 | + <title>Version Details Response: XML</title> |
1431 | + <programlisting language="xml"> |
1432 | +<xi:include href="samples/version.xml" parse="text"/> |
1433 | + </programlisting> |
1434 | + </example> |
1435 | + <example> |
1436 | + <title>Version Details Response: Atom</title> |
1437 | + <programlisting language="xml"> |
1438 | +<xi:include href="samples/version-atom.xml" parse="text"/> |
1439 | + </programlisting> |
1440 | + </example> |
1441 | + <example> |
1442 | + <title>Version Details Response: JSON</title> |
1443 | + <programlisting language="javascript"><xi:include |
1444 | + href="samples/version.json" parse="text"/></programlisting> |
1445 | + </example> |
1446 | + <para> |
1447 | + The detailed version response contains pointers to |
1448 | + both a human-readable and a machine-processable |
1449 | + description of the API service. The machine-processable description is written in the Web |
1450 | + Application Description Language (WADL). |
1451 | + </para> |
1452 | + <note> |
1453 | + <para>If there is a discrepancy between the two specifications, the WADL is |
1454 | + authoritative as it contains the most accurate and up-to-date description of the |
1455 | + API service. </para> |
1456 | + </note> |
1457 | + </section> |
1458 | + <section xml:id="Extensions-d1e688"> |
1459 | + <title>Extensions</title> |
1460 | + <para> |
1461 | + The OpenStack Identity API is extensible. Extensions |
1462 | + serve two purposes: They allow the introduction of new |
1463 | + features in the API without requiring a version change |
1464 | + and they allow the introduction of vendor specific |
1465 | + niche functionality. Applications can programmatically |
1466 | + determine what extensions are available by performing |
1467 | + a &GET; on the /extensions URI. Note that this is a |
1468 | + versioned request — that is, an extension |
1469 | + available in one API version may not be available in |
1470 | + another. |
1471 | + </para> |
1472 | + <informaltable rules="all"> |
1473 | + <thead> |
1474 | + <tr> |
1475 | + <td colspan="1">Verb</td> |
1476 | + <td colspan="2">URI</td> |
1477 | + <td colspan="3">Description</td> |
1478 | + </tr> |
1479 | + </thead> |
1480 | + <tbody> |
1481 | + <tr> |
1482 | + <td colspan="1">&GET;</td> |
1483 | + <td colspan="2">/extensions</td> |
1484 | + <td colspan="3">Returns a list of available extensions</td> |
1485 | + </tr> |
1486 | + </tbody> |
1487 | + </informaltable> |
1488 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
1489 | + <simpara>&ERROR_CODES; badRequest |
1490 | + (<errorcode>400</errorcode>), identityFault (<errorcode>500</errorcode>), |
1491 | + serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
1492 | + &NO_REQUEST; |
1493 | + <para> |
1494 | + Each extension is identified by two unique identifiers, a |
1495 | + <property>namespace</property> and an |
1496 | + <property>alias</property>. Additionally an extension |
1497 | + contains documentation links in various formats. |
1498 | + </para> |
1499 | + <example> |
1500 | + <title>Extensions Response: XML</title> |
1501 | + <programlisting language="xml"> |
1502 | +<xi:include href="samples/extensions.xml" parse="text"/> |
1503 | + </programlisting> |
1504 | + </example> |
1505 | + <example> |
1506 | + <title>Extensions Response: JSON</title> |
1507 | + <programlisting language="javascript"><xi:include |
1508 | + href="samples/extensions.json" parse="text"/></programlisting> |
1509 | + </example> |
1510 | + <para> |
1511 | + Extensions may also be queried individually by their |
1512 | + unique alias. This provides the simplest method of |
1513 | + checking if an extension is available as an unavailable |
1514 | + extension will issue an itemNotFound |
1515 | + (<errorcode>404</errorcode>) response. |
1516 | + </para> |
1517 | + <informaltable rules="all"> |
1518 | + <thead> |
1519 | + <tr> |
1520 | + <td colspan="1">Verb</td> |
1521 | + <td colspan="2">URI</td> |
1522 | + <td colspan="3">Description</td> |
1523 | + </tr> |
1524 | + </thead> |
1525 | + <tbody> |
1526 | + <tr> |
1527 | + <td colspan="1">&GET;</td> |
1528 | + <td colspan="2">/extensions/<parameter>alias</parameter></td> |
1529 | + <td colspan="3">Return details of a single extension</td> |
1530 | + </tr> |
1531 | + </tbody> |
1532 | + </informaltable> |
1533 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
1534 | + <simpara>&ERROR_CODES; itemNotFound |
1535 | + (<errorcode>404</errorcode>), badRequest |
1536 | + (<errorcode>400</errorcode>), identityFault |
1537 | + (<errorcode>500</errorcode>), |
1538 | + serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
1539 | + &NO_REQUEST; |
1540 | + <example> |
1541 | + <title>Extension Response: xml</title> |
1542 | + <programlisting language="xml"> |
1543 | +<xi:include href="samples/extension.xml" parse="text"/> |
1544 | + </programlisting> |
1545 | + </example> |
1546 | + <example> |
1547 | + <title>Extensions Response: JSON</title> |
1548 | + <programlisting language="javascript"><xi:include |
1549 | + href="samples/extension.json" parse="text"/></programlisting> |
1550 | + </example> |
1551 | + <para> |
1552 | + Extensions may define new data types, parameters, actions, |
1553 | + headers, states, and resources. In XML, additional |
1554 | + elements and attributes may be defined. These elements |
1555 | + must be defined in the extension's namespace. In JSON, the |
1556 | + alias must be used. The volumes element in the <xref |
1557 | + linkend="UserEXT" xrefstyle="template: Examples %n"/> and |
1558 | + <xref linkend="UserEXTJ" xrefstyle="select: labelnumber"/> |
1559 | + is defined in the <code>RS-META</code> namespace. Extended |
1560 | + headers are always prefixed with <code>X-</code> followed |
1561 | + by the alias and a dash: (<code>X-RS-META-HEADER1</code>). |
1562 | + Parameters must be prefixed with the extension alias |
1563 | + followed by a colon. |
1564 | + </para> |
1565 | + <important> |
1566 | + <para> |
1567 | + Applications should be prepared to ignore response |
1568 | + data that contains extension elements. Also, |
1569 | + applications should also verify that an extension is |
1570 | + available before submitting an extended request. |
1571 | + </para> |
1572 | + </important> |
1573 | + <example xml:id="UserEXT"> |
1574 | + <title>Extended User Response: XML</title> |
1575 | + <programlisting language="xml"> |
1576 | +<xi:include href="samples/ext-getuser.xml" parse="text"/> |
1577 | + </programlisting> |
1578 | + </example> |
1579 | + <example xml:id="UserEXTJ"> |
1580 | + <title>Extended User Response: JSON</title> |
1581 | + <programlisting language="javascript"><xi:include |
1582 | + href="samples/ext-getuser.json" parse="text"/></programlisting> |
1583 | + </example> |
1584 | + </section> |
1585 | + <section xml:id="Faults-d1e908"> |
1586 | + <title>Faults</title> |
1587 | + <para>When an error occurs the system will return an HTTP error response code denoting the |
1588 | + type of error. The system will also return additional information about the fault in the |
1589 | + body of the response. </para> |
1590 | + <example> |
1591 | + <title>XML Fault Response</title> |
1592 | + <programlisting language="xml"> |
1593 | +<xi:include href="samples/identity_fault.xml" parse="text"/> |
1594 | +</programlisting> |
1595 | + </example> |
1596 | + <example> |
1597 | + <title>JSON Fault Response</title> |
1598 | + <programlisting language="javascript"> |
1599 | +<xi:include href="samples/identity_fault.json" parse="text"/> |
1600 | +</programlisting> |
1601 | + </example> |
1602 | + <para>The error code is returned in the body of the response for convenience. The message |
1603 | + section returns a human readable message. The details section is optional and may contain |
1604 | + useful information for tracking down an error (e.g a stack trace). </para> |
1605 | + <para>The root element of the fault (e.g. identityFault) may change depending on the type of error. |
1606 | + The following is an example of an itemNotFound error. </para> |
1607 | + <example> |
1608 | + <title>XML Not Found Fault</title> |
1609 | + <programlisting language="xml"> |
1610 | +<xi:include href="samples/item_not_found.xml" parse="text"/> |
1611 | +</programlisting> |
1612 | + </example> |
1613 | + <example> |
1614 | + <title>JSON Not Found Fault</title> |
1615 | + <programlisting language="javascript"> |
1616 | +<xi:include href="samples/item_not_found.json" parse="text"/> |
1617 | +</programlisting> |
1618 | + </example> |
1619 | + <para> The following is a list of possible fault types along with their associated error |
1620 | + codes. </para> |
1621 | + <table rules="all"> |
1622 | + <caption>Fault Types</caption> |
1623 | + <thead> |
1624 | + <tr> |
1625 | + <td>Fault Element</td> |
1626 | + <td>Associated Error Code</td> |
1627 | + <td>Expected in All Requests</td> |
1628 | + </tr> |
1629 | + </thead> |
1630 | + <tbody> |
1631 | + <tr align="center"> |
1632 | + <td>identityFault</td> |
1633 | + <td>500, 400</td> |
1634 | + <td> &CHECK; </td> |
1635 | + </tr> |
1636 | + <tr align="center"> |
1637 | + <td>serviceUnavailable</td> |
1638 | + <td>503</td> |
1639 | + <td> &CHECK; </td> |
1640 | + </tr> |
1641 | + <tr align="center"> |
1642 | + <td>badRequest</td> |
1643 | + <td>400</td> |
1644 | + <td> &CHECK; </td> |
1645 | + </tr> |
1646 | + <tr align="center"> |
1647 | + <td>unauthorized</td> |
1648 | + <td>401</td> |
1649 | + <td> &CHECK; </td> |
1650 | + </tr> |
1651 | + <tr align="center"> |
1652 | + <td>overLimit</td> |
1653 | + <td>413</td> |
1654 | + <td/> |
1655 | + </tr> |
1656 | + <tr align="center"> |
1657 | + <td>userDisabled</td> |
1658 | + <td>403</td> |
1659 | + <td/> |
1660 | + </tr> |
1661 | + <tr align="center"> |
1662 | + <td>forbidden</td> |
1663 | + <td>403</td> |
1664 | + <td/> |
1665 | + </tr> |
1666 | + <tr align="center"> |
1667 | + <td>itemNotFound</td> |
1668 | + <td>404</td> |
1669 | + <td/> |
1670 | + </tr> |
1671 | + <tr align="center"> |
1672 | + <td>tenantConflict</td> |
1673 | + <td>409</td> |
1674 | + <td/> |
1675 | + </tr> |
1676 | + </tbody> |
1677 | + </table> |
1678 | + <para>From an XML schema perspective, all API faults are extensions of the base fault type |
1679 | + <type>identityFault</type>. When working with a system that binds XML to actual classes (such |
1680 | + as JAXB), one should be capable of using <type>identityFault</type> as a “catch-all” if |
1681 | + there's no interest in distinguishing between individual fault types. </para> |
1682 | + </section> |
1683 | + </chapter> |
1684 | + <chapter xml:id="Service_API_Client_Operations_-d1e1110"> |
1685 | + <title>Service API (Client Operations)</title> |
1686 | + <section xml:id="Overview-d1e1115"> |
1687 | + <title>Overview</title> |
1688 | + <para>The operations described in this chapter allow clients to authenticate and get |
1689 | + access tokens and service endpoints. </para> |
1690 | + </section> |
1691 | + <section xml:id="Core_Service_API-d1e1124"> |
1692 | + <title>Core Service API</title> |
1693 | + <para>The following calls are core Keystone Service APIs in version 2.0</para> |
1694 | + <informaltable rules="all"> |
1695 | + &URI_REFHEAD; |
1696 | + <tbody> |
1697 | + <tr> |
1698 | + <td colspan="1"> &POST; </td> |
1699 | + <td colspan="1">/tokens</td> |
1700 | + <td colspan="4">Authenticate to generate a token.</td> |
1701 | + </tr> |
1702 | + <tr> |
1703 | + <td colspan="1"> &GET; </td> |
1704 | + <td colspan="1">/tenants</td> |
1705 | + <td colspan="4">Get a list of tenants accessible with supplied token.</td> |
1706 | + </tr> |
1707 | + </tbody> |
1708 | + </informaltable> |
1709 | + </section> |
1710 | + |
1711 | + <section xml:id="Available-operations-d100001"> |
1712 | + <title>Available Operations</title> |
1713 | + <section xml:id="Authenticate-d1e1166"> |
1714 | + <title>Authenticate</title> |
1715 | + <informaltable rules="all"> |
1716 | + &URI_REFHEAD; |
1717 | + <tbody> |
1718 | + <tr> |
1719 | + <td colspan="1"> &POST; </td> |
1720 | + <td colspan="1">/tokens</td> |
1721 | + <td colspan="4">Authenticate to generate a token.</td> |
1722 | + </tr> |
1723 | + </tbody> |
1724 | + </informaltable> |
1725 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
1726 | + <simpara>&ERROR_CODES; unauthorized (<errorcode>401</errorcode>), userDisabled |
1727 | + (<errorcode>403</errorcode>), badRequest (<errorcode>400</errorcode>), identityFault |
1728 | + (<errorcode>500</errorcode>), serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
1729 | + <para> |
1730 | + This call will return a token if successful. Each ReST request against other services (or other |
1731 | + calls on Keystone such as the GET /tenants call) |
1732 | + requires the inclusion of a specific authorization token HTTP x-header, defined as X-Auth-Token. |
1733 | + Clients obtain |
1734 | + this token, along with the URL to other service APIs, by first authenticating against the |
1735 | + Keystone Service and supplying valid credentials. |
1736 | + </para> |
1737 | + <para> |
1738 | + Client authentication is provided via a ReST interface using the POST method, |
1739 | + with v2.0/tokens supplied as the path. A payload of credentials must be included |
1740 | + in the body. |
1741 | + </para> |
1742 | + <para> |
1743 | + The Keystone Service is a ReSTful web service. It is the entry point to all service APIs. |
1744 | + To access the Keystone Service, you must know URL of the Keystone service. |
1745 | + </para> |
1746 | + <example> |
1747 | + <title>XML Auth Request</title> |
1748 | + <programlisting language="xml"> |
1749 | + <xi:include href="samples/auth_credentials.xml" parse="text"/> |
1750 | +</programlisting> |
1751 | + </example> |
1752 | + <example> |
1753 | + <title>JSON Auth Request</title> |
1754 | + <programlisting language="javascript"> |
1755 | +<xi:include href="samples/auth_credentials.json" parse="text"/> |
1756 | +</programlisting> |
1757 | + </example> |
1758 | + <example> |
1759 | + <title>XML Auth Response</title> |
1760 | + <programlisting language="xml"> |
1761 | +<xi:include href="samples/auth.xml" parse="text"/> |
1762 | +</programlisting> |
1763 | + </example> |
1764 | + <example> |
1765 | + <title>JSON Auth Response</title> |
1766 | + <programlisting language="javascript"> |
1767 | +<xi:include href="samples/auth.json" parse="text"/> |
1768 | +</programlisting> |
1769 | + </example> |
1770 | + </section> |
1771 | + <section xml:id="Get_Tenants-d1e1264"> |
1772 | + <title>Get Tenants</title> |
1773 | + <informaltable rules="all"> |
1774 | + &LONG_URI_REFHEAD; |
1775 | + <tbody> |
1776 | + <tr> |
1777 | + <td colspan="1"> &GET; </td> |
1778 | + <td colspan="4">/tenants</td> |
1779 | + <td colspan="3">Get a list of tenants.</td> |
1780 | + </tr> |
1781 | + </tbody> |
1782 | + </informaltable> |
1783 | + <simpara>&CODES;<returnvalue>200</returnvalue>, <returnvalue>203</returnvalue></simpara> |
1784 | + <simpara>&ERROR_CODES; unauthorized (<errorcode>401</errorcode>), |
1785 | + forbidden(<errorcode>403</errorcode>), overLimit(<errorcode>413</errorcode>), |
1786 | + badRequest (<errorcode>400</errorcode>), identityFault (<errorcode>500</errorcode>), |
1787 | + serviceUnavailable(<errorcode>503</errorcode>)</simpara> |
1788 | + <para> |
1789 | + The operation returns a list of tenants which the supplied token provides |
1790 | + access to. This call must be authenticated, so a valid token must |
1791 | + be passed in as a header. |
1792 | + </para> |
1793 | + <example> |
1794 | + <title>Tenants Request with Auth Token</title> |
1795 | + <programlisting language="text"> |
1796 | +<xi:include href="samples/tenants-request.txt" parse="text"/> |
1797 | +</programlisting> |
1798 | + </example> |
1799 | + &NO_REQUEST; |
1800 | + <example> |
1801 | + <title>JSON Tenants Response</title> |
1802 | + <programlisting language="javascript"> |
1803 | +<xi:include href="samples/tenants.json" parse="text"/> |
1804 | +</programlisting> |
1805 | + </example> |
1806 | + <example> |
1807 | + <title>XML Tenants Response</title> |
1808 | + <programlisting language="xml"> |
1809 | +<xi:include href="samples/tenants.xml" parse="text"/> |
1810 | +</programlisting> |
1811 | + </example> |
1812 | + </section> |
1813 | + </section> |
1814 | + </chapter> |
1815 | +</book> |
1816 | |
1817 | === added directory 'doc/source/docbkx/incubation/keystone/devguide/target' |
1818 | === added directory 'doc/source/docbkx/incubation/keystone/devguide/target/docbkx' |
1819 | === added directory 'doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf' |
1820 | === added file 'doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-OS-devguide.fo.OTHER' |
1821 | --- doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-OS-devguide.fo.OTHER 1970-01-01 00:00:00 +0000 |
1822 | +++ doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-OS-devguide.fo.OTHER 2011-08-29 16:57:23 +0000 |
1823 | @@ -0,0 +1,15 @@ |
1824 | +<?xml version="1.0" encoding="utf-8"?><fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="CartoGothic Std" font-size="10.5pt" text-align="start" line-height="normal" font-selection-strategy="character-by-character" line-height-shift-adjustment="disregard-shifts" writing-mode="lr-tb" language="en"><fo:layout-master-set><fo:simple-page-master master-name="blank" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body display-align="center" margin-bottom="0.5in" margin-top="0.5in"/><fo:region-before region-name="xsl-region-before-blank" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-blank" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:page-sequence-master master-name="titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="titlepage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="lot"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="lot-first" page-position="first"/><fo:conditional-page-master-reference master-reference="lot-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="lot-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="front"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="front-first" page-position="first"/><fo:conditional-page-master-reference master-reference="front-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="front-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="body"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="body-first" page-position="first"/><fo:conditional-page-master-reference master-reference="body-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="body-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="back"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="back-first" page-position="first"/><fo:conditional-page-master-reference master-reference="back-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="back-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="index"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="index-first" page-position="first"/><fo:conditional-page-master-reference master-reference="index-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="index-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:simple-page-master xmlns:exslt="http://exslt.org/common" master-name="cloudpage-first" page-width="8.5in" page-height="11in" margin-top="0.0in" margin-bottom="0.0in" margin-left="0.0in" margin-right="0.0in"><fo:region-body margin-bottom="0.0in" margin-top="0.0in" column-gap="0pt" column-count="1"/><fo:region-before extent="11.0in" display-align="before" background-image="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/cloud/cover.svg)" background-repeat="no-repeat" background-position-horizontal="0%" background-position-vertical="0%"/></fo:simple-page-master><fo:page-sequence-master xmlns:exslt="http://exslt.org/common" master-name="cloud-titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="cloudpage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master></fo:layout-master-set><fo:declarations><x:xmpmeta xmlns:x="adobe:ns:meta/"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xapRights="http://ns.adobe.com/xap/1.0/rights/" rdf:about=""><xapRights:Marked>True</xapRights:Marked></rdf:Description><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" rdf:about=""><dc:rights><rdf:Alt><rdf:li xml:lang="x-default">Copyright © 2010, 2011 OpenStack All rights reserved.</rdf:li></rdf:Alt></dc:rights><dc:title>Keystone Developer Guide - OS Extensions</dc:title><dc:creator/></rdf:Description><rdf:Description xmlns:pdf="http://ns.adobe.com/pdf/1.3/" rdf:about=""/><rdf:Description xmlns:xmp="http://ns.adobe.com/xap/1.0/" rdf:about=""><xmp:CreatorTool>Cloud API Docs Plugin</xmp:CreatorTool></rdf:Description></rdf:RDF></x:xmpmeta></fo:declarations><fo:bookmark-tree><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="OSExtensionsGuide-100001" starting-state="hide"><fo:bookmark-title>Keystone Developer Guide - OS Extensions</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="toc...OSExtensionsGuide-100001"><fo:bookmark-title>Table of Contents</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62" starting-state="hide"><fo:bookmark-title>1. Overview</fo:bookmark-title><fo:bookmark internal-destination="Endpoint_Template-d1e113" starting-state="hide"><fo:bookmark-title>1.1. Endpoint Template</fo:bookmark-title></fo:bookmark></fo:bookmark></fo:bookmark-tree><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="OSExtensionsGuide-100001"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Endpoint_Template-d1e113"/><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="cloud-titlepage" language="en" format="i" initial-page-number="1" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body"><fo:block id="OSExtensionsGuide-100001"><fo:block><fo:block><fo:block break-after="page"/><fo:block font-size="14.4pt" font-weight="bold" font-family="CartoGothic Std"><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block><fo:block font-size="10pt"><fo:block> </fo:block></fo:block><fo:block font-size="10pt" space-before="0.5em">API v2.0 (2011-08-23)</fo:block><fo:block font-size="10pt">Copyright © 2010, 2011 OpenStack All rights reserved.</fo:block><fo:block font-size="10pt"><fo:block xmlns:exslt="http://exslt.org/common" start-indent="0.0in" end-indent="0.0in"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="center"/><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">To Be Done: This document describes openstack specific extensions on |
1825 | + keystone.</fo:block></fo:block></fo:block><fo:block font-size="8pt" space-before="1.0em"><fo:block xmlns:exslt="http://exslt.org/common" id="d319e17"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1826 | + Licensed under the Apache License, Version 2.0 (the "License"); |
1827 | + you may not use this file except in compliance with the License. |
1828 | + You may obtain a copy of the License at |
1829 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:basic-link external-destination="http://www.apache.org/licenses/LICENSE-2.0"><fo:inline>http://www.apache.org/licenses/LICENSE-2.0</fo:inline></fo:basic-link></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1830 | + Unless required by applicable law or agreed to in writing, software |
1831 | + distributed under the License is distributed on an "AS IS" BASIS, |
1832 | + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
1833 | + See the License for the specific language governing permissions and |
1834 | + limitations under the License. |
1835 | + </fo:block></fo:block></fo:block></fo:block><fo:block break-after="page"/></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="lot" language="en" format="i" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="toc...OSExtensionsGuide-100001"><fo:block><fo:block><fo:block space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="0pt" start-indent="0pt" font-size="20.736pt" font-weight="bold" color="rgb(196,0,34)" font-family="CartoGothic Std">Table of Contents</fo:block></fo:block></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Overview-d1e62">1. Overview</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Overview-d1e62"><fo:page-number-citation ref-id="Overview-d1e62"/></fo:basic-link></fo:inline></fo:block><fo:block id="toc.OSExtensionsGuide-100001.Overview-d1e62" margin-left="24pt"><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Endpoint_Template-d1e113">1.1. Endpoint Template</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Endpoint_Template-d1e113"><fo:page-number-citation ref-id="Endpoint_Template-d1e113"/></fo:basic-link></fo:inline></fo:block></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="body" language="en" format="1" initial-page-number="1" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - OS Extensions</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="Overview-d1e62"><fo:block font-family="CartoGothic Std"><fo:block margin-left="0pt"><fo:block font-size="24.8832pt" font-weight="bold"><fo:block keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="start" start-indent="0pt" font-family="CartoGothic Std" color="rgb(196,0,34)" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2">1. Overview</fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">TBD</fo:block><fo:block id="Endpoint_Template-d1e113"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Endpoint Template</fo:marker><fo:block font-size="20.735999999999997pt">1.1. Endpoint Template</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1836 | + Endpoint Template represents the templates of all the consumable services |
1837 | + that are available across the regions. |
1838 | + </fo:block></fo:block></fo:flow></fo:page-sequence></fo:root> |
1839 | \ No newline at end of file |
1840 | |
1841 | === added file 'doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-RAX-devguide.fo.OTHER' |
1842 | --- doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-RAX-devguide.fo.OTHER 1970-01-01 00:00:00 +0000 |
1843 | +++ doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-RAX-devguide.fo.OTHER 2011-08-29 16:57:23 +0000 |
1844 | @@ -0,0 +1,12 @@ |
1845 | +<?xml version="1.0" encoding="utf-8"?><fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="CartoGothic Std" font-size="10.5pt" text-align="start" line-height="normal" font-selection-strategy="character-by-character" line-height-shift-adjustment="disregard-shifts" writing-mode="lr-tb" language="en"><fo:layout-master-set><fo:simple-page-master master-name="blank" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body display-align="center" margin-bottom="0.5in" margin-top="0.5in"/><fo:region-before region-name="xsl-region-before-blank" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-blank" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:page-sequence-master master-name="titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="titlepage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="lot"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="lot-first" page-position="first"/><fo:conditional-page-master-reference master-reference="lot-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="lot-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="front"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="front-first" page-position="first"/><fo:conditional-page-master-reference master-reference="front-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="front-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="body"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="body-first" page-position="first"/><fo:conditional-page-master-reference master-reference="body-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="body-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="back"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="back-first" page-position="first"/><fo:conditional-page-master-reference master-reference="back-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="back-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="index"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="index-first" page-position="first"/><fo:conditional-page-master-reference master-reference="index-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="index-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:simple-page-master xmlns:exslt="http://exslt.org/common" master-name="cloudpage-first" page-width="8.5in" page-height="11in" margin-top="0.0in" margin-bottom="0.0in" margin-left="0.0in" margin-right="0.0in"><fo:region-body margin-bottom="0.0in" margin-top="0.0in" column-gap="0pt" column-count="1"/><fo:region-before extent="11.0in" display-align="before" background-image="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/cloud/cover.svg)" background-repeat="no-repeat" background-position-horizontal="0%" background-position-vertical="0%"/></fo:simple-page-master><fo:page-sequence-master xmlns:exslt="http://exslt.org/common" master-name="cloud-titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="cloudpage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master></fo:layout-master-set><fo:declarations><x:xmpmeta xmlns:x="adobe:ns:meta/"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xapRights="http://ns.adobe.com/xap/1.0/rights/" rdf:about=""><xapRights:Marked>True</xapRights:Marked></rdf:Description><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" rdf:about=""><dc:rights><rdf:Alt><rdf:li xml:lang="x-default">Copyright © 2010, 2011 OpenStack All rights reserved.</rdf:li></rdf:Alt></dc:rights><dc:title>Keystone Developer Guide - Rackspace Extensions</dc:title><dc:creator/></rdf:Description><rdf:Description xmlns:pdf="http://ns.adobe.com/pdf/1.3/" rdf:about=""/><rdf:Description xmlns:xmp="http://ns.adobe.com/xap/1.0/" rdf:about=""><xmp:CreatorTool>Cloud API Docs Plugin</xmp:CreatorTool></rdf:Description></rdf:RDF></x:xmpmeta></fo:declarations><fo:bookmark-tree><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="identity-RAX-devguide" starting-state="hide"><fo:bookmark-title>Keystone Developer Guide - Rackspace Extensions</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="toc...identity-RAX-devguide"><fo:bookmark-title>Table of Contents</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62" starting-state="hide"><fo:bookmark-title>1. Overview</fo:bookmark-title></fo:bookmark></fo:bookmark-tree><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="identity-RAX-devguide"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62"/><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="cloud-titlepage" language="en" format="i" initial-page-number="1" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body"><fo:block id="identity-RAX-devguide"><fo:block><fo:block><fo:block break-after="page"/><fo:block font-size="14.4pt" font-weight="bold" font-family="CartoGothic Std"><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block><fo:block font-size="10pt"><fo:block> </fo:block></fo:block><fo:block font-size="10pt" space-before="0.5em">API v2.0 (2011-08-17)</fo:block><fo:block font-size="10pt">Copyright © 2010, 2011 OpenStack All rights reserved.</fo:block><fo:block font-size="10pt"><fo:block xmlns:exslt="http://exslt.org/common" start-indent="0.0in" end-indent="0.0in"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="center"/><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">To Be Done: This document describes rackspace specific extensions on |
1846 | + keystone.</fo:block></fo:block></fo:block><fo:block font-size="8pt" space-before="1.0em"><fo:block xmlns:exslt="http://exslt.org/common" id="d365e17"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1847 | + Licensed under the Apache License, Version 2.0 (the "License"); |
1848 | + you may not use this file except in compliance with the License. |
1849 | + You may obtain a copy of the License at |
1850 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:basic-link external-destination="http://www.apache.org/licenses/LICENSE-2.0"><fo:inline>http://www.apache.org/licenses/LICENSE-2.0</fo:inline></fo:basic-link></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1851 | + Unless required by applicable law or agreed to in writing, software |
1852 | + distributed under the License is distributed on an "AS IS" BASIS, |
1853 | + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
1854 | + See the License for the specific language governing permissions and |
1855 | + limitations under the License. |
1856 | + </fo:block></fo:block></fo:block></fo:block><fo:block break-after="page"/></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="lot" language="en" format="i" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="toc...identity-RAX-devguide"><fo:block><fo:block><fo:block space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="0pt" start-indent="0pt" font-size="20.736pt" font-weight="bold" color="rgb(196,0,34)" font-family="CartoGothic Std">Table of Contents</fo:block></fo:block></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Overview-d1e62">1. Overview</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Overview-d1e62"><fo:page-number-citation ref-id="Overview-d1e62"/></fo:basic-link></fo:inline></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="body" language="en" format="1" initial-page-number="1" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide - Rackspace Extensions </fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 17, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="Overview-d1e62"><fo:block font-family="CartoGothic Std"><fo:block margin-left="0pt"><fo:block font-size="24.8832pt" font-weight="bold"><fo:block keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="start" start-indent="0pt" font-family="CartoGothic Std" color="rgb(196,0,34)" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2">1. Overview</fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">TBD</fo:block></fo:flow></fo:page-sequence></fo:root> |
1857 | \ No newline at end of file |
1858 | |
1859 | === added file 'doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-client-devguide.fo.OTHER' |
1860 | --- doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-client-devguide.fo.OTHER 1970-01-01 00:00:00 +0000 |
1861 | +++ doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-client-devguide.fo.OTHER 2011-08-29 16:57:23 +0000 |
1862 | @@ -0,0 +1,1297 @@ |
1863 | +<?xml version="1.0" encoding="utf-8"?><fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="CartoGothic Std" font-size="10.5pt" text-align="start" line-height="normal" font-selection-strategy="character-by-character" line-height-shift-adjustment="disregard-shifts" writing-mode="lr-tb" language="en"><fo:layout-master-set><fo:simple-page-master master-name="blank" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body display-align="center" margin-bottom="0.5in" margin-top="0.5in"/><fo:region-before region-name="xsl-region-before-blank" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-blank" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:page-sequence-master master-name="titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="titlepage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="lot"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="lot-first" page-position="first"/><fo:conditional-page-master-reference master-reference="lot-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="lot-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="front"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="front-first" page-position="first"/><fo:conditional-page-master-reference master-reference="front-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="front-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="body"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="body-first" page-position="first"/><fo:conditional-page-master-reference master-reference="body-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="body-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="back"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="back-first" page-position="first"/><fo:conditional-page-master-reference master-reference="back-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="back-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="index"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="index-first" page-position="first"/><fo:conditional-page-master-reference master-reference="index-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="index-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:simple-page-master xmlns:exslt="http://exslt.org/common" master-name="cloudpage-first" page-width="8.5in" page-height="11in" margin-top="0.0in" margin-bottom="0.0in" margin-left="0.0in" margin-right="0.0in"><fo:region-body margin-bottom="0.0in" margin-top="0.0in" column-gap="0pt" column-count="1"/><fo:region-before extent="11.0in" display-align="before" background-image="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/cloud/cover.svg)" background-repeat="no-repeat" background-position-horizontal="0%" background-position-vertical="0%"/></fo:simple-page-master><fo:page-sequence-master xmlns:exslt="http://exslt.org/common" master-name="cloud-titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="cloudpage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master></fo:layout-master-set><fo:declarations><x:xmpmeta xmlns:x="adobe:ns:meta/"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xapRights="http://ns.adobe.com/xap/1.0/rights/" rdf:about=""><xapRights:Marked>True</xapRights:Marked></rdf:Description><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" rdf:about=""><dc:rights><rdf:Alt><rdf:li xml:lang="x-default">Copyright © 2010, 2011 OpenStack All rights reserved.</rdf:li></rdf:Alt></dc:rights><dc:title>Keystone Developer Guide</dc:title><dc:creator/></rdf:Description><rdf:Description xmlns:pdf="http://ns.adobe.com/pdf/1.3/" rdf:about=""/><rdf:Description xmlns:xmp="http://ns.adobe.com/xap/1.0/" rdf:about=""><xmp:CreatorTool>Cloud API Docs Plugin</xmp:CreatorTool></rdf:Description></rdf:RDF></x:xmpmeta></fo:declarations><fo:bookmark-tree><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Book-100001" starting-state="hide"><fo:bookmark-title>Keystone Developer Guide</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="toc...Book-100001"><fo:bookmark-title>Table of Contents</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62" starting-state="hide"><fo:bookmark-title>1. Overview</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Concepts-d1e74" starting-state="hide"><fo:bookmark-title>2. Concepts</fo:bookmark-title><fo:bookmark internal-destination="User-d1e103" starting-state="hide"><fo:bookmark-title>2.1. User</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Credentials-d1e103b" starting-state="hide"><fo:bookmark-title>2.2. Credentials</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Authentication-d1e103a" starting-state="hide"><fo:bookmark-title>2.3. Authentication</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Token-d1e82" starting-state="hide"><fo:bookmark-title>2.4. Token</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Tenant-d1e94" starting-state="hide"><fo:bookmark-title>2.5. Tenant</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Service-d1e104" starting-state="hide"><fo:bookmark-title>2.6. Service</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Endpoint-d1e122" starting-state="hide"><fo:bookmark-title>2.7. Endpoint</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Role-d1e131" starting-state="hide"><fo:bookmark-title>2.8. Role</fo:bookmark-title></fo:bookmark></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="General_API_Information-d1e141" starting-state="hide"><fo:bookmark-title>3. General API Information</fo:bookmark-title><fo:bookmark internal-destination="Request_Response_Types-d1e149" starting-state="hide"><fo:bookmark-title>3.1. Request/Response Types</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Content_Compression-d1e262" starting-state="hide"><fo:bookmark-title>3.2. Content Compression</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Paginated_Collections-d1e325" starting-state="hide"><fo:bookmark-title>3.3. Paginated Collections</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Versions-d1e472" starting-state="hide"><fo:bookmark-title>3.4. Versions</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Extensions-d1e688" starting-state="hide"><fo:bookmark-title>3.5. Extensions</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Faults-d1e908" starting-state="hide"><fo:bookmark-title>3.6. Faults</fo:bookmark-title></fo:bookmark></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Service_API_Client_Operations_-d1e1110" starting-state="hide"><fo:bookmark-title>4. Service API (Client Operations)</fo:bookmark-title><fo:bookmark internal-destination="Overview-d1e1115" starting-state="hide"><fo:bookmark-title>4.1. Overview</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Core_Service_API-d1e1124" starting-state="hide"><fo:bookmark-title>4.2. Core Service API</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Available-operations-d100001" starting-state="hide"><fo:bookmark-title>4.3. Available Operations</fo:bookmark-title><fo:bookmark internal-destination="Authenticate-d1e1166" starting-state="hide"><fo:bookmark-title>4.3.1. Authenticate</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Get_Tenants-d1e1264" starting-state="hide"><fo:bookmark-title>4.3.2. Get Tenants</fo:bookmark-title></fo:bookmark></fo:bookmark></fo:bookmark></fo:bookmark-tree><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Book-100001"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Concepts-d1e74"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="User-d1e103"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Credentials-d1e103b"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Authentication-d1e103a"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Token-d1e82"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Tenant-d1e94"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Service-d1e104"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Endpoint-d1e122"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Role-d1e131"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="General_API_Information-d1e141"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Request_Response_Types-d1e149"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Content_Compression-d1e262"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Paginated_Collections-d1e325"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Versions-d1e472"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Extensions-d1e688"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Faults-d1e908"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Service_API_Client_Operations_-d1e1110"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e1115"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Core_Service_API-d1e1124"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Available-operations-d100001"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Authenticate-d1e1166"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Get_Tenants-d1e1264"/><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="cloud-titlepage" language="en" format="i" initial-page-number="1" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body"><fo:block id="Book-100001"><fo:block><fo:block><fo:block break-after="page"/><fo:block font-size="14.4pt" font-weight="bold" font-family="CartoGothic Std"><fo:block>Keystone Developer Guide</fo:block></fo:block><fo:block font-size="10pt"><fo:block> </fo:block></fo:block><fo:block font-size="10pt" space-before="0.5em">API v2.0 (2011-08-23)</fo:block><fo:block font-size="10pt">Copyright © 2010, 2011 OpenStack All rights reserved.</fo:block><fo:block font-size="10pt"><fo:block xmlns:exslt="http://exslt.org/common" start-indent="0.0in" end-indent="0.0in"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="center"/><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">This document is intended for client developers who want to consume any OpenStack |
1864 | + service that uses the Keystone Identity Service for authentication.</fo:block></fo:block></fo:block><fo:block font-size="8pt" space-before="1.0em"><fo:block xmlns:exslt="http://exslt.org/common" id="d149e17"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1865 | + Licensed under the Apache License, Version 2.0 (the "License"); |
1866 | + you may not use this file except in compliance with the License. |
1867 | + You may obtain a copy of the License at |
1868 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:basic-link external-destination="http://www.apache.org/licenses/LICENSE-2.0"><fo:inline>http://www.apache.org/licenses/LICENSE-2.0</fo:inline></fo:basic-link></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1869 | + Unless required by applicable law or agreed to in writing, software |
1870 | + distributed under the License is distributed on an "AS IS" BASIS, |
1871 | + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
1872 | + See the License for the specific language governing permissions and |
1873 | + limitations under the License. |
1874 | + </fo:block></fo:block></fo:block></fo:block><fo:block break-after="page"/></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="lot" language="en" format="i" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="toc...Book-100001"><fo:block><fo:block><fo:block space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="0pt" start-indent="0pt" font-size="20.736pt" font-weight="bold" color="rgb(196,0,34)" font-family="CartoGothic Std">Table of Contents</fo:block></fo:block></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Overview-d1e62">1. Overview</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Overview-d1e62"><fo:page-number-citation ref-id="Overview-d1e62"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Concepts-d1e74">2. Concepts</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Concepts-d1e74"><fo:page-number-citation ref-id="Concepts-d1e74"/></fo:basic-link></fo:inline></fo:block><fo:block id="toc.Book-100001.Concepts-d1e74" margin-left="24pt"><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="User-d1e103">2.1. User</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="User-d1e103"><fo:page-number-citation ref-id="User-d1e103"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Credentials-d1e103b">2.2. Credentials</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Credentials-d1e103b"><fo:page-number-citation ref-id="Credentials-d1e103b"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Authentication-d1e103a">2.3. Authentication</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Authentication-d1e103a"><fo:page-number-citation ref-id="Authentication-d1e103a"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Token-d1e82">2.4. Token</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Token-d1e82"><fo:page-number-citation ref-id="Token-d1e82"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Tenant-d1e94">2.5. Tenant</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Tenant-d1e94"><fo:page-number-citation ref-id="Tenant-d1e94"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Service-d1e104">2.6. Service</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Service-d1e104"><fo:page-number-citation ref-id="Service-d1e104"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Endpoint-d1e122">2.7. Endpoint</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Endpoint-d1e122"><fo:page-number-citation ref-id="Endpoint-d1e122"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Role-d1e131">2.8. Role</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Role-d1e131"><fo:page-number-citation ref-id="Role-d1e131"/></fo:basic-link></fo:inline></fo:block></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="General_API_Information-d1e141">3. General API Information</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="General_API_Information-d1e141"><fo:page-number-citation ref-id="General_API_Information-d1e141"/></fo:basic-link></fo:inline></fo:block><fo:block id="toc.Book-100001.General_API_Information-d1e141" margin-left="24pt"><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Request_Response_Types-d1e149">3.1. Request/Response Types</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Request_Response_Types-d1e149"><fo:page-number-citation ref-id="Request_Response_Types-d1e149"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Content_Compression-d1e262">3.2. Content Compression</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Content_Compression-d1e262"><fo:page-number-citation ref-id="Content_Compression-d1e262"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Paginated_Collections-d1e325">3.3. Paginated Collections</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Paginated_Collections-d1e325"><fo:page-number-citation ref-id="Paginated_Collections-d1e325"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Versions-d1e472">3.4. Versions</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Versions-d1e472"><fo:page-number-citation ref-id="Versions-d1e472"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Extensions-d1e688">3.5. Extensions</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Extensions-d1e688"><fo:page-number-citation ref-id="Extensions-d1e688"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Faults-d1e908">3.6. Faults</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Faults-d1e908"><fo:page-number-citation ref-id="Faults-d1e908"/></fo:basic-link></fo:inline></fo:block></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Service_API_Client_Operations_-d1e1110">4. Service API (Client Operations)</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Service_API_Client_Operations_-d1e1110"><fo:page-number-citation ref-id="Service_API_Client_Operations_-d1e1110"/></fo:basic-link></fo:inline></fo:block><fo:block id="toc.Book-100001.Service_API_Client_Operations_-d1e1110" margin-left="24pt"><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Overview-d1e1115">4.1. Overview</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Overview-d1e1115"><fo:page-number-citation ref-id="Overview-d1e1115"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Core_Service_API-d1e1124">4.2. Core Service API</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Core_Service_API-d1e1124"><fo:page-number-citation ref-id="Core_Service_API-d1e1124"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Available-operations-d100001">4.3. Available Operations</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Available-operations-d100001"><fo:page-number-citation ref-id="Available-operations-d100001"/></fo:basic-link></fo:inline></fo:block><fo:block id="toc.Book-100001.Available-operations-d100001" margin-left="24pt"><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Authenticate-d1e1166">4.3.1. Authenticate</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Authenticate-d1e1166"><fo:page-number-citation ref-id="Authenticate-d1e1166"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="Get_Tenants-d1e1264">4.3.2. Get Tenants</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="Get_Tenants-d1e1264"><fo:page-number-citation ref-id="Get_Tenants-d1e1264"/></fo:basic-link></fo:inline></fo:block></fo:block></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="lot" language="en" format="i" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="lot...table...Book-100001"><fo:block><fo:block><fo:block space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="0pt" start-indent="0pt" font-size="20.736pt" font-weight="bold" color="rgb(196,0,34)" font-family="CartoGothic Std">List of Tables</fo:block></fo:block></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e76">3.1. Response Types</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e76"><fo:page-number-citation ref-id="d149e76"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e108">3.2. Compression Headers</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e108"><fo:page-number-citation ref-id="d149e108"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e337">3.3. Fault Types</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e337"><fo:page-number-citation ref-id="d149e337"/></fo:basic-link></fo:inline></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="lot" language="en" format="i" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="lot...example...Book-100001"><fo:block><fo:block><fo:block space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="0pt" start-indent="0pt" font-size="20.736pt" font-weight="bold" color="rgb(196,0,34)" font-family="CartoGothic Std">List of Examples</fo:block></fo:block></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e95">3.1. JSON Request with Headers</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e95"><fo:page-number-citation ref-id="d149e95"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e99">3.2. XML Response with Headers</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e99"><fo:page-number-citation ref-id="d149e99"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e143">3.3. Tenant Collection, First Page: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e143"><fo:page-number-citation ref-id="d149e143"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e146">3.4. Tenant Collection, First Page: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e146"><fo:page-number-citation ref-id="d149e146"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e149">3.5. Tenant Collection, Second Page: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e149"><fo:page-number-citation ref-id="d149e149"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e152">3.6. Tenant Collection, Second Page: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e152"><fo:page-number-citation ref-id="d149e152"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e155">3.7. Tenant Collection, Last Page: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e155"><fo:page-number-citation ref-id="d149e155"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e158">3.8. Tenant Collection, Last Page: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e158"><fo:page-number-citation ref-id="d149e158"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e164">3.9. Paginated Roles in a User: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e164"><fo:page-number-citation ref-id="d149e164"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e167">3.10. Paginated Roles in an User: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e167"><fo:page-number-citation ref-id="d149e167"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e175">3.11. Request with MIME type versioning</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e175"><fo:page-number-citation ref-id="d149e175"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e178">3.12. Request with URI versioning</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e178"><fo:page-number-citation ref-id="d149e178"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e185">3.13. Multiple Choices Response: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e185"><fo:page-number-citation ref-id="d149e185"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e188">3.14. Multiple Choices Response: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e188"><fo:page-number-citation ref-id="d149e188"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e196">3.15. Versions List Request</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e196"><fo:page-number-citation ref-id="d149e196"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e207">3.16. Versions List Response: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e207"><fo:page-number-citation ref-id="d149e207"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e210">3.17. Versions List Response: Atom</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e210"><fo:page-number-citation ref-id="d149e210"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e213">3.18. Versions List Response: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e213"><fo:page-number-citation ref-id="d149e213"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e219">3.19. Version Details Request</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e219"><fo:page-number-citation ref-id="d149e219"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e230">3.20. Version Details Response: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e230"><fo:page-number-citation ref-id="d149e230"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e233">3.21. Version Details Response: Atom</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e233"><fo:page-number-citation ref-id="d149e233"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e236">3.22. Version Details Response: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e236"><fo:page-number-citation ref-id="d149e236"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e269">3.23. Extensions Response: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e269"><fo:page-number-citation ref-id="d149e269"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e272">3.24. Extensions Response: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e272"><fo:page-number-citation ref-id="d149e272"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e299">3.25. Extension Response: xml</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e299"><fo:page-number-citation ref-id="d149e299"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e302">3.26. Extensions Response: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e302"><fo:page-number-citation ref-id="d149e302"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="UserEXT">3.27. Extended User Response: XML</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="UserEXT"><fo:page-number-citation ref-id="UserEXT"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="UserEXTJ">3.28. Extended User Response: JSON</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="UserEXTJ"><fo:page-number-citation ref-id="UserEXTJ"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e322">3.29. XML Fault Response</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e322"><fo:page-number-citation ref-id="d149e322"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e325">3.30. JSON Fault Response</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e325"><fo:page-number-citation ref-id="d149e325"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e330">3.31. XML Not Found Fault</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e330"><fo:page-number-citation ref-id="d149e330"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e333">3.32. JSON Not Found Fault</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e333"><fo:page-number-citation ref-id="d149e333"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e449">4.1. XML Auth Request</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e449"><fo:page-number-citation ref-id="d149e449"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e452">4.2. JSON Auth Request</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e452"><fo:page-number-citation ref-id="d149e452"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e455">4.3. XML Auth Response</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e455"><fo:page-number-citation ref-id="d149e455"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e458">4.4. JSON Auth Response</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e458"><fo:page-number-citation ref-id="d149e458"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e486">4.5. Tenants Request with Auth Token</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e486"><fo:page-number-citation ref-id="d149e486"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e490">4.6. JSON Tenants Response</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e490"><fo:page-number-citation ref-id="d149e490"/></fo:basic-link></fo:inline></fo:block><fo:block text-align-last="justify" text-align="start" end-indent="24pt" last-line-end-indent="-24pt"><fo:inline keep-with-next.within-line="always"><fo:basic-link internal-destination="d149e493">4.7. XML Tenants Response</fo:basic-link></fo:inline><fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" leader-pattern-width="3pt" leader-alignment="reference-area" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="d149e493"><fo:page-number-citation ref-id="d149e493"/></fo:basic-link></fo:inline></fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="body" language="en" format="1" initial-page-number="1" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="Overview-d1e62"><fo:block font-family="CartoGothic Std"><fo:block margin-left="0pt"><fo:block font-size="24.8832pt" font-weight="bold"><fo:block keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="start" start-indent="0pt" font-family="CartoGothic Std" color="rgb(196,0,34)" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2">1. Overview</fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The Keystone Identity Service allows clients to obtain tokens that can be used to access |
1875 | + OpenStack cloud services. This document is intended for software developers interested in |
1876 | + developing applications that utilize the Keystone Identity Service API for authentication. |
1877 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">This Guide assumes the reader is familiar with RESTful web services, HTTP/1.1, and JSON |
1878 | + and/or XML serialization formats. </fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="body" language="en" format="1" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="Concepts-d1e74"><fo:block font-family="CartoGothic Std"><fo:block margin-left="0pt"><fo:block font-size="24.8832pt" font-weight="bold"><fo:block keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="start" start-indent="0pt" font-family="CartoGothic Std" color="rgb(196,0,34)" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2">2. Concepts</fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1879 | + The Keystone Identity Service has several key concepts which are |
1880 | + important to understand: |
1881 | + </fo:block><fo:block id="User-d1e103"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">User</fo:marker><fo:block font-size="20.735999999999997pt">2.1. User</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1882 | + A digital representation of a person, system, or service who uses OpenStack cloud services. |
1883 | + Keystone authentication services will validate that incoming request are being made by the user |
1884 | + who claims to be making the call. Users have a login and may be assigned tokens to access |
1885 | + resources. Users may be directly assigned to a particular tenant and |
1886 | + behave as if they are contained in that tenant. |
1887 | + </fo:block></fo:block><fo:block id="Credentials-d1e103b"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Credentials</fo:marker><fo:block font-size="20.735999999999997pt">2.2. Credentials</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1888 | + Data that belongs to, is owned by, and generally only known by a user that the user can present |
1889 | + to prove they are who they are (since nobody else should know that data). |
1890 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Examples are: |
1891 | + <fo:list-block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" space-after.optimum="1em" space-after.minimum="0.8em" space-after.maximum="1.2em" provisional-label-separation="0.2em" provisional-distance-between-starts="1.0em" id="d149e36"><fo:list-item space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" id="d149e37"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block><fo:block>a matching username and password</fo:block></fo:block></fo:list-item-body></fo:list-item><fo:list-item space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" id="d149e39"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block><fo:block>a matching username and API key</fo:block></fo:block></fo:list-item-body></fo:list-item><fo:list-item space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" id="d149e41"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block><fo:block>yourself and a driver's license with a picture of you</fo:block></fo:block></fo:list-item-body></fo:list-item><fo:list-item space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" id="d149e43"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block><fo:block>a token that was issued to you that nobody else knows of</fo:block></fo:block></fo:list-item-body></fo:list-item></fo:list-block> |
1892 | + </fo:block></fo:block><fo:block id="Authentication-d1e103a"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Authentication</fo:marker><fo:block font-size="20.735999999999997pt">2.3. Authentication</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1893 | + In the context of Keystone, authentication is the act of confirming the identity of a |
1894 | + user or the truth of a claim. |
1895 | + Keystone will confirm that incoming request are being made by the user |
1896 | + who claims to be making the call by validating a set of claims that the user is making. |
1897 | + These claims are intially in the form of a set of credentials (username & password, |
1898 | + or username and API key). After initial confirmation, Keystone will issue the user a token |
1899 | + which the user can then provide to demonstrate that their identity has been authenticated |
1900 | + when making subsequent requests. |
1901 | + </fo:block></fo:block><fo:block id="Token-d1e82"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Token</fo:marker><fo:block font-size="20.735999999999997pt">2.4. Token</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1902 | + A token is an arbitrary bit of text that is used to access |
1903 | + resources. Each token has a scope which describes which |
1904 | + resources are accessible with it. A token may be |
1905 | + revoked at anytime and is valid for a finite duration. |
1906 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1907 | + While Keystone supports token-based authentication in this release, |
1908 | + the intention is for it to support additional protocols in the |
1909 | + future. The intent is for it to be an integration service foremost, and not |
1910 | + a aspire to be a full-fledged identity store and management solution. |
1911 | + </fo:block></fo:block><fo:block id="Tenant-d1e94"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Tenant</fo:marker><fo:block font-size="20.735999999999997pt">2.5. Tenant</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1912 | + A container used to group or isolate resources and/or identity |
1913 | + objects. Depending on the service operator, a tenant may map to a customer, |
1914 | + account, organization, or project. |
1915 | + </fo:block></fo:block><fo:block id="Service-d1e104"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Service</fo:marker><fo:block font-size="20.735999999999997pt">2.6. Service</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1916 | + An OpenStack service (such as Nova, Swift, or Glance). A service provides |
1917 | + onr or more endpoints through which users can access resources and perform |
1918 | + (presumably useful) operations. |
1919 | + </fo:block></fo:block><fo:block id="Endpoint-d1e122"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Endpoint</fo:marker><fo:block font-size="20.735999999999997pt">2.7. Endpoint</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1920 | + An network-accessible address, usually described by URL, where a service may be accessed. |
1921 | + </fo:block></fo:block><fo:block id="Role-d1e131"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Role</fo:marker><fo:block font-size="20.735999999999997pt">2.8. Role</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> A personality that a user assumes when performing a specific set of operations. |
1922 | + A role includes a set of right and priviledges. A user assuming that role inherits |
1923 | + those rights and priviledges. |
1924 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
1925 | + In Keystone, a token that is issued to a user includes the list of roles that user |
1926 | + can assume. Services that are being called by that user determine how they interpret the set |
1927 | + of roles a user has and which operations or resources each roles grants access to. |
1928 | + </fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="body" language="en" format="1" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="General_API_Information-d1e141"><fo:block font-family="CartoGothic Std"><fo:block margin-left="0pt"><fo:block font-size="24.8832pt" font-weight="bold"><fo:block keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="start" start-indent="0pt" font-family="CartoGothic Std" color="rgb(196,0,34)" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2">3. General API Information</fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The Keystone API is implemented using a RESTful web service interface. All requests to |
1929 | + authenticate and operate against the Keystone API should be performed using SSL over HTTP |
1930 | + (HTTPS) on TCP port 443.</fo:block><fo:block id="Request_Response_Types-d1e149"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Request/Response Types</fo:marker><fo:block font-size="20.735999999999997pt">3.1. Request/Response Types</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> The Keystone API supports both the JSON and XML data serialization formats. The request |
1931 | + format is specified using the <fo:inline font-family="monospace">Content-Type</fo:inline> header and is required for |
1932 | + operations that have a request body. The response format can be specified in requests using |
1933 | + either the <fo:inline font-family="monospace">Accept</fo:inline> header or adding an <fo:inline font-family="monospace">.xml</fo:inline> or <fo:inline font-family="monospace">.json</fo:inline> |
1934 | + extension to the request URI. Note that it is possible for a response to be serialized using |
1935 | + a format different from the request (see example below). If no response format is specified, |
1936 | + JSON is the default. If conflicting formats are specified using both an <fo:inline font-family="monospace">Accept</fo:inline> |
1937 | + header and a query extension, the query extension takes precedence.</fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e76"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Table 3.1. Response Types</fo:block><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
1938 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Format</fo:block></fo:table-cell> |
1939 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Accept Header</fo:block></fo:table-cell> |
1940 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Query Extension</fo:block></fo:table-cell> |
1941 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block font-weight="bold">Default</fo:block></fo:table-cell> |
1942 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
1943 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>JSON</fo:block></fo:table-cell> |
1944 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>application/json</fo:block></fo:table-cell> |
1945 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>.json</fo:block></fo:table-cell> |
1946 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block>Yes</fo:block></fo:table-cell> |
1947 | + </fo:table-row><fo:table-row> |
1948 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>XML</fo:block></fo:table-cell> |
1949 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>application/xml</fo:block></fo:table-cell> |
1950 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>.xml</fo:block></fo:table-cell> |
1951 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none"><fo:block>No</fo:block></fo:table-cell> |
1952 | + </fo:table-row></fo:table-body></fo:table></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e95"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.1. JSON Request with Headers</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e97"> |
1953 | +POST /v2.0/tokens HTTP/1.1 |
1954 | +Host: identity.api.openstack.org |
1955 | +Content-Type: application/json |
1956 | +Accept: application/xml |
1957 | +</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e98"> |
1958 | +{ |
1959 | + "auth": { |
1960 | + "passwordCredentials": { |
1961 | + "username": "test_user", |
1962 | + "password": "mypass" |
1963 | + }, |
1964 | + "tenantId": "1234" |
1965 | + } |
1966 | +} |
1967 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e99"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.2. XML Response with Headers</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e101"> |
1968 | +HTTP/1.1 200 OKAY |
1969 | +Date: Mon, 12 Nov 2010 15:55:01 GMT |
1970 | +Content-Length: |
1971 | +Content-Type: application/xml; charset=UTF-8 |
1972 | +</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e102"> |
1973 | +<?xml version="1.0" encoding="UTF-8"?> |
1974 | +<auth xmlns="http://docs.openstack.org/identity/api/v2.0"> |
1975 | + <token expires="2010-11-01T03:32:15-05:00" |
1976 | + id="ab48a9efdfedb23ty3494"/> |
1977 | + <serviceCatalog> |
1978 | + <service type="compute" name="Computers in the Cloud"> |
1979 | + <endpoint |
1980 | + region="North" |
1981 | + tenantId="1234" |
1982 | + publicURL="https://north.compute.public.com/v2.0/1234" |
1983 | + internalURL="https://north.compute.internal.com/v2.0/1234"> |
1984 | + <version |
1985 | + id="2.0" |
1986 | + info="https://north.compute.public.com/v2.0/" |
1987 | + list="https://north.compute.public.com/" /> |
1988 | + </endpoint> |
1989 | + <endpoint |
1990 | + region="South" |
1991 | + tenantId="3456" |
1992 | + publicURL="https://south.compute.public.com/v2.0/3456" |
1993 | + internalURL="https://south.compute.internal.com/v2.0/3456"> |
1994 | + <version |
1995 | + id="2.0" |
1996 | + info="https://south.compute.public.com/v2.0/" |
1997 | + list="https://south.compute.public.com/" /> |
1998 | + </endpoint> |
1999 | + </service> |
2000 | + <service type="object-store" name="HTTP Object Store"> |
2001 | + <endpoint |
2002 | + region="North" |
2003 | + tenantId="1234" |
2004 | + publicURL="https://north.object-store.public.com/v1/1234" |
2005 | + internalURL="https://north.object-store.internal.com/v1/1234"> |
2006 | + <version |
2007 | + id="1" |
2008 | + info="https://north.object-store.public.com/v1/" |
2009 | + list="https://north.object-store.public.com/" /> |
2010 | + </endpoint> |
2011 | + <endpoint |
2012 | + region="South" |
2013 | + tenantId="3456" |
2014 | + publicURL="https://south.object-store.public.com/v2.0/3456" |
2015 | + internalURL="https://south.object-store.internal.com/v2.0/3456"> |
2016 | + <version |
2017 | + id="2.0" |
2018 | + info="https://south.object-store.public.com/v1/" |
2019 | + list="https://south.object-store.public.com/" /> |
2020 | + </endpoint> |
2021 | + </service> |
2022 | + <service type="dns" name="DNS-as-a-Service"> |
2023 | + <endpoint |
2024 | + publicURL="https://dns.public.com/v2.0/blah-blah"> |
2025 | + <version |
2026 | + id="2.0" |
2027 | + info="https://dns.public.com/v2.0/" |
2028 | + list="https://dns.public.com/" /> |
2029 | + </endpoint> |
2030 | + </service> |
2031 | + </serviceCatalog> |
2032 | +</auth> |
2033 | + |
2034 | +</fo:block></fo:block></fo:block></fo:block><fo:block id="Content_Compression-d1e262"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Content Compression</fo:marker><fo:block font-size="20.735999999999997pt">3.2. Content Compression</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Request and response body data my be encoded with gzip compression in order to |
2035 | + accelerate interactive performance of API calls and responses. This is controlled using the |
2036 | + <fo:inline font-family="monospace">Accept-Encoding</fo:inline> header on the request from the client and indicated by the |
2037 | + <fo:inline font-family="monospace">Content-Encoding</fo:inline> header in the server response. Unless the header is |
2038 | + explicitly set, encoding defaults to disabled.</fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e108"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Table 3.2. Compression Headers</fo:block><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
2039 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Header Type</fo:block></fo:table-cell> |
2040 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Name</fo:block></fo:table-cell> |
2041 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block font-weight="bold">Value</fo:block></fo:table-cell> |
2042 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
2043 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>HTTP/1.1 Request</fo:block></fo:table-cell> |
2044 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>Accept-Encoding</fo:block></fo:table-cell> |
2045 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block>gzip</fo:block></fo:table-cell> |
2046 | + </fo:table-row><fo:table-row> |
2047 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>HTTP/1.1 Response</fo:block></fo:table-cell> |
2048 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>Content-Encoding</fo:block></fo:table-cell> |
2049 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none"><fo:block>gzip</fo:block></fo:table-cell> |
2050 | + </fo:table-row></fo:table-body></fo:table></fo:block></fo:block><fo:block id="Paginated_Collections-d1e325"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Paginated Collections</fo:marker><fo:block font-size="20.735999999999997pt">3.3. Paginated Collections</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2051 | + To reduce load on the service, list operations will |
2052 | + return a maximum number of items at a time. The |
2053 | + maximum number of items returned is determined by the |
2054 | + Identity provider. To navigate the collection, the |
2055 | + parameters <fo:inline font-family="monospace" font-style="italic">limit</fo:inline> and |
2056 | + <fo:inline font-family="monospace" font-style="italic">marker</fo:inline> can be set in the URI |
2057 | + (e.g.?<fo:inline font-family="monospace" font-style="italic">limit</fo:inline>=100&<fo:inline font-family="monospace" font-style="italic">marker</fo:inline>=1234). |
2058 | + The <fo:inline font-family="monospace" font-style="italic">marker</fo:inline> parameter is the ID |
2059 | + of the last item in the previous list. Items are |
2060 | + sorted by update time. When an update time is not |
2061 | + available they are sorted by ID. The |
2062 | + <fo:inline font-family="monospace" font-style="italic">limit</fo:inline> parameter sets the page |
2063 | + size. Both parameters are optional. If the client |
2064 | + requests a <fo:inline font-family="monospace" font-style="italic">limit</fo:inline> beyond that |
2065 | + which is supported by the deployment an overLimit |
2066 | + (413) fault may be thrown. A |
2067 | + marker with an invalid ID will return an itemNotFound |
2068 | + (404) fault. |
2069 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" space-after.optimum="1em" space-after.minimum="0.8em" space-after.maximum="1.2em" id="d149e136"><fo:list-block provisional-distance-between-starts="36pt + 18pt" provisional-label-separation="18pt"><fo:list-item><fo:list-item-label end-indent="label-end()"><fo:block><fo:external-graphic width="auto" height="auto" content-width="36pt" src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/note.svg)"/></fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block font-size="14pt" font-weight="bold" hyphenate="false" keep-with-next.within-column="always" color="rgb(196,0,34)" font-family="CartoGothic Std">Note</fo:block><fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2070 | + Paginated collections never return itemNotFound |
2071 | + (404) faults when the |
2072 | + collection is empty — clients should expect |
2073 | + an empty collection. |
2074 | + </fo:block></fo:block></fo:list-item-body></fo:list-item></fo:list-block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2075 | + For convenience, collections contain atom "next" and |
2076 | + "previous" links. The first page in the list will not |
2077 | + contain a "previous" link, the last page in the list |
2078 | + will not contain a "next" link. The following examples |
2079 | + illustrate three pages in a collection of tenants. The |
2080 | + first page was retrieved via a <fo:inline font-weight="bold">GET</fo:inline> to |
2081 | + http://identity.api.openstack.org/v2.0/1234/tenants?limit=1. |
2082 | + In these examples, the <fo:inline font-family="monospace" font-style="italic">limit</fo:inline> |
2083 | + parameter sets the page size to a single item. |
2084 | + Subsequent "next" and "previous" links will honor the |
2085 | + initial page size. Thus, a client may follow links to |
2086 | + traverse a paginated collection without having to |
2087 | + input the <fo:inline font-family="monospace" font-style="italic">marker</fo:inline> parameter. |
2088 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e143"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.3. Tenant Collection, First Page: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e145"> |
2089 | + <?xml version="1.0" encoding="UTF-8"?> |
2090 | +<tenants xmlns="http://docs.openstack.org/identity/api/v2.0" |
2091 | + xmlns:atom="http://www.w3.org/2005/Atom"> |
2092 | + <tenant enabled="true" id="1234" name="ACME Corp"> |
2093 | + <description>A description...</description> |
2094 | + </tenant> |
2095 | + <atom:link |
2096 | + rel="next" |
2097 | + href="http://identity.api.openstack.org/v2.0/tenants?limit=1&amp;marker=1234"/> |
2098 | +</tenants> |
2099 | + |
2100 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e146"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.4. Tenant Collection, First Page: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e148">{ |
2101 | + "tenants": { |
2102 | + "values": [ |
2103 | + { |
2104 | + "id": "1234", |
2105 | + "name": "ACME corp", |
2106 | + "description": "A description ...", |
2107 | + "enabled": true |
2108 | + } |
2109 | + ], |
2110 | + "links": [ |
2111 | + { |
2112 | + "rel": "next", |
2113 | + "href": "http://identity.api.openstack.org/v2.0/tenants?limit=1&marker=1234" |
2114 | + } |
2115 | + ] |
2116 | + } |
2117 | +} |
2118 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e149"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.5. Tenant Collection, Second Page: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e151"> |
2119 | +<?xml version="1.0" encoding="UTF-8"?> |
2120 | +<tenants xmlns="http://docs.openstack.org/identity/api/v2.0" |
2121 | + xmlns:atom="http://www.w3.org/2005/Atom"> |
2122 | + <tenant enabled="true" id="3645" name="Iron Works"> |
2123 | + <description>A description...</description> |
2124 | + </tenant> |
2125 | + <atom:link |
2126 | + rel="previous" |
2127 | + href="http://identity.api.openstack.org/v2.0/tenants?limit=1"/> |
2128 | + <atom:link |
2129 | + rel="next" |
2130 | + href="http://identity.api.openstack.org/v2.0/tenants?limit=1&amp;marker=3645"/> |
2131 | +</tenants> |
2132 | + |
2133 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e152"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.6. Tenant Collection, Second Page: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e154">{ |
2134 | + "tenants": { |
2135 | + "values": [ |
2136 | + { |
2137 | + "id": "3645", |
2138 | + "name": "Iron Works", |
2139 | + "description": "A description ...", |
2140 | + "enabled": true |
2141 | + } |
2142 | + ], |
2143 | + "links": [ |
2144 | + { |
2145 | + "rel": "next", |
2146 | + "href": "http://identity.api.openstack.org/v2.0/tenants?limit=1&marker=3645" |
2147 | + }, { |
2148 | + "rel": "previous", |
2149 | + "href": "http://identity.api.openstack.org/v2.0/tenants?limit=1" |
2150 | + } |
2151 | + ] |
2152 | + } |
2153 | +} |
2154 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e155"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.7. Tenant Collection, Last Page: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e157"> |
2155 | +<?xml version="1.0" encoding="UTF-8"?> |
2156 | +<tenants xmlns="http://docs.openstack.org/identity/api/v2.0" |
2157 | + xmlns:atom="http://www.w3.org/2005/Atom"> |
2158 | + <tenant enabled="true" id="9999" name="Bigz"> |
2159 | + <description>A description...</description> |
2160 | + </tenant> |
2161 | + <atom:link |
2162 | + rel="previous" |
2163 | + href="http://identity.api.openstack.org/v2.0/tenants?limit=1&amp;marker=1234"/> |
2164 | +</tenants> |
2165 | + |
2166 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e158"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.8. Tenant Collection, Last Page: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e160">{ |
2167 | + "tenants": { |
2168 | + "values": [ |
2169 | + { |
2170 | + "id": "9999", |
2171 | + "name": "Bigz", |
2172 | + "description": "A description ...", |
2173 | + "enabled": true |
2174 | + } |
2175 | + ], |
2176 | + "links": [ |
2177 | + { |
2178 | + "rel": "previous", |
2179 | + "href": "http://identity.api.openstack.org/v2.0/tenants?limit=1&marker=1234" |
2180 | + } |
2181 | + ] |
2182 | + } |
2183 | +} |
2184 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2185 | + In the JSON representation, paginated collections contain |
2186 | + a values property that contains the |
2187 | + items in the collections. Links are accessed via the |
2188 | + links property. The approach allows |
2189 | + for extensibility of both the collection members and of |
2190 | + the paginated collection itself. It also allows |
2191 | + collections to be embedded in other objects as illustrated |
2192 | + below. Here, a subset of grups are presented within a |
2193 | + user. Clients must follow the "next" link to continue to |
2194 | + retrive additonal groups belonging to a user. |
2195 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e164"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.9. Paginated Roles in a User: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e166"> |
2196 | +<?xml version="1.0" encoding="UTF-8"?> |
2197 | +<user xmlns="http://docs.openstack.org/identity/api/v2.0" |
2198 | + xmlns:atom="http://www.w3.org/2005/Atom" |
2199 | + enabled="true" email="john.smith@example.org" |
2200 | + username="jqsmith" id="u1000"> |
2201 | + <roles> |
2202 | + <role tenantId="1234" id="Admin"/> |
2203 | + <role tenantId="1234" id="DBUser"/> |
2204 | + <atom:link |
2205 | + rel="next" |
2206 | + href="http://identity.api.openstack.org/v2.0/tenants/1234/users/u1000/groups?marker=Super"/> |
2207 | + </roles> |
2208 | +</user> |
2209 | + |
2210 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e167"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.10. Paginated Roles in an User: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e169">{ |
2211 | + "user": { |
2212 | + "roles": { |
2213 | + "values": [ |
2214 | + { |
2215 | + "tenantId": "1234", |
2216 | + "id": "Admin" |
2217 | + }, { |
2218 | + "tenantId": "1234", |
2219 | + "id": "DBUser" |
2220 | + } |
2221 | + ], |
2222 | + "links": [ |
2223 | + { |
2224 | + "rel": "next", |
2225 | + "href": "http://identity.api.openstack.org/v2.0/tenants/1234/users/u1000/roles?marker=Super" |
2226 | + } |
2227 | + ] |
2228 | + }, |
2229 | + "id": "u1000", |
2230 | + "username": "jqsmith", |
2231 | + "email": "john.smith@example.org", |
2232 | + "enabled": true |
2233 | + } |
2234 | +} |
2235 | +</fo:block></fo:block></fo:block></fo:block><fo:block id="Versions-d1e472"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Versions</fo:marker><fo:block font-size="20.735999999999997pt">3.4. Versions</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2236 | + The OpenStack Identity API uses both a URI and a MIME |
2237 | + type versioning scheme. In the URI scheme, the first |
2238 | + element of the path contains the target version |
2239 | + identifier (e.g. https://identity.api.openstack.org/ |
2240 | + v2.0/…). The MIME type versioning scheme uses |
2241 | + HTTP content negotiation where the <fo:inline font-family="monospace">Accept</fo:inline> |
2242 | + or <fo:inline font-family="monospace">Content-Type</fo:inline> headers contains a MIME |
2243 | + type that includes the version ID as a parameter |
2244 | + (application/vnd.openstack.identity+xml;version=1.1). A |
2245 | + version MIME type is always linked to a base MIME type |
2246 | + (application/xml or application/json). If conflicting |
2247 | + versions are specified using both an HTTP header and a |
2248 | + URI, the URI takes precedence. |
2249 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e175"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.11. Request with MIME type versioning</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e177"> |
2250 | +GET /tenants HTTP/1.1 |
2251 | +Host: identity.api.openstack.org |
2252 | +Accept: application/vnd.openstack.identity+xml;version=1.1 |
2253 | +X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb |
2254 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e178"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.12. Request with URI versioning</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e180"> |
2255 | +GET /v1.1/tenants HTTP/1.1 |
2256 | +Host: identity.api.openstack.org |
2257 | +Accept: application/xml |
2258 | +X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb |
2259 | + </fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" space-after.optimum="1em" space-after.minimum="0.8em" space-after.maximum="1.2em" id="d149e181"><fo:list-block provisional-distance-between-starts="36pt + 18pt" provisional-label-separation="18pt"><fo:list-item><fo:list-item-label end-indent="label-end()"><fo:block><fo:external-graphic width="auto" height="auto" content-width="36pt" src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/note.svg)"/></fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block font-size="14pt" font-weight="bold" hyphenate="false" keep-with-next.within-column="always" color="rgb(196,0,34)" font-family="CartoGothic Std">Note</fo:block><fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2260 | + The MIME type versioning approach allows for the |
2261 | + creating of permanent links, because the version |
2262 | + scheme is not specified in the URI path: |
2263 | + https://api.identity.openstack.org/tenants/12234. |
2264 | + </fo:block></fo:block></fo:list-item-body></fo:list-item></fo:list-block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2265 | + If a request is made without a version specified in |
2266 | + the URI or via HTTP headers, then a multiple-choices |
2267 | + response (300) will follow |
2268 | + providing links and MIME types to available versions. |
2269 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e185"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.13. Multiple Choices Response: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e187"> |
2270 | +<?xml version="1.0" encoding="utf-8"?> |
2271 | +<choices |
2272 | + xmlns="http://docs.openstack.org/common/api/v2.0" |
2273 | + xmlns:atom="http://www.w3.org/2005/Atom"> |
2274 | + <version id="v1.0" status="DEPRECATED"> |
2275 | + <media-types> |
2276 | + <media-type |
2277 | + base="application/xml" |
2278 | + type="application/vnd.openstack.identity+xml;version=1.0" /> |
2279 | + <media-type |
2280 | + base="application/json" |
2281 | + type="application/vnd.openstack.identity+json;version=1.0" /> |
2282 | + </media-types> |
2283 | + <atom:link rel="self" href="http://identity.api.openstack.org/v1.0" /> |
2284 | + </version> |
2285 | + <version id="v1.1" status="CURRENT"> |
2286 | + <media-types> |
2287 | + <media-type |
2288 | + base="application/xml" |
2289 | + type="application/vnd.openstack.identity+xml;version=1.1" /> |
2290 | + <media-type |
2291 | + base="application/json" |
2292 | + type="application/vnd.openstack.identity+json;version=1.1" /> |
2293 | + </media-types> |
2294 | + <atom:link rel="self" href="http://identity.api.openstack.org/v1.1" /> |
2295 | + </version> |
2296 | + <version id="v2.0" status="BETA"> |
2297 | + <media-types> |
2298 | + <media-type |
2299 | + base="application/xml" |
2300 | + type="application/vnd.openstack.identity+xml;version=2.0" /> |
2301 | + <media-type |
2302 | + base="application/json" |
2303 | + type="application/vnd.openstack.identity+json;version=2.0" /> |
2304 | + </media-types> |
2305 | + <atom:link rel="self" href="http://identity.api.openstack.org/v2.0" /> |
2306 | + </version> |
2307 | +</choices> |
2308 | + |
2309 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e188"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.14. Multiple Choices Response: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e190">{ |
2310 | + "choices": { |
2311 | + "values": [ |
2312 | + { |
2313 | + "id": "v1.0", |
2314 | + "status": "DEPRECATED", |
2315 | + "links": [ |
2316 | + { |
2317 | + "rel": "self", |
2318 | + "href": "http://identity.api.openstack.org/v1.0" |
2319 | + } |
2320 | + ], |
2321 | + "media-types": { |
2322 | + "values": [ |
2323 | + { |
2324 | + "base": "application/xml", |
2325 | + "type": "application/vnd.openstack.identity+xml;version=1.0" |
2326 | + }, { |
2327 | + "base": "application/json", |
2328 | + "type": "application/vnd.openstack.identity+json;version=1.0" |
2329 | + } |
2330 | + ] |
2331 | + } |
2332 | + }, { |
2333 | + "id": "v1.1", |
2334 | + "status": "CURRENT", |
2335 | + "links": [ |
2336 | + { |
2337 | + "rel": "self", |
2338 | + "href": "http://identity.api.openstack.org/v1.1" |
2339 | + } |
2340 | + ], |
2341 | + "media-types": { |
2342 | + "values": [ |
2343 | + { |
2344 | + "base": "application/xml", |
2345 | + "type": "application/vnd.openstack.identity+xml;version=1.1" |
2346 | + }, { |
2347 | + "base": "application/json", |
2348 | + "type": "application/vnd.openstack.identity+json;version=1.1" |
2349 | + } |
2350 | + ] |
2351 | + } |
2352 | + }, { |
2353 | + "id": "v2.0", |
2354 | + "status": "BETA", |
2355 | + "links": [ |
2356 | + { |
2357 | + "rel": "self", |
2358 | + "href": "http://identity.api.openstack.org/v2.0" |
2359 | + } |
2360 | + ], |
2361 | + "media-types": { |
2362 | + "values": [ |
2363 | + { |
2364 | + "base": "application/xml", |
2365 | + "type": "application/vnd.openstack.identity+xml;version=2.0" |
2366 | + }, { |
2367 | + "base": "application/json", |
2368 | + "type": "application/vnd.openstack.identity+json;version=2.0" |
2369 | + } |
2370 | + ] |
2371 | + } |
2372 | + } |
2373 | + ] |
2374 | + } |
2375 | +} |
2376 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2377 | + New features and functionality that do not break |
2378 | + API-compatibility will be introduced in the current |
2379 | + version of the API as extensions (see below) and the |
2380 | + URI and MIME types will remain unchanged. Features or |
2381 | + functionality changes that would necessitate a break |
2382 | + in API-compatibility will require a new version, which |
2383 | + will result in URI and MIME type version being updated |
2384 | + accordingly. When new API versions are released, older |
2385 | + versions will be marked as |
2386 | + <fo:inline font-family="monospace">DEPRECATED</fo:inline>. Providers should work with |
2387 | + developers and partners to ensure there is adequate |
2388 | + time to migrate to the new version before deprecated |
2389 | + versions are discontinued. |
2390 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2391 | + Your application can programmatically determine |
2392 | + available API versions by performing a <fo:inline font-weight="bold">GET</fo:inline> on the |
2393 | + root URL (i.e. with the version and everything to the |
2394 | + right of it truncated) returned from the |
2395 | + authentication system. Note that an Atom |
2396 | + representation of the versions resources is supported |
2397 | + when issuing a request with the <fo:inline font-family="monospace">Accept</fo:inline> |
2398 | + header containing application/atom+xml or by adding a |
2399 | + .atom to the request URI. This allows standard Atom |
2400 | + clients to track version changes. |
2401 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e196"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.15. Versions List Request</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e198"> |
2402 | +GET HTTP/1.1 |
2403 | +Host: identity.api.openstack.org |
2404 | + </fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Normal Response Code(s):200, 203</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Error Response Code(s): badRequest |
2405 | + (400), identityFault |
2406 | + (500), |
2407 | + serviceUnavailable(503)</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2408 | + This operation does not require a request body.</fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e207"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.16. Versions List Response: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e209"> |
2409 | +<?xml version="1.0" encoding="UTF-8"?> |
2410 | + |
2411 | +<versions xmlns="http://docs.openstack.org/common/api/v1.0" |
2412 | + xmlns:atom="http://www.w3.org/2005/Atom"> |
2413 | + |
2414 | + <version id="v1.0" status="DEPRECATED" |
2415 | + updated="2009-10-09T11:30:00Z"> |
2416 | + <atom:link rel="self" |
2417 | + href="http://identity.api.openstack.org/v1.0/"/> |
2418 | + </version> |
2419 | + |
2420 | + <version id="v1.1" status="CURRENT" |
2421 | + updated="2010-12-12T18:30:02.25Z"> |
2422 | + <atom:link rel="self" |
2423 | + href="http://identity.api.openstack.org/v1.1/"/> |
2424 | + </version> |
2425 | + |
2426 | + <version id="v2.0" status="BETA" |
2427 | + updated="2011-05-27T20:22:02.25Z"> |
2428 | + <atom:link rel="self" |
2429 | + href="http://identity.api.openstack.org/v2.0/"/> |
2430 | + </version> |
2431 | + |
2432 | +</versions> |
2433 | + |
2434 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e210"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.17. Versions List Response: Atom</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e212"> |
2435 | +<?xml version="1.0" encoding="UTF-8"?> |
2436 | +<feed xmlns="http://www.w3.org/2005/Atom"> |
2437 | + <title type="text">Available API Versions</title> |
2438 | + <updated>2010-12-12T18:30:02.25Z</updated> |
2439 | + <id>http://identity.api.openstack.org/</id> |
2440 | + <author><name>OpenStack</name><uri>http://www.openstack.org/</uri></author> |
2441 | + <link rel="self" href="http://identity.api.openstack.org/"/> |
2442 | + <entry> |
2443 | + <id>http://identity.api.openstack.org/v2.0/</id> |
2444 | + <title type="text">Version v2.0</title> |
2445 | + <updated>2011-05-27T20:22:02.25Z</updated> |
2446 | + <link rel="self" href="http://identity.api.openstack.org/v2.0/"/> |
2447 | + <content type="text">Version v2.1 CURRENT (2011-05-27T20:22:02.25Z)</content> |
2448 | + </entry> |
2449 | + <entry> |
2450 | + <id>http://identity.api.openstack.org/v1.1/</id> |
2451 | + <title type="text">Version v1.1</title> |
2452 | + <updated>2010-12-12T18:30:02.25Z</updated> |
2453 | + <link rel="self" href="http://identity.api.openstack.org/v1.1/"/> |
2454 | + <content type="text">Version v1.1 CURRENT (2010-12-12T18:30:02.25Z)</content> |
2455 | + </entry> |
2456 | + <entry> |
2457 | + <id>http://identity.api.openstack.org/v1.0/</id> |
2458 | + <title type="text">Version v1.0</title> |
2459 | + <updated>2009-10-09T11:30:00Z</updated> |
2460 | + <link rel="self" href="http://identity.api.openstack.org/v1.0/"/> |
2461 | + <content type="text">Version v1.0 DEPRECATED (2009-10-09T11:30:00Z)</content> |
2462 | + </entry> |
2463 | +</feed> |
2464 | + |
2465 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e213"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.18. Versions List Response: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e215">{ |
2466 | + "versions": { |
2467 | + "values": [ |
2468 | + { |
2469 | + "id": "v1.0", |
2470 | + "status": "DEPRECATED", |
2471 | + "updated": "2009-10-09T11:30:00Z", |
2472 | + "links": [ |
2473 | + { |
2474 | + "rel": "self", |
2475 | + "href": "http://identity.api.openstack.org/v1.0/" |
2476 | + } |
2477 | + ] |
2478 | + }, { |
2479 | + "id": "v1.1", |
2480 | + "status": "CURRENT", |
2481 | + "updated": "2010-12-12T18:30:02.25Z", |
2482 | + "links": [ |
2483 | + { |
2484 | + "rel": "self", |
2485 | + "href": "http://identity.api.openstack.org/v1.1/" |
2486 | + } |
2487 | + ] |
2488 | + }, { |
2489 | + "id": "v2.0", |
2490 | + "status": "BETA", |
2491 | + "updated": "2011-05-27T20:22:02.25Z", |
2492 | + "links": [ |
2493 | + { |
2494 | + "rel": "self", |
2495 | + "href": "http://identity.api.openstack.org/v2.0/" |
2496 | + } |
2497 | + ] |
2498 | + } |
2499 | + ] |
2500 | + } |
2501 | +} |
2502 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2503 | + You can also obtain additional information about a |
2504 | + specific version by performing a <fo:inline font-weight="bold">GET</fo:inline> on the base |
2505 | + version URL |
2506 | + (e.g. https://identity.api.openstack.org/v1.1/). |
2507 | + Version request URLs should always end with a trailing |
2508 | + slash (/). If the slash is omitted, the server may |
2509 | + respond with a 302 |
2510 | + redirection request. Format extensions may be placed |
2511 | + after the slash |
2512 | + (e.g. https://identity.api.openstack.org/v1.1/.xml). Note |
2513 | + that this is a special case that does not hold true |
2514 | + for other API requests. In general, requests such as |
2515 | + /tenants.xml and /tenants/.xml are handled |
2516 | + equivalently. |
2517 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e219"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.19. Version Details Request</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e221"> |
2518 | +GET HTTP/1.1 |
2519 | +Host: identity.api.openstack.org/v1.1/ |
2520 | + </fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Normal Response Code(s):200, 203</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Error Response Code(s): badRequest |
2521 | + (400), identityFault |
2522 | + (500), |
2523 | + serviceUnavailable(503)</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2524 | + This operation does not require a request body.</fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e230"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.20. Version Details Response: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e232"> |
2525 | +<?xml version="1.0" encoding="UTF-8"?> |
2526 | +<version xmlns="http://docs.openstack.org/common/api/v1.0" |
2527 | + xmlns:atom="http://www.w3.org/2005/Atom" |
2528 | + id="v2.0" status="CURRENT" updated="2011-01-21T11:33:21-06:00"> |
2529 | + |
2530 | + <media-types> |
2531 | + <media-type base="application/xml" |
2532 | + type="application/vnd.openstack.identity+xml;version=2.0"/> |
2533 | + <media-type base="application/json" |
2534 | + type="application/vnd.openstack.identity+json;version=2.0"/> |
2535 | + </media-types> |
2536 | + |
2537 | + <atom:link rel="self" |
2538 | + href="http://identity.api.openstack.org/v2.0/"/> |
2539 | + |
2540 | + <atom:link rel="describedby" |
2541 | + type="application/pdf" |
2542 | + href="http://docs.openstack.org/identity/api/v2.0/identity-latest.pdf" /> |
2543 | + |
2544 | + <atom:link rel="describedby" |
2545 | + type="application/vnd.sun.wadl+xml" |
2546 | + href="http://docs.openstack.org/identity/api/v2.0/identity.wadl" /> |
2547 | +</version> |
2548 | + |
2549 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e233"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.21. Version Details Response: Atom</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e235"> |
2550 | +<?xml version="1.0" encoding="UTF-8"?> |
2551 | +<feed xmlns="http://www.w3.org/2005/Atom"> |
2552 | + <title type="text">About This Version</title> |
2553 | + <updated>2011-01-21T11:33:21-06:00</updated> |
2554 | + <id>http://identity.api.openstack.org/v2.0/</id> |
2555 | + <author><name>OpenStack</name><uri>http://www.openstack.org/</uri></author> |
2556 | + <link rel="self" href="http://identity.api.openstack.org/v2.0/"/> |
2557 | + <entry> |
2558 | + <id>http://identity.api.openstack.org/v2.0/</id> |
2559 | + <title type="text">Version v2.0</title> |
2560 | + <updated>2011-01-21T11:33:21-06:00</updated> |
2561 | + <link rel="self" href="http://identity.api.openstack.org/v2.0/"/> |
2562 | + <link rel="describedby" type="application/pdf" |
2563 | + href="http://docs.openstack.org/identity/api/v2.0/identity-latest.pdf"/> |
2564 | + <link rel="describedby" type="application/vnd.sun.wadl+xml" |
2565 | + href="http://docs.openstack.org/identity/api/v2.0/application.wadl"/> |
2566 | + <content type="text">Version v2.0 CURRENT (2011-01-21T11:33:21-06:00)</content> |
2567 | + </entry> |
2568 | +</feed> |
2569 | + |
2570 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e236"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.22. Version Details Response: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e238">{ |
2571 | + "version": { |
2572 | + "id": "v2.0", |
2573 | + "status": "CURRENT", |
2574 | + "updated": "2011-01-21T11:33:21-06:00", |
2575 | + "links": [ |
2576 | + { |
2577 | + "rel": "self", |
2578 | + "href": "http://identity.api.openstack.org/v2.0/" |
2579 | + }, { |
2580 | + "rel": "describedby", |
2581 | + "type": "application/pdf", |
2582 | + "href": "http://docs.openstack.org/identity/api/v2.0/identity-latest.pdf" |
2583 | + }, { |
2584 | + "rel": "describedby", |
2585 | + "type": "application/vnd.sun.wadl+xml", |
2586 | + "href": "http://docs.openstack.org/identity/api/v2.0/identity.wadl" |
2587 | + } |
2588 | + ], |
2589 | + "media-types": [ |
2590 | + { |
2591 | + "base": "application/xml", |
2592 | + "type": "application/vnd.openstack.identity+xml;version=2.0" |
2593 | + }, { |
2594 | + "base": "application/json", |
2595 | + "type": "application/vnd.openstack.identity+json;version=2.0" |
2596 | + } |
2597 | + ] |
2598 | + } |
2599 | +} |
2600 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2601 | + The detailed version response contains pointers to |
2602 | + both a human-readable and a machine-processable |
2603 | + description of the API service. The machine-processable description is written in the Web |
2604 | + Application Description Language (WADL). |
2605 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" space-after.optimum="1em" space-after.minimum="0.8em" space-after.maximum="1.2em" id="d149e240"><fo:list-block provisional-distance-between-starts="36pt + 18pt" provisional-label-separation="18pt"><fo:list-item><fo:list-item-label end-indent="label-end()"><fo:block><fo:external-graphic width="auto" height="auto" content-width="36pt" src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/note.svg)"/></fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block font-size="14pt" font-weight="bold" hyphenate="false" keep-with-next.within-column="always" color="rgb(196,0,34)" font-family="CartoGothic Std">Note</fo:block><fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">If there is a discrepancy between the two specifications, the WADL is |
2606 | + authoritative as it contains the most accurate and up-to-date description of the |
2607 | + API service. </fo:block></fo:block></fo:list-item-body></fo:list-item></fo:list-block></fo:block></fo:block><fo:block id="Extensions-d1e688"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Extensions</fo:marker><fo:block font-size="20.735999999999997pt">3.5. Extensions</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2608 | + The OpenStack Identity API is extensible. Extensions |
2609 | + serve two purposes: They allow the introduction of new |
2610 | + features in the API without requiring a version change |
2611 | + and they allow the introduction of vendor specific |
2612 | + niche functionality. Applications can programmatically |
2613 | + determine what extensions are available by performing |
2614 | + a <fo:inline font-weight="bold">GET</fo:inline> on the /extensions URI. Note that this is a |
2615 | + versioned request — that is, an extension |
2616 | + available in one API version may not be available in |
2617 | + another. |
2618 | + </fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="d149e246"><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
2619 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Verb</fo:block></fo:table-cell> |
2620 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black" number-columns-spanned="2"><fo:block font-weight="bold">URI</fo:block></fo:table-cell> |
2621 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" number-columns-spanned="3"><fo:block font-weight="bold">Description</fo:block></fo:table-cell> |
2622 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
2623 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block><fo:inline font-weight="bold">GET</fo:inline></fo:block></fo:table-cell> |
2624 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black" number-columns-spanned="2"><fo:block>/extensions</fo:block></fo:table-cell> |
2625 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" number-columns-spanned="3"><fo:block>Returns a list of available extensions</fo:block></fo:table-cell> |
2626 | + </fo:table-row></fo:table-body></fo:table></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Normal Response Code(s):200, 203</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Error Response Code(s): badRequest |
2627 | + (400), identityFault (500), |
2628 | + serviceUnavailable(503)</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2629 | + This operation does not require a request body.</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2630 | + Each extension is identified by two unique identifiers, a |
2631 | + namespace and an |
2632 | + alias. Additionally an extension |
2633 | + contains documentation links in various formats. |
2634 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e269"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.23. Extensions Response: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e271"> |
2635 | +<?xml version="1.0" encoding="UTF-8"?> |
2636 | + |
2637 | +<extensions xmlns="http://docs.openstack.org/common/api/v1.0" |
2638 | + xmlns:atom="http://www.w3.org/2005/Atom"> |
2639 | + <extension |
2640 | + name="Reset Password Extension" |
2641 | + namespace="http://docs.rackspacecloud.com/identity/api/ext/rpe/v1.0" |
2642 | + alias="RS-RPE" |
2643 | + updated="2011-01-22T13:25:27-06:00"> |
2644 | + |
2645 | + <description> |
2646 | + Adds the capability to reset a user's password. The user is |
2647 | + emailed when the password has been reset. |
2648 | + </description> |
2649 | + |
2650 | + <atom:link rel="describedby" |
2651 | + type="application/pdf" |
2652 | + href="http://docs.rackspacecloud.com/identity/api/ext/identity-rpe-20111111.pdf"/> |
2653 | + <atom:link rel="describedby" |
2654 | + type="application/vnd.sun.wadl+xml" |
2655 | + href="http://docs.rackspacecloud.com/identity/api/ext/identity-rpe.wadl"/> |
2656 | + </extension> |
2657 | + <extension |
2658 | + name="User Metadata Extension" |
2659 | + namespace="http://docs.rackspacecloud.com/identity/api/ext/meta/v2.0" |
2660 | + alias="RS-META" |
2661 | + updated="2011-01-12T11:22:33-06:00"> |
2662 | + <description> |
2663 | + Allows associating arbritrary metadata with a user. |
2664 | + </description> |
2665 | + |
2666 | + <atom:link rel="describedby" |
2667 | + type="application/pdf" |
2668 | + href="http://docs.rackspacecloud.com/identity/api/ext/identity-meta-20111201.pdf"/> |
2669 | + <atom:link rel="describedby" |
2670 | + type="application/vnd.sun.wadl+xml" |
2671 | + href="http://docs.rackspacecloud.com/identity/api/ext/identity-meta.wadl"/> |
2672 | + </extension> |
2673 | +</extensions> |
2674 | + |
2675 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e272"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.24. Extensions Response: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e274">{ |
2676 | + "extensions": { |
2677 | + "values": [ |
2678 | + { |
2679 | + "name": "Reset Password Extension", |
2680 | + "namespace": "http://docs.rackspacecloud.com/identity/api/ext/rpe/v2.0", |
2681 | + "alias": "RS-RPE", |
2682 | + "updated": "2011-01-22T13:25:27-06:00", |
2683 | + "description": "Adds the capability to reset a user's password. The user is emailed when the password has been reset.", |
2684 | + "links": [ |
2685 | + { |
2686 | + "rel": "describedby", |
2687 | + "type": "application/pdf", |
2688 | + "href": "http://docs.rackspacecloud.com/identity/api/ext/identity-rpe-20111111.pdf" |
2689 | + }, { |
2690 | + "rel": "describedby", |
2691 | + "type": "application/vnd.sun.wadl+xml", |
2692 | + "href": "http://docs.rackspacecloud.com/identity/api/ext/identity-rpe.wadl" |
2693 | + } |
2694 | + ] |
2695 | + }, { |
2696 | + "name": "User Metadata Extension", |
2697 | + "namespace": "http://docs.rackspacecloud.com/identity/api/ext/meta/v2.0", |
2698 | + "alias": "RS-META", |
2699 | + "updated": "2011-01-12T11:22:33-06:00", |
2700 | + "description": "Allows associating arbritrary metadata with a user.", |
2701 | + "links": [ |
2702 | + { |
2703 | + "rel": "describedby", |
2704 | + "type": "application/pdf", |
2705 | + "href": "http://docs.rackspacecloud.com/identity/api/ext/identity-meta-20111201.pdf" |
2706 | + }, { |
2707 | + "rel": "describedby", |
2708 | + "type": "application/vnd.sun.wadl+xml", |
2709 | + "href": "http://docs.rackspacecloud.com/identity/api/ext/identity-meta.wadl" |
2710 | + } |
2711 | + ] |
2712 | + } |
2713 | + ] |
2714 | + } |
2715 | +} |
2716 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2717 | + Extensions may also be queried individually by their |
2718 | + unique alias. This provides the simplest method of |
2719 | + checking if an extension is available as an unavailable |
2720 | + extension will issue an itemNotFound |
2721 | + (404) response. |
2722 | + </fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="d149e277"><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
2723 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Verb</fo:block></fo:table-cell> |
2724 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black" number-columns-spanned="2"><fo:block font-weight="bold">URI</fo:block></fo:table-cell> |
2725 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" number-columns-spanned="3"><fo:block font-weight="bold">Description</fo:block></fo:table-cell> |
2726 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
2727 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block><fo:inline font-weight="bold">GET</fo:inline></fo:block></fo:table-cell> |
2728 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black" number-columns-spanned="2"><fo:block>/extensions/<fo:inline font-family="monospace" font-style="italic">alias</fo:inline></fo:block></fo:table-cell> |
2729 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" number-columns-spanned="3"><fo:block>Return details of a single extension</fo:block></fo:table-cell> |
2730 | + </fo:table-row></fo:table-body></fo:table></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Normal Response Code(s):200, 203</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Error Response Code(s): itemNotFound |
2731 | + (404), badRequest |
2732 | + (400), identityFault |
2733 | + (500), |
2734 | + serviceUnavailable(503)</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2735 | + This operation does not require a request body.</fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e299"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.25. Extension Response: xml</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e301"> |
2736 | +<?xml version="1.0" encoding="UTF-8"?> |
2737 | + |
2738 | +<extension xmlns="http://docs.openstack.org/common/api/v1.0" |
2739 | + xmlns:atom="http://www.w3.org/2005/Atom" |
2740 | + name="User Metadata Extension" |
2741 | + namespace="http://docs.rackspacecloud.com/identity/api/ext/meta/v2.0" |
2742 | + alias="RS-META" |
2743 | + updated="2011-01-12T11:22:33-06:00"> |
2744 | + |
2745 | + <description> |
2746 | + Allows associating arbritrary metadata with a user. |
2747 | + </description> |
2748 | + |
2749 | + <atom:link rel="describedby" |
2750 | + type="application/pdf" |
2751 | + href="http://docs.rackspacecloud.com/identity/api/ext/identity-meta-20111201.pdf"/> |
2752 | + <atom:link rel="describedby" |
2753 | + type="application/vnd.sun.wadl+xml" |
2754 | + href="http://docs.rackspacecloud.com/identity/api/ext/identity-meta.wadl"/> |
2755 | + |
2756 | +</extension> |
2757 | + |
2758 | + |
2759 | + |
2760 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e302"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.26. Extensions Response: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e304">{ |
2761 | + "extension": { |
2762 | + "name": "User Metadata Extension", |
2763 | + "namespace": "http://docs.rackspacecloud.com/identity/api/ext/meta/v2.0", |
2764 | + "alias": "RS-META", |
2765 | + "updated": "2011-01-12T11:22:33-06:00", |
2766 | + "description": "Allows associating arbritrary metadata with a user.", |
2767 | + "links": [ |
2768 | + { |
2769 | + "rel": "describedby", |
2770 | + "type": "application/pdf", |
2771 | + "href": "http://docs.rackspacecloud.com/identity/api/ext/identity-meta-20111201.pdf" |
2772 | + }, { |
2773 | + "rel": "describedby", |
2774 | + "type": "application/vnd.sun.wadl+xml", |
2775 | + "href": "http://docs.rackspacecloud.com/identity/api/ext/identity-cbs.wadl" |
2776 | + } |
2777 | + ] |
2778 | + } |
2779 | +} |
2780 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2781 | + Extensions may define new data types, parameters, actions, |
2782 | + headers, states, and resources. In XML, additional |
2783 | + elements and attributes may be defined. These elements |
2784 | + must be defined in the extension's namespace. In JSON, the |
2785 | + alias must be used. The volumes element in the <fo:basic-link internal-destination="UserEXT"><fo:inline> Examples 3.27</fo:inline></fo:basic-link> and |
2786 | + <fo:basic-link internal-destination="UserEXTJ"><fo:inline>3.28</fo:inline></fo:basic-link> |
2787 | + is defined in the <fo:inline font-family="monospace">RS-META</fo:inline> namespace. Extended |
2788 | + headers are always prefixed with <fo:inline font-family="monospace">X-</fo:inline> followed |
2789 | + by the alias and a dash: (<fo:inline font-family="monospace">X-RS-META-HEADER1</fo:inline>). |
2790 | + Parameters must be prefixed with the extension alias |
2791 | + followed by a colon. |
2792 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" space-after.optimum="1em" space-after.minimum="0.8em" space-after.maximum="1.2em" id="d149e311"><fo:list-block provisional-distance-between-starts="36pt + 18pt" provisional-label-separation="18pt"><fo:list-item><fo:list-item-label end-indent="label-end()"><fo:block><fo:external-graphic width="auto" height="auto" content-width="36pt" src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/important.svg)"/></fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block font-size="14pt" font-weight="bold" hyphenate="false" keep-with-next.within-column="always" color="rgb(196,0,34)" font-family="CartoGothic Std">Important</fo:block><fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2793 | + Applications should be prepared to ignore response |
2794 | + data that contains extension elements. Also, |
2795 | + applications should also verify that an extension is |
2796 | + available before submitting an extended request. |
2797 | + </fo:block></fo:block></fo:list-item-body></fo:list-item></fo:list-block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="UserEXT"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.27. Extended User Response: XML</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e315"> |
2798 | +<?xml version="1.0" encoding="UTF-8"?> |
2799 | +<user xmlns="http://docs.openstack.org/identity/api/v2.0" |
2800 | + enabled="true" email="john.smith@example.org" |
2801 | + id="u1000" username="jqsmith"> |
2802 | + <roles> |
2803 | + <role tenantId="1234" id="Admin"/> |
2804 | + </roles> |
2805 | + <metadata |
2806 | + xmlns="http://docs.rackspacecloud.com/identity/api/ext/meta/v2.0"> |
2807 | + <meta key="MetaKey1">MetaValue1</meta> |
2808 | + <meta key="MetaKey2">MetaValue2</meta> |
2809 | + </metadata> |
2810 | +</user> |
2811 | + |
2812 | + </fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="UserEXTJ"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.28. Extended User Response: JSON</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e318">{ |
2813 | + "user": { |
2814 | + "roles": { |
2815 | + "values": [ |
2816 | + { |
2817 | + "tenantId": "1234", |
2818 | + "id": "Admin" |
2819 | + } |
2820 | + ] |
2821 | + }, |
2822 | + "id": "u1000", |
2823 | + "username": "jqsmith", |
2824 | + "email": "john.smith@example.org", |
2825 | + "enabled": true, |
2826 | + "RS-META:metadata": { |
2827 | + "values": { |
2828 | + "MetaKey1": "MetaValue1", |
2829 | + "MetaKey2": "MetaValue2" |
2830 | + } |
2831 | + } |
2832 | + } |
2833 | +} |
2834 | +</fo:block></fo:block></fo:block></fo:block><fo:block id="Faults-d1e908"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Faults</fo:marker><fo:block font-size="20.735999999999997pt">3.6. Faults</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">When an error occurs the system will return an HTTP error response code denoting the |
2835 | + type of error. The system will also return additional information about the fault in the |
2836 | + body of the response. </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e322"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.29. XML Fault Response</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e324"> |
2837 | +<?xml version="1.0" encoding="UTF-8"?> |
2838 | +<identityFault xmlns="http://docs.openstack.org/identity/api/v2.0" |
2839 | + code="500"> |
2840 | + <message>Fault</message> |
2841 | + <details>Error Details...</details> |
2842 | +</identityFault> |
2843 | + |
2844 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e325"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.30. JSON Fault Response</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e327"> |
2845 | +{ |
2846 | + "identityFault": { |
2847 | + "message": "Fault", |
2848 | + "details": "Error Details...", |
2849 | + "code": 500 |
2850 | + } |
2851 | +} |
2852 | + |
2853 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The error code is returned in the body of the response for convenience. The message |
2854 | + section returns a human readable message. The details section is optional and may contain |
2855 | + useful information for tracking down an error (e.g a stack trace). </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The root element of the fault (e.g. identityFault) may change depending on the type of error. |
2856 | + The following is an example of an itemNotFound error. </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e330"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.31. XML Not Found Fault</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e332"> |
2857 | +<?xml version="1.0" encoding="UTF-8"?> |
2858 | +<itemNotFound xmlns="http://docs.openstack.org/identity/api/v2.0" |
2859 | + code="404"> |
2860 | + <message>Item not found.</message> |
2861 | + <details>Error Details...</details> |
2862 | +</itemNotFound> |
2863 | + |
2864 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e333"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 3.32. JSON Not Found Fault</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e335"> |
2865 | +{ |
2866 | + "itemNotFound": { |
2867 | + "message": "Item not found.", |
2868 | + "details": "Error Details...", |
2869 | + "code": 404 |
2870 | + } |
2871 | +} |
2872 | + |
2873 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> The following is a list of possible fault types along with their associated error |
2874 | + codes. </fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e337"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Table 3.3. Fault Types</fo:block><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
2875 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Fault Element</fo:block></fo:table-cell> |
2876 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Associated Error Code</fo:block></fo:table-cell> |
2877 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block font-weight="bold">Expected in All Requests</fo:block></fo:table-cell> |
2878 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
2879 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>identityFault</fo:block></fo:table-cell> |
2880 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>500, 400</fo:block></fo:table-cell> |
2881 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block> <fo:external-graphic src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/src/docbkx/img/Check_mark_23x20_02.svg)" width="auto" height="auto" content-width="60%" content-height="60%" content-type="content-type:image/svg+xml"/> </fo:block></fo:table-cell> |
2882 | + </fo:table-row><fo:table-row> |
2883 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>serviceUnavailable</fo:block></fo:table-cell> |
2884 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>503</fo:block></fo:table-cell> |
2885 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block> <fo:external-graphic src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/src/docbkx/img/Check_mark_23x20_02.svg)" width="auto" height="auto" content-width="60%" content-height="60%" content-type="content-type:image/svg+xml"/> </fo:block></fo:table-cell> |
2886 | + </fo:table-row><fo:table-row> |
2887 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>badRequest</fo:block></fo:table-cell> |
2888 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>400</fo:block></fo:table-cell> |
2889 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block> <fo:external-graphic src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/src/docbkx/img/Check_mark_23x20_02.svg)" width="auto" height="auto" content-width="60%" content-height="60%" content-type="content-type:image/svg+xml"/> </fo:block></fo:table-cell> |
2890 | + </fo:table-row><fo:table-row> |
2891 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>unauthorized</fo:block></fo:table-cell> |
2892 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>401</fo:block></fo:table-cell> |
2893 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block> <fo:external-graphic src="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/src/docbkx/img/Check_mark_23x20_02.svg)" width="auto" height="auto" content-width="60%" content-height="60%" content-type="content-type:image/svg+xml"/> </fo:block></fo:table-cell> |
2894 | + </fo:table-row><fo:table-row> |
2895 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>overLimit</fo:block></fo:table-cell> |
2896 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>413</fo:block></fo:table-cell> |
2897 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block/></fo:table-cell> |
2898 | + </fo:table-row><fo:table-row> |
2899 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>userDisabled</fo:block></fo:table-cell> |
2900 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>403</fo:block></fo:table-cell> |
2901 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block/></fo:table-cell> |
2902 | + </fo:table-row><fo:table-row> |
2903 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>forbidden</fo:block></fo:table-cell> |
2904 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>403</fo:block></fo:table-cell> |
2905 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block/></fo:table-cell> |
2906 | + </fo:table-row><fo:table-row> |
2907 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>itemNotFound</fo:block></fo:table-cell> |
2908 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>404</fo:block></fo:table-cell> |
2909 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black"><fo:block/></fo:table-cell> |
2910 | + </fo:table-row><fo:table-row> |
2911 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>tenantConflict</fo:block></fo:table-cell> |
2912 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>409</fo:block></fo:table-cell> |
2913 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" text-align="center" border-start-style="none" border-top-style="none"><fo:block/></fo:table-cell> |
2914 | + </fo:table-row></fo:table-body></fo:table></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">From an XML schema perspective, all API faults are extensions of the base fault type |
2915 | + identityFault. When working with a system that binds XML to actual classes (such |
2916 | + as JAXB), one should be capable of using identityFault as a “catch-all” if |
2917 | + there's no interest in distinguishing between individual fault types. </fo:block></fo:block></fo:flow></fo:page-sequence><fo:page-sequence xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions" hyphenate="true" master-reference="body" language="en" format="1" initial-page-number="auto" force-page-count="no-force" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2"><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-first"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-odd"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-even"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block>Keystone Developer Guide</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block>Aug 23, 2011</fo:block></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block>API v2.0</fo:block></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content xmlns:exslt="http://exslt.org/common" flow-name="xsl-region-before-blank"><fo:block-container reference-orientation="90" absolute-position="fixed" top="-1in" overflow="visible" height="2in" width="30in" z-index="1"><fo:block padding-before=".45in" font-size="1.5em" color="gray" font-weight="bold"><fo:leader leader-pattern="use-content" leader-length="30in" letter-spacing=".1em"> DRAFT - </fo:leader></fo:block></fo:block-container><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-bottom-width="0.5pt" border-bottom-style="solid" border-bottom-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell><fo:table-cell text-align="right" display-align="before" relative-align="baseline"><fo:block><fo:block/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-footnote-separator"><fo:block><fo:leader color="black" leader-pattern="rule" leader-length="1in"/></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-first"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-odd"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-even"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"><fo:page-number/></fo:block></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:static-content flow-name="xsl-region-after-blank"><fo:block font-family="CartoGothic Std" margin-left="0pt"><fo:table table-layout="fixed" width="100%" border-top-width="0.5pt" border-top-style="solid" border-top-color="black"><fo:table-column column-number="1" column-width="proportional-column-width(1)"/><fo:table-column column-number="2" column-width="proportional-column-width(1)"/><fo:table-column column-number="3" column-width="proportional-column-width(1)"/><fo:table-body><fo:table-row block-progression-dimension.minimum="14pt"><fo:table-cell text-align="start" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="center" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell><fo:table-cell text-align="end" display-align="after" relative-align="baseline"><fo:block><fo:block xmlns:exslt="http://exslt.org/common"/></fo:block></fo:table-cell></fo:table-row></fo:table-body></fo:table></fo:block></fo:static-content><fo:flow flow-name="xsl-region-body" start-indent="4pc" end-indent="0pt"><fo:block id="Service_API_Client_Operations_-d1e1110"><fo:block font-family="CartoGothic Std"><fo:block margin-left="0pt"><fo:block font-size="24.8832pt" font-weight="bold"><fo:block keep-with-next.within-column="always" space-before.optimum="10pt" space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" hyphenate="false" text-align="start" start-indent="0pt" font-family="CartoGothic Std" color="rgb(196,0,34)" hyphenation-character="-" hyphenation-push-character-count="2" hyphenation-remain-character-count="2">4. Service API (Client Operations)</fo:block></fo:block></fo:block></fo:block></fo:block><fo:block id="Overview-d1e1115"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Overview</fo:marker><fo:block font-size="20.735999999999997pt">4.1. Overview</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The operations described in this chapter allow clients to authenticate and get |
2918 | + access tokens and service endpoints. </fo:block></fo:block><fo:block id="Core_Service_API-d1e1124"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Core Service API</fo:marker><fo:block font-size="20.735999999999997pt">4.2. Core Service API</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The following calls are core Keystone Service APIs in version 2.0</fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="d149e404"><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
2919 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Verb</fo:block></fo:table-cell> |
2920 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">URI</fo:block></fo:table-cell> |
2921 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" number-columns-spanned="4"><fo:block font-weight="bold">Description</fo:block></fo:table-cell> |
2922 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
2923 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block> <fo:inline font-weight="bold">POST</fo:inline> </fo:block></fo:table-cell> |
2924 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>/tokens</fo:block></fo:table-cell> |
2925 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" number-columns-spanned="4"><fo:block>Authenticate to generate a token.</fo:block></fo:table-cell> |
2926 | + </fo:table-row><fo:table-row> |
2927 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block> <fo:inline font-weight="bold">GET</fo:inline> </fo:block></fo:table-cell> |
2928 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>/tenants</fo:block></fo:table-cell> |
2929 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" number-columns-spanned="4"><fo:block>Get a list of tenants accessible with supplied token.</fo:block></fo:table-cell> |
2930 | + </fo:table-row></fo:table-body></fo:table></fo:block></fo:block><fo:block id="Available-operations-d100001"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Available Operations</fo:marker><fo:block font-size="20.735999999999997pt">4.3. Available Operations</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block id="Authenticate-d1e1166"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Authenticate</fo:marker><fo:block font-size="17.28pt">4.3.1. Authenticate</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="d149e425"><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
2931 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Verb</fo:block></fo:table-cell> |
2932 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">URI</fo:block></fo:table-cell> |
2933 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" number-columns-spanned="4"><fo:block font-weight="bold">Description</fo:block></fo:table-cell> |
2934 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
2935 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block> <fo:inline font-weight="bold">POST</fo:inline> </fo:block></fo:table-cell> |
2936 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block>/tokens</fo:block></fo:table-cell> |
2937 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" number-columns-spanned="4"><fo:block>Authenticate to generate a token.</fo:block></fo:table-cell> |
2938 | + </fo:table-row></fo:table-body></fo:table></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Normal Response Code(s):200, 203</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Error Response Code(s): unauthorized (401), userDisabled |
2939 | + (403), badRequest (400), identityFault |
2940 | + (500), serviceUnavailable(503)</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2941 | + This call will return a token if successful. Each ReST request against other services (or other |
2942 | + calls on Keystone such as the GET /tenants call) |
2943 | + requires the inclusion of a specific authorization token HTTP x-header, defined as X-Auth-Token. |
2944 | + Clients obtain |
2945 | + this token, along with the URL to other service APIs, by first authenticating against the |
2946 | + Keystone Service and supplying valid credentials. |
2947 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2948 | + Client authentication is provided via a ReST interface using the POST method, |
2949 | + with v2.0/tokens supplied as the path. A payload of credentials must be included |
2950 | + in the body. |
2951 | + </fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
2952 | + The Keystone Service is a ReSTful web service. It is the entry point to all service APIs. |
2953 | + To access the Keystone Service, you must know URL of the Keystone service. |
2954 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e449"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 4.1. XML Auth Request</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e451"> |
2955 | + <?xml version="1.0" encoding="UTF-8"?> |
2956 | +<auth |
2957 | + xmlns="http://docs.openstack.org/identity/api/v2.0" |
2958 | + tenantId="1234"> |
2959 | + <passwordCredentials |
2960 | + username="testuser" |
2961 | + password="P@ssword1"/> |
2962 | +</auth> |
2963 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e452"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 4.2. JSON Auth Request</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e454"> |
2964 | +{ |
2965 | + "auth": { |
2966 | + "passwordCredentials": { |
2967 | + "username": "test_user", |
2968 | + "password": "mypass" |
2969 | + }, |
2970 | + "tenantId": "1234" |
2971 | + } |
2972 | +} |
2973 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e455"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 4.3. XML Auth Response</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e457"> |
2974 | +<?xml version="1.0" encoding="UTF-8"?> |
2975 | +<auth xmlns="http://docs.openstack.org/identity/api/v2.0"> |
2976 | + <token expires="2010-11-01T03:32:15-05:00" |
2977 | + id="ab48a9efdfedb23ty3494"/> |
2978 | + <serviceCatalog> |
2979 | + <service type="compute" name="Computers in the Cloud"> |
2980 | + <endpoint |
2981 | + region="North" |
2982 | + tenantId="1234" |
2983 | + publicURL="https://north.compute.public.com/v2.0/1234" |
2984 | + internalURL="https://north.compute.internal.com/v2.0/1234"> |
2985 | + <version |
2986 | + id="2.0" |
2987 | + info="https://north.compute.public.com/v2.0/" |
2988 | + list="https://north.compute.public.com/" /> |
2989 | + </endpoint> |
2990 | + <endpoint |
2991 | + region="South" |
2992 | + tenantId="3456" |
2993 | + publicURL="https://south.compute.public.com/v2.0/3456" |
2994 | + internalURL="https://south.compute.internal.com/v2.0/3456"> |
2995 | + <version |
2996 | + id="2.0" |
2997 | + info="https://south.compute.public.com/v2.0/" |
2998 | + list="https://south.compute.public.com/" /> |
2999 | + </endpoint> |
3000 | + </service> |
3001 | + <service type="object-store" name="HTTP Object Store"> |
3002 | + <endpoint |
3003 | + region="North" |
3004 | + tenantId="1234" |
3005 | + publicURL="https://north.object-store.public.com/v1/1234" |
3006 | + internalURL="https://north.object-store.internal.com/v1/1234"> |
3007 | + <version |
3008 | + id="1" |
3009 | + info="https://north.object-store.public.com/v1/" |
3010 | + list="https://north.object-store.public.com/" /> |
3011 | + </endpoint> |
3012 | + <endpoint |
3013 | + region="South" |
3014 | + tenantId="3456" |
3015 | + publicURL="https://south.object-store.public.com/v2.0/3456" |
3016 | + internalURL="https://south.object-store.internal.com/v2.0/3456"> |
3017 | + <version |
3018 | + id="2.0" |
3019 | + info="https://south.object-store.public.com/v1/" |
3020 | + list="https://south.object-store.public.com/" /> |
3021 | + </endpoint> |
3022 | + </service> |
3023 | + <service type="dns" name="DNS-as-a-Service"> |
3024 | + <endpoint |
3025 | + publicURL="https://dns.public.com/v2.0/blah-blah"> |
3026 | + <version |
3027 | + id="2.0" |
3028 | + info="https://dns.public.com/v2.0/" |
3029 | + list="https://dns.public.com/" /> |
3030 | + </endpoint> |
3031 | + </service> |
3032 | + </serviceCatalog> |
3033 | +</auth> |
3034 | + |
3035 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e458"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 4.4. JSON Auth Response</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e460"> |
3036 | +{ |
3037 | + "auth": { |
3038 | + "token": { |
3039 | + "id": "asdasdasd-adsasdads-asdasdasd-adsadsasd", |
3040 | + "expires": "2010-11-01T03:32:15-05:00" |
3041 | + }, |
3042 | + "serviceCatalog": [ |
3043 | + { |
3044 | + "name": "Cloud Servers", |
3045 | + "type": "compute", |
3046 | + "endpoints": [ |
3047 | + { |
3048 | + "publicURL": "https://compute.north.host/v1/1234", |
3049 | + "internalURL": "https://compute.north.host/v1/1234", |
3050 | + "region": "North", |
3051 | + "tenantId": "1234", |
3052 | + "versionId": "1.0", |
3053 | + "versionInfo": "https://compute.north.host/v1.0/", |
3054 | + "versionList": "https://compute.north.host/" |
3055 | + }, { |
3056 | + "publicURL": "https://compute.north.host/v1.1/3456", |
3057 | + "internalURL": "https://compute.north.host/v1.1/3456", |
3058 | + "region": "North", |
3059 | + "tenantId": "3456", |
3060 | + "versionId": "1.1", |
3061 | + "versionInfo": "https://compute.north.host/v1.1/", |
3062 | + "versionList": "https://compute.north.host/" |
3063 | + } |
3064 | + ] |
3065 | + }, { |
3066 | + "name": "Cloud Files", |
3067 | + "type": "object-store", |
3068 | + "endpoints": [ |
3069 | + { |
3070 | + "publicURL": "https://compute.north.host/v1/blah-blah", |
3071 | + "internalURL": "https://compute.north.host/v1/blah-blah", |
3072 | + "region": "South", |
3073 | + "tenantId": "1234", |
3074 | + "versionId": "1.0", |
3075 | + "versionInfo": "uri", |
3076 | + "versionList": "uri" |
3077 | + }, { |
3078 | + "publicURL": "https://compute.north.host/v1.1/blah-blah", |
3079 | + "internalURL": "https://compute.north.host/v1.1/blah-blah", |
3080 | + "region": "South", |
3081 | + "tenantId": "3456", |
3082 | + "versionId": "1.1", |
3083 | + "versionInfo": "https://compute.north.host/v1.1/", |
3084 | + "versionList": "https://compute.north.host/" |
3085 | + } |
3086 | + ], |
3087 | + "endpoint_links": [ |
3088 | + { |
3089 | + "rel": "next", |
3090 | + "href": "https://identity.north.host/v2.0/endpoints?marker=2" |
3091 | + } |
3092 | + ] |
3093 | + } |
3094 | + ], |
3095 | + "serviceCatalog_links": [ |
3096 | + { |
3097 | + "rel": "next", |
3098 | + "href": "https://identity.host/v2.0/endpoints?session=2hfh8Ar&marker=2" |
3099 | + } |
3100 | + ] |
3101 | + } |
3102 | +} |
3103 | +</fo:block></fo:block></fo:block></fo:block><fo:block id="Get_Tenants-d1e1264"><fo:block><fo:block><fo:block keep-together.within-column="always" margin-left="0pt" font-family="CartoGothic Std"><fo:block keep-with-next.within-column="always"><fo:block font-family="CartoGothic Std" font-weight="bold" keep-with-next.within-column="always" space-before.minimum="0.8em" space-before.optimum="1.0em" space-before.maximum="1.2em" text-align="start" start-indent="0pt" color="rgb(196,0,34)"><fo:marker marker-class-name="section.head.marker">Get Tenants</fo:marker><fo:block font-size="17.28pt">4.3.2. Get Tenants</fo:block></fo:block></fo:block></fo:block></fo:block></fo:block><fo:block xmlns:rx="http://www.renderx.com/XSL/Extensions" space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" id="d149e463"><fo:table border-before-width.conditionality="retain" border-collapse="collapse" font-size="8pt" width="100%" border-start-style="solid" border-end-style="solid" border-top-style="solid" border-bottom-style="solid" border-start-width="0.5pt" border-end-width="0.5pt" border-top-width="0.5pt" border-bottom-width="0.5pt" border-start-color="black" border-end-color="black" border-top-color="black" border-bottom-color="black"><fo:table-header start-indent="0pt" end-indent="0pt"><fo:table-row keep-with-next.within-column="always"> |
3104 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block font-weight="bold">Verb</fo:block></fo:table-cell> |
3105 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" border-end-style="solid" border-end-width="0.5pt" border-end-color="black" number-columns-spanned="4"><fo:block font-weight="bold">URI</fo:block></fo:table-cell> |
3106 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-bottom-style="solid" border-bottom-width="0.5pt" border-bottom-color="black" number-columns-spanned="3"><fo:block font-weight="bold">Description</fo:block></fo:table-cell> |
3107 | + </fo:table-row></fo:table-header><fo:table-body start-indent="0pt" end-indent="0pt"><fo:table-row> |
3108 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black"><fo:block> <fo:inline font-weight="bold">GET</fo:inline> </fo:block></fo:table-cell> |
3109 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" border-end-style="solid" border-end-width="0.5pt" border-end-color="black" number-columns-spanned="4"><fo:block>/tenants</fo:block></fo:table-cell> |
3110 | + <fo:table-cell padding-start="2pt" padding-end="2pt" padding-top="2pt" padding-bottom="2pt" border-start-style="none" border-top-style="none" number-columns-spanned="3"><fo:block>Get a list of tenants.</fo:block></fo:table-cell> |
3111 | + </fo:table-row></fo:table-body></fo:table></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Normal Response Code(s):200, 203</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Error Response Code(s): unauthorized (401), |
3112 | + forbidden(403), overLimit(413), |
3113 | + badRequest (400), identityFault (500), |
3114 | + serviceUnavailable(503)</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
3115 | + The operation returns a list of tenants which the supplied token provides |
3116 | + access to. This call must be authenticated, so a valid token must |
3117 | + be passed in as a header. |
3118 | + </fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e486"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 4.5. Tenants Request with Auth Token</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e488"> |
3119 | +GET /v2.0/tenants HTTP/1.1 |
3120 | +Host: identity.api.openstack.org |
3121 | +Content-Type: application/json |
3122 | +X-Auth-Token: fa8426a0-8eaf-4d22-8e13-7c1b16a9370c |
3123 | +Accept: application/json |
3124 | +</fo:block></fo:block></fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
3125 | + This operation does not require a request body.</fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e490"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 4.6. JSON Tenants Response</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e492"> |
3126 | +{ |
3127 | + "tenants": { |
3128 | + "values": [ |
3129 | + { |
3130 | + "id": "1234", |
3131 | + "name": "ACME Corp", |
3132 | + "description": "A description ...", |
3133 | + "enabled": true |
3134 | + }, { |
3135 | + "id": "3456", |
3136 | + "name": "Iron Works", |
3137 | + "description": "A description ...", |
3138 | + "enabled": true |
3139 | + } |
3140 | + ] |
3141 | + } |
3142 | +} |
3143 | +</fo:block></fo:block></fo:block><fo:block><fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em" keep-together.within-column="auto" id="d149e493"><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" font-weight="bold" font-size="12pt" hyphenate="false" space-after.minimum="0.4em" space-after.optimum="0.6em" space-after.maximum="0.8em" color="rgb(176,0,14)" font-family="CartoGothic Std" keep-with-next.within-column="always">Example 4.7. XML Tenants Response</fo:block><fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" space-after.minimum="0.8em" space-after.optimum="1em" space-after.maximum="1.2em" hyphenate="false" wrap-option="wrap" white-space-collapse="false" white-space-treatment="preserve" linefeed-treatment="preserve" text-align="start" font-family="monospace" font-size="85%" hyphenation-character="\" background-color="#E0E0E0" id="d149e495"> |
3144 | +HTTP/1.1 200 OK |
3145 | +Content-Type: application/xml; charset=UTF-8 |
3146 | +Content-Length: 200 |
3147 | +Date: Sun, 1 Jan 2011 9:00:00 GMT |
3148 | + |
3149 | +<?xml version="1.0" encoding="UTF-8"?> |
3150 | +<tenants xmlns="http://docs.openstack.org/identity/api/v2.0"> |
3151 | + <tenant enabled="true" id="1234" name="ACME Corp"> |
3152 | + <description>A description...</description> |
3153 | + </tenant> |
3154 | + <tenant enabled="true" id="3645" name="Iron Works"> |
3155 | + <description>A description...</description> |
3156 | + </tenant> |
3157 | +</tenants> |
3158 | + |
3159 | +</fo:block></fo:block></fo:block></fo:block></fo:block></fo:flow></fo:page-sequence></fo:root> |
3160 | \ No newline at end of file |
3161 | |
3162 | === added file 'doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-service-devguide.fo.OTHER' |
3163 | --- doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-service-devguide.fo.OTHER 1970-01-01 00:00:00 +0000 |
3164 | +++ doc/source/docbkx/incubation/keystone/devguide/target/docbkx/pdf/identity-service-devguide.fo.OTHER 2011-08-29 16:57:23 +0000 |
3165 | @@ -0,0 +1,1704 @@ |
3166 | +<?xml version="1.0" encoding="utf-8"?><fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="CartoGothic Std" font-size="10.5pt" text-align="start" line-height="normal" font-selection-strategy="character-by-character" line-height-shift-adjustment="disregard-shifts" writing-mode="lr-tb" language="en"><fo:layout-master-set><fo:simple-page-master master-name="blank" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body display-align="center" margin-bottom="0.5in" margin-top="0.5in"/><fo:region-before region-name="xsl-region-before-blank" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-blank" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="titlepage-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="lot-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="front-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="body-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="back-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="1"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-first" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-first" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-first" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-odd" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-odd" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-odd" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:simple-page-master master-name="index-even" page-width="8.5in" page-height="11in" margin-top="0.5in" margin-bottom="0.5in" margin-left="1in" margin-right="1in"><fo:region-body margin-bottom="0.5in" margin-top="0.5in" column-gap="12pt" column-count="2"/><fo:region-before region-name="xsl-region-before-even" extent="0.4in" display-align="before"/><fo:region-after region-name="xsl-region-after-even" extent="0.4in" display-align="after"/></fo:simple-page-master><fo:page-sequence-master master-name="titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="titlepage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="lot"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="lot-first" page-position="first"/><fo:conditional-page-master-reference master-reference="lot-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="lot-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="front"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="front-first" page-position="first"/><fo:conditional-page-master-reference master-reference="front-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="front-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="body"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="body-first" page-position="first"/><fo:conditional-page-master-reference master-reference="body-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="body-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="back"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="back-first" page-position="first"/><fo:conditional-page-master-reference master-reference="back-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="back-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:page-sequence-master master-name="index"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="index-first" page-position="first"/><fo:conditional-page-master-reference master-reference="index-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="index-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master><fo:simple-page-master xmlns:exslt="http://exslt.org/common" master-name="cloudpage-first" page-width="8.5in" page-height="11in" margin-top="0.0in" margin-bottom="0.0in" margin-left="0.0in" margin-right="0.0in"><fo:region-body margin-bottom="0.0in" margin-top="0.0in" column-gap="0pt" column-count="1"/><fo:region-before extent="11.0in" display-align="before" background-image="url(/home/yogi/bkups/trunk/doc/source/docbkx/incubation/keystone/devguide/target/docbkx/images/cloud/cover.svg)" background-repeat="no-repeat" background-position-horizontal="0%" background-position-vertical="0%"/></fo:simple-page-master><fo:page-sequence-master xmlns:exslt="http://exslt.org/common" master-name="cloud-titlepage"><fo:repeatable-page-master-alternatives><fo:conditional-page-master-reference master-reference="blank" blank-or-not-blank="blank"/><fo:conditional-page-master-reference master-reference="cloudpage-first" page-position="first"/><fo:conditional-page-master-reference master-reference="titlepage-odd" odd-or-even="odd"/><fo:conditional-page-master-reference odd-or-even="even" master-reference="titlepage-odd"/></fo:repeatable-page-master-alternatives></fo:page-sequence-master></fo:layout-master-set><fo:declarations><x:xmpmeta xmlns:x="adobe:ns:meta/"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xapRights="http://ns.adobe.com/xap/1.0/rights/" rdf:about=""><xapRights:Marked>True</xapRights:Marked></rdf:Description><rdf:Description xmlns:dc="http://purl.org/dc/elements/1.1/" rdf:about=""><dc:rights><rdf:Alt><rdf:li xml:lang="x-default">Copyright © 2010, 2011 OpenStack All rights reserved.</rdf:li></rdf:Alt></dc:rights><dc:title>Keystone Developer Guide</dc:title><dc:creator/></rdf:Description><rdf:Description xmlns:pdf="http://ns.adobe.com/pdf/1.3/" rdf:about=""/><rdf:Description xmlns:xmp="http://ns.adobe.com/xap/1.0/" rdf:about=""><xmp:CreatorTool>Cloud API Docs Plugin</xmp:CreatorTool></rdf:Description></rdf:RDF></x:xmpmeta></fo:declarations><fo:bookmark-tree><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Book-d0001" starting-state="hide"><fo:bookmark-title>Keystone Developer Guide</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="toc...Book-d0001"><fo:bookmark-title>Table of Contents</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62" starting-state="hide"><fo:bookmark-title>1. Overview</fo:bookmark-title></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Concepts-d1e74" starting-state="hide"><fo:bookmark-title>2. Concepts</fo:bookmark-title><fo:bookmark internal-destination="User-d1e103" starting-state="hide"><fo:bookmark-title>2.1. User</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Credentials-d1e103b" starting-state="hide"><fo:bookmark-title>2.2. Credentials</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Authentication-d1e103a" starting-state="hide"><fo:bookmark-title>2.3. Authentication</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Token-d1e82" starting-state="hide"><fo:bookmark-title>2.4. Token</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Tenant-d1e94" starting-state="hide"><fo:bookmark-title>2.5. Tenant</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Service-d1e104" starting-state="hide"><fo:bookmark-title>2.6. Service</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Endpoint-d1e122" starting-state="hide"><fo:bookmark-title>2.7. Endpoint</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Role-d1e131" starting-state="hide"><fo:bookmark-title>2.8. Role</fo:bookmark-title></fo:bookmark></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="General_API_Information-d1e141" starting-state="hide"><fo:bookmark-title>3. General API Information</fo:bookmark-title><fo:bookmark internal-destination="Request_Response_Types-d1e149" starting-state="hide"><fo:bookmark-title>3.1. Request/Response Types</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Content_Compression-d1e262" starting-state="hide"><fo:bookmark-title>3.2. Content Compression</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Paginated_Collections-d1e325" starting-state="hide"><fo:bookmark-title>3.3. Paginated Collections</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Versions-d1e472" starting-state="hide"><fo:bookmark-title>3.4. Versions</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Extensions-d1e688" starting-state="hide"><fo:bookmark-title>3.5. Extensions</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Faults-d1e908" starting-state="hide"><fo:bookmark-title>3.6. Faults</fo:bookmark-title></fo:bookmark></fo:bookmark><fo:bookmark xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Admin_API_Service_Developer_Operations_-d1e1356" starting-state="hide"><fo:bookmark-title>4. Admin API (Service Developer Operations)</fo:bookmark-title><fo:bookmark internal-destination="Overview-d1e1361" starting-state="hide"><fo:bookmark-title>4.1. Overview</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Core_Admin_API-d1e1370" starting-state="hide"><fo:bookmark-title>4.2. Core Admin API</fo:bookmark-title><fo:bookmark internal-destination="Admin_Access-d1e1378" starting-state="hide"><fo:bookmark-title>4.2.1. Admin Access</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Tokens-d1e1565" starting-state="hide"><fo:bookmark-title>4.2.2. Tokens</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Users-d1e1435" starting-state="hide"><fo:bookmark-title>4.2.3. Users</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Tenants-d1e1606" starting-state="hide"><fo:bookmark-title>4.2.4. Tenants</fo:bookmark-title></fo:bookmark></fo:bookmark><fo:bookmark internal-destination="Token_Operations-d1e1900" starting-state="hide"><fo:bookmark-title>4.3. Token Operations</fo:bookmark-title><fo:bookmark internal-destination="Authenticate-d1e1166" starting-state="hide"><fo:bookmark-title>4.3.1. Authenticate</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Validate_Token-d1e1914" starting-state="hide"><fo:bookmark-title>4.3.2. Validate Token</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Validate_Token-HEAD-d1e1914" starting-state="hide"><fo:bookmark-title>4.3.3. Validate Token</fo:bookmark-title></fo:bookmark></fo:bookmark><fo:bookmark internal-destination="User_Operations-d1e1900" starting-state="hide"><fo:bookmark-title>4.4. User Operations</fo:bookmark-title><fo:bookmark internal-destination="Get_a_User-d1e2242" starting-state="hide"><fo:bookmark-title>4.4.1. Get a User</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Get_a_User-By_Name-d1e2242" starting-state="hide"><fo:bookmark-title>4.4.2. Get a User</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Get_User_Roles-d1e2242" starting-state="hide"><fo:bookmark-title>4.4.3. Get list of User Roles</fo:bookmark-title></fo:bookmark></fo:bookmark><fo:bookmark internal-destination="Tenant_Operations-d1e1900" starting-state="hide"><fo:bookmark-title>4.5. Tenant Operations</fo:bookmark-title><fo:bookmark internal-destination="Get_Tenants-d1e1264" starting-state="hide"><fo:bookmark-title>4.5.1. Get Tenants</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Get_a_Tenant-d1e2242" starting-state="hide"><fo:bookmark-title>4.5.2. Get a Tenant</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Get_a_Tenant-By_Name-d1e2242" starting-state="hide"><fo:bookmark-title>4.5.3. Get a Tenant by Name</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Get_Tenant_Endpoints-d1e2242" starting-state="hide"><fo:bookmark-title>4.5.4. Get list of Tenant Endpoints</fo:bookmark-title></fo:bookmark><fo:bookmark internal-destination="Get_Tenant_User_Roles-d1e2242" starting-state="hide"><fo:bookmark-title>4.5.5. Get list of Roles assigned for a User on a Tenant</fo:bookmark-title></fo:bookmark></fo:bookmark></fo:bookmark></fo:bookmark-tree><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Book-d0001"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e62"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Concepts-d1e74"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="User-d1e103"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Credentials-d1e103b"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Authentication-d1e103a"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Token-d1e82"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Tenant-d1e94"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Service-d1e104"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Endpoint-d1e122"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Role-d1e131"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="General_API_Information-d1e141"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Request_Response_Types-d1e149"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Content_Compression-d1e262"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Paginated_Collections-d1e325"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Versions-d1e472"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Extensions-d1e688"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Faults-d1e908"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Admin_API_Service_Developer_Operations_-d1e1356"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Overview-d1e1361"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Core_Admin_API-d1e1370"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Admin_Access-d1e1378"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Tokens-d1e1565"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Users-d1e1435"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Tenants-d1e1606"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Token_Operations-d1e1900"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Authenticate-d1e1166"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Validate_Token-d1e1914"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Validate_Token-HEAD-d1e1914"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="User_Operations-d1e1900"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Get_a_User-d1e2242"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Get_a_User-By_Name-d1e2242"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Get_User_Roles-d1e2242"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Tenant_Operations-d1e1900"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Get_Tenants-d1e1264"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destination="Get_a_Tenant-d1e2242"/><fox:destination xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" internal-destin |
Hi Yogi - Let's hold off on putting the extension docs into this repo and get them into the Git repo that we'll set up after we get guidance from all the PTLs on the direction here.