IoT Platform:Utiliser l'exemple de code OpenAPI

Consulter la documentation OpenAPI

Consultez la liste des API pour trouver l'opération Pub, qui permet de publier des messages sur un appareil via une rubrique personnalisée. Examinez sa documentation pour connaître les données requises et les autorisations nécessaires.

Créer un utilisateur RAM et lui accorder des autorisations

Identité

Vous pouvez appeler cette opération en utilisant un compte Alibaba Cloud, un utilisateur Resource Access Management (RAM) ou un rôle RAM. Pour plus d'informations sur les différences entre ces identités, consultez la section Identités, informations d'identification et autorisation. Cet exemple utilise un utilisateur RAM.

Connectez-vous à la console Resource Access Management (RAM), créez un utilisateur RAM destiné uniquement aux appels API et enregistrez la paire de clés AccessKey. Pour plus d'informations, consultez la section Créer un utilisateur RAM.

Autorisation

1. Accédez à la page Liste des utilisateurs RAM. Dans la colonne Actions de l'utilisateur RAM cible, cliquez sur Add Permissions.

2. Dans la section Select Policy, saisissez le mot-clé IoT dans la zone de recherche et sélectionnez la stratégie AliyunIOTFullAccess.

   Remarque

   • Les stratégies système pour IoT Platform sont les suivantes :

     • AliyunIOTFullAccess : accorde des autorisations de gestion complètes pour Internet of Things (IoT) Platform.

     • AliyunIOTReadOnlyAccess : accorde des autorisations d'accès en lecture seule pour Internet of Things (IoT) Platform.

   • Pour plus d'informations sur la création d'une stratégie personnalisée, consultez la section Stratégies personnalisées.

3. Cliquez sur OK pour finaliser l'autorisation.

Informations d'identification

Une paire de clés AccessKey est générée par défaut lors de la création d'un utilisateur RAM.

Vous pouvez également accéder à la page de détails de l'utilisateur RAM. Sous l'onglet Authentication Management, cliquez sur Create AccessKey. Pour plus d'informations, consultez la section Créer une clé AccessKey.

Appeler l'OpenAPI

L'exemple suivant utilise Python pour appeler l'opération Pub.

Préparer l'environnement Python

1. Vérifiez si Python 3 est installé sur votre système.

   Systèmes Linux et macOS

   Ouvrez le terminal et exécutez la commande python3 --version.

   Si le système renvoie le numéro de version de Python, cela signifie que Python 3 est installé. Sinon, passez à l'étape suivante pour installer Python 3.

   Système Windows

   Dans le chemin d'installation de Python, double-cliquez sur python.exe pour ouvrir une fenêtre command prompt. Vous pouvez également utiliser le raccourci clavier Win+R pour ouvrir la boîte de dialogue Run, saisir python, puis cliquer sur OK.

   Si le système renvoie une réponse similaire à celle ci-dessous et accède à l'environnement interactif Python, cela signifie que Python est installé.

   Python 3.9.6 (tags/v3.9.6:db3ff76, Jun 28 2021, 15:26:21) [MSC v.1929 64 bit (AMD64)] on win32
   Type "help", "copyright", "credits" or "license" for more information.
   >>>  

2. Téléchargez et installez Python.

   Pour télécharger Python 3, consultez la page Python 3.

   Linux

   1. Téléchargez le package Python.

      wget https://www.python.org/ftp/python/3.9.6/Python-3.9.6.tgz

   2. Décompressez le package Python.

      tar -zxvf Python-3.9.6.tgz

   3. Accédez au dossier décompressé et spécifiez le chemin d'installation.

      cd Python-3.9.6
      sudo ./configure --prefix=/usr/bin/python3

   4. Compilez et installez Python.

      make
      make install

   5. Configurez la variable d'environnement pour Python 3.

      Par exemple, sur un système Ubuntu Linux, vous pouvez exécuter les commandes suivantes.

      1. Ouvrez le fichier .bashrc et ajoutez le contenu suivant à la fin du fichier.

         nano ~/.bashrc

      2. Ajoutez le contenu suivant à la fin du fichier, puis enregistrez et fermez le fichier.

         export PATH=$PATH:/usr/bin/python3

      3. Exécutez la commande suivante pour mettre à jour la variable d'environnement.

         source ~/.bashrc

      4. Exécutez la commande suivante pour afficher la variable d'environnement et confirmer qu'elle inclut le chemin d'installation de Python 3.

         echo $PATH

   macOS

   Ce système est livré avec Python 2.7. Téléchargez et installez la dernière version de Python 3.x.

   1. Après avoir téléchargé le package d'installation, double-cliquez dessus pour ouvrir l'assistant d'installation de Python.

   2. Cliquez sur Continue, puis suivez les instructions pour configurer et installer.

   3. Configurez la variable d'environnement en fonction du chemin d'installation de Python 3.

   Windows

   1. Une fois le téléchargement terminé, double-cliquez sur le package pour ouvrir l'assistant d'installation de Python. Conservez les paramètres par défaut et sélectionnez l'option Add Python 3.9 to PATH.

   2. Cliquez sur Install Now pour démarrer l'installation.

   3. Une fois l'installation terminée, cliquez sur Close pour fermer la fenêtre d'installation.

3. Répétez l'étape 1 pour vérifier la version de Python 3. Si le numéro de version correct s'affiche, l'installation a réussi.

Configurer les variables d'environnement

Pour éviter d'encoder en dur une paire de clés AccessKey dans votre code, stockez les informations d'identification dans des variables d'environnement.

• Systèmes Linux et macOS

  Remplacez <access_key_id> et <access_key_secret> dans les commandes suivantes par votre ID de clé AccessKey et votre secret de clé AccessKey. Ensuite, exécutez les commandes dans le terminal.

  export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
  export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>

• Système Windows

  Créez les variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET et définissez leurs valeurs sur votre ID de clé AccessKey et votre secret de clé AccessKey. Ensuite, redémarrez votre système Windows.

Installer les dépendances

pip3 install alibabacloud_tea_openapi
pip3 install alibabacloud_iot20180120
pip3 install alibabacloud-tea-console

Télécharger l'exemple de code

1. Dans le portail OpenAPI, accédez à la page de débogage de l'API Pub.

2. Saisissez les valeurs des paramètres de requête IotInstanceId, ProductKey, TopicFullName et MessageContent. Vous pouvez laisser les autres paramètres vides.

3. Cliquez sur Submit Request.

4. Sous l'onglet Call Result, une fois le message Call Succeeded affiché, cliquez sur l'onglet SDK Sample, puis sur l'onglet Python.

5. Cliquez sur Download Complete Project pour télécharger le package de l'exemple de code.

6. Décompressez le package de l'exemple de code sur votre machine locale et accédez au dossier alibabacloud_sample.

Exécuter le code

Exécutez la commande suivante :

python sample.py

Le résultat est le suivant :

{
    "headers": {
        "date": "Thu, 10 Aug 2023 09:26:52 GMT",
        "content-type": "application/json;charset=utf-8",
        "content-length": "99",
        "connection": "keep-alive",
        "keep-alive": "timeout=25",
        "access-control-allow-origin": "*",
        "access-control-expose-headers": "*",
        "x-acs-request-id": "1296FD43-4BD3-5F80-AB2C-1ADF99B02253",
        "x-acs-trace-id": "aee72e4c5e***************77fc9d",
        "etag": "9umD************cjYJ8og9"
	},
    "statusCode": 200,
    "body": {
        "MessageId": 1689000000000004736,
        "RequestId": "1296FD43-4BD3-5F80-AB2C-1ADF99B02253",
        "Success": true
    }
}