Tous les produits
Search

Ce produit

    IoT Platform:PublishThingModel

    Centre de documentation

    IoT Platform:PublishThingModel

    Dernière mise à jour :Aug 09, 2026

    Publie le modèle TSL (Thing Specification Language) d'un produit.

    Notes d'utilisation

    Si un produit est déjà publié, appelez l'opération CancelReleaseProduct pour annuler sa publication avant d'appeler cette opération.

    Limites QPS

    Vous pouvez appeler cette opération API jusqu'à cinq fois par seconde par compte.

    Remarque

    Les utilisateurs RAM (Resource Access Management) d'un compte Alibaba Cloud partagent le quota du compte.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

    Paramètres de requête

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    PublishThingModel

    Opération à effectuer. Définissez la valeur sur PublishThingModel.

    ProductKey

    String

    Yes

    a1BwAGV****

    Clé ProductKey du produit.

    Vous pouvez afficher la clé ProductKey sur la page Products de la console IoT Platform. Vous pouvez également l'obtenir en appelant l'opération QueryProductList.

    IotInstanceId

    String

    No

    iot_instc_pu**_c-v64*

    ID de l'instance. Vous pouvez afficher l'ID de l'instance dans l'onglet Overview de la console IoT Platform.

    Important

    • Si l'instance possède un ID, spécifiez ce paramètre. À défaut, la requête échoue.

    • Si la page Overview ou l'ID de l'instance n'est pas affiché dans la console IoT Platform, ne spécifiez pas ce paramètre.

    Pour plus d'informations sur les instances, consultez la rubrique Overview.

    ResourceGroupId

    String

    No

    rg-acfm4l5tcwd****

    ID du groupe de ressources.

    Important

    IoT Platform prend en charge la gestion des groupes de ressources uniquement par instance. Le paramètre ResourceGroupId est invalide. Ne spécifiez pas ce paramètre.

    ModelVersion

    String

    No

    v1.0.0

    Numéro de version du modèle TSL.

    Le numéro de version doit comporter entre 1 et 16 caractères et peut contenir des lettres, des chiffres et des points (.).

    Description

    String

    No

    Second version

    Description de la version du modèle TSL.

    Outre les paramètres de requête spécifiques à l'opération ci-dessus, spécifiez les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez la rubrique Common parameters.

    Paramètres de réponse

    Parameter

    Type

    Example

    Description

    Code

    String

    iot.system.SystemException

    Code d'erreur renvoyé en cas d'échec de la requête. Pour plus d'informations, consultez la rubrique Error codes.

    ErrorMessage

    String

    A system exception occurred.

    Message d'erreur renvoyé en cas d'échec de la requête.

    RequestId

    String

    E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

    ID de la requête.

    Success

    Boolean

    true

    Indique si la requête a réussi. Valeurs possibles :

    • true

    • false

    Exemples

    Exemple de requête

    https://iot.cn-shanghai.aliyuncs.com/?Action=PublishThingModel
&ProductKeySource=a1rYuVF****
&ModelVersion=V1.0.0
&<Common request parameters>

    Exemple de réponse réussie

    Format XML

    <PublishThingModelResponse>
  <RequestId>5252CC6E-9E4B-4DB1-B1D8-7EEA190A5B3E</RequestId>
  <Success>true</Success>
</PublishThingModelResponse>

    Format JSON

    {
  "RequestId": "5252CC6E-9E4B-4DB1-B1D8-7EEA190A5B3E",
  "Success": true
}

    Codes d'erreur

    Pour une liste des codes d'erreur, consultez la rubrique Service error codes.