Changeset View
Changeset View
Standalone View
Standalone View
docs/user-manual.rst
Show First 20 Lines • Show All 334 Lines • ▼ Show 20 Lines | |||||
Multisteps deposit | Multisteps deposit | ||||
^^^^^^^^^^^^^^^^^^ | ^^^^^^^^^^^^^^^^^^ | ||||
In this case, the deposit is created by several requests, uploading objects | In this case, the deposit is created by several requests, uploading objects | ||||
piece by piece. The steps to create a multisteps deposit: | piece by piece. The steps to create a multisteps deposit: | ||||
1. Create an partial deposit | 1. Create an partial deposit | ||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | """""""""""""""""""""""""""" | ||||
First use the ``--partial`` argument to declare there is more to come | First use the ``--partial`` argument to declare there is more to come | ||||
.. code:: console | .. code:: console | ||||
$ swh deposit upload --username name --password secret \ | $ swh deposit upload --username name --password secret \ | ||||
--archive foo.tar.gz \ | --archive foo.tar.gz \ | ||||
--partial | --partial | ||||
2. Add content or metadata to the deposit | 2. Add content or metadata to the deposit | ||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | """"""""""""""""""""""""""""""""""""""""" | ||||
Continue the deposit by using the ``--deposit-id`` argument given as a response | Continue the deposit by using the ``--deposit-id`` argument given as a response | ||||
for the first step. You can continue adding content or metadata while you use | for the first step. You can continue adding content or metadata while you use | ||||
the ``--partial`` argument. | the ``--partial`` argument. | ||||
To only add one new archive to the deposit: | To only add one new archive to the deposit: | ||||
.. code:: console | .. code:: console | ||||
Show All 9 Lines | .. code:: console | ||||
$ swh deposit upload --username name --password secret \ | $ swh deposit upload --username name --password secret \ | ||||
--metadata add-foo.tar.gz.metadata.xml \ | --metadata add-foo.tar.gz.metadata.xml \ | ||||
--deposit-id 42 \ | --deposit-id 42 \ | ||||
--partial | --partial | ||||
3. Finalize deposit | 3. Finalize deposit | ||||
~~~~~~~~~~~~~~~~~~~ | """"""""""""""""""" | ||||
On your last addition (same command as before), by not declaring it | On your last addition (same command as before), by not declaring it | ||||
``--partial``, the deposit will be considered completed. Its status will be | ``--partial``, the deposit will be considered completed. Its status will be | ||||
changed to ``deposited``: | changed to ``deposited``: | ||||
.. code:: console | .. code:: console | ||||
$ swh deposit upload --username name --password secret \ | $ swh deposit upload --username name --password secret \ | ||||
▲ Show 20 Lines • Show All 97 Lines • Show Last 20 Lines |