Äcdocutils.nodes
document
q)Åq}q(U nametypesq}q(X���rfc2046qàX���message body in put or postqNX���url path parametersqNX���message body in deleteq NX���message serializationq
NX���date parameters in urlsq NX���rest interface overviewq NX���session informationq
NX���rfc3986qàX ���boolean url query parametersqNX���parameters in requestsqNX���url query parametersqNuUsubstitution_defsq}qUparse_messagesq]qUcurrent_sourceqNU
decorationqNUautofootnote_startqKUnameidsq}q(hUrfc2046qhUmessage-body-in-put-or-postq hUurl-path-parametersq h Umessage-body-in-deleteq h
Umessage-serializationq h Udate-parameters-in-urlsq h Urest-interface-overviewq!h
Usession-informationq"hUrfc3986q#hU boolean-url-query-parametersq$hUparameters-in-requestsq%hUurl-query-parametersq&uUchildrenq']q(cdocutils.nodes
section
q))Åq*}q+(U rawsourceq,U�Uparentq-hUsourceq.Xd���/var/lib/jenkins/jobs/API_Documentation_trunk/workspace/api-documentation/source/apis/rest_comms.txtq/Utagnameq0Usectionq1U
attributesq2}q3(Udupnamesq4]Uclassesq5]Ubackrefsq6]Uidsq7]q8h!aUnamesq9]q:h auUlineq;KUdocumentq<hh']q=(cdocutils.nodes
title
q>)Åq?}q@(h,X���REST Interface OverviewqAh-h*h.h/h0UtitleqBh2}qC(h4]h5]h6]h7]h9]uh;Kh<hh']qDcdocutils.nodes
Text
qEX���REST Interface OverviewqFÖÅqG}qH(h,hAh-h?ubaubcdocutils.nodes
paragraph
qI)ÅqJ}qK(h,X∂���This document describes how the Member (:doc:`MN_APIs`) and Coordinating
(:doc:`CN_APIs`) Node APIs are implemented using a Representational State
Transfer (REST) approach over HTTP.h-h*h.h/h0U paragraphqLh2}qM(h4]h5]h6]h7]h9]uh;Kh<hh']qN(hEX(���This document describes how the Member (qOÖÅqP}qQ(h,X(���This document describes how the Member (h-hJubcsphinx.addnodes
pending_xref
qR)ÅqS}qT(h,X���:doc:`MN_APIs`qUh-hJh.h/h0U pending_xrefqVh2}qW(UreftypeX���docqXUrefwarnqYàU reftargetqZX���MN_APIsU refdomainU�h7]h6]U refexplicitâh4]h5]h9]Urefdocq[X���apis/rest_commsq\uh;Kh']q]cdocutils.nodes
inline
q^)Åq_}q`(h,hUh2}qa(h4]h5]qb(UxrefqchXeh6]h7]h9]uh-hSh']qdhEX���MN_APIsqeÖÅqf}qg(h,U�h-h_ubah0UinlineqhubaubhEX���) and Coordinating
(qiÖÅqj}qk(h,X���) and Coordinating
(h-hJubhR)Åql}qm(h,X���:doc:`CN_APIs`qnh-hJh.h/h0hVh2}qo(UreftypeX���docqphYàhZX���CN_APIsU refdomainU�h7]h6]U refexplicitâh4]h5]h9]h[h\uh;Kh']qqh^)Åqr}qs(h,hnh2}qt(h4]h5]qu(hchpeh6]h7]h9]uh-hlh']qvhEX���CN_APIsqwÖÅqx}qy(h,U�h-hrubah0hhubaubhEX^���) Node APIs are implemented using a Representational State
Transfer (REST) approach over HTTP.qzÖÅq{}q|(h,X^���) Node APIs are implemented using a Representational State
Transfer (REST) approach over HTTP.h-hJubeubhI)Åq}}q~(h,X+���Key points on REST interactions in DataONE:qh-h*h.h/h0hLh2}qÄ(h4]h5]h6]h7]h9]uh;Kh<hh']qÅhEX+���Key points on REST interactions in DataONE:qÇÖÅqÉ}qÑ(h,hh-h}ubaubcdocutils.nodes
enumerated_list
qÖ)ÅqÜ}qá(h,U�h-h*h.h/h0Uenumerated_listqàh2}qâ(UsuffixqäU.h7]h6]h4]UprefixqãU�h5]h9]UenumtypeqåUarabicqçuh;K
h<hh']qé(cdocutils.nodes
list_item
qè)Åqê}që(h,XÅ���Content is generally modeled as collections, with :class:`PIDs
<Types.Identifier>` identifying individual items of a collection.
h-hÜh.h/h0U list_itemqíh2}qì(h4]h5]h6]h7]h9]uh;Nh<hh']qîhI)Åqï}qñ(h,XÄ���Content is generally modeled as collections, with :class:`PIDs
<Types.Identifier>` identifying individual items of a collection.h-hêh.h/h0hLh2}qó(h4]h5]h6]h7]h9]uh;K
h']qò(hEX2���Content is generally modeled as collections, with qôÖÅqö}qõ(h,X2���Content is generally modeled as collections, with h-hïubhR)Åqú}qù(h,X ���:class:`PIDs
<Types.Identifier>`qûh-hïh.h/h0hVh2}qü(UreftypeX���classhYâhZX���Types.IdentifierU refdomainX���pyq†h7]h6]U refexplicitàh4]h5]h9]h[h\Upy:classq°NU py:moduleq¢Nuh;K
h']q£cdocutils.nodes
literal
q§)Åq•}q¶(h,hûh2}qß(h4]h5]q®(hch†X���py-classq©eh6]h7]h9]uh-húh']q™hEX���PIDsq´ÖÅq¨}q≠(h,U�h-h•ubah0UliteralqÆubaubhEX.��� identifying individual items of a collection.qØÖÅq∞}q±(h,X.��� identifying individual items of a collection.h-hïubeubaubhè)Åq≤}q≥(h,X∫���The HTTP verbs HEAD, GET, POST, PUT, DELETE are used for retrieving
information about content, retrieving content, creating content, updating
content, and deleting content respectively.
h-hÜh.h/h0híh2}q¥(h4]h5]h6]h7]h9]uh;Nh<hh']qµhI)Åq∂}q∑(h,Xπ���The HTTP verbs HEAD, GET, POST, PUT, DELETE are used for retrieving
information about content, retrieving content, creating content, updating
content, and deleting content respectively.q∏h-h≤h.h/h0hLh2}qπ(h4]h5]h6]h7]h9]uh;K
h']q∫hEXπ���The HTTP verbs HEAD, GET, POST, PUT, DELETE are used for retrieving
information about content, retrieving content, creating content, updating
content, and deleting content respectively.qªÖÅqº}qΩ(h,h∏h-h∂ubaubaubhè)Åqæ}qø(h,X?���State information, if required, is passed in the HTTP headers.
h-hÜh.h/h0híh2}q¿(h4]h5]h6]h7]h9]uh;Nh<hh']q¡hI)Åq¬}q√(h,X>���State information, if required, is passed in the HTTP headers.qƒh-hæh.h/h0hLh2}q≈(h4]h5]h6]h7]h9]uh;Kh']q∆hEX>���State information, if required, is passed in the HTTP headers.q«ÖÅq»}q…(h,hƒh-h¬ubaubaubhè)Åq }qÀ(h,X¨���Identity transfer is performed using SSL, with the client certificate
accessible through implementation specific mechanisms supported by the
respective server environment.
h-hÜh.h/h0híh2}qÃ(h4]h5]h6]h7]h9]uh;Nh<hh']qÕhI)ÅqŒ}qœ(h,X´���Identity transfer is performed using SSL, with the client certificate
accessible through implementation specific mechanisms supported by the
respective server environment.q–h-h h.h/h0hLh2}q—(h4]h5]h6]h7]h9]uh;Kh']q“hEX´���Identity transfer is performed using SSL, with the client certificate
accessible through implementation specific mechanisms supported by the
respective server environment.q”ÖÅq‘}q’(h,h–h-hŒubaubaubhè)Åq÷}q◊(h,Xw���The identity information described in (4) is indicated as a *Session* in the
method signatures and their descriptions.
h-hÜh.h/h0híh2}qÿ(h4]h5]h6]h7]h9]uh;Nh<hh']qŸhI)Åq⁄}q€(h,Xv���The identity information described in (4) is indicated as a *Session* in the
method signatures and their descriptions.h-h÷h.h/h0hLh2}q‹(h4]h5]h6]h7]h9]uh;Kh']q›(hEX<���The identity information described in (4) is indicated as a qfiÖÅqfl}q‡(h,X<���The identity information described in (4) is indicated as a h-h⁄ubcdocutils.nodes
emphasis
q·)Åq‚}q„(h,X ���*Session*h2}q‰(h4]h5]h6]h7]h9]uh-h⁄h']qÂhEX���SessionqÊÖÅqÁ}qË(h,U�h-h‚ubah0UemphasisqÈubhEX1��� in the
method signatures and their descriptions.qÍÖÅqÎ}qÏ(h,X1��� in the
method signatures and their descriptions.h-h⁄ubeubaubhè)ÅqÌ}qÓ(h,Xù���Hints to support efficient caching (e.g. content time stamps) should be
respected. Caching is an important mechanism for assisting with service
scalability.
h-hÜh.h/h0híh2}qÔ(h4]h5]h6]h7]h9]uh;Nh<hh']qhI)ÅqÒ}qÚ(h,Xú���Hints to support efficient caching (e.g. content time stamps) should be
respected. Caching is an important mechanism for assisting with service
scalability.qÛh-hÌh.h/h0hLh2}qÙ(h4]h5]h6]h7]h9]uh;Kh']qıhEXú���Hints to support efficient caching (e.g. content time stamps) should be
respected. Caching is an important mechanism for assisting with service
scalability.qˆÖÅq˜}q¯(h,hÛh-hÒubaubaubhè)Åq˘}q˙(h,X��Names of parameters passed in URLs or message bodies are case sensitive
unless explicitly indicated otherwise. If the case of the parameters names
does not match the method signature, the request MAY be rejected with an
:exc:`Exceptions.InvalidRequest` exception.
h-hÜh.h/h0híh2}q˚(h4]h5]h6]h7]h9]uh;Nh<hh']q¸hI)Åq˝}q˛(h,X��Names of parameters passed in URLs or message bodies are case sensitive
unless explicitly indicated otherwise. If the case of the parameters names
does not match the method signature, the request MAY be rejected with an
:exc:`Exceptions.InvalidRequest` exception.h-h˘h.h/h0hLh2}qˇ(h4]h5]h6]h7]h9]uh;K h']r���(hEX‹���Names of parameters passed in URLs or message bodies are case sensitive
unless explicitly indicated otherwise. If the case of the parameters names
does not match the method signature, the request MAY be rejected with an
r��ÖÅr��}r��(h,X‹���Names of parameters passed in URLs or message bodies are case sensitive
unless explicitly indicated otherwise. If the case of the parameters names
does not match the method signature, the request MAY be rejected with an
h-h˝ubhR)År��}r��(h,X ���:exc:`Exceptions.InvalidRequest`r��h-h˝h.h/h0hVh2}r��(UreftypeX���exchYâhZX���Exceptions.InvalidRequestU refdomainX���pyr��h7]h6]U refexplicitâh4]h5]h9]h[h\h°Nh¢Nuh;K h']r ��h§)År
��}r ��(h,j��h2}r ��(h4]h5]r
��(hcj��X���py-excr��eh6]h7]h9]uh-j��h']r��hEX���Exceptions.InvalidRequestr��ÖÅr��}r��(h,U�h-j
��ubah0hÆubaubhEX ��� exception.r��ÖÅr��}r��(h,X ��� exception.h-h˝ubeubaubhè)År��}r��(h,X≤���GET, HEAD, DELETE requests only pass parameters as part of the URL. The
parameter values are converted to UTF-8 Strings and appropriately escaped for
incorporating into the URL.
h-hÜh.h/h0híh2}r��(h4]h5]h6]h7]h9]uh;Nh<hh']r��hI)År��}r��(h,X±���GET, HEAD, DELETE requests only pass parameters as part of the URL. The
parameter values are converted to UTF-8 Strings and appropriately escaped for
incorporating into the URL.r ��h-j��h.h/h0hLh2}r ��(h4]h5]h6]h7]h9]uh;K#h']r ��hEX±���GET, HEAD, DELETE requests only pass parameters as part of the URL. The
parameter values are converted to UTF-8 Strings and appropriately escaped for
incorporating into the URL.r ��ÖÅr ��}r!��(h,j ��h-j��ubaubaubhè)År"��}r#��(h,Xd���Message bodies (e.g. for POST and PUT requests) are encoded using MIME
Multipart, mixed (RFC2046_).
h-hÜh.h/h0híh2}r$��(h4]h5]h6]h7]h9]uh;Nh<hh']r%��hI)År&��}r'��(h,Xc���Message bodies (e.g. for POST and PUT requests) are encoded using MIME
Multipart, mixed (RFC2046_).h-j"��h.h/h0hLh2}r(��(h4]h5]h6]h7]h9]uh;K'h']r)��(hEXY���Message bodies (e.g. for POST and PUT requests) are encoded using MIME
Multipart, mixed (r*��ÖÅr+��}r,��(h,XY���Message bodies (e.g. for POST and PUT requests) are encoded using MIME
Multipart, mixed (h-j&��ubcdocutils.nodes
reference
r-��)År.��}r/��(h,X���RFC2046_Uresolvedr0��Kh-j&��h0U referencer1��h2}r2��(UnameX���RFC2046Urefurir3��X0���http://tools.ietf.org/html/rfc2046#section-5.1.3r4��h7]h6]h4]h5]h9]uh']r5��hEX���RFC2046r6��ÖÅr7��}r8��(h,U�h-j.��ubaubhEX���).r9��ÖÅr:��}r;��(h,X���).h-j&��ubeubaubhè)År<��}r=��(h,XZ��PUT requests are for updating an existing resource. An identifier of some
sort will typically appear in the URL (e.g. a PID or a Subject), which should
be a UTF-8 string and appropriately URL path encoded. The message body will
be MIME multipart/mixed and may contain values expressed as parameter and /
or file parts as described in (12) below.
h-hÜh.h/h0híh2}r>��(h4]h5]h6]h7]h9]uh;Nh<hh']r?��hI)År@��}rA��(h,XY��PUT requests are for updating an existing resource. An identifier of some
sort will typically appear in the URL (e.g. a PID or a Subject), which should
be a UTF-8 string and appropriately URL path encoded. The message body will
be MIME multipart/mixed and may contain values expressed as parameter and /
or file parts as described in (12) below.rB��h-j<��h.h/h0hLh2}rC��(h4]h5]h6]h7]h9]uh;K*h']rD��hEXY��PUT requests are for updating an existing resource. An identifier of some
sort will typically appear in the URL (e.g. a PID or a Subject), which should
be a UTF-8 string and appropriately URL path encoded. The message body will
be MIME multipart/mixed and may contain values expressed as parameter and /
or file parts as described in (12) below.rE��ÖÅrF��}rG��(h,jB��h-j@��ubaubaubhè)ÅrH��}rI��(h,X∫���POST requests are for creating resources. All information for creating the
new object or resource is transmitted in the message body, which is encoded
as a MIME multipart/mixed message.
h-hÜh.h/h0híh2}rJ��(h4]h5]h6]h7]h9]uh;Nh<hh']rK��hI)ÅrL��}rM��(h,Xπ���POST requests are for creating resources. All information for creating the
new object or resource is transmitted in the message body, which is encoded
as a MIME multipart/mixed message.rN��h-jH��h.h/h0hLh2}rO��(h4]h5]h6]h7]h9]uh;K0h']rP��hEX�POST requests are for creating resources. All information for creating the
new object or resource is transmitted in the message body, which is encoded
as a MIME multipart/mixed message.rQ��ÖÅrR��}rS��(h,jN��h-jL��ubaubaubhè)ÅrT��}rU��(h,Xfi���We use two types of content in MIME multipart/mixed messages: parameters and
files. Parameters are to be used for all simple types (13, below). Files are
to be used for all complex types (14, below) and for octet streams.
h-hÜh.h/h0híh2}rV��(h4]h5]h6]h7]h9]uh;Nh<hh']rW��hI)ÅrX��}rY��(h,X›���We use two types of content in MIME multipart/mixed messages: parameters and
files. Parameters are to be used for all simple types (13, below). Files are
to be used for all complex types (14, below) and for octet streams.rZ��h-jT��h.h/h0hLh2}r[��(h4]h5]h6]h7]h9]uh;K4h']r\��hEX›���We use two types of content in MIME multipart/mixed messages: parameters and
files. Parameters are to be used for all simple types (13, below). Files are
to be used for all complex types (14, below) and for octet streams.r]��ÖÅr^��}r_��(h,jZ��h-jX��ubaubaubhè)År`��}ra��(h,XΩ��Simple types are structures that contain a single value. When creating the
parameter entry, the value is converted to a UTF-8 String using formatting
equivalent to what is used when expressing the same value as part of an XML
document (e.g. when serializing using PyxB or JibX). The expression of a
simple type as a String in a MIME multipart/mixed parameter should be
equivalent to expressing the same value as part of a URL (before escaping).
h-hÜh.h/h0híh2}rb��(h4]h5]h6]h7]h9]uh;Nh<hh']rc��hI)Ård��}re��(h,Xº��Simple types are structures that contain a single value. When creating the
parameter entry, the value is converted to a UTF-8 String using formatting
equivalent to what is used when expressing the same value as part of an XML
document (e.g. when serializing using PyxB or JibX). The expression of a
simple type as a String in a MIME multipart/mixed parameter should be
equivalent to expressing the same value as part of a URL (before escaping).rf��h-j`��h.h/h0hLh2}rg��(h4]h5]h6]h7]h9]uh;K8h']rh��hEXº��Simple types are structures that contain a single value. When creating the
parameter entry, the value is converted to a UTF-8 String using formatting
equivalent to what is used when expressing the same value as part of an XML
document (e.g. when serializing using PyxB or JibX). The expression of a
simple type as a String in a MIME multipart/mixed parameter should be
equivalent to expressing the same value as part of a URL (before escaping).ri��ÖÅrj��}rk��(h,jf��h-jd��ubaubaubhè)Årl��}rm��(h,X<��Complex types are any structures that contain more than a single value. A
simple example of a complex type is the :class:`Types.Checksum` type. It is
a String (the checksum) with an attribute (the algorithm). Complex types are
serialized to UTF-8 encoded XML structures that are defined by the DataONE
Types Schema.
h-hÜh.h/h0híh2}rn��(h4]h5]h6]h7]h9]uh;Nh<hh']ro��hI)Årp��}rq��(h,X;��Complex types are any structures that contain more than a single value. A
simple example of a complex type is the :class:`Types.Checksum` type. It is
a String (the checksum) with an attribute (the algorithm). Complex types are
serialized to UTF-8 encoded XML structures that are defined by the DataONE
Types Schema.h-jl��h.h/h0hLh2}rr��(h4]h5]h6]h7]h9]uh;K?h']rs��(hEXr���Complex types are any structures that contain more than a single value. A
simple example of a complex type is the rt��ÖÅru��}rv��(h,Xr���Complex types are any structures that contain more than a single value. A
simple example of a complex type is the h-jp��ubhR)Årw��}rx��(h,X���:class:`Types.Checksum`ry��h-jp��h.h/h0hVh2}rz��(UreftypeX���classhYâhZX���Types.ChecksumU refdomainX���pyr{��h7]h6]U refexplicitâh4]h5]h9]h[h\h°Nh¢Nuh;K?h']r|��h§)År}��}r~��(h,jy��h2}r��(h4]h5]rÄ��(hcj{��X���py-classrÅ��eh6]h7]h9]uh-jw��h']rÇ��hEX���Types.ChecksumrÉ��ÖÅrÑ��}rÖ��(h,U�h-j}��ubah0hÆubaubhEX≤��� type. It is
a String (the checksum) with an attribute (the algorithm). Complex types are
serialized to UTF-8 encoded XML structures that are defined by the DataONE
Types Schema.rÜ��ÖÅrá��}rà��(h,X≤��� type. It is
a String (the checksum) with an attribute (the algorithm). Complex types are
serialized to UTF-8 encoded XML structures that are defined by the DataONE
Types Schema.h-jp��ubeubaubhè)Årâ��}rä��(h,X˜��File parts of MIME multipart/mixed have three properties: the name of the
entry, the file name of the content, and the content. The name of the entry
must match the parameter name as described in the signature of the method
being called. The content of the entry is XML encoded structure as described
in (14) above (or an octet stream). The file name property is not used, and
can be set to whatever the client considers appropriate. The file name MAY
be ignored by the service receiving the request.
h-hÜh.h/h0híh2}rã��(h4]h5]h6]h7]h9]uh;Nh<hh']rå��hI)Årç��}ré��(h,XÙ��File parts of MIME multipart/mixed have three properties: the name of the
entry, the file name of the content, and the content. The name of the entry
must match the parameter name as described in the signature of the method
being called. The content of the entry is XML encoded structure as described
in (14) above (or an octet stream). The file name property is not used, and
can be set to whatever the client considers appropriate. The file name MAY
be ignored by the service receiving the request.r�h-j�h.h/h0hLh2}r�(h4]h5]h6]h7]h9]uh;KEh']r�hEX��File parts of MIME multipart/mixed have three properties: the name of the
entry, the file name of the content, and the content. The name of the entry
must match the parameter name as described in the signature of the method
being called. The content of the entry is XML encoded structure as described
in (14) above (or an octet stream). The file name property is not used, and
can be set to whatever the client considers appropriate. The file name MAY
be ignored by the service receiving the request.rí��ÖÅrì��}rî��(h,jè��h-jç��ubaubaubeubhI)Årï��}rñ��(h,XU���Collections exposed by :term:`Member Node`\s and :term:`Coordinating Node`\s
include:h-h*h.h/h0hLh2}ró��(h4]h5]h6]h7]h9]uh;KOh<hh']rò��(hEX���Collections exposed by rô��ÖÅrö��}rõ��(h,X���Collections exposed by h-jï��ubhR)Årú��}rù��(h,X���:term:`Member Node`rû��h-jï��h.h/h0hVh2}rü��(UreftypeX���termhYàhZX ���member nodeU refdomainX���stdr†��h7]h6]U refexplicitâh4]h5]h9]h[h\uh;KOh']r°��h^)År¢��}r£��(h,jû��h2}r§��(h4]h5]r•��(hcj†��X���std-termr¶��eh6]h7]h9]uh-jú��h']rß��hEX ���Member Noder®��ÖÅr©��}r™��(h,U�h-j¢��ubah0hhubaubhEX���s and r´��ÖÅr¨��}r≠��(h,X���\s and h-jï��ubhR)ÅrÆ��}rØ��(h,X���:term:`Coordinating Node`r∞��h-jï��h.h/h0hVh2}r±��(UreftypeX���termhYàhZX���coordinating nodeU refdomainX���stdr≤��h7]h6]U refexplicitâh4]h5]h9]h[h\uh;KOh']r≥��h^)År¥��}rµ��(h,j∞��h2}r∂��(h4]h5]r∑��(hcj≤��X���std-termr∏��eh6]h7]h9]uh-jÆ��h']rπ��hEX���Coordinating Noder∫��ÖÅrª��}rº��(h,U�h-j¥��ubah0hhubaubhEX
���s
include:rΩ��ÖÅræ��}rø��(h,X ���\s
include:h-j�ubeubcdocutils.nodes
field_list
r¿��)År¡��}r¬��(h,U�h-h*h.h/h0U
field_listr√��h2}rƒ��(h4]h5]h6]h7]h9]uh;KRh<hh']r≈��(cdocutils.nodes
field
r∆��)År«��}r»��(h,U�h-j¡��h.h/h0Ufieldr…��h2}r ��(h4]h5]h6]h7]h9]uh;KRh<hh']rÀ��(cdocutils.nodes
field_name
rÃ��)ÅrÕ��}rŒ��(h,X ���``/object``rœ��h-j«��h.h/h0U
field_namer–��h2}r—��(h4]h5]h6]h7]h9]uh;K�h']r“��h§)År”��}r‘��(h,jœ��h2}r’��(h4]h5]h6]h7]h9]uh-jÕ��h']r÷��hEX���/objectr◊��ÖÅrÿ��}rŸ��(h,U�h-j”��ubah0hÆubaubcdocutils.nodes
field_body
r⁄��)År€��}r‹��(h,X:���The set of objects available for retrieval from the node.
h2}r›��(h4]h5]h6]h7]h9]uh-j«��h']rfi��hI)Årfl��}r‡��(h,X9���The set of objects available for retrieval from the node.r·��h-j€��h.h/h0hLh2}r‚��(h4]h5]h6]h7]h9]uh;KSh']r„��hEX9���The set of objects available for retrieval from the node.r‰��ÖÅrÂ��}rÊ��(h,j·��h-jfl��ubaubah0U
field_bodyrÁ��ubeubj∆��)ÅrË��}rÈ��(h,U�h-j¡��h.h/h0j…��h2}rÍ��(h4]h5]h6]h7]h9]uh;KUh<hh']rÎ��(jÃ��)ÅrÏ��}rÌ��(h,X ���``/meta``rÓ��h-jË��h.h/h0j–��h2}rÔ��(h4]h5]h6]h7]h9]uh;K�h']r��h§)ÅrÒ��}rÚ��(h,jÓ��h2}rÛ��(h4]h5]h6]h7]h9]uh-jÏ��h']rÙ��hEX���/metarı��ÖÅrˆ��}r˜��(h,U�h-jÒ��ubah0hÆubaubj⁄��)År¯��}r˘��(h,X>���Metadata about objects available for retrieval from the node.
h2}r˙��(h4]h5]h6]h7]h9]uh-jË��h']r˚��hI)År¸��}r˝��(h,X=���Metadata about objects available for retrieval from the node.r˛��h-j¯��h.h/h0hLh2}rˇ��(h4]h5]h6]h7]h9]uh;KVh']r���hEX=���Metadata about objects available for retrieval from the node.r��ÖÅr��}r��(h,j˛��h-j¸��ubaubah0jÁ��ubeubj∆��)År��}r��(h,U�h-j¡��h.h/h0j…��h2}r��(h4]h5]h6]h7]h9]uh;KXh<hh']r��(jÃ��)År��}r ��(h,X ���``/formats``r
��h-j��h.h/h0j–��h2}r ��(h4]h5]h6]h7]h9]uh;K�h']r ��h§)År
��}r��(h,j
��h2}r��(h4]h5]h6]h7]h9]uh-j��h']r��hEX���/formatsr��ÖÅr��}r��(h,U�h-j
��ubah0hÆubaubj⁄��)År��}r��(h,X'���Object formats registered on the node.
h2}r��(h4]h5]h6]h7]h9]uh-j��h']r��hI)År��}r��(h,X&���Object formats registered on the node.r��h-j��h.h/h0hLh2}r��(h4]h5]h6]h7]h9]uh;KYh']r ��hEX&���Object formats registered on the node.r ��ÖÅr ��}r ��(h,j��h-j��ubaubah0jÁ��ubeubj∆��)År ��}r!��(h,U�h-j¡��h.h/h0j…��h2}r"��(h4]h5]h6]h7]h9]uh;K[h<hh']r#��(jÃ��)År$��}r%��(h,X���``/log``r&��h-j ��h.h/h0j–��h2}r'��(h4]h5]h6]h7]h9]uh;K�h']r(��h§)År)��}r*��(h,j&��h2}r+��(h4]h5]h6]h7]h9]uh-j$��h']r,��hEX���/logr-��ÖÅr.��}r/��(h,U�h-j)��ubah0hÆubaubj⁄��)År0��}r1��(h,X ���Log records held on the node.
h2}r2��(h4]h5]h6]h7]h9]uh-j ��h']r3��hI)År4��}r5��(h,X ���Log records held on the node.r6��h-j0��h.h/h0hLh2}r7��(h4]h5]h6]h7]h9]uh;K\h']r8��hEX ���Log records held on the node.r9��ÖÅr:��}r;��(h,j6��h-j4��ubaubah0jÁ��ubeubj∆��)År<��}r=��(h,U�h-j¡��h.h/h0j…��h2}r>��(h4]h5]h6]h7]h9]uh;K^h<hh']r?��(jÃ��)År@��}rA��(h,X ���``/reserve``rB��h-j<��h.h/h0j–��h2}rC��(h4]h5]h6]h7]h9]uh;K�h']rD��h§)ÅrE��}rF��(h,jB��h2}rG��(h4]h5]h6]h7]h9]uh-j@��h']rH��hEX���/reserverI��ÖÅrJ��}rK��(h,U�h-jE��ubah0hÆubaubj⁄��)ÅrL��}rM��(h,X4���Identifiers that have been reserved for future use.
h2}rN��(h4]h5]h6]h7]h9]uh-j<��h']rO��hI)ÅrP��}rQ��(h,X3���Identifiers that have been reserved for future use.rR��h-jL��h.h/h0hLh2}rS��(h4]h5]h6]h7]h9]uh;K_h']rT��hEX3���Identifiers that have been reserved for future use.rU��ÖÅrV��}rW��(h,jR��h-jP��ubaubah0jÁ��ubeubj∆��)ÅrX��}rY��(h,U�h-j¡��h.h/h0j…��h2}rZ��(h4]h5]h6]h7]h9]uh;Kah<hh']r[��(jÃ��)År\��}r]��(h,X
���``/accounts``r^��h-jX��h.h/h0j–��h2}r_��(h4]h5]h6]h7]h9]uh;K�h']r`��h§)Åra��}rb��(h,j^��h2}rc��(h4]h5]h6]h7]h9]uh-j\��h']rd��hEX ���/accountsre��ÖÅrf��}rg��(h,U�h-ja��ubah0hÆubaubj⁄��)Årh��}ri��(h,X/���Principal and ownership related functionality.
h2}rj��(h4]h5]h6]h7]h9]uh-jX��h']rk��hI)Årl��}rm��(h,X.���Principal and ownership related functionality.rn��h-jh��h.h/h0hLh2}ro��(h4]h5]h6]h7]h9]uh;Kbh']rp��hEX.���Principal and ownership related functionality.rq��ÖÅrr��}rs��(h,jn��h-jl��ubaubah0jÁ��ubeubj∆��)Årt��}ru��(h,U�h-j¡��h.h/h0j…��h2}rv��(h4]h5]h6]h7]h9]uh;Kdh<hh']rw��(jÃ��)Årx��}ry��(h,X
���``/sessions``rz��h-jt��h.h/h0j–��h2}r{��(h4]h5]h6]h7]h9]uh;K�h']r|��h§)År}��}r~��(h,jz��h2}r��(h4]h5]h6]h7]h9]uh-jx��h']rÄ��hEX ���/sessionsrÅ��ÖÅrÇ��}rÉ��(h,U�h-j}��ubah0hÆubaubj⁄��)ÅrÑ��}rÖ��(h,X,���Authenticated session management functions.
h2}rÜ��(h4]h5]h6]h7]h9]uh-jt��h']rá��hI)Årà��}râ��(h,X+���Authenticated session management functions.rä��h-jÑ��h.h/h0hLh2}rã��(h4]h5]h6]h7]h9]uh;Keh']rå��hEX+���Authenticated session management functions.rç��ÖÅré��}rè��(h,jä��h-jà��ubaubah0jÁ��ubeubj∆��)Årê��}rë��(h,U�h-j¡��h.h/h0j…��h2}rí��(h4]h5]h6]h7]h9]uh;Kgh<hh']rì��(jÃ��)Årî��}rï��(h,X ���``/node``rñ��h-jê��h.h/h0j–��h2}ró��(h4]h5]h6]h7]h9]uh;K�h']rò��h§)Årô��}rö��(h,jñ��h2}rõ��(h4]h5]h6]h7]h9]uh-jî��h']rú��hEX���/noderù��ÖÅrû��}rü��(h,U�h-jô��ubah0hÆubaubj⁄��)År†��}r°��(h,X<���Service and status information for all nodes on the system.
h2}r¢��(h4]h5]h6]h7]h9]uh-jê��h']r£��hI)År§��}r•��(h,X;���Service and status information for all nodes on the system.r¶��h-j†��h.h/h0hLh2}rß��(h4]h5]h6]h7]h9]uh;Khh']r®��hEX;���Service and status information for all nodes on the system.r©��ÖÅr™��}r´��(h,j¶��h-j§��ubaubah0jÁ��ubeubj∆��)År¨��}r≠��(h,U�h-j¡��h.h/h0j…��h2}rÆ��(h4]h5]h6]h7]h9]uh;Kjh<hh']rØ��(jÃ��)År∞��}r±��(h,X ���``/monitor``r≤��h-j¨��h.h/h0j–��h2}r≥��(h4]h5]h6]h7]h9]uh;K�h']r¥��h§)Årµ��}r∂��(h,j≤��h2}r∑��(h4]h5]h6]h7]h9]uh-j∞��h']r∏��hEX���/monitorrπ��ÖÅr∫��}rª��(h,U�h-jµ��ubah0hÆubaubj⁄��)Årº��}rΩ��(h,X���Node health monitoring
h2}ræ��(h4]h5]h6]h7]h9]uh-j¨��h']rø��hI)År¿��}r¡��(h,X���Node health monitoringr¬��h-jº��h.h/h0hLh2}r√��(h4]h5]h6]h7]h9]uh;Kkh']rƒ��hEX���Node health monitoringr≈��ÖÅr∆��}r«��(h,j¬��h-j¿��ubaubah0jÁ��ubeubj∆��)År»��}r…��(h,U�h-j¡��h.h/h0j…��h2}r ��(h4]h5]h6]h7]h9]uh;Kmh<hh']rÀ��(jÃ��)ÅrÃ��}rÕ��(h,X���``/replicate``rŒ��h-j»��h.h/h0j–��h2}rœ��(h4]h5]h6]h7]h9]uh;K�h']r–��h§)År—��}r“��(h,jŒ��h2}r”��(h4]h5]h6]h7]h9]uh-jÃ��h']r‘��hEX
���/replicater’��ÖÅr÷��}r◊��(h,U�h-j—��ubah0hÆubaubj⁄��)Årÿ��}rŸ��(h,X7���Member node to member node replication functionality
h2}r⁄��(h4]h5]h6]h7]h9]uh-j»��h']r€��hI)År‹��}r›��(h,X4���Member node to member node replication functionalityrfi��h-jÿ��h.h/h0hLh2}rfl��(h4]h5]h6]h7]h9]uh;Knh']r‡��hEX4���Member node to member node replication functionalityr·��ÖÅr‚��}r„��(h,jfi��h-j‹��ubaubah0jÁ��ubeubeubh))År‰��}rÂ��(h,U�h-h*h.h/h0h1h2}rÊ��(h4]h5]h6]h7]rÁ��h ah9]rË��h
auh;Ksh<hh']rÈ��(h>)ÅrÍ��}rÎ��(h,X���Message SerializationrÏ��h-j‰��h.h/h0hBh2}rÌ��(h4]h5]h6]h7]h9]uh;Ksh<hh']rÓ��hEX���Message SerializationrÔ��ÖÅr��}rÒ��(h,jÏ��h-jÍ��ubaubhI)ÅrÚ��}rÛ��(h,Xû���The format of the response (except for responses from :func:`MNRead.get` or
:func:`CNRead.get`) is determined by the *Accept:* header provided in the
request.h-j‰��h.h/h0hLh2}rÙ��(h4]h5]h6]h7]h9]uh;Kuh<hh']rı��(hEX6���The format of the response (except for responses from rˆ��ÖÅr˜��}r¯��(h,X6���The format of the response (except for responses from h-jÚ��ubhR)År˘��}r˙��(h,X���:func:`MNRead.get`r˚��h-jÚ��h.h/h0hVh2}r¸��(UreftypeX���funchYâhZX
���MNRead.getU refdomainX���pyr˝��h7]h6]U refexplicitâh4]h5]h9]h[h\h°Nh¢Nuh;Kuh']r˛��h§)Årˇ��}r���(h,j˚��h2}r��(h4]h5]r��(hcj˝��X���py-funcr��eh6]h7]h9]uh-j˘��h']r��hEX ���MNRead.get()r��ÖÅr��}r��(h,U�h-jˇ��ubah0hÆubaubhEX��� or
r��ÖÅr ��}r
��(h,X��� or
h-jÚ��ubhR)År ��}r ��(h,X���:func:`CNRead.get`r
��h-jÚ��h.h/h0hVh2}r��(UreftypeX���funchYâhZX
���CNRead.getU refdomainX���pyr��h7]h6]U refexplicitâh4]h5]h9]h[h\h°Nh¢Nuh;Kuh']r��h§)År��}r��(h,j
��h2}r��(h4]h5]r��(hcj��X���py-funcr��eh6]h7]h9]uh-j ��h']r��hEX ���CNRead.get()r��ÖÅr��}r��(h,U�h-j��ubah0hÆubaubhEX���) is determined by the r��ÖÅr��}r ��(h,X���) is determined by the h-jÚ��ubh·)År ��}r ��(h,X ���*Accept:*h2}r ��(h4]h5]h6]h7]h9]uh-jÚ��h']r ��hEX���Accept:r!��ÖÅr"��}r#��(h,U�h-j ��ubah0hÈubhEX ��� header provided in the
request.r$��ÖÅr%��}r&��(h,X ��� header provided in the
request.h-jÚ��ubeubhI)År'��}r(��(h,X¶���Version 1.0 of the DataONE services only support XML serialization, and this
format MUST be supported by all services and clients interacting with the
DataONE system.r)��h-j‰��h.h/h0hLh2}r*��(h4]h5]h6]h7]h9]uh;Kyh<hh']r+��hEX¶���Version 1.0 of the DataONE services only support XML serialization, and this
format MUST be supported by all services and clients interacting with the
DataONE system.r,��ÖÅr-��}r.��(h,j)��h-j'��ubaubhI)År/��}r0��(h,XQ���All request and response documents MUST be encoded using the UTF-8 character
set.r1��h-j‰��h.h/h0hLh2}r2��(h4]h5]h6]h7]h9]uh;K}h<hh']r3��hEXQ���All request and response documents MUST be encoded using the UTF-8 character
set.r4��ÖÅr5��}r6��(h,j1��h-j/��ubaubhI)År7��}r8��(h,XΩ���If the service is not able to provide a response in the specified format, then
the node should return an error code of :exc:`Exceptions.NotImplemented`, with
the HTTP error code set to 406.h-j‰��h.h/h0hLh2}r9��(h4]h5]h6]h7]h9]uh;KÄh<hh']r:��(hEXw���If the service is not able to provide a response in the specified format, then
the node should return an error code of r;��ÖÅr<��}r=��(h,Xw���If the service is not able to provide a response in the specified format, then
the node should return an error code of h-j7��ubhR)År>��}r?��(h,X ���:exc:`Exceptions.NotImplemented`r@��h-j7��h.h/h0hVh2}rA��(UreftypeX���exchYâhZX���Exceptions.NotImplementedU refdomainX���pyrB��h7]h6]U refexplicitâh4]h5]h9]h[h\h°Nh¢Nuh;KÄh']rC��h§)ÅrD��}rE��(h,j@��h2}rF��(h4]h5]rG��(hcjB��X���py-excrH��eh6]h7]h9]uh-j>��h']rI��hEX���Exceptions.NotImplementedrJ��ÖÅrK��}rL��(h,U�h-jD��ubah0hÆubaubhEX&���, with
the HTTP error code set to 406.rM��ÖÅrN��}rO��(h,X&���, with
the HTTP error code set to 406.h-j7��ubeubeubh))ÅrP��}rQ��(h,U�h-h*h.h/h0h1h2}rR��(h4]h5]h6]h7]rS��h%ah9]rT��hauh;Káh<hh']rU��(h>)ÅrV��}rW��(h,X���Parameters in RequestsrX��h-jP��h.h/h0hBh2}rY��(h4]h5]h6]h7]h9]uh;Káh<hh']rZ��hEX���Parameters in Requestsr[��ÖÅr\��}r]��(h,jX��h-jV��ubaubhI)År^��}r_��(h,X~���Many of the URL patterns described here accept parameters in the URL and as
components of a MIME multipart-mixed message body.r`��h-jP��h.h/h0hLh2}ra��(h4]h5]h6]h7]h9]uh;Kâh<hh']rb��hEX~���Many of the URL patterns described here accept parameters in the URL and as
components of a MIME multipart-mixed message body.rc��ÖÅrd��}re��(h,j`��h-j^��ubaubhI)Årf��}rg��(h,X_���Unless otherwise indicated, all parameter names and values should be considered
case sensitive.rh��h-jP��h.h/h0hLh2}ri��(h4]h5]h6]h7]h9]uh;Kåh<hh']rj��hEX_���Unless otherwise indicated, all parameter names and values should be considered
case sensitive.rk��ÖÅrl��}rm��(h,jh��h-jf��ubaubcdocutils.nodes
note
rn��)Åro��}rp��(h,XF��The default configuration of web servers such as Apache introduces some
ambiguity in the interpretation of URLs that include slashes and other
reserved characters that are used as path separators for example. The
document :doc:`/notes/ApacheConfiguration` describes appropriate
configuration details for the Apache web server.h-jP��h.h/h0Unoterq��h2}rr��(h4]h5]h6]h7]h9]uh;Nh<hh']rs��hI)Årt��}ru��(h,XF��The default configuration of web servers such as Apache introduces some
ambiguity in the interpretation of URLs that include slashes and other
reserved characters that are used as path separators for example. The
document :doc:`/notes/ApacheConfiguration` describes appropriate
configuration details for the Apache web server.h-jo��h.h/h0hLh2}rv��(h4]h5]h6]h7]h9]uh;Kíh']rw��(hEXfi���The default configuration of web servers such as Apache introduces some
ambiguity in the interpretation of URLs that include slashes and other
reserved characters that are used as path separators for example. The
document rx��ÖÅry��}rz��(h,Xfi���The default configuration of web servers such as Apache introduces some
ambiguity in the interpretation of URLs that include slashes and other
reserved characters that are used as path separators for example. The
document h-jt��ubhR)År{��}r|��(h,X!���:doc:`/notes/ApacheConfiguration`r}��h-jt��h.h/h0hVh2}r~��(UreftypeX���docr��hYàhZX���/notes/ApacheConfigurationU refdomainU�h7]h6]U refexplicitâh4]h5]h9]h[h\uh;Kíh']rÄ��h^)ÅrÅ��}rÇ��(h,j}��h2}rÉ��(h4]h5]rÑ��(hcj��eh6]h7]h9]uh-j{��h']rÖ��hEX���/notes/ApacheConfigurationrÜ��ÖÅrá��}rà��(h,U�h-jÅ��ubah0hhubaubhEXG��� describes appropriate
configuration details for the Apache web server.râ��ÖÅrä��}rã��(h,XG��� describes appropriate
configuration details for the Apache web server.h-jt��ubeubaubh))Årå��}rç��(h,U�h-jP��h.h/h0h1h2}ré��(h4]h5]h6]h7]rè��h"ah9]rê��h
auh;Köh<hh']rë��(h>)Årí��}rì��(h,X���Session Informationrî��h-jå��h.h/h0hBh2}rï��(h4]h5]h6]h7]h9]uh;Köh<hh']rñ��hEX���Session Informationró��ÖÅrò��}rô��(h,jî��h-jí��ubaubhI)Årö��}rõ��(h,XØ��Session information (formerly referred to as a *token*) is obtained from the
client side authentication certificate held by the SSL processing library of the
HTTPS service handling the request. Hence, even though a *session* parameter may
be present in the method signature, the session information itself is
transported as part of the HTTPS handshaking process and is not present in the
body or header section of the HTTP request.h-jå��h.h/h0hLh2}rú��(h4]h5]h6]h7]h9]uh;Kúh<hh']rù��(hEX/���Session information (formerly referred to as a rû��ÖÅrü��}r†��(h,X/���Session information (formerly referred to as a h-jö��ubh·)År°��}r¢��(h,X���*token*h2}r£��(h4]h5]h6]h7]h9]uh-jö��h']r§��hEX���tokenr•��ÖÅr¶��}rß��(h,U�h-j°��ubah0hÈubhEX°���) is obtained from the
client side authentication certificate held by the SSL processing library of the
HTTPS service handling the request. Hence, even though a r®��ÖÅr©��}r™��(h,X°���) is obtained from the
client side authentication certificate held by the SSL processing library of the
HTTPS service handling the request. Hence, even though a h-jö��ubh·)År´��}r¨��(h,X ���*session*h2}r≠��(h4]h5]h6]h7]h9]uh-jö��h']rÆ��hEX���sessionrØ��ÖÅr∞��}r±��(h,U�h-j´��ubah0hÈubhEXœ��� parameter may
be present in the method signature, the session information itself is
transported as part of the HTTPS handshaking process and is not present in the
body or header section of the HTTP request.r≤��ÖÅr≥��}r¥��(h,Xœ��� parameter may
be present in the method signature, the session information itself is
transported as part of the HTTPS handshaking process and is not present in the
body or header section of the HTTP request.h-jö��ubeubeubh))Årµ��}r∂��(h,U�h-jP��h.h/h0h1h2}r∑��(h4]h5]h6]h7]r∏��h ah9]rπ��hauh;K•h<hh']r∫��(h>)Årª��}rº��(h,X���URL Path ParametersrΩ��h-jµ��h.h/h0hBh2}ræ��(h4]h5]h6]h7]h9]uh;K•h<hh']rø��hEX���URL Path Parametersr¿��ÖÅr¡��}r¬��(h,jΩ��h-jª��ubaubhI)År√��}rƒ��(h,XH��Some parameters are passed as part of the REST service URL path (e.g.
/get/{pid}). Such values MUST be encoded according to the rules of RFC3986_ with
the additional restriction that the space character MUST be encoded as "%20"
rather than "+". Examples of DataONE REST URLs for retrieving an object (i.e.
the get() operation)::h-jµ��h.h/h0hLh2}r≈��(h4]h5]h6]h7]h9]uh;Kßh<hh']r∆��(hEXâ���Some parameters are passed as part of the REST service URL path (e.g.
/get/{pid}). Such values MUST be encoded according to the rules of r«��ÖÅr»��}r…��(h,Xâ���Some parameters are passed as part of the REST service URL path (e.g.
/get/{pid}). Such values MUST be encoded according to the rules of h-j√��ubj-��)År ��}rÀ��(h,X���RFC3986_j0��Kh-j√��h0j1��h2}rÃ��(UnameX���RFC3986j3��X"���http://tools.ietf.org/html/rfc3986rÕ��h7]h6]h4]h5]h9]uh']rŒ��hEX���RFC3986rœ��ÖÅr–��}r—��(h,U�h-j ��ubaubhEX∂��� with
the additional restriction that the space character MUST be encoded as "%20"
rather than "+". Examples of DataONE REST URLs for retrieving an object (i.e.
the get() operation):r“��ÖÅr”��}r‘��(h,X∂��� with
the additional restriction that the space character MUST be encoded as "%20"
rather than "+". Examples of DataONE REST URLs for retrieving an object (i.e.
the get() operation):h-j√��ubeubcdocutils.nodes
literal_block
r’��)År÷��}r◊��(h,X7��PID: 10.1000/182
URL: https://mn.example.com/mn/v1/object/10.1000%2F182
PID: http://example.com/data/mydata?row=24
URL: https://mn.example.com/mn/v1/object/http:%2F%2Fexample.com%2Fdata%2Fmydata%3Frow=24
PID: Is_féidir_liom_ithe_gloine
URL: https://mn.example.com/mn/v1/object/Is_f%C3%A9idir_liom_ithe_gloineh-jµ��h.h/h0U
literal_blockrÿ��h2}rŸ��(U xml:spacer⁄��Upreserver€��h7]h6]h4]h5]h9]uh;K≠h<hh']r‹��hEX7��PID: 10.1000/182
URL: https://mn.example.com/mn/v1/object/10.1000%2F182
PID: http://example.com/data/mydata?row=24
URL: https://mn.example.com/mn/v1/object/http:%2F%2Fexample.com%2Fdata%2Fmydata%3Frow=24
PID: Is_féidir_liom_ithe_gloine
URL: https://mn.example.com/mn/v1/object/Is_f%C3%A9idir_liom_ithe_gloiner›��ÖÅrfi��}rfl��(h,U�h-j÷��ubaubeubh))År‡��}r·��(h,U�h-jP��h.h/h0h1h2}r‚��(h4]h5]h6]h7]r„��h&ah9]r‰��hauh;K∏h<hh']rÂ��(h>)ÅrÊ��}rÁ��(h,X���URL Query ParametersrË��h-j‡��h.h/h0hBh2}rÈ��(h4]h5]h6]h7]h9]uh;K∏h<hh']rÍ��hEX���URL Query ParametersrÎ��ÖÅrÏ��}rÌ��(h,jË��h-jÊ��ubaubhI)ÅrÓ��}rÔ��(h,X#��Parameters passed as key, values parameters in the URL query string MUST be
appropriately encoded for transmission as part of the URL according to RFC3986_
rules for the URL query component. In addition, the space character MUST be
encoded as "%20" rather than the alternative "+" character.h-j‡��h.h/h0hLh2}r��(h4]h5]h6]h7]h9]uh;K∫h<hh']rÒ��(hEXì���Parameters passed as key, values parameters in the URL query string MUST be
appropriately encoded for transmission as part of the URL according to rÚ��ÖÅrÛ��}rÙ��(h,Xì���Parameters passed as key, values parameters in the URL query string MUST be
appropriately encoded for transmission as part of the URL according to h-jÓ��ubj-��)Årı��}rˆ��(h,X���RFC3986_j0��Kh-jÓ��h0j1��h2}r˜��(UnameX���RFC3986j3��jÕ��h7]h6]h4]h5]h9]uh']r¯��hEX���RFC3986r˘��ÖÅr˙��}r˚��(h,U�h-jı��ubaubhEXà���
rules for the URL query component. In addition, the space character MUST be
encoded as "%20" rather than the alternative "+" character.r¸��ÖÅr˝��}r˛��(h,Xà���
rules for the URL query component. In addition, the space character MUST be
encoded as "%20" rather than the alternative "+" character.h-jÓ��ubeubeubh))Årˇ��}r���(h,U�h-jP��h.h/h0h1h2}r��(h4]h5]h6]h7]r��h$ah9]r��hauh;K¡h<hh']r��(h>)År��}r��(h,X ���Boolean URL Query Parametersr��h-jˇ��h.h/h0hBh2}r��(h4]h5]h6]h7]h9]uh;K¡h<hh']r ��hEX ���Boolean URL Query Parametersr
��ÖÅr ��}r ��(h,j��h-j��ubaubhI)År
��}r��(h,X‘���Where a boolean parameter value is being specified as the value portion of a
key-value pair appearing in a URL, the strings "true" and "false" MUST be used
to indicate logical true and logical false respectively.r��h-jˇ��h.h/h0hLh2}r��(h4]h5]h6]h7]h9]uh;K√h<hh']r��hEX‘���Where a boolean parameter value is being specified as the value portion of a
key-value pair appearing in a URL, the strings "true" and "false" MUST be used
to indicate logical true and logical false respectively.r��ÖÅr��}r��(h,j��h-j
��ubaubeubh))År��}r��(h,U�h-jP��h.h/h0h1h2}r��(h4]h5]h6]h7]r��h ah9]r��h auh;K…h<hh']r��(h>)År��}r ��(h,X���Date Parameters in URLsr ��h-j��h.h/h0hBh2}r ��(h4]h5]h6]h7]h9]uh;K…h<hh']r ��hEX���Date Parameters in URLsr ��ÖÅr!��}r"��(h,j ��h-j��ubaubhI)År#��}r$��(h,X,���Date values in URLs should be formatted as::r%��h-j��h.h/h0hLh2}r&��(h4]h5]h6]h7]h9]uh;KÀh<hh']r'��hEX+���Date values in URLs should be formatted as:r(��ÖÅr)��}r*��(h,X+���Date values in URLs should be formatted as:h-j#��ubaubj’��)År+��}r,��(h,X ���yyyy-MM-dd[Thh:mm:ss.S[+ZZ:zz]]h-j��h.h/h0jÿ��h2}r-��(j⁄��j€��h7]h6]h4]h5]h9]uh;KÕh<hh']r.��hEX ���yyyy-MM-dd[Thh:mm:ss.S[+ZZ:zz]]r/��ÖÅr0��}r1��(h,U�h-j+��ubaubhI)År2��}r3��(h,X���Where::r4��h-j��h.h/h0hLh2}r5��(h4]h5]h6]h7]h9]uh;Kœh<hh']r6��hEX���Where:r7��ÖÅr8��}r9��(h,X���Where:h-j2��ubaubj’��)År:��}r;��(h,X��yyyy = Four digit year
MM = Two digit month, 01 = January
dd = Two digit day of month, 01 = first day
hh = Hour of day, 00 - 23
mm = Minute of hour, 00 - 59
ss = Second of minute, 00 - 59
S = Milliseconds
ZZ = Hours of timezone offset
zz = Minutes of timezone offseth-j��h.h/h0jÿ��h2}r<��(j⁄��j€��h7]h6]h4]h5]h9]uh;K—h<hh']r=��hEX��yyyy = Four digit year
MM = Two digit month, 01 = January
dd = Two digit day of month, 01 = first day
hh = Hour of day, 00 - 23
mm = Minute of hour, 00 - 59
ss = Second of minute, 00 - 59
S = Milliseconds
ZZ = Hours of timezone offset
zz = Minutes of timezone offsetr>��ÖÅr?��}r@��(h,U�h-j:��ubaubhI)ÅrA��}rB��(h,XV���If the timezone values are not present then the date time is interpreted to be
in GMT.rC��h-j��h.h/h0hLh2}rD��(h4]h5]h6]h7]h9]uh;K€h<hh']rE��hEXV���If the timezone values are not present then the date time is interpreted to be
in GMT.rF��ÖÅrG��}rH��(h,jC��h-jA��ubaubhI)ÅrI��}rJ��(h,Xë���If the time portion of the date time is not present, then the time is assumed to
be 00:00:00.0, i.e. the first millisecond of the specified date.rK��h-j��h.h/h0hLh2}rL��(h4]h5]h6]h7]h9]uh;Kfih<hh']rM��hEX��If the time portion of the date time is not present, then the time is assumed to
be 00:00:00.0, i.e. the first millisecond of the specified date.rN��ÖÅrO��}rP��(h,jK��h-jI��ubaubeubh))ÅrQ��}rR��(h,U�h-jP��h.h/h0h1h2}rS��(h4]h5]h6]h7]rT��h ah9]rU��hauh;K„h<hh']rV��(h>)ÅrW��}rX��(h,X���Message Body in PUT or POSTrY��h-jQ��h.h/h0hBh2}rZ��(h4]h5]h6]h7]h9]uh;K„h<hh']r[��hEX���Message Body in PUT or POSTr\��ÖÅr]��}r^��(h,jY��h-jW��ubaubhI)År_��}r`��(h,X<��Requests sent using the HTTP POST or PUT verbs MUST use MIME multipart-mixed
encoding of the message body as described in RFC2046_. In most cases and unless
otherwise indicated, all parameters for PUT and POST requests except the
authorization session will be sent in the message body (as opposed to URL
parameters).h-jQ��h.h/h0hLh2}ra��(h4]h5]h6]h7]h9]uh;KÂh<hh']rb��(hEXz���Requests sent using the HTTP POST or PUT verbs MUST use MIME multipart-mixed
encoding of the message body as described in rc��ÖÅrd��}re��(h,Xz���Requests sent using the HTTP POST or PUT verbs MUST use MIME multipart-mixed
encoding of the message body as described in h-j_��ubj-��)Årf��}rg��(h,X���RFC2046_j0��Kh-j_��h0j1��h2}rh��(UnameX���RFC2046j3��j4��h7]h6]h4]h5]h9]uh']ri��hEX���RFC2046rj��ÖÅrk��}rl��(h,U�h-jf��ubaubhEX∫���. In most cases and unless
otherwise indicated, all parameters for PUT and POST requests except the
authorization session will be sent in the message body (as opposed to URL
parameters).rm��ÖÅrn��}ro��(h,X∫���. In most cases and unless
otherwise indicated, all parameters for PUT and POST requests except the
authorization session will be sent in the message body (as opposed to URL
parameters).h-j_��ubeubhI)Årp��}rq��(h,XG���Example of a HTTP POST request to the MN create() method using *curl*::rr��h-jQ��h.h/h0hLh2}rs��(h4]h5]h6]h7]h9]uh;KÎh<hh']rt��(hEX?���Example of a HTTP POST request to the MN create() method using ru��ÖÅrv��}rw��(h,X?���Example of a HTTP POST request to the MN create() method using h-jp��ubh·)Årx��}ry��(h,X���*curl*h2}rz��(h4]h5]h6]h7]h9]uh-jp��h']r{��hEX���curlr|��ÖÅr}��}r~��(h,U�h-jx��ubah0hÈubhEX���:ÖÅr��}rÄ��(h,X���:h-jp��ubeubj’��)ÅrÅ��}rÇ��(h,Xõ��curl -X POST \
--cert /tmp/x509up_u502 \
-H "Charset: utf-8" \
-H "Content-Type: multipart/mixed; boundary=----------6B3C785C-6290-11DF-A355-A6ECDED72085_$" \
-H "Accept: text/xml" \
-H "User-Agent: pyd1/1.0 +http://dataone.org/" \
-F pid=10Dappend1.txt \
-F object=@content.bin \
-F sysmeta=@systemmetadata.abc \
"https://demo1.test.dataone.org/knb/d1/mn/v1/object"h-jQ��h.h/h0jÿ��h2}rÉ��(j⁄��j€��h7]h6]h4]h5]h9]uh;KÌh<hh']rÑ��hEXõ��curl -X POST \
--cert /tmp/x509up_u502 \
-H "Charset: utf-8" \
-H "Content-Type: multipart/mixed; boundary=----------6B3C785C-6290-11DF-A355-A6ECDED72085_$" \
-H "Accept: text/xml" \
-H "User-Agent: pyd1/1.0 +http://dataone.org/" \
-F pid=10Dappend1.txt \
-F object=@content.bin \
-F sysmeta=@systemmetadata.abc \
"https://demo1.test.dataone.org/knb/d1/mn/v1/object"rÖ��ÖÅrÜ��}rá��(h,U�h-jÅ��ubaubhI)Årà��}râ��(h,Xj���Example serialized body of a HTTP POST request to the MN create() method
(excluding session information)::h-jQ��h.h/h0hLh2}rä��(h4]h5]h6]h7]h9]uh;K¯h<hh']rã��hEXi���Example serialized body of a HTTP POST request to the MN create() method
(excluding session information):rå��ÖÅrç��}ré��(h,Xi���Example serialized body of a HTTP POST request to the MN create() method
(excluding session information):h-jà��ubaubj’��)Årè��}rê��(h,X���TODOh-jQ��h.h/h0jÿ��h2}rë��(j⁄��j€��h7]h6]h4]h5]h9]uh;K¸h<hh']rí��hEX���TODOrì��ÖÅrî��}rï��(h,U�h-jè��ubaubeubh))Årñ��}ró��(h,U�h-jP��h.h/h0h1h2}rò��(h4]h5]h6]h7]rô��h ah9]rö��h auh;M�h<hh']rõ��(h>)Årú��}rù��(h,X���Message Body in DELETErû��h-jñ��h.h/h0hBh2}rü��(h4]h5]h6]h7]h9]uh;M�h<hh']r†��hEX���Message Body in DELETEr°��ÖÅr¢��}r£��(h,jû��h-jú��ubaubhI)År§��}r•��(h,X+��RFC2046_ does not explicitly prevent the presence of a message body in a HTTP
DELETE request, however support for transmission of the request payload may vary
by technology. DELETE requests requiring a request payload MUST have
accompanying integration tests that exercise the technologies involved.h-jñ��h.h/h0hLh2}r¶��(h4]h5]h6]h7]h9]uh;Mh<hh']rß��(j-��)År®��}r©��(h,X���RFC2046_j0��Kh-j§��h0j1��h2}r™��(UnameX���RFC2046j3��j4��h7]h6]h4]h5]h9]uh']r´��hEX���RFC2046r¨��ÖÅr≠��}rÆ��(h,U�h-j®��ubaubhEX#�� does not explicitly prevent the presence of a message body in a HTTP
DELETE request, however support for transmission of the request payload may vary
by technology. DELETE requests requiring a request payload MUST have
accompanying integration tests that exercise the technologies involved.rØ��ÖÅr∞��}r±��(h,X#�� does not explicitly prevent the presence of a message body in a HTTP
DELETE request, however support for transmission of the request payload may vary
by technology. DELETE requests requiring a request payload MUST have
accompanying integration tests that exercise the technologies involved.h-j§��ubeubcdocutils.nodes
target
r≤��)År≥��}r¥��(h,X=���.. _RFC2046: http://tools.ietf.org/html/rfc2046#section-5.1.3U
referencedrµ��Kh-jñ��h.h/h0Utargetr∂��h2}r∑��(j3��j4��h7]r∏��hah6]h4]h5]h9]rπ��hauh;Mh<hh']ubj≤��)År∫��}rª��(h,X/���.. _RFC3986: http://tools.ietf.org/html/rfc3986jµ��Kh-jñ��h.h/h0j∂��h2}rº��(j3��jÕ��h7]rΩ��h#ah6]h4]h5]h9]ræ��hauh;M
h<hh']ubeubeubeubah,U�U transformerrø��NU
footnote_refsr¿��}r¡��Urefnamesr¬��}r√��(X���rfc2046]rƒ��(j.��jf��j®��eX���rfc3986]r≈��(j ��jı��euUsymbol_footnotesr∆��]r«��Uautofootnote_refsr»��]r…��Usymbol_footnote_refsr ��]rÀ��U citationsrÃ��]rÕ��h<hU current_linerŒ��NUtransform_messagesrœ��]r–��Ureporterr—��NUid_startr“��KU
autofootnotesr”��]r‘��U
citation_refsr’��}r÷��Uindirect_targetsr◊��]rÿ��UsettingsrŸ��(cdocutils.frontend
Values
r⁄��or€��}r‹��(Ufootnote_backlinksr›��KUrecord_dependenciesrfi��NU rfc_base_urlrfl��U https://tools.ietf.org/html/r‡��U tracebackr·��àUpep_referencesr‚��NUstrip_commentsr„��NU
toc_backlinksr‰��UentryrÂ��U
language_coderÊ��UenrÁ��U datestamprË��NU report_levelrÈ��KU _destinationrÍ��NU
halt_levelr��KU
strip_classesrÏ��NhBNU error_encoding_error_handlerrÌ��UbackslashreplacerÓ��UdebugrÔ��NUembed_stylesheetr��âU output_encoding_error_handlerrÒ��UstrictrÚ��U
sectnum_xformr��KUdump_transformsr��NU
docinfo_xformrı��KUwarning_streamrˆ��NUpep_file_url_templater˜��Upep-%04dr¯��Uexit_status_levelr˘��KUconfigr˙��NUstrict_visitorr˚��NUcloak_email_addressesr¸��àU trim_footnote_reference_spacer˝��âUenvr˛��NUdump_pseudo_xmlrˇ��NUexpose_internalsr���NUsectsubtitle_xformr��âU source_linkr��NUrfc_referencesr��NUoutput_encodingr��Uutf-8r��U
source_urlr��NUinput_encodingr��U utf-8-sigr��U_disable_configr ��NU id_prefixr
��U�U tab_widthr ��KUerror_encodingr ��UUTF-8r
��U_sourcer��h/Ugettext_compactr��àU generatorr��NUdump_internalsr��NU smart_quotesr��âU pep_base_urlr��U https://www.python.org/dev/peps/r��Usyntax_highlightr��Ulongr��U input_encoding_error_handlerr��jÚ��Uauto_id_prefixr��Uidr��Udoctitle_xformr��âUstrip_elements_with_classesr��NU
_config_filesr ��]r ��Ufile_insertion_enabledr ��àU raw_enabledr ��KU
dump_settingsr ��NubUsymbol_footnote_startr!��K�Uidsr"��}r#��(hj≥��h%jP��h j‰��h$jˇ��h jµ��h"jå��h j��h&j‡��h jñ��h#j∫��h!h*h jQ��uUsubstitution_namesr$��}r%��h0h<h2}r&��(h4]h7]h6]Usourceh/h5]h9]uU footnotesr'��]r(��Urefidsr)��}r*��ub.