docs(validation): Refactoring validate example

Author: leandrodamascena

docs/utilities/validation.md

@@ -65,7 +65,7 @@ You can also gracefully handle schema validation errors by catching `SchemaValid
 
 === "getting_started_validator_standalone_function.py"
 
-	```python hl_lines="3 10 16 18"
+	```python hl_lines="5 16 17 26"
     --8<-- "examples/validation/src/getting_started_validator_standalone_function.py"
 	```
 

examples/validation/src/getting_started_validator_standalone_function.py

@@ -1,8 +1,13 @@
 import getting_started_validator_standalone_schema as schemas
 
+from aws_lambda_powertools.utilities import parameters
 from aws_lambda_powertools.utilities.typing import LambdaContext
 from aws_lambda_powertools.utilities.validation import SchemaValidationError, validate
 
+# we can get list of allowed IPs from AWS Parameter Store using Parameters Utility
+# See: https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/parameters/
+ALLOWED_IPS = parameters.get_parameter("/lambda-powertools/allowed_ips")
+
 
 def lambda_handler(event, context: LambdaContext) -> dict:
     try:
@@ -11,10 +16,14 @@ def lambda_handler(event, context: LambdaContext) -> dict:
         # using standalone function to validate input data only
         validate(event=event, schema=schemas.INPUT)
 
-        if event.get("username") == "lambda" and event.get("password") == "powertools":
-            user_authenticated = "Authenticated"
+        if (
+            event.get("user_id") == "0d44b083-8206-4a3a-aa95-5d392a99be4a"
+            and event.get("project") == "powertools"
+            and event.get("ip") in ALLOWED_IPS
+        ):
+            user_authenticated = "Allowed"
 
-        # in this example the body can be a string because we are not validating the OUTPUT
+        # in this example the body can be of any type because we are not validating the OUTPUT
         return {"body": user_authenticated, "statusCode": 200 if user_authenticated else 204}
     except SchemaValidationError as exception:
         # SchemaValidationError indicates where a data mismatch is

examples/validation/src/getting_started_validator_standalone_payload.json

@@ -1,6 +1,6 @@
 
 {
-    "username": "lambda",
-    "password": "powertools",
+    "user_id": "0d44b083-8206-4a3a-aa95-5d392a99be4a",
+    "project": "powertools",
     "ip": "192.168.0.1"
 }

examples/validation/src/getting_started_validator_standalone_schema.py

@@ -4,20 +4,20 @@
     "type": "object",
     "title": "Sample schema",
     "description": "The root schema comprises the entire JSON document.",
-    "examples": [{"username": "hello world", "password": "lessa", "ip": "192.168.0.1"}],
-    "required": ["username", "password", "ip"],
+    "examples": [{"user_id": "0d44b083-8206-4a3a-aa95-5d392a99be4a", "powertools": "lessa", "ip": "192.168.0.1"}],
+    "required": ["user_id", "project", "ip"],
     "properties": {
-        "username": {
-            "$id": "#/properties/username",
+        "user_id": {
+            "$id": "#/properties/user_id",
             "type": "string",
-            "title": "The username",
-            "examples": ["lambda"],
-            "maxLength": 30,
+            "title": "The user_id",
+            "examples": ["0d44b083-8206-4a3a-aa95-5d392a99be4a"],
+            "maxLength": 50,
         },
-        "password": {
-            "$id": "#/properties/password",
+        "project": {
+            "$id": "#/properties/project",
             "type": "string",
-            "title": "The password",
+            "title": "The project",
             "examples": ["powertools"],
             "maxLength": 30,
         },