More documentation and validation for job relaunching/template launching

awx/api/templates/api/job_relaunch.md

@@ -0,0 +1,3 @@
+Relaunch a job:
+
+Make a POST request to this resource to launch a job. If any passwords or variables are required then they should be passed in via POST data.   In order to determine what values are required in order to launch a job based on this job template you may make a GET request to this endpoint.

awx/api/templates/api/job_template_launch.md

@@ -0,0 +1,3 @@
+Launch a Job Template:
+
+Make a POST request to this resource to launch a job. If any passwords or variables are required then they should be passed in via POST data.   In order to determine what values are required in order to launch a job based on this job template you may make a GET request to this endpoint.

awx/api/views.py

@@ -1468,6 +1468,8 @@ class JobTemplateSurveySpec(GenericAPIView):
                 return Response(dict(error="'question_description' missing from survey element %s" % str(idx)), status=status.HTTP_400_BAD_REQUEST)
             if "variable" not in survey_item:
                 return Response(dict(error="'variable' missing from survey element %s" % str(idx)), status=status.HTTP_400_BAD_REQUEST)
+            if "required" not in survey_item:
+                return Response(dict(error="'required' missing from survey element %s" % str(idx)), status=status.HTTP_400_BAD_REQUEST)
             idx += 1
         obj.save()
         return Response()