The AWS IoT Greengrass SDK for Python
Project description
Greengrass SDK
=====================
The AWS IoT Greengrass Core SDK is meant to be used by AWS Lambda functions running on an AWS IoT Greengrass Core. It will enable Lambda functions to invoke other Lambda functions deployed to the Greengrass Core, publish messages to the Greengrass Core and work with the local Shadow service.
You can find the latest, most up to date, documentation at our `doc site <http://aws-greengrass-core-sdk-python-docs.s3-website-us-east-1.amazonaws.com/v1.4.0/index.html>`_.
===============================
Using AWS IoT Greengrass Core SDK
===============================
To use the AWS IoT Greengrass Core SDK, you must first import the AWS IoT Greengrass Core SDK in your Lambda function as you would with any other external libraries. You then need to create a client for 'iot-data' or 'lambda'. Use 'iot-data' if you wish to publish messages to the local Greengrass Core and interact with the local Shadow service. Use 'lambda' if you wish to invoke other Lambda functions deployed to the same Greengrass Core.
Here is an example for using the 'iot-data' client
.. code-block:: python
import greengrasssdk
# Let's instantiate the iot-data client
client = greengrasssdk.client('iot-data')
Now that you have an ``iot-data`` client, you can publish requests.
.. code-block:: python
response = client.publish(
topic='someTopic',
payload='some data'.encode()
)
Here is an example for using the 'lambda' client.
.. code-block:: python
import greengrasssdk
client = greengrasssdk.client('lambda')
Now that you have a lambda client, you can publish requests.
.. code-block:: python
# Define the payload to pass to the invoked lambda function
msg = json.dumps({
'message':"hello"
})
# Invoke the lambda function
response = client.invoke(
FunctionName='arn:<partition>:lambda:<region>:<account id>:function:<function name>',
InvocationType='RequestResponse',
Payload=payload,
Qualifier='2'
)
==============
Compatibility
==============
As new features are added to AWS IoT Greengrass, previous versions of the AWS IoT Greengrass SDK will be incompatible with newer versions of the AWS IoT Greengrass core. The following table lists the compatible SDKs for all GGC releases.
+-------------+------------------------+
| GGC Version | Compatible SDK Versions|
+=============+========================+
| 1.0.x-1.6.x | 1.0.x-1.2.x |
+-------------+------------------------+
| 1.7.x-1.8.x | 1.0.x-1.3.x |
+-------------+------------------------+
| 1.9.x | 1.0.x-1.4.x |
+-------------+------------------------+
=====================
The AWS IoT Greengrass Core SDK is meant to be used by AWS Lambda functions running on an AWS IoT Greengrass Core. It will enable Lambda functions to invoke other Lambda functions deployed to the Greengrass Core, publish messages to the Greengrass Core and work with the local Shadow service.
You can find the latest, most up to date, documentation at our `doc site <http://aws-greengrass-core-sdk-python-docs.s3-website-us-east-1.amazonaws.com/v1.4.0/index.html>`_.
===============================
Using AWS IoT Greengrass Core SDK
===============================
To use the AWS IoT Greengrass Core SDK, you must first import the AWS IoT Greengrass Core SDK in your Lambda function as you would with any other external libraries. You then need to create a client for 'iot-data' or 'lambda'. Use 'iot-data' if you wish to publish messages to the local Greengrass Core and interact with the local Shadow service. Use 'lambda' if you wish to invoke other Lambda functions deployed to the same Greengrass Core.
Here is an example for using the 'iot-data' client
.. code-block:: python
import greengrasssdk
# Let's instantiate the iot-data client
client = greengrasssdk.client('iot-data')
Now that you have an ``iot-data`` client, you can publish requests.
.. code-block:: python
response = client.publish(
topic='someTopic',
payload='some data'.encode()
)
Here is an example for using the 'lambda' client.
.. code-block:: python
import greengrasssdk
client = greengrasssdk.client('lambda')
Now that you have a lambda client, you can publish requests.
.. code-block:: python
# Define the payload to pass to the invoked lambda function
msg = json.dumps({
'message':"hello"
})
# Invoke the lambda function
response = client.invoke(
FunctionName='arn:<partition>:lambda:<region>:<account id>:function:<function name>',
InvocationType='RequestResponse',
Payload=payload,
Qualifier='2'
)
==============
Compatibility
==============
As new features are added to AWS IoT Greengrass, previous versions of the AWS IoT Greengrass SDK will be incompatible with newer versions of the AWS IoT Greengrass core. The following table lists the compatible SDKs for all GGC releases.
+-------------+------------------------+
| GGC Version | Compatible SDK Versions|
+=============+========================+
| 1.0.x-1.6.x | 1.0.x-1.2.x |
+-------------+------------------------+
| 1.7.x-1.8.x | 1.0.x-1.3.x |
+-------------+------------------------+
| 1.9.x | 1.0.x-1.4.x |
+-------------+------------------------+
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
greengrasssdk-1.4.0.tar.gz
(7.7 kB
view hashes)
Built Distribution
Close
Hashes for greengrasssdk-1.4.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f37eb09dad09d0d0fe3b354aa29fc12226c139ff421dd34f525d6b80df89aae5 |
|
MD5 | a75c8f51ebd44f6e5a8f33f3444fd0f0 |
|
BLAKE2b-256 | 587f7c48616e8632bc5d44b58d04087ee85bad4ee8db3a2d2cca5ef26434b5e4 |