**Examples**

The outgoing request body *must* be encoded as `MIME multipart/form-data`_ with
the system metadata portion and the object as file attachments.

(POST) Create a new object with a given identifier (*XYZ33256*)::

  curl -E /tmp/x509up_u502 \
       -F "pid=XYZ33256" \
       -F "object=@sciencemetadata.xml" \
       -F "sysmeta=@sysmeta.xml" \
       https://m1.dataone.org/mn/v1/object
  
  HTTP/1.1 200 Success
  Content-Type: 
  Date: Wed, 16 Dec 2009 13:58:34 GMT
  Content-Length: 355
  
  XYZ33256

The system metadata included with the create call must contain values for the
elements required to be set by clients (see :doc:`/design/SystemMetadata`). The
system metadata document can be crafted by hand or preferably with a tool such
as *generate_sysmeta.py* which is available in the d1_instance_generator_ Python
package. See documentation included with that package for more information on
its operation.

For example, the system metadata document for the example above was generated
using the sequence of commands::

  <<log on to cilogon.org and download my certificate>>
  
  MYSUBJECT=`python my_subject.py /tmp/x509up_u502`
  echo $MYSUBJECT
  
  CN=Dave Vieglais T799,O=Google,C=US,DC=cilogon,DC=org
  
  python generate_sysmeta.py -f sciencemetadata.xml \
                             -i "XYZ33256" \
                             -s "$MYSUBJECT" \
                             -t "eml://ecoinformatics.org/eml-2.0.1" \
                              > sysmeta.xml


The generated system metadata document contains default information that indicates:

- The submitter is ``CN=Dave Vieglais T799,O=Google,C=US,DC=cilogon,DC=org``
- The rights holder is the same as the submitter
- The access policy indicates public read, and write by the submitter
- The replication policy indicates replication is allowed to any node

The generated system metadata document is presented below::

  <?xml version='1.0' encoding='UTF-8'?>
  <ns1:systemMetadata xmlns:ns1="http://ns.dataone.org/service/types/v1">
    <identifier>XYZ33256</identifier>
    <formatId>eml://ecoinformatics.org/eml-2.0.1</formatId>
    <size>22936</size>
    <checksum algorithm="MD5">2ec0084d1e11e0d5c9a46ba6a230aa85</checksum>
    <submitter>CN=Dave Vieglais T799,O=Google,C=US,DC=cilogon,DC=org</submitter>
    <rightsHolder>CN=Dave Vieglais T799,O=Google,C=US,DC=cilogon,DC=org</rightsHolder>
    <accessPolicy>
      <allow>
        <subject>public</subject>
        <permission>read</permission>
      </allow>
      <allow>
        <subject>CN=Dave Vieglais T799,O=Google,C=US,DC=cilogon,DC=org</subject>
        <permission>changePermission</permission>
      </allow>
    </accessPolicy>
    <replicationPolicy replicationAllowed="true"/>
    <dateUploaded>2012-02-20T20:39:19.664495</dateUploaded>
    <dateSysMetadataModified>2012-02-20T20:39:19.70598</dateSysMetadataModified>
  </ns1:systemMetadata>


.. _d1_instance_generator: https://repository.dataone.org/software/cicore/trunk/d1_instance_generator