MAAS

Merge ~jsseidel/maas:jsseidel-load-nodes-examples-by-default into maas:master

Proposed by Spencer Seidel on 2018-11-26

Status:	Merged
Approved by:	Newell Jensen on 2018-11-26
Approved revision:	0c2b1dab0c5a4ef476666d1e11a041d776244d98
Merge reported by:	MAAS Lander
Merged at revision:	not available
Proposed branch:	~jsseidel/maas:jsseidel-load-nodes-examples-by-default
Merge into:	maas:master
Diff against target:	3358 lines (+2970/-168) 4 files modified src/maasserver/api/annotations.py (+31/-10) src/maasserver/api/examples/nodes.json (+2605/-0) src/maasserver/api/nodes.py (+308/-157) src/maasserver/api/tests/test_annotations.py (+26/-1)
Related bugs:	Link a bug report

Reviewer	Review Type	Date Requested	Status
Newell Jensen (community)		2018-11-26	Approve on 2018-11-26
MAAS Lander	unittests		Pending
Review via email: mp+359556@code.launchpad.net

Commit message

Added nodes api annotations, updated annotations to load nodes by default, added tests to make sure that nodes examples are loaded by default.

Description of the change

Updated annotations.py so that it always loads examples/nodes.json by default since other API operations like machines and devices inherit from nodes. Added a unit test to make sure that this is in fact being loaded by default. The unit test creates a operation URI unrelated to nodes (.../for-test/{foobar}) and then makes sure that an example specific to nodes is loaded for a key known to be in examples/nodes.json.

~jsseidel/maas:jsseidel-load-nodes-examples-by-default updated on 2018-11-26

bf2caf3... by Spencer Seidel on 2018-11-26: Formatted nodes examples correctly.

Revision history for this message

Newell Jensen (newell-jensen) wrote on 2018-11-26:

Looks good. Couple nits inline.

review: Approve

~jsseidel/maas:jsseidel-load-nodes-examples-by-default updated on 2018-11-26

0c2b1da... by Spencer Seidel on 2018-11-26: Removed unneeded parens and changed confusing comment

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk

Subscribers

People subscribed via source and target branches

to all changes:

MAAS Committers

Matvej Jurbin

Shane Holloman

Spencer Seidel

 diff --git a/src/maasserver/api/annotations.py b/src/maasserver/api/annotations.py
 index 79da0f3..c8bac9f 100644
 --- a/src/maasserver/api/annotations.py
 +++ b/src/maasserver/api/annotations.py
@@ -627,8 +627,30 @@ class APIDocstringParser:
          return ""
++    def _load_nodes_examples_dict(self):
++        """Returns a dictionary containing 'nodes' examples data.
++
++        Since many API objects inherit from nodes (e.g. machines, devices) we
++        always load nodes examples to prevent duplicating data.
++
++        If examples/nodes.json cannot be found, we warn, which will prevent
++        the unit tests from completing normally, but we return an empty
++        dictionary so the code can continue.
++        """
++        nodes_examples = {}
++
++        json_file = ("%s/examples/nodes.json" % os.path.dirname(__file__))
++
++        if not os.path.isfile(json_file):
++            self._warn("examples/nodes.json not found.")
++        else:
++            with open(json_file, "r") as ex_db_file:
++                nodes_examples = json.load(ex_db_file)
++
++        return nodes_examples
++
      def _get_examples_dict(self, uri):
--        """Returns a dictionary containing examples data or None
++        """Returns a dictionary containing examples data
          Given an operation string like "zone" or "zones", this function tries
          to open and slurp in the JSON of a matching file in the api/examples
@@ -638,15 +660,13 @@ class APIDocstringParser:
                  ... any JSON object ...
+             }
--        If no database is associated with the operation, the function
--        returns None.
++        This function will always return at least nodes examples data.
          """
--        examples = {}
++        examples = self._load_nodes_examples_dict()
          operation = self._get_operation_from_uri(uri)
--
--        if operation == "":
--            return None
++        if operation == "" or operation == "nodes" or operation == "node":
++            return examples
          # First, try the operation string as is:
          json_file = ("%s/examples/%s.json" %
@@ -658,11 +678,12 @@ class APIDocstringParser:
                           (os.path.dirname(__file__), operation))
              if not os.path.isfile(json_file):
--                # Give up
--                return None
++                # No examples found so return base set
++                return examples
          with open(json_file, "r") as ex_db_file:
--            examples = json.load(ex_db_file)
++            operation_examples = json.load(ex_db_file)
++            examples.update(operation_examples)
          return examples
 diff --git a/src/maasserver/api/examples/nodes.json b/src/maasserver/api/examples/nodes.json
 new file mode 100644
 index 0000000..9ba7ecc
 --- /dev/null
 +++ b/src/maasserver/api/examples/nodes.json
@@ -0,0 +1,2605 @@
++{
++  "read-node": {
++    "boot_interface": {
++      "system_id": "g8xyqs",
++      "name": "eth-jJ5ZwN",
++      "vlan": {
++        "vid": 0,
++        "mtu": 1500,
++        "dhcp_on": false,
++        "external_dhcp": null,
++        "relay_vlan": null,
++        "name": "untagged",
++        "fabric_id": 2,
++        "id": 5005,
++        "secondary_rack": null,
++        "space": "undefined",
++        "primary_rack": null,
++        "fabric": "fabric-2",
++        "resource_uri": "/MAAS/api/2.0/vlans/5005/"
++      },
++      "vendor": null,
++      "enabled": true,
++      "children": [
++        "bond-VpkNvO"
++      ],
++      "discovered": null,
++      "id": 112,
++      "params": "",
++      "type": "physical",
++      "firmware_version": null,
++      "mac_address": "3d:fd:40:ef:70:e8",
++      "parents": [],
++      "tags": [
++        "tag-M21kgB",
++        "tag-CpnGzQ",
++        "tag-Wgd7Eu"
++      ],
++      "links": [],
++      "effective_mtu": 1500,
++      "product": null,
++      "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/interfaces/112/"
++    },
++    "memory": 8192,
++    "tag_names": [],
++    "current_installation_result_id": null,
++    "fqdn": "causal-quagga.maas",
++    "disable_ipv4": false,
++    "distro_series": "",
++    "ip_addresses": [],
++    "pool": {
++      "name": "default",
++      "description": "Default pool",
++      "id": 0,
++      "resource_uri": "/MAAS/api/2.0/resourcepool/0/"
++    },
++    "node_type": 0,
++    "min_hwe_kernel": null,
++    "commissioning_status_name": "Passed",
++    "domain": {
++      "authoritative": true,
++      "ttl": null,
++      "name": "maas",
++      "resource_record_count": 0,
++      "id": 0,
++      "is_default": true,
++      "resource_uri": "/MAAS/api/2.0/domains/0/"
++    },
++    "boot_disk": {
++      "firmware_version": "firmware_version-tnhqNO",
++      "partitions": [],
++      "system_id": "g8xyqs",
++      "name": "name-rcEM1G",
++      "id_path": null,
++      "block_size": 512,
++      "model": "model-RAViIE",
++      "available_size": 2250362368,
++      "id": 75,
++      "filesystem": null,
++      "size": 2250362368,
++      "type": "physical",
++      "used_size": 0,
++      "partition_table_type": null,
++      "serial": "serial-qlOilQ",
++      "path": "/dev/disk/by-dname/name-rcEM1G",
++      "tags": [
++        "tag-OKbSzN",
++        "tag-IExJAF",
++        "tag-p2t26t"
++      ],
++      "storage_pool": "pool_id-ry2OnY",
++      "uuid": null,
++      "used_for": "Unused",
++      "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/blockdevices/75/"
++    },
++    "system_id": "g8xyqs",
++    "zone": {
++      "name": "zone-north",
++      "description": "xsMaq90fRE",
++      "id": 2,
++      "resource_uri": "/MAAS/api/2.0/zones/zone-north/"
++    },
++    "blockdevice_set": [
++      {
++        "id_path": null,
++        "size": 2250362368,
++        "block_size": 512,
++        "tags": [
++          "tag-OKbSzN",
++          "tag-IExJAF",
++          "tag-p2t26t"
++        ],
++        "partitions": [],
++        "system_id": "g8xyqs",
++        "name": "name-rcEM1G",
++        "model": "model-RAViIE",
++        "available_size": 2250362368,
++        "id": 75,
++        "filesystem": null,
++        "type": "physical",
++        "used_size": 0,
++        "partition_table_type": null,
++        "serial": "serial-qlOilQ",
++        "path": "/dev/disk/by-dname/name-rcEM1G",
++        "storage_pool": "pool_id-ry2OnY",
++        "uuid": null,
++        "used_for": "Unused",
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/blockdevices/75/"
++      },
++      {
++        "id_path": null,
++        "size": 1443074048,
++        "block_size": 4096,
++        "tags": [
++          "tag-sgRDAF",
++          "tag-kytOd1",
++          "tag-acWXTG"
++        ],
++        "partitions": [],
++        "system_id": "g8xyqs",
++        "name": "name-a5uEVy",
++        "model": "model-0mBTZN",
++        "available_size": 1443074048,
++        "id": 76,
++        "filesystem": null,
++        "type": "physical",
++        "used_size": 0,
++        "partition_table_type": null,
++        "serial": "serial-fbDnkc",
++        "path": "/dev/disk/by-dname/name-a5uEVy",
++        "storage_pool": "pool_id-aMRZUu",
++        "uuid": null,
++        "used_for": "Unused",
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/blockdevices/76/"
++      }
++    ],
++    "current_commissioning_result_id": 198,
++    "cpu_test_status": 2,
++    "address_ttl": null,
++    "cache_sets": [],
++    "storage": 3693.436416,
++    "node_type_name": "Machine",
++    "hardware_info": {
++      "system_vendor": "Unknown",
++      "system_product": "Unknown",
++      "system_version": "Unknown",
++      "system_serial": "Unknown",
++      "cpu_model": "Unknown",
++      "mainboard_vendor": "Unknown",
++      "mainboard_product": "Unknown",
++      "mainboard_firmware_version": "Unknown",
++      "mainboard_firmware_date": "Unknown"
++    },
++    "cpu_count": 7,
++    "storage_test_status_name": "Passed",
++    "owner": "user2",
++    "status": 20,
++    "volume_groups": [],
++    "hwe_kernel": null,
++    "netboot": true,
++    "current_testing_result_id": 199,
++    "commissioning_status": 2,
++    "testing_status_name": "Passed",
++    "architecture": "i386/generic",
++    "locked": false,
++    "power_state": "error",
++    "memory_test_status_name": "Passed",
++    "power_type": "virsh",
++    "interface_set": [
++      {
++        "system_id": "g8xyqs",
++        "name": "eth-jJ5ZwN",
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": false,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "name": "untagged",
++          "fabric_id": 2,
++          "id": 5005,
++          "secondary_rack": null,
++          "space": "undefined",
++          "primary_rack": null,
++          "fabric": "fabric-2",
++          "resource_uri": "/MAAS/api/2.0/vlans/5005/"
++        },
++        "vendor": null,
++        "enabled": true,
++        "children": [
++          "bond-VpkNvO"
++        ],
++        "discovered": null,
++        "id": 112,
++        "params": "",
++        "type": "physical",
++        "firmware_version": null,
++        "mac_address": "3d:fd:40:ef:70:e8",
++        "parents": [],
++        "tags": [
++          "tag-M21kgB",
++          "tag-CpnGzQ",
++          "tag-Wgd7Eu"
++        ],
++        "links": [],
++        "effective_mtu": 1500,
++        "product": null,
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/interfaces/112/"
++      },
++      {
++        "system_id": "g8xyqs",
++        "name": "eth-ex07mq",
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": false,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "name": "untagged",
++          "fabric_id": 2,
++          "id": 5005,
++          "secondary_rack": null,
++          "space": "undefined",
++          "primary_rack": null,
++          "fabric": "fabric-2",
++          "resource_uri": "/MAAS/api/2.0/vlans/5005/"
++        },
++        "vendor": null,
++        "enabled": true,
++        "children": [
++          "bond-VpkNvO"
++        ],
++        "discovered": null,
++        "id": 113,
++        "params": "",
++        "type": "physical",
++        "firmware_version": null,
++        "mac_address": "8f:75:69:58:26:47",
++        "parents": [],
++        "tags": [
++          "tag-ymen6c",
++          "tag-oKQ7iK",
++          "tag-yQLBgJ"
++        ],
++        "links": [],
++        "effective_mtu": 1500,
++        "product": null,
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/interfaces/113/"
++      },
++      {
++        "system_id": "g8xyqs",
++        "name": "eth-CE1j2X",
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": false,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "name": "untagged",
++          "fabric_id": 2,
++          "id": 5005,
++          "secondary_rack": null,
++          "space": "undefined",
++          "primary_rack": null,
++          "fabric": "fabric-2",
++          "resource_uri": "/MAAS/api/2.0/vlans/5005/"
++        },
++        "vendor": null,
++        "enabled": true,
++        "children": [
++          "bond-VpkNvO"
++        ],
++        "discovered": null,
++        "id": 114,
++        "params": "",
++        "type": "physical",
++        "firmware_version": null,
++        "mac_address": "b0:5e:ed:8d:d8:36",
++        "parents": [],
++        "tags": [
++          "tag-LJPUwT",
++          "tag-U5zGn3",
++          "tag-dHGEeD"
++        ],
++        "links": [],
++        "effective_mtu": 1500,
++        "product": null,
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/interfaces/114/"
++      },
++      {
++        "system_id": "g8xyqs",
++        "name": "bond-VpkNvO",
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": false,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "name": "untagged",
++          "fabric_id": 2,
++          "id": 5005,
++          "secondary_rack": null,
++          "space": "undefined",
++          "primary_rack": null,
++          "fabric": "fabric-2",
++          "resource_uri": "/MAAS/api/2.0/vlans/5005/"
++        },
++        "vendor": null,
++        "enabled": true,
++        "children": [],
++        "discovered": null,
++        "id": 115,
++        "params": "",
++        "type": "bond",
++        "firmware_version": null,
++        "mac_address": "0a:87:3f:94:0e:68",
++        "parents": [
++          "eth-CE1j2X",
++          "eth-ex07mq",
++          "eth-jJ5ZwN"
++        ],
++        "tags": [
++          "tag-HwhC7n",
++          "tag-WHGBJc",
++          "tag-yY8Ap5"
++        ],
++        "links": [],
++        "effective_mtu": 1500,
++        "product": null,
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/interfaces/115/"
++      }
++    ],
++    "owner_data": {},
++    "bcaches": [],
++    "hostname": "causal-quagga",
++    "raids": [],
++    "other_test_status": 2,
++    "status_action": "action-BqENyW",
++    "special_filesystems": [],
++    "physicalblockdevice_set": [
++      {
++        "firmware_version": "firmware_version-tnhqNO",
++        "partitions": [],
++        "system_id": "g8xyqs",
++        "name": "name-rcEM1G",
++        "id_path": null,
++        "block_size": 512,
++        "model": "model-RAViIE",
++        "available_size": 2250362368,
++        "id": 75,
++        "filesystem": null,
++        "size": 2250362368,
++        "type": "physical",
++        "used_size": 0,
++        "partition_table_type": null,
++        "serial": "serial-qlOilQ",
++        "path": "/dev/disk/by-dname/name-rcEM1G",
++        "tags": [
++          "tag-OKbSzN",
++          "tag-IExJAF",
++          "tag-p2t26t"
++        ],
++        "storage_pool": "pool_id-ry2OnY",
++        "uuid": null,
++        "used_for": "Unused",
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/blockdevices/75/"
++      },
++      {
++        "firmware_version": "firmware_version-UW8ucD",
++        "partitions": [],
++        "system_id": "g8xyqs",
++        "name": "name-a5uEVy",
++        "id_path": null,
++        "block_size": 4096,
++        "model": "model-0mBTZN",
++        "available_size": 1443074048,
++        "id": 76,
++        "filesystem": null,
++        "size": 1443074048,
++        "type": "physical",
++        "used_size": 0,
++        "partition_table_type": null,
++        "serial": "serial-fbDnkc",
++        "path": "/dev/disk/by-dname/name-a5uEVy",
++        "tags": [
++          "tag-sgRDAF",
++          "tag-kytOd1",
++          "tag-acWXTG"
++        ],
++        "storage_pool": "pool_id-aMRZUu",
++        "uuid": null,
++        "used_for": "Unused",
++        "resource_uri": "/MAAS/api/2.0/nodes/g8xyqs/blockdevices/76/"
++      }
++    ],
++    "iscsiblockdevice_set": [],
++    "testing_status": 2,
++    "default_gateways": {
++      "ipv4": {
++        "gateway_ip": null,
++        "link_id": null
++      },
++      "ipv6": {
++        "gateway_ip": null,
++        "link_id": null
++      }
++    },
++    "storage_test_status": 2,
++    "pod": {
++      "id": 5,
++      "name": "sacred-hen",
++      "resource_uri": "/MAAS/api/2.0/pods/5/"
++    },
++    "swap_size": null,
++    "status_message": "desc-eqGqfo",
++    "status_name": "Failed to exit rescue mode",
++    "osystem": "",
++    "cpu_test_status_name": "Passed",
++    "memory_test_status": 2,
++    "other_test_status_name": "Passed",
++    "virtualblockdevice_set": [],
++    "cpu_speed": 0,
++    "resource_uri": "/MAAS/api/2.0/machines/g8xyqs/"
++  },
++  "details": {
++    "lldp": {
++      "$binary": "cjBZSWw2S1ZkRA==",
++      "$type": "00"
++    },
++    "lshw": {
++      "$binary": "Nkd5MzRLYjBkTQ==",
++      "$type": "00"
++    }
++  },
++  "read-visible-nodes": [
++    {
++      "commissioning_status": 2,
++      "version": "2.5.0~beta3-7325-g1425f6d4c-0ubuntu1~18.04.1",
++      "node_type_name": "Region and rack controller",
++      "ip_addresses": [
++        "10.55.32.135",
++        "192.168.122.1"
++      ],
++      "storage_test_status": -1,
++      "cpu_count": 4,
++      "hostname": "mymaas",
++      "domain": {
++        "authoritative": true,
++        "ttl": null,
++        "id": 0,
++        "name": "maas",
++        "resource_record_count": 23,
++        "is_default": true,
++        "resource_uri": "/MAAS/api/2.0/domains/0/"
++      },
++      "swap_size": null,
++      "power_type": "",
++      "memory": 8192,
++      "current_testing_result_id": null,
++      "osystem": "ubuntu",
++      "node_type": 4,
++      "service_set": [
++        {
++          "name": "proxy",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "bind9",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "ntp_region",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "regiond",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "syslog_region",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "ntp_rack",
++          "status": "unknown",
++          "status_info": "managed by the region"
++        },
++        {
++          "name": "dhcpd",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "tftp",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "dns_rack",
++          "status": "unknown",
++          "status_info": "managed by the region"
++        },
++        {
++          "name": "http",
++          "status": "running",
++          "status_info": ""
++        },
++        {
++          "name": "proxy_rack",
++          "status": "unknown",
++          "status_info": "managed by the region"
++        },
++        {
++          "name": "syslog_rack",
++          "status": "unknown",
++          "status_info": "managed by the region"
++        },
++        {
++          "name": "dhcpd6",
++          "status": "off",
++          "status_info": ""
++        },
++        {
++          "name": "rackd",
++          "status": "running",
++          "status_info": ""
++        }
++      ],
++      "other_test_status": -1,
++      "testing_status": -1,
++      "zone": {
++        "name": "default",
++        "description": "",
++        "id": 1,
++        "resource_uri": "/MAAS/api/2.0/zones/default/"
++      },
++      "status_action": "",
++      "commissioning_status_name": "Passed",
++      "interface_set": [
++        {
++          "vlan": {
++            "vid": 0,
++            "mtu": 1500,
++            "dhcp_on": true,
++            "external_dhcp": null,
++            "relay_vlan": null,
++            "id": 5001,
++            "name": "untagged",
++            "fabric_id": 0,
++            "secondary_rack": null,
++            "space": "undefined",
++            "fabric": "fabric-0",
++            "primary_rack": "6gsym8",
++            "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++          },
++          "mac_address": "fa:16:3e:b8:af:ff",
++          "tags": [],
++          "params": "",
++          "id": 1,
++          "discovered": null,
++          "product": "OpenStack Nova",
++          "parents": [],
++          "type": "physical",
++          "name": "ens3",
++          "enabled": true,
++          "effective_mtu": 1500,
++          "vendor": "OpenStack Foundation",
++          "system_id": "6gsym8",
++          "children": [],
++          "firmware_version": null,
++          "links": [
++            {
++              "id": 1,
++              "mode": "static",
++              "ip_address": "10.55.32.135",
++              "subnet": {
++                "name": "10.55.32.0/20",
++                "vlan": {
++                  "vid": 0,
++                  "mtu": 1500,
++                  "dhcp_on": true,
++                  "external_dhcp": null,
++                  "relay_vlan": null,
++                  "id": 5001,
++                  "name": "untagged",
++                  "fabric_id": 0,
++                  "secondary_rack": null,
++                  "space": "undefined",
++                  "fabric": "fabric-0",
++                  "primary_rack": "6gsym8",
++                  "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++                },
++                "cidr": "10.55.32.0/20",
++                "rdns_mode": 2,
++                "gateway_ip": "10.55.32.1",
++                "dns_servers": [],
++                "allow_dns": true,
++                "allow_proxy": true,
++                "active_discovery": false,
++                "managed": true,
++                "id": 1,
++                "space": "undefined",
++                "resource_uri": "/MAAS/api/2.0/subnets/1/"
++              }
++            }
++          ],
++          "resource_uri": "/MAAS/api/2.0/nodes/6gsym8/interfaces/1/"
++        },
++        {
++          "vlan": {
++            "vid": 0,
++            "mtu": 1500,
++            "dhcp_on": false,
++            "external_dhcp": null,
++            "relay_vlan": null,
++            "id": 5002,
++            "name": "untagged",
++            "fabric_id": 1,
++            "secondary_rack": null,
++            "space": "undefined",
++            "fabric": "fabric-1",
++            "primary_rack": null,
++            "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++          },
++          "mac_address": "52:54:00:09:88:41",
++          "tags": [],
++          "params": "",
++          "id": 17,
++          "discovered": null,
++          "product": null,
++          "parents": [],
++          "type": "bridge",
++          "name": "virbr0",
++          "enabled": true,
++          "effective_mtu": 1500,
++          "vendor": null,
++          "system_id": "6gsym8",
++          "children": [],
++          "firmware_version": null,
++          "links": [
++            {
++              "id": 17,
++              "mode": "static",
++              "ip_address": "192.168.122.1",
++              "subnet": {
++                "name": "192.168.122.0/24",
++                "vlan": {
++                  "vid": 0,
++                  "mtu": 1500,
++                  "dhcp_on": false,
++                  "external_dhcp": null,
++                  "relay_vlan": null,
++                  "id": 5002,
++                  "name": "untagged",
++                  "fabric_id": 1,
++                  "secondary_rack": null,
++                  "space": "undefined",
++                  "fabric": "fabric-1",
++                  "primary_rack": null,
++                  "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++                },
++                "cidr": "192.168.122.0/24",
++                "rdns_mode": 2,
++                "gateway_ip": null,
++                "dns_servers": [],
++                "allow_dns": true,
++                "allow_proxy": true,
++                "active_discovery": false,
++                "managed": true,
++                "id": 2,
++                "space": "undefined",
++                "resource_uri": "/MAAS/api/2.0/subnets/2/"
++              }
++            }
++          ],
++          "resource_uri": "/MAAS/api/2.0/nodes/6gsym8/interfaces/17/"
++        }
++      ],
++      "cpu_speed": 2400,
++      "testing_status_name": "Unknown",
++      "tag_names": [
++        "virtual"
++      ],
++      "current_commissioning_result_id": 1,
++      "system_id": "6gsym8",
++      "distro_series": "bionic",
++      "cpu_test_status": -1,
++      "memory_test_status_name": "Unknown",
++      "hardware_info": {
++        "system_vendor": "OpenStack Foundation",
++        "system_product": "OpenStack Nova",
++        "system_version": "2013.2.3",
++        "system_serial": "33313934-3432-5a43-4339-343532355a35",
++        "cpu_model": "Intel Core i7 9xx (Nehalem Class Core i7)",
++        "mainboard_vendor": "Unknown",
++        "mainboard_product": "Unknown",
++        "mainboard_firmware_version": "Bochs",
++        "mainboard_firmware_date": "01/01/2011"
++      },
++      "other_test_status_name": "Unknown",
++      "fqdn": "mymaas.maas",
++      "power_state": "unknown",
++      "memory_test_status": -1,
++      "current_installation_result_id": null,
++      "storage_test_status_name": "Unknown",
++      "architecture": "amd64/generic",
++      "cpu_test_status_name": "Unknown",
++      "resource_uri": "/MAAS/api/2.0/rackcontrollers/6gsym8/"
++    }
++  ],
++  "set-owner-data": {
++    "owner_data": {
++      "somekey": "somevalue"
++    },
++    "cpu_speed": 0,
++    "boot_interface": {
++      "system_id": "q46awd",
++      "effective_mtu": 1500,
++      "product": null,
++      "type": "physical",
++      "mac_address": "fc:5f:a6:d0:30:97",
++      "enabled": true,
++      "params": "",
++      "vlan": {
++        "vid": 0,
++        "mtu": 1500,
++        "dhcp_on": false,
++        "external_dhcp": null,
++        "relay_vlan": null,
++        "secondary_rack": null,
++        "primary_rack": null,
++        "name": "untagged",
++        "fabric_id": 0,
++        "space": "management",
++        "id": 5001,
++        "fabric": "fabric-0",
++        "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++      },
++      "children": [],
++      "name": "eth-tlHn9H",
++      "vendor": null,
++      "firmware_version": null,
++      "parents": [],
++      "id": 100,
++      "tags": [
++        "tag-Krwbm6",
++        "tag-6Ov2DQ",
++        "tag-ZIbKlm"
++      ],
++      "links": [
++        {
++          "id": 45,
++          "mode": "auto",
++          "subnet": {
++            "name": "name-rLI3eq",
++            "vlan": {
++              "vid": 0,
++              "mtu": 1500,
++              "dhcp_on": false,
++              "external_dhcp": null,
++              "relay_vlan": null,
++              "secondary_rack": null,
++              "primary_rack": null,
++              "name": "untagged",
++              "fabric_id": 0,
++              "space": "management",
++              "id": 5001,
++              "fabric": "fabric-0",
++              "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++            },
++            "cidr": "172.16.1.0/24",
++            "rdns_mode": 2,
++            "gateway_ip": "172.16.1.1",
++            "dns_servers": [
++              "fd89:8724:81f1:5512:557f:99c3:6967:8d63"
++            ],
++            "allow_dns": true,
++            "allow_proxy": true,
++            "active_discovery": false,
++            "managed": true,
++            "space": "management",
++            "id": 1,
++            "resource_uri": "/MAAS/api/2.0/subnets/1/"
++          }
++        }
++      ],
++      "discovered": null,
++      "resource_uri": "/MAAS/api/2.0/nodes/q46awd/interfaces/100/"
++    },
++    "swap_size": null,
++    "status": 17,
++    "zone": {
++      "name": "zone-Llc45k",
++      "description": "LirDm9tBHA",
++      "id": 6,
++      "resource_uri": "/MAAS/api/2.0/zones/zone-Llc45k/"
++    },
++    "other_test_status": 3,
++    "virtualblockdevice_set": [],
++    "disable_ipv4": false,
++    "power_type": "manual",
++    "pool": {
++      "name": "default",
++      "description": "Default pool",
++      "id": 0,
++      "resource_uri": "/MAAS/api/2.0/resourcepool/0/"
++    },
++    "locked": false,
++    "system_id": "q46awd",
++    "boot_disk": {
++      "firmware_version": "firmware_version-8leXpL",
++      "system_id": "q46awd",
++      "type": "physical",
++      "used_size": 0,
++      "used_for": "Unused",
++      "partitions": [],
++      "uuid": null,
++      "name": "name-w1MxuB",
++      "id_path": null,
++      "tags": [
++        "tag-iF4AD7",
++        "tag-BtgV26",
++        "tag-wZF5A6"
++      ],
++      "partition_table_type": null,
++      "size": 3770708992,
++      "storage_pool": null,
++      "path": "/dev/disk/by-dname/name-w1MxuB",
++      "serial": "serial-u1CbU0",
++      "block_size": 1024,
++      "filesystem": null,
++      "id": 66,
++      "model": "model-A6yydP",
++      "available_size": 3770708992,
++      "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/66/"
++    },
++    "special_filesystems": [],
++    "current_testing_result_id": 171,
++    "cache_sets": [],
++    "memory_test_status_name": "Failed",
++    "storage_test_status_name": "Failed",
++    "node_type_name": "Machine",
++    "architecture": "i386/generic",
++    "commissioning_status_name": "Passed",
++    "distro_series": "",
++    "interface_set": [
++      {
++        "system_id": "q46awd",
++        "effective_mtu": 1500,
++        "product": null,
++        "type": "physical",
++        "mac_address": "fc:5f:a6:d0:30:97",
++        "enabled": true,
++        "params": "",
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": false,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "secondary_rack": null,
++          "primary_rack": null,
++          "name": "untagged",
++          "fabric_id": 0,
++          "space": "management",
++          "id": 5001,
++          "fabric": "fabric-0",
++          "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++        },
++        "children": [],
++        "name": "eth-tlHn9H",
++        "vendor": null,
++        "firmware_version": null,
++        "parents": [],
++        "id": 100,
++        "tags": [
++          "tag-Krwbm6",
++          "tag-6Ov2DQ",
++          "tag-ZIbKlm"
++        ],
++        "links": [
++          {
++            "id": 45,
++            "mode": "auto",
++            "subnet": {
++              "name": "name-rLI3eq",
++              "vlan": {
++                "vid": 0,
++                "mtu": 1500,
++                "dhcp_on": false,
++                "external_dhcp": null,
++                "relay_vlan": null,
++                "secondary_rack": null,
++                "primary_rack": null,
++                "name": "untagged",
++                "fabric_id": 0,
++                "space": "management",
++                "id": 5001,
++                "fabric": "fabric-0",
++                "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++              },
++              "cidr": "172.16.1.0/24",
++              "rdns_mode": 2,
++              "gateway_ip": "172.16.1.1",
++              "dns_servers": [
++                "fd89:8724:81f1:5512:557f:99c3:6967:8d63"
++              ],
++              "allow_dns": true,
++              "allow_proxy": true,
++              "active_discovery": false,
++              "managed": true,
++              "space": "management",
++              "id": 1,
++              "resource_uri": "/MAAS/api/2.0/subnets/1/"
++            }
++          }
++        ],
++        "discovered": null,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/interfaces/100/"
++      },
++      {
++        "system_id": "q46awd",
++        "effective_mtu": 1500,
++        "product": null,
++        "type": "physical",
++        "mac_address": "37:96:81:86:7d:26",
++        "enabled": true,
++        "params": "",
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": false,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "secondary_rack": null,
++          "primary_rack": null,
++          "name": "untagged",
++          "fabric_id": 0,
++          "space": "management",
++          "id": 5001,
++          "fabric": "fabric-0",
++          "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++        },
++        "children": [],
++        "name": "eth-uHmeXv",
++        "vendor": null,
++        "firmware_version": null,
++        "parents": [],
++        "id": 101,
++        "tags": [
++          "tag-GBBGJm",
++          "tag-PorMko",
++          "tag-6ZtyQZ"
++        ],
++        "links": [
++          {
++            "id": 46,
++            "mode": "auto",
++            "subnet": {
++              "name": "name-rLI3eq",
++              "vlan": {
++                "vid": 0,
++                "mtu": 1500,
++                "dhcp_on": false,
++                "external_dhcp": null,
++                "relay_vlan": null,
++                "secondary_rack": null,
++                "primary_rack": null,
++                "name": "untagged",
++                "fabric_id": 0,
++                "space": "management",
++                "id": 5001,
++                "fabric": "fabric-0",
++                "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++              },
++              "cidr": "172.16.1.0/24",
++              "rdns_mode": 2,
++              "gateway_ip": "172.16.1.1",
++              "dns_servers": [
++                "fd89:8724:81f1:5512:557f:99c3:6967:8d63"
++              ],
++              "allow_dns": true,
++              "allow_proxy": true,
++              "active_discovery": false,
++              "managed": true,
++              "space": "management",
++              "id": 1,
++              "resource_uri": "/MAAS/api/2.0/subnets/1/"
++            }
++          }
++        ],
++        "discovered": null,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/interfaces/101/"
++      },
++      {
++        "system_id": "q46awd",
++        "effective_mtu": 1500,
++        "product": null,
++        "type": "physical",
++        "mac_address": "ec:03:50:cc:92:e7",
++        "enabled": true,
++        "params": "",
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": false,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "secondary_rack": null,
++          "primary_rack": null,
++          "name": "untagged",
++          "fabric_id": 0,
++          "space": "management",
++          "id": 5001,
++          "fabric": "fabric-0",
++          "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++        },
++        "children": [],
++        "name": "eth-LCuSY9",
++        "vendor": null,
++        "firmware_version": null,
++        "parents": [],
++        "id": 102,
++        "tags": [
++          "tag-OB7Urg",
++          "tag-KI8wUy",
++          "tag-2ggdxa"
++        ],
++        "links": [
++          {
++            "id": 47,
++            "mode": "static",
++            "ip_address": "172.16.1.252",
++            "subnet": {
++              "name": "name-rLI3eq",
++              "vlan": {
++                "vid": 0,
++                "mtu": 1500,
++                "dhcp_on": false,
++                "external_dhcp": null,
++                "relay_vlan": null,
++                "secondary_rack": null,
++                "primary_rack": null,
++                "name": "untagged",
++                "fabric_id": 0,
++                "space": "management",
++                "id": 5001,
++                "fabric": "fabric-0",
++                "resource_uri": "/MAAS/api/2.0/vlans/5001/"
++              },
++              "cidr": "172.16.1.0/24",
++              "rdns_mode": 2,
++              "gateway_ip": "172.16.1.1",
++              "dns_servers": [
++                "fd89:8724:81f1:5512:557f:99c3:6967:8d63"
++              ],
++              "allow_dns": true,
++              "allow_proxy": true,
++              "active_discovery": false,
++              "managed": true,
++              "space": "management",
++              "id": 1,
++              "resource_uri": "/MAAS/api/2.0/subnets/1/"
++            }
++          }
++        ],
++        "discovered": null,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/interfaces/102/"
++      }
++    ],
++    "storage_test_status": 3,
++    "testing_status_name": "Failed",
++    "osystem": "",
++    "default_gateways": {
++      "ipv4": {
++        "gateway_ip": "172.16.1.1",
++        "link_id": null
++      },
++      "ipv6": {
++        "gateway_ip": null,
++        "link_id": null
++      }
++    },
++    "physicalblockdevice_set": [
++      {
++        "firmware_version": "firmware_version-8leXpL",
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-w1MxuB",
++        "id_path": null,
++        "tags": [
++          "tag-iF4AD7",
++          "tag-BtgV26",
++          "tag-wZF5A6"
++        ],
++        "partition_table_type": null,
++        "size": 3770708992,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-w1MxuB",
++        "serial": "serial-u1CbU0",
++        "block_size": 1024,
++        "filesystem": null,
++        "id": 66,
++        "model": "model-A6yydP",
++        "available_size": 3770708992,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/66/"
++      },
++      {
++        "firmware_version": "firmware_version-fE2JVD",
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-8Ows7O",
++        "id_path": null,
++        "tags": [
++          "tag-ItoUN0",
++          "tag-MM2fGY",
++          "tag-oe8y1B"
++        ],
++        "partition_table_type": null,
++        "size": 3681153024,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-8Ows7O",
++        "serial": "serial-KEhV9v",
++        "block_size": 1024,
++        "filesystem": null,
++        "id": 67,
++        "model": "model-XNLSfS",
++        "available_size": 3681153024,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/67/"
++      },
++      {
++        "firmware_version": "firmware_version-MD0sRK",
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-5UnjsY",
++        "id_path": null,
++        "tags": [
++          "tag-TR2qBE",
++          "tag-JJIvWV",
++          "tag-pYoDjB"
++        ],
++        "partition_table_type": null,
++        "size": 2411704320,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-5UnjsY",
++        "serial": "serial-h0LybM",
++        "block_size": 1024,
++        "filesystem": null,
++        "id": 68,
++        "model": "model-UEouuL",
++        "available_size": 2411704320,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/68/"
++      },
++      {
++        "firmware_version": "firmware_version-4TDPi8",
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-xZSseq",
++        "id_path": null,
++        "tags": [
++          "tag-p53o0X",
++          "tag-8NIex3",
++          "tag-bSwNmr"
++        ],
++        "partition_table_type": null,
++        "size": 3030908928,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-xZSseq",
++        "serial": "serial-wANhJs",
++        "block_size": 4096,
++        "filesystem": null,
++        "id": 69,
++        "model": "model-kIe7Vc",
++        "available_size": 3030908928,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/69/"
++      },
++      {
++        "firmware_version": "firmware_version-IU8B1C",
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-SmOpsN",
++        "id_path": null,
++        "tags": [
++          "tag-Ois1Gc",
++          "tag-DwHmIC",
++          "tag-jOzK03"
++        ],
++        "partition_table_type": null,
++        "size": 806171648,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-SmOpsN",
++        "serial": "serial-c5xGdX",
++        "block_size": 1024,
++        "filesystem": null,
++        "id": 70,
++        "model": "model-7ZvrZr",
++        "available_size": 806171648,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/70/"
++      }
++    ],
++    "bcaches": [],
++    "iscsiblockdevice_set": [],
++    "cpu_test_status": 2,
++    "other_test_status_name": "Failed",
++    "memory": 1024,
++    "current_commissioning_result_id": 170,
++    "cpu_test_status_name": "Passed",
++    "hwe_kernel": null,
++    "current_installation_result_id": null,
++    "tag_names": [],
++    "netboot": true,
++    "hardware_info": {
++      "system_vendor": "Unknown",
++      "system_product": "Unknown",
++      "system_version": "Unknown",
++      "system_serial": "Unknown",
++      "cpu_model": "Unknown",
++      "mainboard_vendor": "Unknown",
++      "mainboard_product": "Unknown",
++      "mainboard_firmware_version": "Unknown",
++      "mainboard_firmware_date": "Unknown"
++    },
++    "cpu_count": 6,
++    "blockdevice_set": [
++      {
++        "id_path": null,
++        "size": 3770708992,
++        "block_size": 1024,
++        "tags": [
++          "tag-iF4AD7",
++          "tag-BtgV26",
++          "tag-wZF5A6"
++        ],
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-w1MxuB",
++        "partition_table_type": null,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-w1MxuB",
++        "serial": "serial-u1CbU0",
++        "filesystem": null,
++        "id": 66,
++        "model": "model-A6yydP",
++        "available_size": 3770708992,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/66/"
++      },
++      {
++        "id_path": null,
++        "size": 3681153024,
++        "block_size": 1024,
++        "tags": [
++          "tag-ItoUN0",
++          "tag-MM2fGY",
++          "tag-oe8y1B"
++        ],
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-8Ows7O",
++        "partition_table_type": null,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-8Ows7O",
++        "serial": "serial-KEhV9v",
++        "filesystem": null,
++        "id": 67,
++        "model": "model-XNLSfS",
++        "available_size": 3681153024,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/67/"
++      },
++      {
++        "id_path": null,
++        "size": 2411704320,
++        "block_size": 1024,
++        "tags": [
++          "tag-TR2qBE",
++          "tag-JJIvWV",
++          "tag-pYoDjB"
++        ],
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-5UnjsY",
++        "partition_table_type": null,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-5UnjsY",
++        "serial": "serial-h0LybM",
++        "filesystem": null,
++        "id": 68,
++        "model": "model-UEouuL",
++        "available_size": 2411704320,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/68/"
++      },
++      {
++        "id_path": null,
++        "size": 3030908928,
++        "block_size": 4096,
++        "tags": [
++          "tag-p53o0X",
++          "tag-8NIex3",
++          "tag-bSwNmr"
++        ],
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-xZSseq",
++        "partition_table_type": null,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-xZSseq",
++        "serial": "serial-wANhJs",
++        "filesystem": null,
++        "id": 69,
++        "model": "model-kIe7Vc",
++        "available_size": 3030908928,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/69/"
++      },
++      {
++        "id_path": null,
++        "size": 806171648,
++        "block_size": 1024,
++        "tags": [
++          "tag-Ois1Gc",
++          "tag-DwHmIC",
++          "tag-jOzK03"
++        ],
++        "system_id": "q46awd",
++        "type": "physical",
++        "used_size": 0,
++        "used_for": "Unused",
++        "partitions": [],
++        "uuid": null,
++        "name": "name-SmOpsN",
++        "partition_table_type": null,
++        "storage_pool": null,
++        "path": "/dev/disk/by-dname/name-SmOpsN",
++        "serial": "serial-c5xGdX",
++        "filesystem": null,
++        "id": 70,
++        "model": "model-7ZvrZr",
++        "available_size": 806171648,
++        "resource_uri": "/MAAS/api/2.0/nodes/q46awd/blockdevices/70/"
++      }
++    ],
++    "domain": {
++      "authoritative": true,
++      "ttl": null,
++      "is_default": true,
++      "name": "maas",
++      "id": 0,
++      "resource_record_count": 0,
++      "resource_uri": "/MAAS/api/2.0/domains/0/"
++    },
++    "memory_test_status": 3,
++    "status_message": "desc-jWUG7Z",
++    "owner": "user2",
++    "address_ttl": null,
++    "node_type": 0,
++    "volume_groups": [],
++    "pod": null,
++    "storage": 13700.646912,
++    "raids": [],
++    "status_action": "action-3rkEpa",
++    "min_hwe_kernel": null,
++    "status_name": "Entering rescue mode",
++    "commissioning_status": 2,
++    "testing_status": 3,
++    "fqdn": "clever-thrush.maas",
++    "power_state": "unknown",
++    "hostname": "clever-thrush",
++    "ip_addresses": [
++      "172.16.1.252"
++    ],
++    "resource_uri": "/MAAS/api/2.0/machines/q46awd/"
++  },
++  "query-power-state": {
++    "state": "on"
++  },
++  "power-on": {
++    "cpu_count": 1,
++    "fqdn": "node2.maas",
++    "hostname": "node2",
++    "power_state": "on",
++    "cpu_test_status": -1,
++    "storage": 8000,
++    "osystem": "ubuntu",
++    "cpu_test_status_name": "Unknown",
++    "testing_status": 2,
++    "iscsiblockdevice_set": [],
++    "boot_interface": {
++      "vlan": {
++        "vid": 0,
++        "mtu": 1500,
++        "dhcp_on": true,
++        "external_dhcp": null,
++        "relay_vlan": null,
++        "fabric": "fabric-1",
++        "fabric_id": 1,
++        "primary_rack": "mhce3f",
++        "secondary_rack": null,
++        "space": "FooSpace",
++        "name": "untagged",
++        "id": 5002,
++        "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++      },
++      "links": [
++        {
++          "id": 13,
++          "mode": "auto",
++          "ip_address": "172.16.99.5",
++          "subnet": {
++            "name": "172.16.99.0/24",
++            "vlan": {
++              "vid": 0,
++              "mtu": 1500,
++              "dhcp_on": true,
++              "external_dhcp": null,
++              "relay_vlan": null,
++              "fabric": "fabric-1",
++              "fabric_id": 1,
++              "primary_rack": "mhce3f",
++              "secondary_rack": null,
++              "space": "FooSpace",
++              "name": "untagged",
++              "id": 5002,
++              "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++            },
++            "cidr": "172.16.99.0/24",
++            "rdns_mode": 2,
++            "gateway_ip": "172.16.99.1",
++            "dns_servers": [],
++            "allow_dns": true,
++            "allow_proxy": true,
++            "active_discovery": false,
++            "managed": true,
++            "space": "FooSpace",
++            "id": 2,
++            "resource_uri": "/MAAS/api/2.0/subnets/2/"
++          }
++        }
++      ],
++      "vendor": "QEMU",
++      "enabled": true,
++      "children": [],
++      "name": "ens4",
++      "id": 5,
++      "discovered": [],
++      "parents": [],
++      "effective_mtu": 1500,
++      "product": "Standard PC (i440FX + PIIX, 1996)",
++      "firmware_version": null,
++      "system_id": "e8xa8m",
++      "mac_address": "52:54:00:52:a5:9e",
++      "tags": [],
++      "type": "physical",
++      "params": "",
++      "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/interfaces/5/"
++    },
++    "boot_disk": {
++      "firmware_version": null,
++      "model": "",
++      "path": "/dev/disk/by-dname/vda",
++      "serial": "",
++      "block_size": 4096,
++      "partitions": [
++        {
++          "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++          "size": 7994343424,
++          "bootable": false,
++          "tags": [],
++          "type": "partition",
++          "path": "/dev/disk/by-dname/vda-part1",
++          "device_id": 2,
++          "used_for": "ext4 formatted filesystem mounted at /",
++          "system_id": "e8xa8m",
++          "filesystem": {
++            "fstype": "ext4",
++            "label": "root",
++            "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++            "mount_point": "/",
++            "mount_options": null
++          },
++          "id": 2,
++          "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++        }
++      ],
++      "available_size": 0,
++      "used_size": 7999586304,
++      "id_path": "/dev/vda",
++      "name": "vda",
++      "id": 2,
++      "used_for": "MBR partitioned with 1 partition",
++      "partition_table_type": "MBR",
++      "system_id": "e8xa8m",
++      "size": 8000000000,
++      "tags": [
++        "rotary"
++      ],
++      "filesystem": null,
++      "uuid": null,
++      "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++      "type": "physical",
++      "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++    },
++    "bcaches": [],
++    "cpu_speed": 2500,
++    "ip_addresses": [
++      "172.16.99.5"
++    ],
++    "virtualblockdevice_set": [],
++    "special_filesystems": [],
++    "owner_data": {},
++    "physicalblockdevice_set": [
++      {
++        "firmware_version": null,
++        "model": "",
++        "path": "/dev/disk/by-dname/vda",
++        "serial": "",
++        "block_size": 4096,
++        "partitions": [
++          {
++            "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++            "size": 7994343424,
++            "bootable": false,
++            "tags": [],
++            "type": "partition",
++            "path": "/dev/disk/by-dname/vda-part1",
++            "device_id": 2,
++            "used_for": "ext4 formatted filesystem mounted at /",
++            "system_id": "e8xa8m",
++            "filesystem": {
++              "fstype": "ext4",
++              "label": "root",
++              "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++              "mount_point": "/",
++              "mount_options": null
++            },
++            "id": 2,
++            "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++          }
++        ],
++        "available_size": 0,
++        "used_size": 7999586304,
++        "id_path": "/dev/vda",
++        "name": "vda",
++        "id": 2,
++        "used_for": "MBR partitioned with 1 partition",
++        "partition_table_type": "MBR",
++        "system_id": "e8xa8m",
++        "size": 8000000000,
++        "tags": [
++          "rotary"
++        ],
++        "filesystem": null,
++        "uuid": null,
++        "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++        "type": "physical",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++      }
++    ],
++    "testing_status_name": "Passed",
++    "disable_ipv4": false,
++    "blockdevice_set": [
++      {
++        "id_path": "/dev/vda",
++        "size": 8000000000,
++        "block_size": 4096,
++        "tags": [
++          "rotary"
++        ],
++        "model": "",
++        "path": "/dev/disk/by-dname/vda",
++        "serial": "",
++        "partitions": [
++          {
++            "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++            "size": 7994343424,
++            "bootable": false,
++            "tags": [],
++            "type": "partition",
++            "path": "/dev/disk/by-dname/vda-part1",
++            "device_id": 2,
++            "used_for": "ext4 formatted filesystem mounted at /",
++            "system_id": "e8xa8m",
++            "filesystem": {
++              "fstype": "ext4",
++              "label": "root",
++              "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++              "mount_point": "/",
++              "mount_options": null
++            },
++            "id": 2,
++            "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++          }
++        ],
++        "available_size": 0,
++        "used_size": 7999586304,
++        "name": "vda",
++        "id": 2,
++        "used_for": "MBR partitioned with 1 partition",
++        "partition_table_type": "MBR",
++        "system_id": "e8xa8m",
++        "filesystem": null,
++        "uuid": null,
++        "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++        "type": "physical",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++      }
++    ],
++    "interface_set": [
++      {
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": true,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "fabric": "fabric-1",
++          "fabric_id": 1,
++          "primary_rack": "mhce3f",
++          "secondary_rack": null,
++          "space": "FooSpace",
++          "name": "untagged",
++          "id": 5002,
++          "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++        },
++        "links": [
++          {
++            "id": 13,
++            "mode": "auto",
++            "ip_address": "172.16.99.5",
++            "subnet": {
++              "name": "172.16.99.0/24",
++              "vlan": {
++                "vid": 0,
++                "mtu": 1500,
++                "dhcp_on": true,
++                "external_dhcp": null,
++                "relay_vlan": null,
++                "fabric": "fabric-1",
++                "fabric_id": 1,
++                "primary_rack": "mhce3f",
++                "secondary_rack": null,
++                "space": "FooSpace",
++                "name": "untagged",
++                "id": 5002,
++                "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++              },
++              "cidr": "172.16.99.0/24",
++              "rdns_mode": 2,
++              "gateway_ip": "172.16.99.1",
++              "dns_servers": [],
++              "allow_dns": true,
++              "allow_proxy": true,
++              "active_discovery": false,
++              "managed": true,
++              "space": "FooSpace",
++              "id": 2,
++              "resource_uri": "/MAAS/api/2.0/subnets/2/"
++            }
++          }
++        ],
++        "vendor": "QEMU",
++        "enabled": true,
++        "children": [],
++        "name": "ens4",
++        "id": 5,
++        "discovered": [],
++        "parents": [],
++        "effective_mtu": 1500,
++        "product": "Standard PC (i440FX + PIIX, 1996)",
++        "firmware_version": null,
++        "system_id": "e8xa8m",
++        "mac_address": "52:54:00:52:a5:9e",
++        "tags": [],
++        "type": "physical",
++        "params": "",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/interfaces/5/"
++      }
++    ],
++    "architecture": "amd64/generic",
++    "commissioning_status": 2,
++    "hwe_kernel": "ga-18.04",
++    "current_installation_result_id": 8,
++    "swap_size": null,
++    "memory": 1024,
++    "pod": {
++      "id": 1,
++      "name": "MyPodName",
++      "resource_uri": "/MAAS/api/2.0/pods/1/"
++    },
++    "current_commissioning_result_id": 6,
++    "hardware_info": {
++      "system_vendor": "QEMU",
++      "system_product": "Standard PC (i440FX + PIIX, 1996)",
++      "system_version": "pc-i440fx-bionic",
++      "system_serial": "Unknown",
++      "cpu_model": "QEMU Virtual CPU version 2.5+",
++      "mainboard_vendor": "Unknown",
++      "mainboard_product": "Unknown",
++      "mainboard_firmware_version": "1.10.2-1ubuntu1",
++      "mainboard_firmware_date": "04/01/2014"
++    },
++    "pool": {
++      "name": "newname",
++      "description": "new description",
++      "id": 1,
++      "resource_uri": "/MAAS/api/2.0/resourcepool/1/"
++    },
++    "current_testing_result_id": 7,
++    "tag_names": [
++      "virtual",
++      "mypod"
++    ],
++    "storage_test_status": 2,
++    "address_ttl": null,
++    "status_message": "'cloudinit' running modules for final",
++    "cache_sets": [],
++    "other_test_status_name": "Unknown",
++    "node_type_name": "Machine",
++    "distro_series": "bionic",
++    "zone": {
++      "name": "default",
++      "description": "",
++      "id": 1,
++      "resource_uri": "/MAAS/api/2.0/zones/default/"
++    },
++    "min_hwe_kernel": "",
++    "domain": {
++      "authoritative": true,
++      "ttl": null,
++      "name": "maas",
++      "resource_record_count": 0,
++      "id": 0,
++      "is_default": true,
++      "resource_uri": "/MAAS/api/2.0/domains/0/"
++    },
++    "system_id": "e8xa8m",
++    "locked": false,
++    "power_type": "virsh",
++    "node_type": 0,
++    "memory_test_status": -1,
++    "memory_test_status_name": "Unknown",
++    "status": 6,
++    "netboot": false,
++    "volume_groups": [],
++    "raids": [],
++    "default_gateways": {
++      "ipv4": {
++        "gateway_ip": "172.16.99.1",
++        "link_id": null
++      },
++      "ipv6": {
++        "gateway_ip": null,
++        "link_id": null
++      }
++    },
++    "commissioning_status_name": "Passed",
++    "status_action": "modules-final",
++    "other_test_status": -1,
++    "status_name": "Deployed",
++    "storage_test_status_name": "Passed",
++    "owner": "admin",
++    "resource_uri": "/MAAS/api/2.0/machines/e8xa8m/"
++  },
++  "power-off": {
++    "cpu_count": 1,
++    "fqdn": "node2.maas",
++    "hostname": "node2",
++    "power_state": "on",
++    "cpu_test_status": -1,
++    "storage": 8000,
++    "osystem": "ubuntu",
++    "cpu_test_status_name": "Unknown",
++    "testing_status": 2,
++    "iscsiblockdevice_set": [],
++    "boot_interface": {
++      "vlan": {
++        "vid": 0,
++        "mtu": 1500,
++        "dhcp_on": true,
++        "external_dhcp": null,
++        "relay_vlan": null,
++        "fabric": "fabric-1",
++        "fabric_id": 1,
++        "primary_rack": "mhce3f",
++        "secondary_rack": null,
++        "space": "FooSpace",
++        "name": "untagged",
++        "id": 5002,
++        "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++      },
++      "links": [
++        {
++          "id": 13,
++          "mode": "auto",
++          "ip_address": "172.16.99.5",
++          "subnet": {
++            "name": "172.16.99.0/24",
++            "vlan": {
++              "vid": 0,
++              "mtu": 1500,
++              "dhcp_on": true,
++              "external_dhcp": null,
++              "relay_vlan": null,
++              "fabric": "fabric-1",
++              "fabric_id": 1,
++              "primary_rack": "mhce3f",
++              "secondary_rack": null,
++              "space": "FooSpace",
++              "name": "untagged",
++              "id": 5002,
++              "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++            },
++            "cidr": "172.16.99.0/24",
++            "rdns_mode": 2,
++            "gateway_ip": "172.16.99.1",
++            "dns_servers": [],
++            "allow_dns": true,
++            "allow_proxy": true,
++            "active_discovery": false,
++            "managed": true,
++            "space": "FooSpace",
++            "id": 2,
++            "resource_uri": "/MAAS/api/2.0/subnets/2/"
++          }
++        }
++      ],
++      "vendor": "QEMU",
++      "enabled": true,
++      "children": [],
++      "name": "ens4",
++      "id": 5,
++      "discovered": [],
++      "parents": [],
++      "effective_mtu": 1500,
++      "product": "Standard PC (i440FX + PIIX, 1996)",
++      "firmware_version": null,
++      "system_id": "e8xa8m",
++      "mac_address": "52:54:00:52:a5:9e",
++      "tags": [],
++      "type": "physical",
++      "params": "",
++      "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/interfaces/5/"
++    },
++    "boot_disk": {
++      "firmware_version": null,
++      "model": "",
++      "path": "/dev/disk/by-dname/vda",
++      "serial": "",
++      "block_size": 4096,
++      "partitions": [
++        {
++          "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++          "size": 7994343424,
++          "bootable": false,
++          "tags": [],
++          "type": "partition",
++          "path": "/dev/disk/by-dname/vda-part1",
++          "device_id": 2,
++          "used_for": "ext4 formatted filesystem mounted at /",
++          "system_id": "e8xa8m",
++          "filesystem": {
++            "fstype": "ext4",
++            "label": "root",
++            "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++            "mount_point": "/",
++            "mount_options": null
++          },
++          "id": 2,
++          "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++        }
++      ],
++      "available_size": 0,
++      "used_size": 7999586304,
++      "id_path": "/dev/vda",
++      "name": "vda",
++      "id": 2,
++      "used_for": "MBR partitioned with 1 partition",
++      "partition_table_type": "MBR",
++      "system_id": "e8xa8m",
++      "size": 8000000000,
++      "tags": [
++        "rotary"
++      ],
++      "filesystem": null,
++      "uuid": null,
++      "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++      "type": "physical",
++      "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++    },
++    "bcaches": [],
++    "cpu_speed": 2500,
++    "ip_addresses": [
++      "172.16.99.5"
++    ],
++    "virtualblockdevice_set": [],
++    "special_filesystems": [],
++    "owner_data": {},
++    "physicalblockdevice_set": [
++      {
++        "firmware_version": null,
++        "model": "",
++        "path": "/dev/disk/by-dname/vda",
++        "serial": "",
++        "block_size": 4096,
++        "partitions": [
++          {
++            "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++            "size": 7994343424,
++            "bootable": false,
++            "tags": [],
++            "type": "partition",
++            "path": "/dev/disk/by-dname/vda-part1",
++            "device_id": 2,
++            "used_for": "ext4 formatted filesystem mounted at /",
++            "system_id": "e8xa8m",
++            "filesystem": {
++              "fstype": "ext4",
++              "label": "root",
++              "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++              "mount_point": "/",
++              "mount_options": null
++            },
++            "id": 2,
++            "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++          }
++        ],
++        "available_size": 0,
++        "used_size": 7999586304,
++        "id_path": "/dev/vda",
++        "name": "vda",
++        "id": 2,
++        "used_for": "MBR partitioned with 1 partition",
++        "partition_table_type": "MBR",
++        "system_id": "e8xa8m",
++        "size": 8000000000,
++        "tags": [
++          "rotary"
++        ],
++        "filesystem": null,
++        "uuid": null,
++        "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++        "type": "physical",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++      }
++    ],
++    "testing_status_name": "Passed",
++    "disable_ipv4": false,
++    "blockdevice_set": [
++      {
++        "id_path": "/dev/vda",
++        "size": 8000000000,
++        "block_size": 4096,
++        "tags": [
++          "rotary"
++        ],
++        "model": "",
++        "path": "/dev/disk/by-dname/vda",
++        "serial": "",
++        "partitions": [
++          {
++            "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++            "size": 7994343424,
++            "bootable": false,
++            "tags": [],
++            "type": "partition",
++            "path": "/dev/disk/by-dname/vda-part1",
++            "device_id": 2,
++            "used_for": "ext4 formatted filesystem mounted at /",
++            "system_id": "e8xa8m",
++            "filesystem": {
++              "fstype": "ext4",
++              "label": "root",
++              "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++              "mount_point": "/",
++              "mount_options": null
++            },
++            "id": 2,
++            "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++          }
++        ],
++        "available_size": 0,
++        "used_size": 7999586304,
++        "name": "vda",
++        "id": 2,
++        "used_for": "MBR partitioned with 1 partition",
++        "partition_table_type": "MBR",
++        "system_id": "e8xa8m",
++        "filesystem": null,
++        "uuid": null,
++        "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++        "type": "physical",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++      }
++    ],
++    "interface_set": [
++      {
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": true,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "fabric": "fabric-1",
++          "fabric_id": 1,
++          "primary_rack": "mhce3f",
++          "secondary_rack": null,
++          "space": "FooSpace",
++          "name": "untagged",
++          "id": 5002,
++          "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++        },
++        "links": [
++          {
++            "id": 13,
++            "mode": "auto",
++            "ip_address": "172.16.99.5",
++            "subnet": {
++              "name": "172.16.99.0/24",
++              "vlan": {
++                "vid": 0,
++                "mtu": 1500,
++                "dhcp_on": true,
++                "external_dhcp": null,
++                "relay_vlan": null,
++                "fabric": "fabric-1",
++                "fabric_id": 1,
++                "primary_rack": "mhce3f",
++                "secondary_rack": null,
++                "space": "FooSpace",
++                "name": "untagged",
++                "id": 5002,
++                "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++              },
++              "cidr": "172.16.99.0/24",
++              "rdns_mode": 2,
++              "gateway_ip": "172.16.99.1",
++              "dns_servers": [],
++              "allow_dns": true,
++              "allow_proxy": true,
++              "active_discovery": false,
++              "managed": true,
++              "space": "FooSpace",
++              "id": 2,
++              "resource_uri": "/MAAS/api/2.0/subnets/2/"
++            }
++          }
++        ],
++        "vendor": "QEMU",
++        "enabled": true,
++        "children": [],
++        "name": "ens4",
++        "id": 5,
++        "discovered": [],
++        "parents": [],
++        "effective_mtu": 1500,
++        "product": "Standard PC (i440FX + PIIX, 1996)",
++        "firmware_version": null,
++        "system_id": "e8xa8m",
++        "mac_address": "52:54:00:52:a5:9e",
++        "tags": [],
++        "type": "physical",
++        "params": "",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/interfaces/5/"
++      }
++    ],
++    "architecture": "amd64/generic",
++    "commissioning_status": 2,
++    "hwe_kernel": "ga-18.04",
++    "current_installation_result_id": 8,
++    "swap_size": null,
++    "memory": 1024,
++    "pod": {
++      "id": 1,
++      "name": "MyPodName",
++      "resource_uri": "/MAAS/api/2.0/pods/1/"
++    },
++    "current_commissioning_result_id": 6,
++    "hardware_info": {
++      "system_vendor": "QEMU",
++      "system_product": "Standard PC (i440FX + PIIX, 1996)",
++      "system_version": "pc-i440fx-bionic",
++      "system_serial": "Unknown",
++      "cpu_model": "QEMU Virtual CPU version 2.5+",
++      "mainboard_vendor": "Unknown",
++      "mainboard_product": "Unknown",
++      "mainboard_firmware_version": "1.10.2-1ubuntu1",
++      "mainboard_firmware_date": "04/01/2014"
++    },
++    "pool": {
++      "name": "newname",
++      "description": "new description",
++      "id": 1,
++      "resource_uri": "/MAAS/api/2.0/resourcepool/1/"
++    },
++    "current_testing_result_id": 7,
++    "tag_names": [
++      "virtual",
++      "mypod"
++    ],
++    "storage_test_status": 2,
++    "address_ttl": null,
++    "status_message": "'cloudinit' running modules for final",
++    "cache_sets": [],
++    "other_test_status_name": "Unknown",
++    "node_type_name": "Machine",
++    "distro_series": "bionic",
++    "zone": {
++      "name": "default",
++      "description": "",
++      "id": 1,
++      "resource_uri": "/MAAS/api/2.0/zones/default/"
++    },
++    "min_hwe_kernel": "",
++    "domain": {
++      "authoritative": true,
++      "ttl": null,
++      "name": "maas",
++      "resource_record_count": 0,
++      "id": 0,
++      "is_default": true,
++      "resource_uri": "/MAAS/api/2.0/domains/0/"
++    },
++    "system_id": "e8xa8m",
++    "locked": false,
++    "power_type": "virsh",
++    "node_type": 0,
++    "memory_test_status": -1,
++    "memory_test_status_name": "Unknown",
++    "status": 6,
++    "netboot": false,
++    "volume_groups": [],
++    "raids": [],
++    "default_gateways": {
++      "ipv4": {
++        "gateway_ip": "172.16.99.1",
++        "link_id": null
++      },
++      "ipv6": {
++        "gateway_ip": null,
++        "link_id": null
++      }
++    },
++    "commissioning_status_name": "Passed",
++    "status_action": "modules-final",
++    "other_test_status": -1,
++    "status_name": "Deployed",
++    "storage_test_status_name": "Passed",
++    "owner": "admin",
++    "resource_uri": "/MAAS/api/2.0/machines/e8xa8m/"
++  },
++  "test": {
++    "cpu_speed": 2500,
++    "disable_ipv4": false,
++    "cache_sets": [],
++    "other_test_status_name": "Unknown",
++    "memory_test_status": -1,
++    "tag_names": [
++      "virtual",
++      "mypod"
++    ],
++    "netboot": false,
++    "power_type": "virsh",
++    "hostname": "node2",
++    "node_type": 0,
++    "testing_status": 0,
++    "default_gateways": {
++      "ipv4": {
++        "gateway_ip": "172.16.99.1",
++        "link_id": null
++      },
++      "ipv6": {
++        "gateway_ip": null,
++        "link_id": null
++      }
++    },
++    "raids": [],
++    "current_installation_result_id": 8,
++    "locked": false,
++    "zone": {
++      "name": "default",
++      "description": "",
++      "id": 1,
++      "resource_uri": "/MAAS/api/2.0/zones/default/"
++    },
++    "iscsiblockdevice_set": [],
++    "current_commissioning_result_id": 6,
++    "current_testing_result_id": 49,
++    "osystem": "ubuntu",
++    "cpu_count": 1,
++    "node_type_name": "Machine",
++    "blockdevice_set": [
++      {
++        "id_path": "/dev/vda",
++        "size": 8000000000,
++        "block_size": 4096,
++        "tags": [
++          "rotary"
++        ],
++        "used_size": 7999586304,
++        "used_for": "MBR partitioned with 1 partition",
++        "filesystem": null,
++        "model": "",
++        "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++        "serial": "",
++        "partition_table_type": "MBR",
++        "type": "physical",
++        "id": 2,
++        "path": "/dev/disk/by-dname/vda",
++        "system_id": "e8xa8m",
++        "uuid": null,
++        "available_size": 0,
++        "partitions": [
++          {
++            "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++            "size": 7994343424,
++            "bootable": false,
++            "tags": [],
++            "used_for": "ext4 formatted filesystem mounted at /",
++            "filesystem": {
++              "fstype": "ext4",
++              "label": "root",
++              "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++              "mount_point": "/",
++              "mount_options": null
++            },
++            "device_id": 2,
++            "type": "partition",
++            "id": 2,
++            "path": "/dev/disk/by-dname/vda-part1",
++            "system_id": "e8xa8m",
++            "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++          }
++        ],
++        "name": "vda",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++      }
++    ],
++    "boot_interface": {
++      "firmware_version": null,
++      "vlan": {
++        "vid": 0,
++        "mtu": 1500,
++        "dhcp_on": true,
++        "external_dhcp": null,
++        "relay_vlan": null,
++        "secondary_rack": null,
++        "primary_rack": "mhce3f",
++        "space": "FooSpace",
++        "id": 5002,
++        "fabric": "fabric-1",
++        "fabric_id": 1,
++        "name": "untagged",
++        "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++      },
++      "links": [
++        {
++          "id": 13,
++          "mode": "auto",
++          "ip_address": "172.16.99.5",
++          "subnet": {
++            "name": "172.16.99.0/24",
++            "vlan": {
++              "vid": 0,
++              "mtu": 1500,
++              "dhcp_on": true,
++              "external_dhcp": null,
++              "relay_vlan": null,
++              "secondary_rack": null,
++              "primary_rack": "mhce3f",
++              "space": "FooSpace",
++              "id": 5002,
++              "fabric": "fabric-1",
++              "fabric_id": 1,
++              "name": "untagged",
++              "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++            },
++            "cidr": "172.16.99.0/24",
++            "rdns_mode": 2,
++            "gateway_ip": "172.16.99.1",
++            "dns_servers": [],
++            "allow_dns": true,
++            "allow_proxy": true,
++            "active_discovery": false,
++            "managed": true,
++            "space": "FooSpace",
++            "id": 2,
++            "resource_uri": "/MAAS/api/2.0/subnets/2/"
++          }
++        }
++      ],
++      "mac_address": "52:54:00:52:a5:9e",
++      "parents": [],
++      "effective_mtu": 1500,
++      "discovered": [],
++      "type": "physical",
++      "children": [],
++      "product": "Standard PC (i440FX + PIIX, 1996)",
++      "params": "",
++      "tags": [],
++      "id": 5,
++      "vendor": "QEMU",
++      "system_id": "e8xa8m",
++      "enabled": true,
++      "name": "ens4",
++      "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/interfaces/5/"
++    },
++    "pod": {
++      "id": 1,
++      "name": "MyPodName",
++      "resource_uri": "/MAAS/api/2.0/pods/1/"
++    },
++    "storage_test_status": 0,
++    "architecture": "amd64/generic",
++    "memory_test_status_name": "Unknown",
++    "storage": 8000,
++    "status_action": "modules-final",
++    "virtualblockdevice_set": [],
++    "special_filesystems": [],
++    "other_test_status": -1,
++    "status_name": "Testing",
++    "volume_groups": [],
++    "ip_addresses": [
++      "172.16.99.5"
++    ],
++    "hardware_info": {
++      "system_vendor": "QEMU",
++      "system_product": "Standard PC (i440FX + PIIX, 1996)",
++      "system_version": "pc-i440fx-bionic",
++      "system_serial": "Unknown",
++      "cpu_model": "QEMU Virtual CPU version 2.5+",
++      "mainboard_vendor": "Unknown",
++      "mainboard_product": "Unknown",
++      "mainboard_firmware_version": "1.10.2-1ubuntu1",
++      "mainboard_firmware_date": "04/01/2014"
++    },
++    "swap_size": null,
++    "owner_data": {},
++    "status": 21,
++    "cpu_test_status_name": "Unknown",
++    "boot_disk": {
++      "firmware_version": null,
++      "id_path": "/dev/vda",
++      "block_size": 4096,
++      "used_size": 7999586304,
++      "used_for": "MBR partitioned with 1 partition",
++      "filesystem": null,
++      "model": "",
++      "size": 8000000000,
++      "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++      "serial": "",
++      "partition_table_type": "MBR",
++      "type": "physical",
++      "tags": [
++        "rotary"
++      ],
++      "id": 2,
++      "path": "/dev/disk/by-dname/vda",
++      "system_id": "e8xa8m",
++      "uuid": null,
++      "available_size": 0,
++      "partitions": [
++        {
++          "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++          "size": 7994343424,
++          "bootable": false,
++          "tags": [],
++          "used_for": "ext4 formatted filesystem mounted at /",
++          "filesystem": {
++            "fstype": "ext4",
++            "label": "root",
++            "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++            "mount_point": "/",
++            "mount_options": null
++          },
++          "device_id": 2,
++          "type": "partition",
++          "id": 2,
++          "path": "/dev/disk/by-dname/vda-part1",
++          "system_id": "e8xa8m",
++          "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++        }
++      ],
++      "name": "vda",
++      "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++    },
++    "address_ttl": null,
++    "system_id": "e8xa8m",
++    "memory": 1024,
++    "domain": {
++      "authoritative": true,
++      "ttl": null,
++      "resource_record_count": 0,
++      "is_default": true,
++      "id": 0,
++      "name": "maas",
++      "resource_uri": "/MAAS/api/2.0/domains/0/"
++    },
++    "min_hwe_kernel": "",
++    "physicalblockdevice_set": [
++      {
++        "firmware_version": null,
++        "id_path": "/dev/vda",
++        "block_size": 4096,
++        "used_size": 7999586304,
++        "used_for": "MBR partitioned with 1 partition",
++        "filesystem": null,
++        "model": "",
++        "size": 8000000000,
++        "storage_pool": "30c2ef09-cfca-4a17-b2b0-2b69bf4d62d8",
++        "serial": "",
++        "partition_table_type": "MBR",
++        "type": "physical",
++        "tags": [
++          "rotary"
++        ],
++        "id": 2,
++        "path": "/dev/disk/by-dname/vda",
++        "system_id": "e8xa8m",
++        "uuid": null,
++        "available_size": 0,
++        "partitions": [
++          {
++            "uuid": "b4922056-6481-4d40-87cd-5bac47dca519",
++            "size": 7994343424,
++            "bootable": false,
++            "tags": [],
++            "used_for": "ext4 formatted filesystem mounted at /",
++            "filesystem": {
++              "fstype": "ext4",
++              "label": "root",
++              "uuid": "bc478524-ad85-419f-8795-aa7b89590f6f",
++              "mount_point": "/",
++              "mount_options": null
++            },
++            "device_id": 2,
++            "type": "partition",
++            "id": 2,
++            "path": "/dev/disk/by-dname/vda-part1",
++            "system_id": "e8xa8m",
++            "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/partition/2"
++          }
++        ],
++        "name": "vda",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/blockdevices/2/"
++      }
++    ],
++    "owner": "admin",
++    "power_state": "on",
++    "hwe_kernel": "ga-18.04",
++    "testing_status_name": "Pending",
++    "pool": {
++      "name": "newname",
++      "description": "new description",
++      "id": 1,
++      "resource_uri": "/MAAS/api/2.0/resourcepool/1/"
++    },
++    "fqdn": "node2.maas",
++    "status_message": "'cloudinit' running modules for final",
++    "commissioning_status": 2,
++    "distro_series": "bionic",
++    "cpu_test_status": -1,
++    "storage_test_status_name": "Pending",
++    "bcaches": [],
++    "interface_set": [
++      {
++        "firmware_version": null,
++        "vlan": {
++          "vid": 0,
++          "mtu": 1500,
++          "dhcp_on": true,
++          "external_dhcp": null,
++          "relay_vlan": null,
++          "secondary_rack": null,
++          "primary_rack": "mhce3f",
++          "space": "FooSpace",
++          "id": 5002,
++          "fabric": "fabric-1",
++          "fabric_id": 1,
++          "name": "untagged",
++          "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++        },
++        "links": [
++          {
++            "id": 13,
++            "mode": "auto",
++            "ip_address": "172.16.99.5",
++            "subnet": {
++              "name": "172.16.99.0/24",
++              "vlan": {
++                "vid": 0,
++                "mtu": 1500,
++                "dhcp_on": true,
++                "external_dhcp": null,
++                "relay_vlan": null,
++                "secondary_rack": null,
++                "primary_rack": "mhce3f",
++                "space": "FooSpace",
++                "id": 5002,
++                "fabric": "fabric-1",
++                "fabric_id": 1,
++                "name": "untagged",
++                "resource_uri": "/MAAS/api/2.0/vlans/5002/"
++              },
++              "cidr": "172.16.99.0/24",
++              "rdns_mode": 2,
++              "gateway_ip": "172.16.99.1",
++              "dns_servers": [],
++              "allow_dns": true,
++              "allow_proxy": true,
++              "active_discovery": false,
++              "managed": true,
++              "space": "FooSpace",
++              "id": 2,
++              "resource_uri": "/MAAS/api/2.0/subnets/2/"
++            }
++          }
++        ],
++        "mac_address": "52:54:00:52:a5:9e",
++        "parents": [],
++        "effective_mtu": 1500,
++        "discovered": [],
++        "type": "physical",
++        "children": [],
++        "product": "Standard PC (i440FX + PIIX, 1996)",
++        "params": "",
++        "tags": [],
++        "id": 5,
++        "vendor": "QEMU",
++        "system_id": "e8xa8m",
++        "enabled": true,
++        "name": "ens4",
++        "resource_uri": "/MAAS/api/2.0/nodes/e8xa8m/interfaces/5/"
++      }
++    ],
++    "commissioning_status_name": "Passed",
++    "resource_uri": "/MAAS/api/2.0/machines/e8xa8m/"
++  },
++  "get-power-params": {
++    "dypesm": {
++      "power_address": "qemu+ssh://ubuntu@172.16.1.28/system",
++      "power_id": "driven-bat"
++    },
++    "xs7qfn": {
++      "power_address": "qemu+ssh://ubuntu@172.16.1.134/system",
++      "power_id": "nice-shad"
++    }
++  }
++}
 diff --git a/src/maasserver/api/nodes.py b/src/maasserver/api/nodes.py
 index 24086dc..1fe4012 100644
 --- a/src/maasserver/api/nodes.py
 +++ b/src/maasserver/api/nodes.py
@@ -297,7 +297,8 @@ def get_script_status_name(script_status):
  class NodeHandler(OperationsHandler):
--    """Manage an individual Node.
++    """
++    Manage an individual Node.
      The Node is identified by its system_id.
      """
@@ -420,9 +421,20 @@ class NodeHandler(OperationsHandler):
          return ret
      def read(self, request, system_id):
--        """Read a specific Node.
++        """@description-title Read a node
++        @description Reads a node with the given system_id.
++
++        @param (string) "{system_id}" [required=true] A node's system_id.
++
++        @success (http-status-code) "server-success" 200
++        @success (json) "success-json" A JSON object containing
++        information about the requested node.
++        @success-example "success-json" [exkey=read-node] placeholder text
--        Returns 404 if the node is not found.
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
          """
          node = self.model.objects.get_node_or_404(
              system_id=system_id, user=request.user, perm=NodePermission.view)
@@ -434,11 +446,21 @@ class NodeHandler(OperationsHandler):
              return node.as_self()
      def delete(self, request, system_id):
--        """Delete a specific Node.
++        """@description-title Delete a node
++        @description Deletes a node with a given system_id.
++
++        @param (string) "{system_id}" [required=true] A node's system_id.
++
++        @success (http-status-code) "204" 204
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
--        Returns 404 if the node is not found.
--        Returns 403 if the user does not have permission to delete the node.
--        Returns 204 if the node is successfully deleted.
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user is not authorized to delete the
++        node.
          """
          node = self.model.objects.get_node_or_404(
              system_id=system_id, user=request.user,
@@ -476,18 +498,31 @@ class NodeHandler(OperationsHandler):
      @operation(idempotent=True)
      def details(self, request, system_id):
--        """Obtain various system details.
--
--        For example, LLDP and ``lshw`` XML dumps.
++        """@description-title Get system details
++        @description Returns system details -- for example, LLDP and
++        ``lshw`` XML dumps.
          Returns a ``{detail_type: xml, ...}`` map, where
          ``detail_type`` is something like "lldp" or "lshw".
          Note that this is returned as BSON and not JSON. This is for
--        efficiency, but mainly because JSON can't do binary content
--        without applying additional encoding like base-64.
++        efficiency, but mainly because JSON can't do binary content without
++        applying additional encoding like base-64. The example output below is
++        represented in ASCII using ``bsondump example.bson`` and is for
++        demonstrative purposes.
++
++        @param (string) "{system_id}" [required=true] The node's system_id.
++
++        @success (http-status-code) "200" 200
--        Returns 404 if the node is not found.
++        @success (content) "success-content" A BSON object represented here in
++        ASCII using ``bsondump example.bson``.
++        @success-example "success-content" [exkey=details] placeholder text
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
          """
          node = get_object_or_404(self.model, system_id=system_id)
          probe_details = get_single_probed_details(node)
@@ -503,16 +538,26 @@ class NodeHandler(OperationsHandler):
      @admin_method
      @operation(idempotent=True)
      def power_parameters(self, request, system_id):
--        """Obtain power parameters.
--
--        This method is reserved for admin users and returns a 403 if the
--        user is not one.
--
--        This returns the power parameters, if any, configured for a
--        node. For some types of power control this will include private
--        information such as passwords and secret keys.
--
--        Returns 404 if the node is not found.
++        """@description-title Get power parameters
++        @description Gets power parameters for a given system_id, if any. For
++        some types of power control this will include private information such
++        as passwords and secret keys.
++
++        Note that this method is reserved for admin users and returns a 403 if
++        the user is not one.
++
++        @success (http-status-code) "200" 200
++
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user does not have permission to see
++        the power parameters.
++        @error-example "no-perms"
++            This method is reserved for admin users.
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
          """
          node = get_object_or_404(self.model, system_id=system_id)
          return node.power_parameters
@@ -532,15 +577,24 @@ class AnonNodesHandler(AnonymousOperationsHandler):
      @operation(idempotent=True)
      def is_registered(self, request):
--        """Returns whether or not the given MAC address is registered within
--        this MAAS (and attached to a non-retired node).
--
--        :param mac_address: The mac address to be checked.
--        :type mac_address: unicode
--        :return: 'true' or 'false'.
--        :rtype: unicode
--
--        Returns 400 if any mandatory parameters are missing.
++        """@description-title MAC address registered
++        @description Returns whether or not the given MAC address is registered
++        within this MAAS (and attached to a non-retired node).
++
++        @param (url-string) "mac_address" [required=true] The MAC address to be
++        checked.
++        @param-example "mac_address"
++            ``/nodes/?op=is_registered&mac_address=28:16:ad:a1:fa:63``
++
++        @success (http-status-code) "200" 200
++        @success (boolean) "success_example" 'true' or 'false'
++        @success-example "success_example"
++            false
++
++        @error (http-status-code) "400" 400
++        @error (content) "no-address" mac_address was missing
++        @error-example "no-address"
++            No provided mac_address!
          """
          # If a node is added with missing/incorrect arch/boot MAC it will
          # enter enlistment instead of commissioning. Enlistment should be
@@ -555,13 +609,24 @@ class AnonNodesHandler(AnonymousOperationsHandler):
      @operation(idempotent=True)
      def is_action_in_progress(self, request):
--        """Returns whether or not the given MAC address is a machine
++        """@description-title MAC address of deploying or commissioning node
++        @description Returns whether or not the given MAC address is a machine
          that's either 'deploying' or 'commissioning'.
--        :param mac_address: The mac address to be checked.
--        :type mac_address: unicode
--        :return: 'true' or 'false'.
--        :rtype: unicode
++        @param (url-string) "mac_address" [required=true] The MAC address to be
++        checked.
++        @param-example "mac_address"
++            ``/nodes/?op=is_action_in_progress&mac_address=28:16:ad:a1:fa:63``
++
++        @success (http-status-code) "200" 200
++        @success (boolean) "success_example" 'true' or 'false'
++        @success "success_example"
++            false
++
++        @error (http-status-code) "400" 400
++        @error (content) "no-address" mac_address was missing
++        @error-example "no-address"
++            No provided mac_address!
          """
          mac_address = get_mandatory_param(request.GET, 'mac_address')
          interfaces = Interface.objects.filter(mac_address=mac_address)
@@ -583,39 +648,41 @@ class NodesHandler(OperationsHandler):
      base_model = Node
      def read(self, request):
--        """List Nodes visible to the user, optionally filtered by criteria.
++        """@description-title List Nodes visible to the user
++        @description List nodes visible to current user, optionally filtered by
++        criteria.
          Nodes are sorted by id (i.e. most recent last) and grouped by type.
--        :param hostname: An optional hostname. Only nodes relating to the node
--            with the matching hostname will be returned. This can be specified
--            multiple times to see multiple nodes.
--        :type hostname: unicode
++        @param (string) "hostname" [required=false] Only nodes relating to the
++        node with the matching hostname will be returned. This can be specified
++        multiple times to see multiple nodes.
++
++        @param (string) "mac_address" [required=false] Only nodes relating to
++        the node owning the specified MAC address will be returned. This can be
++        specified multiple times to see multiple nodes.
--        :param mac_address: An optional MAC address. Only nodes relating to the
--            node owning the specified MAC address will be returned. This can be
--            specified multiple times to see multiple nodes.
--        :type mac_address: unicode
++        @param (string) "id" [required=false] Only nodes relating to the nodes
++        with matching system ids will be returned.
--        :param id: An optional list of system ids.  Only nodes relating to the
--            nodes with matching system ids will be returned.
--        :type id: unicode
++        @param (string) "domain" [required=false] Only nodes relating to the
++        nodes in the domain will be returned.
--        :param domain: An optional name for a dns domain. Only nodes relating
--            to the nodes in the domain will be returned.
--        :type domain: unicode
++        @param (string) "zone" [required=false] Only nodes relating to the
++        nodes in the zone will be returned.
--        :param zone: An optional name for a physical zone. Only nodes relating
--            to the nodes in the zone will be returned.
--        :type zone: unicode
++        @param (string) "pool" [required=false] Only nodes belonging to the
++        pool will be returned.
--        :param pool: An optional name for a resource pool. Only nodes belonging
--            to the pool will be returned.
--        :type pool: unicode
++        @param (string) "agent_name" [required=false] Only nodes relating to
++        the nodes with matching agent names will be returned.
--        :param agent_name: An optional agent name.  Only nodes relating to the
--            nodes with matching agent names will be returned.
--        :type agent_name: unicode
++        @success (http-status-code) "200" 200
++
++        @success (json) "success_json" A JSON object containing a list of node
++        objects.
++        @success-example "success_json" [exkey=read-visible-nodes] placeholder
++        text
          """
          if self.base_model == Node:
@@ -650,29 +717,46 @@ class NodesHandler(OperationsHandler):
      @operation(idempotent=True)
      def is_registered(self, request):
--        """Returns whether or not the given MAC address is registered within
--        this MAAS (and attached to a non-retired node).
++        """@description-title MAC address registered
++        @description Returns whether or not the given MAC address is registered
++        within this MAAS (and attached to a non-retired node).
++
++        @param (url-string) "mac_address" [required=true] The MAC address to be
++        checked.
++        @param-example "mac_address"
++            ``/nodes/?op=is_registered&mac_address=28:16:ad:a1:fa:63``
++
++        @success (http-status-code) "200" 200
--        :param mac_address: The mac address to be checked.
--        :type mac_address: unicode
--        :return: 'true' or 'false'.
--        :rtype: unicode
++        @success (boolean) "success_example" 'true' or 'false'
++        @success-example "success_example"
++            false
--        Returns 400 if any mandatory parameters are missing.
++        @error (http-status-code) "400" 400
++        @error (content) "no-address" mac_address was missing
++        @error-example "no-address"
++            No provided mac_address!
          """
          return is_registered(request)
      @admin_method
      @operation(idempotent=False)
      def set_zone(self, request):
--        """Assign multiple nodes to a physical zone at once.
++        """@description-title Assign nodes to a zone
++        @description Assigns a given node to a given zone.
++
++        @param (string) "zone" [required=true] The zone name.
++        @param (string) "nodes" [required=true] The node to add.
++
++        @success (http-status-code) "204" 204
--        :param zone: Zone name.  If omitted, the zone is "none" and the nodes
--            will be taken out of their physical zones.
--        :param nodes: system_ids of the nodes whose zones are to be set.
--           (An empty list is acceptable).
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user does not have set the zone.
++        @error-example "no-perms"
++            This method is reserved for admin users.
--        Raises 403 if the user is not an admin.
++        @error (http-status-code) "400" 400
++        @error (content) "bad-param" The given parameters were not correct.
          """
          data = {
              'action': 'set_zone',
@@ -703,17 +787,25 @@ class OwnerDataMixin:
      @operation(idempotent=False)
      def set_owner_data(self, request, system_id):
--        """Set key/value data for the current owner.
++        """@description-title Set key=value data
++        @description Set key=value data for the current owner.
--        Pass any key/value data to this method to add, modify, or remove. A key
--        is removed when the value for that key is set to an empty string.
++        Pass any key=value form data to this method to add, modify, or remove.
++        A key is removed when the value for that key is set to an empty string.
          This operation will not remove any previous keys unless explicitly
          passed with an empty string. All owner data is removed when the machine
          is no longer allocated to a user.
--        Returns 404 if the machine is not found.
--        Returns 403 if the user does not have permission.
++        @param (string) "key" [required=true] ``key`` can be any string value.
++
++        @success (http-status-code) "204" 204
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user does not have set the zone.
          """
          node = self.model.objects.get_node_or_404(
              user=request.user, system_id=system_id, perm=NodePermission.edit)
@@ -731,20 +823,25 @@ class PowerMixin:
      @operation(idempotent=True)
      def query_power_state(self, request, system_id):
--        """Query the power state of a node.
--
--        Send a request to the node's power controller which asks it about
--        the node's state.  The reply to this could be delayed by up to
--        30 seconds while waiting for the power controller to respond.
--        Use this method sparingly as it ties up an appserver thread
--        while waiting.
--
--        :param system_id: The node to query.
--        :return: a dict whose key is "state" with a value of one of
--            'on' or 'off'.
--
--        Returns 404 if the node is not found.
--        Returns node's power state.
++        """@description-title Get the power state of a node
++        @description Gets the power state of a given node. MAAS sends a request
++        to the node's power controller, which asks it about the node's state.
++        The reply to this could be delayed by up to 30 seconds while waiting
++        for the power controller to respond.  Use this method sparingly as it
++        ties up an appserver thread while waiting.
++
++        @param (string) "system_id" [required=true] The node to query.
++
++        @success (http-status-code) "200" 200
++        @success (json) "success_json" A JSON object containing the node's
++        power state.
++        @success-example "success_json" [exkey=query-power-state] placeholder
++        text.
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
          """
          node = self.model.objects.get_node_or_404(
              system_id=system_id, user=request.user,
@@ -755,24 +852,33 @@ class PowerMixin:
      @operation(idempotent=False)
      def power_on(self, request, system_id):
--        """Turn on a node.
--
--        :param user_data: If present, this blob of user-data to be made
--            available to the nodes through the metadata service.
--        :type user_data: base64-encoded unicode
--        :param comment: Optional comment for the event log.
--        :type comment: unicode
--
--        Ideally we'd have MIME multipart and content-transfer-encoding etc.
--        deal with the encapsulation of binary data, but couldn't make it work
--        with the framework in reasonable time so went for a dumb, manual
--        encoding instead.
--
--        Returns 404 if the node is not found.
--        Returns 403 if the user does not have permission to start the machine.
--        Returns 503 if the start-up attempted to allocate an IP address,
--        and there were no IP addresses available on the relevant cluster
--        interface.
++        """@description-title Turn on a node
++        @description Turn on the given node with optional user-data and
++        comment.
++
++        @param (string) "user_data" [required=false] Base64-encoded blob of
++        data to be made available to the nodes through the metadata service.
++
++        @param (string) "comment" [required=false] Comment for the event log.
++
++        @success (http-status-code) "204" 204
++        @success (json) "success_json" A JSON object containing the node's
++        information.
++        @success-example "success_json" [exkey=power-on] placeholder text
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
++
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user is not authorized to power on the
++        node.
++
++        @error (http-status-code) "503" 503
++        @error (content) "no-ips" Returns 503 if the start-up attempted to
++        allocate an IP address, and there were no IP addresses available on the
++        relevant cluster interface.
          """
          user_data = request.POST.get('user_data', None)
          comment = get_optional_param(request.POST, 'comment')
@@ -797,21 +903,32 @@ class PowerMixin:
      @operation(idempotent=False)
      def power_off(self, request, system_id):
--        """Power off a node.
--
--        :param stop_mode: An optional power off mode. If 'soft',
--            perform a soft power down if the node's power type supports
--            it, otherwise perform a hard power off. For all values other
--            than 'soft', and by default, perform a hard power off. A
--            soft power off generally asks the OS to shutdown the system
--            gracefully before powering off, while a hard power off
--            occurs immediately without any warning to the OS.
--        :type stop_mode: unicode
--        :param comment: Optional comment for the event log.
--        :type comment: unicode
--
--        Returns 404 if the node is not found.
--        Returns 403 if the user does not have permission to stop the node.
++        """@description-title Power off a node
++        @description Powers off a given node.
++
++        @param (string) "stop_mode" [required=false] Power-off mode. If 'soft',
++        perform a soft power down if the node's power type supports it,
++        otherwise perform a hard power off. For all values other than 'soft',
++        and by default, perform a hard power off. A soft power off generally
++        asks the OS to shutdown the system gracefully before powering off,
++        while a hard power off occurs immediately without any warning to the
++        OS.
++
++        @param (string) "comment" [required=false] Comment for the event log.
++
++        @success (http-status-code) "204" 204
++        @success (json) "success_json" A JSON object containing the node's
++        information.
++        @success-example "success_json" [exkey=power-off] placeholder text
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
++
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user is not authorized to power off the
++        node.
          """
          stop_mode = request.POST.get('stop_mode', 'hard')
          comment = get_optional_param(request.POST, 'comment')
@@ -827,23 +944,32 @@ class PowerMixin:
      @operation(idempotent=False)
      def test(self, request, system_id):
--        """Begin testing process for a node.
--
--        :param enable_ssh: Whether to enable SSH for the testing environment
--            using the user's SSH key(s).
--        :type enable_ssh: bool ('0' for False, '1' for True)
--        :param testing_scripts: A comma seperated list of testing script names
--            and tags to be run. By default all tests tagged 'commissioning'
--            will be run.
--        :type testing_scripts: string
++        """@description-title Begin testing process for a node
++        @description Begins the testing process for a given node.
          A node in the 'ready', 'allocated', 'deployed', 'broken', or any failed
          state may run tests. If testing is started and successfully passes from
--        a 'broken', or any failed state besides 'failed commissioning' the node
++        'broken' or any failed state besides 'failed commissioning' the node
          will be returned to a ready state. Otherwise the node will return to
          the state it was when testing started.
--        Returns 404 if the node is not found.
++        @param (int) "enable_ssh" [required=false] Whether to enable SSH for
++        the testing environment using the user's SSH key(s). 0 == false. 1 ==
++        true.
++
++        @param (string) "testing_scripts" [required=false] A comma-separated
++        list of testing script names and tags to be run. By default all tests
++        tagged 'commissioning' will be run.
++
++        @success (http-status-code) "204" 204
++        @success (json) "success_json" A JSON object containing the node's
++        information.
++        @success-example "success_json" [exkey=test] placeholder text
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
          """
          node = self.model.objects.get_node_or_404(
              system_id=system_id, user=request.user, perm=NodePermission.admin)
@@ -858,14 +984,21 @@ class PowerMixin:
      @operation(idempotent=False)
      def override_failed_testing(self, request, system_id):
--        """Ignore failed tests and put node back into a usable state.
++        """@description-title Ignore failed tests
++        @description Ignore failed tests and put node back into a usable state.
++
++        @param (string) "comment" [required=false] Comment for the event log.
++
++        @success (http-status-code) "204" 204
--        :param comment: Optional comment for the event log.
--        :type comment: unicode
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
--        Returns 404 if the machine is not found.
--        Returns 403 if the user does not have permission to ignore tests for
--        the node.
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user is not authorized to override
++        tests.
          """
          comment = get_optional_param(request.POST, 'comment')
          node = self.model.objects.get_node_or_404(
@@ -875,13 +1008,20 @@ class PowerMixin:
      @operation(idempotent=False)
      def abort(self, request, system_id):
--        """Abort a node's current operation.
++        """@description-title Abort a node operation
++        @description Abort a node's current operation.
--        :param comment: Optional comment for the event log.
--        :type comment: unicode
++        @param (string) "comment" [required=false] Comment for the event log.
--        Returns 404 if the node could not be found.
--        Returns 403 if the user does not have permission to abort the
++        @success (http-status-code) "204" 204
++
++        @error (http-status-code) "404" 404
++        @error (content) "not-found" The requested node is not found.
++        @error-example "not-found"
++            Not Found
++
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user is not authorized to abort the
          current operation.
          """
          comment = get_optional_param(request.POST, 'comment')
@@ -898,15 +1038,26 @@ class PowersMixin:
      @admin_method
      @operation(idempotent=True)
      def power_parameters(self, request):
--        """Retrieve power parameters for multiple machines.
--
--        :param id: An optional list of system ids.  Only machines with
--            matching system ids will be returned.
--        :type id: iterable
--
--        :return: A dictionary of power parameters, keyed by machine system_id.
--
--        Raises 403 if the user is not an admin.
++        """@description-title Get power parameters
++        @description Get power parameters for multiple machines. To request
++        power parameters for a specific machine or more than one machine:
++        ``op=power_parameters&id=abc123&id=def456``.
++
++        @param (url-string) "id" [required=false] A system ID. To request more
++        than one machine, provide multiple ``id`` arguments in the request.
++        Only machines with matching system ids will be returned.
++        @param-example "id"
++            op=power_parameters&id=abc123&id=def456
++
++        @success (http-status-code) "200" 200
++        @success (json) "success_json" A JSON object containing a list of
++        power parameters with system_ids as keys.
++        @success-example "success_json" [exkey=get-power-params] placeholder
++        text
++
++        @error (http-status-code) "403" 403
++        @error (content) "no-perms" The user is not authorized to view the
++        power parameters.
          """
          match_ids = get_optional_list(request.GET, 'id')
 diff --git a/src/maasserver/api/tests/test_annotations.py b/src/maasserver/api/tests/test_annotations.py
 index e669171..896b4a0 100644
 --- a/src/maasserver/api/tests/test_annotations.py
 +++ b/src/maasserver/api/tests/test_annotations.py
@@ -66,7 +66,10 @@ class TestAPIAnnotations(APITestCase.ForUser):
      @success-example "success_name" success content
      @success (content) "success_with_exdb" success description
--    @success-example "success_with_exdb" [exkey=key1] ignored content
++    @success-example "success_with_exdb" [exkey=key1] placeholder text
++
++    @success (content) "success_inherit_node" success description
++    @success-example "success_inherit_node" [exkey=read-node] placeholder text
      @error (http-status-code) "error_name" error description
      @error-example "error_name" error content
@@ -606,3 +609,25 @@ class TestAPIAnnotations(APITestCase.ForUser):
          d = api_docstring_parser.get_dict()
          self.assert_has_api_warning(d)
++
++    def test_load_nodes_examples_by_default(self):
++        """Nodes examples should be loading by default.
++
++        Some API objects like machines and devices inherit operations from
++        nodes, so when we load the examples database, we always start with
++        nodes and add on object-specific examples.
++        """
++        ds = self.sample_api_annotated_docstring
++
++        api_docstring_parser = APIDocstringParser()
++        api_docstring_parser.parse(ds, uri=self.test_uri_plural)
++        d = api_docstring_parser.get_dict()
++
++        # index=2 contains the example with inherited examples from
++        # example/nodes.json
++        s = d['successes'][2]
++
++        # The presence of the 'resource-uri' string is a good indicator
++        # that the 'read-node' key has picked up the JSON object and
++        # converted it to a string for output in API docs.
++        self.assertTrue(s['example'].find("resource_uri") != -1)