Merge ~lloydwaltersj/maas:fix-url-string-parameters into maas:master

[Jack Lloyd-Walters]

fix incorrect url-string parameter in methods

OAS3 requires these be defined as true

[Alexsander de Souza (alexsander-souza)]

+1

review: Approve

[MAAS Lander (maas-lander)]

UNIT TESTS
-b fix-url-string-parameters lp:~lloydwaltersj/maas/+git/maas into -b master lp:~maas-committers/maas

STATUS: SUCCESS
COMMIT: 72558a5be68e1f500719c1c661b1621177a57e20

review: Approve

diff --git a/src/maasserver/api/nodes.py b/src/maasserver/api/nodes.py
index 6896e07..f7152c0 100644
--- a/src/maasserver/api/nodes.py
+++ b/src/maasserver/api/nodes.py
@@ -1197,7 +1197,7 @@ class PowersMixin:
         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
+        @param (url-string) "id" [required=true] 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"
diff --git a/src/maasserver/api/tests/test_annotations.py b/src/maasserver/api/tests/test_annotations.py
index 5f0e27d..19f40d4 100644
--- a/src/maasserver/api/tests/test_annotations.py
+++ b/src/maasserver/api/tests/test_annotations.py
@@ -50,7 +50,7 @@ class TestAPIAnnotations(APITestCase.ForUser):
     @param (int) "param_name2" [required=false] param2 description
     @param-example "param_name2" param2-ex
 
-    @param (url-string) "param_name3" [required=false] param3 description
+    @param (url-string) "param_name3" [required=true] param3 description
     @param-example "param_name3" param3-ex
 
     @param (json) "param_name4" [required=false] param4 description