Todos los productos
Search
Centro de documentos

IoT Platform:UpdateProduct

Última actualización: Sep 08, 2026

Modifica la información de un producto.

Límites de QPS

Puede invocar esta API hasta 10 veces por segundo por cuenta.

Nota

Los usuarios RAM de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda invocar esta operación en OpenAPI Explorer. OpenAPI Explorer genera de forma dinámica el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
Action String Sí UpdateProduct

La operación que desea ejecutar. Establezca el valor en UpdateProduct.

ProductKey String Sí a1BwAGV****

El ProductKey del producto. Un ProductKey es un GUID que IoT Platform emite para el producto.

Para consultar la información de todos los productos de la cuenta actual de Alibaba Cloud, utilice la consola de IoT Platform o invoque la operación QueryProductList.

ProductName String Sí Street light

El nuevo nombre que desea asignar al producto.

El nombre debe tener entre 4 y 30 caracteres. Puede contener letras, dígitos y guiones bajos (_).

Importante Cada nombre de producto debe ser único dentro de la cuenta actual de Alibaba Cloud.
IotInstanceId String No iot_instc_pu****_c*-v64********

El ID de la instancia. Consulte el ID de la instancia en la página Descripción general de la consola de IoT Platform.

Importante
  • Si su instancia tiene un ID, especifique dicho ID en este parámetro. De lo contrario, la llamada fallará con errores.
  • Si no se generó ninguna página Descripción general ni ningún ID para su instancia, no es necesario configurar este parámetro.

Para obtener más información, consulte Descripción general.

Description String No The 2nd generation street light.

La descripción del producto. La descripción debe tener entre 1 y 100 caracteres.

Además de los parámetros de solicitud específicos de esta operación, configure los parámetros de solicitud comunes cuando ejecute esta llamada. Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
Code String iot.system.SystemException

El código de error que se devuelve si la llamada falla con errores. Para obtener más información, consulte Códigos de error.

ErrorMessage String A system exception occurred.

El mensaje de error que se devuelve si la llamada falla con errores.

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

El ID de la solicitud.

Success Boolean true

Indica si la llamada se completó correctamente. Valores válidos:

  • true: la llamada se completó correctamente.
  • false: la llamada falló con errores.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateProduct
&ProductKey=a1BwAGV****
&ProductName=TestProductNew
&Description=new features v2
&<Common request parameters>

Respuestas de ejemplo exitosas

Formato XML

<UpdateProductResponse>
  <RequestId>C4FDA54C-4201-487F-92E9-022F42387458</RequestId>
  <Success>true</Success>
</UpdateProductResponse>

Formato JSON

{
      "RequestId":"C4FDA54C-4201-487F-92E9-022F42387458",
      "Success":true
  }

Códigos de error

Para consultar la lista de códigos de error, consulte Códigos de error del servicio.