REST-API.md

@@ -3,56 +3,70 @@
 Bob has an REST Api specified in 
 [config-examples/openapi.yaml](https://github.com/qoollo/bob/blob/master/config-examples/openapi.yaml).
 
-## Methods
 
-* [GET /status](#status)
-* [GET /nodes](#nodes)
-* [GET /metadata/distrfunc](#distrfunc)
-* [GET /vdisks](#vdisks)
-* [GET /vdisks/{VDiskId}](#vdisks_by_id)
-* [GET /vdisks/{VDiskId}/records/count](#vdisks_records_count)
-* [GET /vdisks/{VDiskId}/partitions](#toc)
-* [GET /vdisks/{VDiskId}/partitions/{partitionId}](#toc)
-* [DELETE /vdisks/{VDiskId}/partitions/by_timestamp/{timestamp}](#toc)
-* [PUT /vdisks/{VDiskId}/partitions/by_timestamp/{timestamp}/{action}](#toc)
-* [GET /disks/list](#toc)
-* [POST /disks/{disk_name}/start](#toc)
-* [POST /vdisks/{vdisk_id}/remount](#toc)
-* [DELETE /blobs/outdated](#toc)
-* [GET /alien](#toc)
-* [GET /alien/dir](#toc)
-* [GET /vdisks/{vdisk_id}/replicas/local/dirs](#toc)
+<a name="toc"></a>
+
+- [REST API](#rest-api)
+  - [Methods](#methods)
+    - [GET /status](#get-status)
+    - [GET /nodes](#get-nodes)
+    - [GET /metadata/distrfunc](#get-metadatadistrfunc)
+    - [GET /vdisks](#get-vdisks)
+    - [GET /vdisks/{VDiskId}](#get-vdisksvdiskid)
+    - [GET /vdisks/{VDiskId}/records/count](#get-vdisksvdiskidrecordscount)
+    - [GET /vdisks/{VDiskId}/partitions](#get-vdisksvdiskidpartitions)
+    - [GET /vdisks/{VDiskId}/partitions/{partitionId}](#get-vdisksvdiskidpartitionspartitionid)
+    - [DELETE /vdisks/{VDiskId}/partitions/by_timestamp/{timestamp}](#delete-vdisksvdiskidpartitionsby_timestamptimestamp)
+    - [PUT /vdisks/{VDiskId}/partitions/by_timestamp/{timestamp}/{action}](#put-vdisksvdiskidpartitionsby_timestamptimestampaction)
+    - [GET /disks/list](#get-diskslist)
+    - [POST /disks/{disk_name}/stop](#post-disksdisk_namestop)
+    - [POST /disks/{disk_name}/start](#post-disksdisk_namestart)
+    - [POST /vdisks/{vdisk_id}/remount](#post-vdisksvdisk_idremount)
+    - [DELETE /blobs/outdated](#delete-blobsoutdated)
+    - [GET /alien](#get-alien)
+    - [GET /alien/dir](#get-aliendir)
+    - [GET /vdisks/{vdisk_id}/replicas/local/dirs](#get-vdisksvdisk_idreplicaslocaldirs)
+
+## Methods
 
+<a name="status"></a>
 ### GET /status 
 Returns information about this node.
 
+<a name="nodes"></a>
 ### GET /nodes 
 Returns a list of known nodes and vdisks on them.
 
+<a name="distrfunc"></a>
 ### GET /metadata/distrfunc 
 Return information about key distribution function
 
+<a name="vdisks"></a>
 ### GET /vdisks 
 Returns a list of vdisks 
 
+<a name="vdisks_id"></a>
 ### GET /vdisks/{VDiskId} 
 Returns a vdisk info by ID
 
 Arguments:
 * VDiskId - unsigned 32bit integer
 
+<a name="vdisks_id_records_count"></a>
 ### GET /vdisks/{VDiskId}/records/count 
 Returns count of records of this on node
 
 Arguments:
 * VDiskId - unsigned 32bit integer
 
+<a name="vdisks_id_partitions"></a>
 ### GET /vdisks/{VDiskId}/partitions 
 Returns a list of partitions
 
 Arguments:
 * VDiskId - unsigned 32bit integer
 
+<a name="vdisks_id_partitions_id"></a>
 ### GET /vdisks/{VDiskId}/partitions/{partitionId} 
 Returns a partition info by ID
 
@@ -60,6 +74,7 @@ Arguments:
 * VDiskId - unsigned 32bit integer
 * partitionId - string
 
+<a name="vdisks_id_partitions_by_timestamp"></a>
 ### DELETE /vdisks/{VDiskId}/partitions/by_timestamp/{timestamp} 
 Delete partitions by timestamp
 
@@ -67,6 +82,7 @@ Arguments:
 * VDiskId - unsigned 32bit integer
 * timestamp - unsigned 64bit integer
 
+<a name="vdisks_id_partitions_by_timestamp_action"></a>
 ### PUT /vdisks/{VDiskId}/partitions/by_timestamp/{timestamp}/{action} 
 Attach/Detach a partition by timestamp
 
@@ -75,36 +91,44 @@ Arguments:
 * timestamp - unsigned 64bit integer
 * action - 'attach' or 'detach' string
 
+<a name="disks_list"></a>
 ### GET /disks/list 
 Returns the list of disks with their states
 
+<a name="disks_name_stop"></a>
 ### POST /disks/{disk_name}/stop 
 Stops all disks controller for disk
 
 Arguments:
 * disk_name - string
 
+<a name="disks_name_start"></a>
 ### POST /disks/{disk_name}/start 
 Trying to start all disk controllers for disk
 
 Arguments:
 * disk_name - string
   
+<a name="vdisks_id_remount"></a>
 ### POST /vdisks/{vdisk_id}/remount 
 Remount partitions on vdisk
 
 Arguments:
 * vdisk_id - unsigned 32bit integer
 
+<a name="blobs_outdated"></a>
 ### DELETE /blobs/outdated 
 Close active blobs of holders not used recently
 
+<a name="alien"></a>
 ### GET /alien 
 Returns an alien dir info
 
+<a name="alien_dir"></a>
 ### GET /alien/dir 
 Return directory of alien
 
+<a name="vdisks_id_replicas_local_dirs"></a>
 ### GET /vdisks/{vdisk_id}/replicas/local/dirs 
 Returns directories of local replicas of vdisk