Copie un modèle de langage de spécification des objets (TSL) d'un produit source vers un produit de destination.
Remarques sur l'utilisation
Si le produit de destination est publié, appelez l'opération CancelReleaseProduct pour annuler sa publication avant de copier un modèle TSL depuis le produit source vers ce produit de destination.
Les catégories du produit source et du produit de destination doivent être identiques. La catégorie du produit est indiquée par le paramètre CategoryKey. Appelez l'opération QueryProduct pour consulter le paramètre CategoryKey d'un produit.
Spécifiez la version du modèle TSL à copier à l'aide du paramètre SourceModelVersion dans la requête. À défaut, l'opération CopyThingModel échoue.
Limites de QPS
Vous pouvez appeler cette opération API jusqu'à cinq fois par seconde par compte.
Les utilisateurs Resource Access Management (RAM) d'un compte Alibaba Cloud partagent le quota de ce compte.
Débogage
OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.
Paramètres de requête
Paramètre | Type | Obligatoire | Exemple | Description |
Action | String | Oui | CopyThingModel | Opération à effectuer. Définissez la valeur sur CopyThingModel. |
SourceProductKey | String | Oui | a1BwAGV**** | ProductKey du produit source. Consultez le ProductKey sur la page Products de la console IoT Platform. Vous pouvez également obtenir le ProductKey en appelant l'opération QueryProductList. |
TargetProductKey | String | Oui | a1BwwG0**** | ProductKey du produit de destination. Consultez le ProductKey sur la page Products de la console IoT Platform. Vous pouvez également obtenir le ProductKey en appelant l'opération QueryProductList. |
IotInstanceId | String | Non | iot_instc_pu**_c-v64* | ID de l'instance. Consultez l'ID de l'instance sur l'onglet Overview de la console IoT Platform. Important
Pour plus d'informations sur les instances, consultez la rubrique Overview. |
ResourceGroupId | String | Non | 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 n'est pas valide. Ne spécifiez pas ce paramètre. |
SourceModelVersion | String | Non | V1.0.0 | Version du modèle TSL à copier. Appelez l'opération ListThingModelVersion pour afficher les versions du modèle TSL d'un produit. |
En plus des paramètres de requête spécifiques à l'opération mentionnés ci-dessus, spécifiez les paramètres de requête communs lors de l'appel à cette opération. Pour plus d'informations sur les paramètres de requête communs, consultez la rubrique Paramètres communs.
Paramètres de réponse
Paramètre | Type | Exemple | Description |
Code | String | iot.system.SystemException | Code d'erreur renvoyé en cas d'échec de la requête. Pour plus d'informations sur les codes d'erreur, consultez la rubrique Codes d'erreur. |
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 abouti. Valeurs possibles :
|
Exemples
Exemples de requêtes
https://iot.cn-shanghai.aliyuncs.com/?Action=CopyThingModel
&ProductKeySource=a1rYuVF****
&ProductKeyTarget=a1bPo9p****
&SourceModelVersion=v1.0.0
&<Common request parameters>Exemples de réponses réussies
Format XML
<CopyThingModelResponse>
<RequestId>9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E</RequestId>
<Success>true</Success>
</CopyThingModelResponse>Format JSON
{
"RequestId": "9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E",
"Success": true
}Codes d'erreur
Pour une liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.