Crée une tâche pour distribuer un produit vers une instance spécifiée.
Notes d'utilisation
Cette opération ne peut être appelée qu'en utilisant l'endpoint suivant :
iot.cn-shanghai.aliyuncs.com.Vous ne pouvez pas utiliser cette opération pour distribuer un produit entre différents comptes.
Une tâche de distribution de produit ne distribue pas les appareils associés à ce produit.
Une fois le produit distribué, vous ne pouvez plus modifier son modèle TSL ni ses scripts.
Chaque compte Alibaba Cloud peut créer au maximum 10 tâches de distribution de produits ou d'appareils. Pour plus d'informations sur la création d'une tâche de distribution d'appareil, consultez CreateDeviceDistributeJob.
-
Chaque compte Alibaba Cloud peut exécuter un maximum de 2 requêtes par seconde (QPS).
RemarqueLes utilisateurs RAM d'un compte Alibaba Cloud partagent le quota du compte.
Débogage
Paramètres de requête
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | CreateProductDistributeJob | L'opération que vous souhaitez effectuer. Définissez la valeur sur CreateProductDistributeJob. |
| ProductKey | String | Yes | a1BwAGV**** | La ProductKey du produit à publier. |
| SourceInstanceId | String | Yes | iot-cn-st2*** | L'ID de l'instance source à laquelle appartient le produit.
|
| TargetInstanceId | String | Yes | iot-cn-6ja*** | L'ID de l'instance de destination vers laquelle le produit est distribué. Pour plus d'informations sur les ID d'instance, consultez la description du paramètre SourceInstanceId. |
| TargetUid | String | No | 198*** | L'ID du compte Alibaba Cloud auquel appartient le produit. Vous pouvez vous connecter à la console IoT Platform, cliquer sur l'image de profil, puis afficher Account ID sur la page Security Settings. Les paramètres TargetUid et TargetAliyunId ne peuvent pas être laissés vides simultanément. |
| TargetAliyunId | String | No | io****@example.com | Le compte Alibaba Cloud auquel appartient le produit. Vous pouvez vous connecter à la console IoT Platform, cliquer sur l'image de profil, puis afficher Logon Account sur la page Security Settings. Les paramètres TargetUid et TargetAliyunId ne peuvent pas être laissés vides simultanément. |
En plus des paramètres de requête spécifiques à l'opération mentionnés ci-dessus, vous devez spécifier les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez Common request parameters.
Paramètres de réponse
| Parameter | Type | Example | Description |
| Code | String | iot.system.SystemException | Le code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez Codes d'erreur. |
| ErrorMessage | String | A system exception occurred. | Le message d'erreur renvoyé en cas d'échec de l'appel. |
| JobId | String | UbmsMHmkqv0PiAG****010001 | L'ID de la tâche renvoyé en cas de succès de l'appel. Cet ID identifie la tâche de manière globale. |
| RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | L'ID de la requête. |
| Success | Boolean | true | Indique si l'appel a réussi.
|
Exemples
Exemples de requêtes
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=CreateProductDistributeJob
&ProductKey=a1BwAGV****
&SourceInstanceId=iot-cn-st2***
&TargetInstanceId=iot-cn-6ja***
&TargetAliyunId=io****@example.com
&<Common request parameters>Exemples de réponses réussies
Format XML
<CreateProductDistributeJobResponse>
<RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
<JobId>UbmsMHmkqv0PiAG****010001</JobId>
<Success>true</Success>
</CreateProductDistributeJobResponse>Format JSON
{
"RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
"JobId": "UbmsMHmkqv0PiAG****010001",
"Success": true
}Codes d'erreur
Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.