Doc: document storage uploading with examples

Author: Antti Myyrä

docs/Storage.md

@@ -50,12 +50,14 @@ Storage can be created with the CloudManager's `.create_storage(size=10, tier="m
 
 ```python
 
-storage1 = manager.create_storage(	size=10,
-									tier="maxiops",
-									title="my storage disk",
-									zone='fi-hel1' )
+storage1 = manager.create_storage(
+    zone='fi-hel1',
+    size=10,
+	tier="maxiops",
+	title="my storage disk"
+)
 
-storage2 = manager.create_storage(100, zone='fi-hel1')
+storage2 = manager.create_storage(zone='de-fra1', size=100)
 
 ```
 
@@ -81,6 +83,52 @@ storage.destroy()
 
 ```
 
+## Import
+
+Storages can be imported either by passing a URL or by uploading the file. Currently .iso, .raw and .img formats
+are supported. Other formats like qcow2 or vmdk should be converted before uploading.
+
+Warning: size of the import cannot exceed the size of the storage. The data will be written starting from
+the beginning of the storage, and the storage will not be truncated before starting to write.
+
+Storages can be uploaded by providing a URL.
+```python
+
+new_storage = manager.create_storage(size=20, zone='nl-ams1')
+storage_import = manager.create_storage_import(
+    storage=new_storage.uuid,
+    source='http_import',
+    source_location='https://username:password@example.server/path/to/data.raw',
+)
+
+import_details = manager.get_storage_import_details(new_storage.uuid)
+
+```
+
+Other way is to upload a storage directly. Note that unlike with URLs, file upload will block until it has been
+fully uploaded.
+```python
+
+from pathlib import Path
+
+new_storage = manager.create_storage(size=20, zone='de-fra1', title='New imported storage')
+storage_import = manager.create_storage_import(storage=new_storage.uuid, source='direct_upload')
+
+manager.upload_file_for_storage_import(
+    storage_import=storage_import,
+    file=Path('/path/to/your/storage.img'),
+)
+
+import_details = manager.get_storage_import_details(new_storage.uuid)
+
+```
+
+Ongoing imports can also be cancelled:
+```python
+
+manager.cancel_storage_import(new_storage.uuid)
+
+```
 
 ## Clone