IoT Platform ofrece un SDK en la nube para Python. En este tema se describe cómo instalar, configurar y utilizar el SDK de Python para invocar las API en la nube.
Instalación del SDK
-
Instale Python.
Descargue Python desde official Python website. El SDK es compatible con Python 2.7.x y 3.x.
-
Instale pip. Omita este paso si ya tiene pip instalado.
Descargue pip desde official pip website.
-
Instale el SDK de IoT para Python con permisos de administrador.
Para consultar las instrucciones de uso del SDK, visite aliyun-python-sdk-iot.
sudo pip install aliyun-python-sdk-core sudo pip install aliyun-python-sdk-iot -
Importe los módulos del SDK de IoT para Python.
from aliyunsdkcore import client from aliyunsdkiot.request.v20180120 import RegisterDeviceRequest from aliyunsdkiot.request.v20180120 import PubRequest ...
Inicialización del SDK
A continuación se muestra un ejemplo de código para inicializar el SDK y llamar a una API en la región China (Shanghai).
Inicialice el cliente del SDK con client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai'):
import os
accessKeyId = os.getenv('ACCESS_KEY_ID')
accessKeySecret = os.getenv('ACCESS_KEY_SECRET')
clt = client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai')|
Parámetro |
Descripción |
|
clt |
Inicializa el cliente del SDK. Verifique la región de su servicio en la esquina superior izquierda de IoT Platform console. Códigos de región: Supported regions. |
Llamada a una API
El SDK encapsula cada solicitud de API como una clase ${API name}Request. Establezca los parámetros de la solicitud con set_${request parameter name} y luego invoque do_action_with_exception(request) en el cliente del SDK clt para obtener la respuesta.
Para consultar la lista de API en la nube de IoT Platform, consulte API list. Para ver las descripciones de los parámetros de solicitud en request y los parámetros de respuesta en response, consulte la referencia de la API correspondiente.
En este tema se utiliza la operación Pub como ejemplo para mostrar cómo publicar un mensaje en un tema. Para obtener información sobre los parámetros de la solicitud, consulte Pub.
request = PubRequest.PubRequest()
request.set_accept_format('json') # Set the data format of the response. The default format is XML. This example sets the format to JSON.
request.set_IotInstanceId('iotInstanceId')
request.set_ProductKey('productKey')
request.set_TopicFullName('/productKey/deviceName/user/get') # The full name of the topic to which the message is sent.
request.set_MessageContent('aGVsbG8gd29ybGQ=') # hello world Base64 string
request.set_Qos(0)
result = clt.do_action_with_exception(request)
print('result : ' + result)Apéndice: Código de ejemplo
Puede acceder al Centro de ejemplos del SDK en la nube de IoT Platform para consultar o descargar código de ejemplo para llamadas a la API. El código de ejemplo incluye muestras para los SDK de Java, Python, PHP, .NET y Go.
El Portal para desarrolladores de OpenAPI de Alibaba Cloud proporciona online API debugging tool. En la página API debugging, puede buscar y probar llamadas a la API. El portal genera automáticamente código de ejemplo del SDK en diferentes lenguajes según los parámetros que introduzca. Consulte el código generado en la pestaña SDK Example y la respuesta en la pestaña Call Result.