drop! Add endpoint to return a 503 response

Author: dsotirho-ucsc

lambdas/service/app.py

@@ -45,6 +45,9 @@
 from azul.auth import (
     OAuth2,
 )
+from azul.chalice import (
+    ServiceUnavailableError,
+)
 from azul.collections import (
     OrderedSet,
 )
@@ -591,6 +594,14 @@ def __call__(self, param):
 }
 
 
+@app.route(
+    '/error-503',
+    spec={'summary': 'test endpoint for a 503 status response'}
+)
+def error_503():
+    raise ServiceUnavailableError()
+
+
 @app.route(
     '/index/catalogs',
     methods=['GET'],

lambdas/service/openapi.json

@@ -900,6 +900,31 @@
                 ]
             }
         },
+        "/error-503": {
+            "get": {
+                "responses": {
+                    "400": {
+                        "description": "Bad request. The request was rejected due to malformed parameters."
+                    },
+                    "429": {
+                        "description": "Too many requests. \nWhen handling this response, clients should wait the number of seconds\nspecified in the `Retry-After` header and then retry the request.\n"
+                    },
+                    "500": {
+                        "description": "Internal server error. An internal server error occurred."
+                    },
+                    "502": {
+                        "description": "Bad gateway. The server received an invalid response from the upstream server."
+                    },
+                    "503": {
+                        "description": "Service unavailable. \nWhen handling this response, clients should wait the number of seconds\nspecified in the `Retry-After` header and then retry the request.\n"
+                    },
+                    "504": {
+                        "description": "Gateway timeout. The server did not respond in time. Please try again later."
+                    }
+                },
+                "summary": "test endpoint for a 503 status response"
+            }
+        },
         "/index/catalogs": {
             "get": {
                 "responses": {