SDK do IoT Platform para Python - instalar, configurar e chamar APIs da cloud - IoT Platform: Central de Documentação do Alibaba Cloud

O IoT Platform oferece um SDK de cloud para Python. Saiba como instalar, configurar e usar o SDK em Python para chamar APIs da cloud.

Instale o SDK

Instale o Python.

Baixe o Python no official Python website. O SDK é compatível com as versões 2.7.x e 3.x do Python.
Instale o pip. Ignore esta etapa se o pip já estiver instalado.

Baixe o pip no official pip website.
Instale o SDK de IoT para Python com permissões de administrador.

Para obter instruções de uso do SDK, acesse aliyun-python-sdk-iot.
```
sudo pip install aliyun-python-sdk-core
sudo pip install aliyun-python-sdk-iot
```

Importe os módulos do SDK de IoT para Python.

from aliyunsdkcore import client
from aliyunsdkiot.request.v20180120 import RegisterDeviceRequest
from aliyunsdkiot.request.v20180120 import PubRequest
...

Inicialize o SDK

O código a seguir mostra um exemplo de inicialização do SDK para chamar uma API na região China (Shanghai).

Inicialize o cliente do SDK com 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

Descrição

clt

Inicializa o cliente do SDK. cn-shanghai é o código da região do seu service IoT Platform.

Verifique a região do seu service no canto superior esquerdo do IoT Platform console.

Códigos de região: Supported regions.

Chame uma API

O SDK encapsula cada requisição de API como uma classe ${API name}Request. Defina os parâmetros da requisição com set_${request parameter name} e chame do_action_with_exception(request) no cliente do SDK clt para obter a resposta.

Para consultar a lista de APIs de cloud do IoT Platform, visualize API list. Para obter descrições dos parâmetros de requisição em request e dos parâmetros de resposta em response, consulte a referência da API correspondente.

Este tópico usa a operação Pub como exemplo para demonstrar a publicação de uma mensagem em um tópico. Para mais informações sobre os parâmetros da requisição, 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 exemplo

Acesse o IoT Platform Cloud SDK Example Center para visualizar ou baixar códigos de exemplo de chamadas de API. Os exemplos abrangem os SDKs para Java, Python, PHP, .NET e Go.

O Portal do Desenvolvedor OpenAPI da Alibaba Cloud disponibiliza um online API debugging tool. Na página API debugging, pesquise e teste chamadas de API. O portal gera automaticamente códigos de exemplo do SDK em diferentes linguagens com base nos parâmetros inseridos. Visualize o código gerado na aba SDK Example e a resposta na aba Call Result.