HTTPPython

HTTP Python

What is this function?

This function makes HTTP requests from the Greengrass Core. This can be used to access HTTP resources on the Greengrass Core's local network by any client that has access to publish to the ${AWS_IOT_THING_NAME}/http_python/request topic.

This can also be used by other functions that need to do simple HTTP requests but don't want to include or maintain HTTP related code.

What does the output look like?

${AWS_IOT_THING_NAME} is the name of the thing associated with your Core.

When the function receives a message on the ${AWS_IOT_THING_NAME}/http_python/request topic that looks like this:

{
  "id": "1",
  "action": "get",
  "url": "https://www.amazon.com"
}

It will initiate a GET request to https://www.amazon.com. It will then respond with the content retrieved from that URL, wrapped in a JSON message, on the topic ${AWS_IOT_THING_NAME}/http_python/response/ID where ID is the id value included in the request.

The id, action, and url fields are required. If a required field is missing the request is ignored and no errors are reported.

action can only be get or post.

The requests are performed by Requests. This library was chosen because it is "the only Non-GMO HTTP library for Python, safe for human consumption".

params is an optional parameter. It must be a dictionary. The values in the dictionary will be included in the request as URL parameters.

data is an optional parameter. It must be a dictionary. The values in the dictionary will be included in the body of POST requests.