RAPI documentation: Add link targets

A newly added table of RAPI access permissions will link to all
resources and their supported methods. For this reason link targets need
to be added.

The GET method on “/2/nodes/[node_name]” was not separately mentioned.
This is also fixed.

Signed-off-by: Michael Hanselmann <hansmi@google.com>
Reviewed-by: Guido Trotter <ultrotter@google.com>

diff --git a/doc/rapi.rst b/doc/rapi.rst
index 04439f2..23f827e 100644 (file)
--- a/doc/rapi.rst
+++ b/doc/rapi.rst
@@ -330,6 +330,8 @@ method is supported.
 
 Has no function, but for legacy reasons the ``GET`` method is supported.
 
+.. _rapi-res-info:
+
 ``/2/info``
 +++++++++++
 
@@ -337,6 +339,8 @@ Cluster information resource.
 
 It supports the following commands: ``GET``.
 
+.. _rapi-res-info+get:
+
 ``GET``
 ~~~~~~~
 
@@ -375,6 +379,8 @@ Example::
   }
 
 
+.. _rapi-res-redistribute-config:
+
 ``/2/redistribute-config``
 ++++++++++++++++++++++++++
 
@@ -382,6 +388,9 @@ Redistribute configuration to all nodes.
 
 It supports the following commands: ``PUT``.
 
+
+.. _rapi-res-redistribute-config+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -392,9 +401,14 @@ Job result:
 .. opcode_result:: OP_CLUSTER_REDIST_CONF
 
 
+.. _rapi-res-features:
+
 ``/2/features``
 +++++++++++++++
 
+
+.. _rapi-res-features+get:
+
 ``GET``
 ~~~~~~~
 
@@ -420,6 +434,8 @@ features:
   a new-style result (see resource description)
 
 
+.. _rapi-res-modify:
+
 ``/2/modify``
 ++++++++++++++++++++++++++++++++++++++++
 
@@ -427,6 +443,9 @@ Modifies cluster parameters.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-modify+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -441,6 +460,8 @@ Job result:
 .. opcode_result:: OP_CLUSTER_SET_PARAMS
 
 
+.. _rapi-res-groups:
+
 ``/2/groups``
 +++++++++++++
 
@@ -448,6 +469,8 @@ The groups resource.
 
 It supports the following commands: ``GET``, ``POST``.
 
+.. _rapi-res-groups+get:
+
 ``GET``
 ~~~~~~~
 
@@ -497,6 +520,9 @@ Example::
       …
     ]
 
+
+.. _rapi-res-groups+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -519,6 +545,8 @@ Job result:
 .. opcode_result:: OP_GROUP_ADD
 
 
+.. _rapi-res-groups-group_name:
+
 ``/2/groups/[group_name]``
 ++++++++++++++++++++++++++
 
@@ -526,6 +554,8 @@ Returns information about a node group.
 
 It supports the following commands: ``GET``, ``DELETE``.
 
+.. _rapi-res-groups-group_name+get:
+
 ``GET``
 ~~~~~~~
 
@@ -534,6 +564,8 @@ the node group list.
 
 Returned fields: :pyeval:`utils.CommaJoin(sorted(rlib2.G_FIELDS))`.
 
+.. _rapi-res-groups-group_name+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -546,6 +578,8 @@ Job result:
 .. opcode_result:: OP_GROUP_REMOVE
 
 
+.. _rapi-res-groups-group_name-modify:
+
 ``/2/groups/[group_name]/modify``
 +++++++++++++++++++++++++++++++++
 
@@ -553,6 +587,8 @@ Modifies the parameters of a node group.
 
 Supports the following commands: ``PUT``.
 
+.. _rapi-res-groups-group_name-modify+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -568,6 +604,8 @@ Job result:
 .. opcode_result:: OP_GROUP_SET_PARAMS
 
 
+.. _rapi-res-groups-group_name-rename:
+
 ``/2/groups/[group_name]/rename``
 +++++++++++++++++++++++++++++++++
 
@@ -575,6 +613,8 @@ Renames a node group.
 
 Supports the following commands: ``PUT``.
 
+.. _rapi-res-groups-group_name-rename+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -590,6 +630,8 @@ Job result:
 .. opcode_result:: OP_GROUP_RENAME
 
 
+.. _rapi-res-groups-group_name-assign-nodes:
+
 ``/2/groups/[group_name]/assign-nodes``
 +++++++++++++++++++++++++++++++++++++++
 
@@ -597,6 +639,8 @@ Assigns nodes to a group.
 
 Supports the following commands: ``PUT``.
 
+.. _rapi-res-groups-group_name-assign-nodes+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -611,6 +655,7 @@ Job result:
 
 .. opcode_result:: OP_GROUP_ASSIGN_NODES
 
+.. _rapi-res-groups-group_name-tags:
 
 ``/2/groups/[group_name]/tags``
 +++++++++++++++++++++++++++++++
@@ -619,6 +664,8 @@ Manages per-nodegroup tags.
 
 Supports the following commands: ``GET``, ``PUT``, ``DELETE``.
 
+.. _rapi-res-groups-group_name-tags+get:
+
 ``GET``
 ~~~~~~~
 
@@ -628,6 +675,8 @@ Example::
 
     ["tag1", "tag2", "tag3"]
 
+.. _rapi-res-groups-group_name-tags+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -639,6 +688,8 @@ result will be a job id.
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-groups-group_name-tags+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -652,6 +703,8 @@ to URI like::
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-networks:
+
 ``/2/networks``
 +++++++++++++++
 
@@ -659,6 +712,9 @@ The networks resource.
 
 It supports the following commands: ``GET``, ``POST``.
 
+
+.. _rapi-res-networks+get:
+
 ``GET``
 ~~~~~~~
 
@@ -705,6 +761,9 @@ Example::
       …
     ]
 
+
+.. _rapi-res-networks+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -724,6 +783,8 @@ Job result:
 .. opcode_result:: OP_NETWORK_ADD
 
 
+.. _rapi-res-networks-network_name:
+
 ``/2/networks/[network_name]``
 ++++++++++++++++++++++++++++++
 
@@ -731,6 +792,9 @@ Returns information about a network.
 
 It supports the following commands: ``GET``, ``DELETE``.
 
+
+.. _rapi-res-networks-network_name+get:
+
 ``GET``
 ~~~~~~~
 
@@ -739,6 +803,9 @@ the network list.
 
 Returned fields: :pyeval:`utils.CommaJoin(sorted(rlib2.NET_FIELDS))`.
 
+
+.. _rapi-res-networks-network_name+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -751,6 +818,8 @@ Job result:
 .. opcode_result:: OP_NETWORK_REMOVE
 
 
+.. _rapi-res-networks-network_name-modify:
+
 ``/2/networks/[network_name]/modify``
 +++++++++++++++++++++++++++++++++++++
 
@@ -758,6 +827,9 @@ Modifies the parameters of a network.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-networks-network_name-modify+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -772,6 +844,8 @@ Job result:
 .. opcode_result:: OP_NETWORK_SET_PARAMS
 
 
+.. _rapi-res-networks-network_name-connect:
+
 ``/2/networks/[network_name]/connect``
 ++++++++++++++++++++++++++++++++++++++
 
@@ -779,6 +853,9 @@ Connects a network to a nodegroup.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-networks-network_name-connect+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -793,6 +870,8 @@ Job result:
 .. opcode_result:: OP_NETWORK_CONNECT
 
 
+.. _rapi-res-networks-network_name-disconnect:
+
 ``/2/networks/[network_name]/disconnect``
 +++++++++++++++++++++++++++++++++++++++++
 
@@ -800,6 +879,9 @@ Disonnects a network from a nodegroup.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-networks-network_name-disconnect+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -814,6 +896,8 @@ Job result:
 .. opcode_result:: OP_NETWORK_DISCONNECT
 
 
+.. _rapi-res-networks-network_name-tags:
+
 ``/2/networks/[network_name]/tags``
 +++++++++++++++++++++++++++++++++++
 
@@ -821,6 +905,9 @@ Manages per-network tags.
 
 Supports the following commands: ``GET``, ``PUT``, ``DELETE``.
 
+
+.. _rapi-res-networks-network_name-tags+get:
+
 ``GET``
 ~~~~~~~
 
@@ -830,6 +917,9 @@ Example::
 
     ["tag1", "tag2", "tag3"]
 
+
+.. _rapi-res-networks-network_name-tags+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -841,6 +931,8 @@ result will be a job id.
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-networks-network_name-tags+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -854,6 +946,8 @@ to URI like::
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-instances-multi-alloc:
+
 ``/2/instances-multi-alloc``
 ++++++++++++++++++++++++++++
 
@@ -861,6 +955,9 @@ Tries to allocate multiple instances.
 
 It supports the following commands: ``POST``
 
+
+.. _rapi-res-instances-multi-alloc+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -873,6 +970,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_MULTI_ALLOC
 
 
+.. _rapi-res-instances:
+
 ``/2/instances``
 ++++++++++++++++
 
@@ -880,6 +979,9 @@ The instances resource.
 
 It supports the following commands: ``GET``, ``POST``.
 
+
+.. _rapi-res-instances+get:
+
 ``GET``
 ~~~~~~~
 
@@ -935,6 +1037,8 @@ Example::
     ]
 
 
+.. _rapi-res-instances+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -965,6 +1069,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_CREATE
 
 
+.. _rapi-res-instances-instance_name:
+
 ``/2/instances/[instance_name]``
 ++++++++++++++++++++++++++++++++
 
@@ -972,6 +1078,9 @@ Instance-specific resource.
 
 It supports the following commands: ``GET``, ``DELETE``.
 
+
+.. _rapi-res-instances-instance_name+get:
+
 ``GET``
 ~~~~~~~
 
@@ -980,6 +1089,9 @@ the instance list.
 
 Returned fields: :pyeval:`utils.CommaJoin(sorted(rlib2.I_FIELDS))`.
 
+
+.. _rapi-res-instances-instance_name+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -992,11 +1104,16 @@ Job result:
 .. opcode_result:: OP_INSTANCE_REMOVE
 
 
+.. _rapi-res-instances-instance_name-info:
+
 ``/2/instances/[instance_name]/info``
 +++++++++++++++++++++++++++++++++++++++
 
 It supports the following commands: ``GET``.
 
+
+.. _rapi-res-instances-instance_name-info+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1010,6 +1127,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_QUERY_DATA
 
 
+.. _rapi-res-instances-instance_name-reboot:
+
 ``/2/instances/[instance_name]/reboot``
 +++++++++++++++++++++++++++++++++++++++
 
@@ -1017,6 +1136,9 @@ Reboots URI for an instance.
 
 It supports the following commands: ``POST``.
 
+
+.. _rapi-res-instances-instance_name-reboot+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1042,6 +1164,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_REBOOT
 
 
+.. _rapi-res-instances-instance_name-shutdown:
+
 ``/2/instances/[instance_name]/shutdown``
 +++++++++++++++++++++++++++++++++++++++++
 
@@ -1049,6 +1173,9 @@ Instance shutdown URI.
 
 It supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-shutdown+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1064,6 +1191,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_SHUTDOWN
 
 
+.. _rapi-res-instances-instance_name-startup:
+
 ``/2/instances/[instance_name]/startup``
 ++++++++++++++++++++++++++++++++++++++++
 
@@ -1071,6 +1200,9 @@ Instance startup URI.
 
 It supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-startup+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1086,6 +1218,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_STARTUP
 
 
+.. _rapi-res-instances-instance_name-reinstall:
+
 ``/2/instances/[instance_name]/reinstall``
 ++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -1093,6 +1227,9 @@ Installs the operating system again.
 
 It supports the following commands: ``POST``.
 
+
+.. _rapi-res-instances-instance_name-reinstall+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1112,6 +1249,8 @@ parameters ``os`` (OS template name) and ``nostartup`` (bool). New
 clients should use the body parameters.
 
 
+.. _rapi-res-instances-instance_name-replace-disks:
+
 ``/2/instances/[instance_name]/replace-disks``
 ++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -1119,6 +1258,9 @@ Replaces disks on an instance.
 
 It supports the following commands: ``POST``.
 
+
+.. _rapi-res-instances-instance_name-replace-disks+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1137,6 +1279,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_REPLACE_DISKS
 
 
+.. _rapi-res-instances-instance_name-activate-disks:
+
 ``/2/instances/[instance_name]/activate-disks``
 +++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -1144,6 +1288,9 @@ Activate disks on an instance.
 
 It supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-activate-disks+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1155,6 +1302,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_ACTIVATE_DISKS
 
 
+.. _rapi-res-instances-instance_name-deactivate-disks:
+
 ``/2/instances/[instance_name]/deactivate-disks``
 +++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -1162,6 +1311,9 @@ Deactivate disks on an instance.
 
 It supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-deactivate-disks+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1172,12 +1324,17 @@ Job result:
 .. opcode_result:: OP_INSTANCE_DEACTIVATE_DISKS
 
 
+.. _rapi-res-instances-instance_name-recreate-disks:
+
 ``/2/instances/[instance_name]/recreate-disks``
 +++++++++++++++++++++++++++++++++++++++++++++++++
 
 Recreate disks of an instance. Supports the following commands:
 ``POST``.
 
+
+.. _rapi-res-instances-instance_name-recreate-disks+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1193,6 +1350,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_RECREATE_DISKS
 
 
+.. _rapi-res-instances-instance_name-disk-disk_index-grow:
+
 ``/2/instances/[instance_name]/disk/[disk_index]/grow``
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -1200,6 +1359,9 @@ Grows one disk of an instance.
 
 Supports the following commands: ``POST``.
 
+
+.. _rapi-res-instances-instance_name-disk-disk_index-grow+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1215,6 +1377,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_GROW_DISK
 
 
+.. _rapi-res-instances-instance_name-prepare-export:
+
 ``/2/instances/[instance_name]/prepare-export``
 +++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -1222,6 +1386,9 @@ Prepares an export of an instance.
 
 It supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-prepare-export+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1232,6 +1399,8 @@ Job result:
 .. opcode_result:: OP_BACKUP_PREPARE
 
 
+.. _rapi-res-instances-instance_name-export:
+
 ``/2/instances/[instance_name]/export``
 +++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -1239,6 +1408,9 @@ Exports an instance.
 
 It supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-export+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1255,6 +1427,8 @@ Job result:
 .. opcode_result:: OP_BACKUP_EXPORT
 
 
+.. _rapi-res-instances-instance_name-migrate:
+
 ``/2/instances/[instance_name]/migrate``
 ++++++++++++++++++++++++++++++++++++++++
 
@@ -1262,6 +1436,9 @@ Migrates an instance.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-migrate+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1277,6 +1454,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_MIGRATE
 
 
+.. _rapi-res-instances-instance_name-failover:
+
 ``/2/instances/[instance_name]/failover``
 +++++++++++++++++++++++++++++++++++++++++
 
@@ -1284,6 +1463,9 @@ Does a failover of an instance.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-failover+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1299,6 +1481,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_FAILOVER
 
 
+.. _rapi-res-instances-instance_name-rename:
+
 ``/2/instances/[instance_name]/rename``
 ++++++++++++++++++++++++++++++++++++++++
 
@@ -1306,6 +1490,9 @@ Renames an instance.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-rename+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1321,6 +1508,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_RENAME
 
 
+.. _rapi-res-instances-instance_name-modify:
+
 ``/2/instances/[instance_name]/modify``
 ++++++++++++++++++++++++++++++++++++++++
 
@@ -1328,6 +1517,9 @@ Modifies an instance.
 
 Supports the following commands: ``PUT``.
 
+
+.. _rapi-res-instances-instance_name-modify+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1343,6 +1535,8 @@ Job result:
 .. opcode_result:: OP_INSTANCE_SET_PARAMS
 
 
+.. _rapi-res-instances-instance_name-console:
+
 ``/2/instances/[instance_name]/console``
 ++++++++++++++++++++++++++++++++++++++++
 
@@ -1358,6 +1552,9 @@ Supports the following commands: ``GET``. Requires authentication with
 one of the following options:
 :pyeval:`utils.CommaJoin(rlib2.R_2_instances_name_console.GET_ACCESS)`.
 
+
+.. _rapi-res-instances-instance_name-console+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1409,6 +1606,8 @@ console. Contained keys:
   VNC display number (:pyeval:`constants.CONS_VNC` only)
 
 
+.. _rapi-res-instances-instance_name-tags:
+
 ``/2/instances/[instance_name]/tags``
 +++++++++++++++++++++++++++++++++++++
 
@@ -1416,6 +1615,9 @@ Manages per-instance tags.
 
 It supports the following commands: ``GET``, ``PUT``, ``DELETE``.
 
+
+.. _rapi-res-instances-instance_name-tags+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1425,6 +1627,9 @@ Example::
 
     ["tag1", "tag2", "tag3"]
 
+
+.. _rapi-res-instances-instance_name-tags+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1436,6 +1641,8 @@ result will be a job id.
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-instances-instance_name-tags+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -1449,6 +1656,8 @@ to URI like::
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-jobs:
+
 ``/2/jobs``
 +++++++++++
 
@@ -1456,6 +1665,9 @@ The ``/2/jobs`` resource.
 
 It supports the following commands: ``GET``.
 
+
+.. _rapi-res-jobs+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1471,6 +1683,9 @@ Returned fields for bulk requests (unlike other bulk requests, these
 fields are not the same as for per-job requests):
 :pyeval:`utils.CommaJoin(sorted(rlib2.J_FIELDS_BULK))`.
 
+
+.. _rapi-res-jobs-job_id:
+
 ``/2/jobs/[job_id]``
 ++++++++++++++++++++
 
@@ -1479,6 +1694,9 @@ Individual job URI.
 
 It supports the following commands: ``GET``, ``DELETE``.
 
+
+.. _rapi-res-jobs-job_id+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1565,15 +1783,22 @@ Note that in the above list, by entity we refer to a node or instance,
 while by a resource we refer to an instance's disk, or NIC, etc.
 
 
+.. _rapi-res-jobs-job_id+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
 Cancel a not-yet-started job.
 
 
+.. _rapi-res-jobs-job_id-wait:
+
 ``/2/jobs/[job_id]/wait``
 +++++++++++++++++++++++++
 
+
+.. _rapi-res-jobs-job_id-wait+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1594,6 +1819,8 @@ Returns None if no changes have been detected and a dict with two keys,
 ``job_info`` and ``log_entries`` otherwise.
 
 
+.. _rapi-res-nodes:
+
 ``/2/nodes``
 ++++++++++++
 
@@ -1601,6 +1828,9 @@ Nodes resource.
 
 It supports the following commands: ``GET``.
 
+
+.. _rapi-res-nodes+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1644,6 +1874,9 @@ Example::
       …
     ]
 
+
+.. _rapi-res-nodes-node_name:
+
 ``/2/nodes/[node_name]``
 +++++++++++++++++++++++++++++++++
 
@@ -1651,13 +1884,26 @@ Returns information about a node.
 
 It supports the following commands: ``GET``.
 
+
+.. _rapi-res-nodes-node_name+get:
+
+``GET``
+~~~~~~~
+
 Returned fields: :pyeval:`utils.CommaJoin(sorted(rlib2.N_FIELDS))`.
 
+
+
+.. _rapi-res-nodes-node_name-powercycle:
+
 ``/2/nodes/[node_name]/powercycle``
 +++++++++++++++++++++++++++++++++++
 
 Powercycles a node. Supports the following commands: ``POST``.
 
+
+.. _rapi-res-nodes-node_name-powercycle+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1668,6 +1914,8 @@ Job result:
 .. opcode_result:: OP_NODE_POWERCYCLE
 
 
+.. _rapi-res-nodes-node_name-evacuate:
+
 ``/2/nodes/[node_name]/evacuate``
 +++++++++++++++++++++++++++++++++
 
@@ -1675,6 +1923,9 @@ Evacuates instances off a node.
 
 It supports the following commands: ``POST``.
 
+
+.. _rapi-res-nodes-node_name-evacuate+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1695,6 +1946,8 @@ Job result:
 .. opcode_result:: OP_NODE_EVACUATE
 
 
+.. _rapi-res-nodes-node_name-migrate:
+
 ``/2/nodes/[node_name]/migrate``
 +++++++++++++++++++++++++++++++++
 
@@ -1702,6 +1955,8 @@ Migrates all primary instances from a node.
 
 It supports the following commands: ``POST``.
 
+.. _rapi-res-nodes-node_name-migrate+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1720,6 +1975,8 @@ Job result:
 .. opcode_result:: OP_NODE_MIGRATE
 
 
+.. _rapi-res-nodes-node_name-role:
+
 ``/2/nodes/[node_name]/role``
 +++++++++++++++++++++++++++++
 
@@ -1738,6 +1995,9 @@ Note that the 'master' role is a special, and currently it can't be
 modified via RAPI, only via the command line (``gnt-cluster
 master-failover``).
 
+
+.. _rapi-res-nodes-node_name-role+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1747,6 +2007,9 @@ Example::
 
     "master-candidate"
 
+
+.. _rapi-res-nodes-node_name-role+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1762,12 +2025,17 @@ Job result:
 .. opcode_result:: OP_NODE_SET_PARAMS
 
 
+.. _rapi-res-nodes-node_name-modify:
+
 ``/2/nodes/[node_name]/modify``
 +++++++++++++++++++++++++++++++
 
 Modifies the parameters of a node. Supports the following commands:
 ``POST``.
 
+
+.. _rapi-res-nodes-node_name-modify+post:
+
 ``POST``
 ~~~~~~~~
 
@@ -1783,11 +2051,15 @@ Job result:
 .. opcode_result:: OP_NODE_SET_PARAMS
 
 
+.. _rapi-res-nodes-node_name-storage:
+
 ``/2/nodes/[node_name]/storage``
 ++++++++++++++++++++++++++++++++
 
 Manages storage units on the node.
 
+.. _rapi-res-nodes-node_name-storage+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1803,11 +2075,17 @@ Requests a list of storage units on a node. Requires the parameters
 ``output_fields``. The result will be a job id, using which the result
 can be retrieved.
 
+
+.. _rapi-res-nodes-node_name-storage-modify:
+
 ``/2/nodes/[node_name]/storage/modify``
 +++++++++++++++++++++++++++++++++++++++
 
 Modifies storage units on the node.
 
+
+.. _rapi-res-nodes-node_name-storage-modify+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1823,11 +2101,16 @@ Job result:
 .. opcode_result:: OP_NODE_MODIFY_STORAGE
 
 
+.. _rapi-res-nodes-node_name-storage-repair:
+
 ``/2/nodes/[node_name]/storage/repair``
 +++++++++++++++++++++++++++++++++++++++
 
 Repairs a storage unit on the node.
 
+
+.. _rapi-res-nodes-node_name-storage-repair+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1847,6 +2130,8 @@ Job result:
 .. opcode_result:: OP_REPAIR_NODE_STORAGE
 
 
+.. _rapi-res-nodes-node_name-tags:
+
 ``/2/nodes/[node_name]/tags``
 +++++++++++++++++++++++++++++
 
@@ -1854,6 +2139,9 @@ Manages per-node tags.
 
 It supports the following commands: ``GET``, ``PUT``, ``DELETE``.
 
+
+.. _rapi-res-nodes-node_name-tags+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1863,6 +2151,9 @@ Example::
 
     ["tag1", "tag2", "tag3"]
 
+
+.. _rapi-res-nodes-node_name-tags+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1873,6 +2164,9 @@ will be a job id.
 
 It supports the ``dry-run`` argument.
 
+
+.. _rapi-res-nodes-node_name-tags+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -1886,6 +2180,8 @@ to URI like::
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-query-resource:
+
 ``/2/query/[resource]``
 +++++++++++++++++++++++
 
@@ -1904,6 +2200,9 @@ Supports the following commands: ``GET``, ``PUT``. Requires
 authentication with one of the following options:
 :pyeval:`utils.CommaJoin(rlib2.R_2_query.GET_ACCESS)`.
 
+
+.. _rapi-res-query-resource+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1911,6 +2210,9 @@ Returns list of included fields and actual data. Takes a query parameter
 named "fields", containing a comma-separated list of field names. Does
 not support filtering.
 
+
+.. _rapi-res-query-resource+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1921,6 +2223,8 @@ be given and must be either ``null`` or a list containing filter
 operators.
 
 
+.. _rapi-res-query-resource-fields:
+
 ``/2/query/[resource]/fields``
 ++++++++++++++++++++++++++++++
 
@@ -1930,6 +2234,9 @@ Request list of available fields for a resource. The resource is one of
 
 Supports the following commands: ``GET``.
 
+
+.. _rapi-res-query-resource-fields+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1938,6 +2245,8 @@ optional query parameter named "fields", containing a comma-separated
 list of field names.
 
 
+.. _rapi-res-os:
+
 ``/2/os``
 +++++++++
 
@@ -1945,6 +2254,9 @@ OS resource.
 
 It supports the following commands: ``GET``.
 
+
+.. _rapi-res-os+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1957,6 +2269,9 @@ Example::
 
     ["debian-etch"]
 
+
+.. _rapi-res-tags:
+
 ``/2/tags``
 +++++++++++
 
@@ -1964,6 +2279,9 @@ Manages cluster tags.
 
 It supports the following commands: ``GET``, ``PUT``, ``DELETE``.
 
+
+.. _rapi-res-tags+get:
+
 ``GET``
 ~~~~~~~
 
@@ -1973,6 +2291,9 @@ Example::
 
     ["tag1", "tag2", "tag3"]
 
+
+.. _rapi-res-tags+put:
+
 ``PUT``
 ~~~~~~~
 
@@ -1984,6 +2305,8 @@ will be a job id.
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-tags+delete:
+
 ``DELETE``
 ~~~~~~~~~~
 
@@ -1997,6 +2320,8 @@ to URI like::
 It supports the ``dry-run`` argument.
 
 
+.. _rapi-res-version:
+
 ``/version``
 ++++++++++++
 
@@ -2007,6 +2332,8 @@ adapt clients accordingly.
 
 It supports the following commands: ``GET``.
 
+.. _rapi-res-version+get:
+
 ``GET``
 ~~~~~~~