UpdateProductTags - IoT Platform - Centro de documentación de Alibaba Cloud

Actualice las etiquetas de un producto.

Notas de uso

Puede actualizar un máximo de 10 etiquetas en una sola llamada.

Importante

Debe especificar las claves y los valores de las etiquetas. De lo contrario, la llamada falla. Para conocer la descripción de los valores de las etiquetas, consulte la sección "

Parámetros de solicitud

" de este tema.

Límites de QPS

Cada cuenta de Alibaba Cloud puede ejecutar un máximo de 500 consultas por segundo (QPS).

Nota

Los usuarios de Resource Access Management (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 llamar a esta operación desde OpenAPI Explorer, ya que genera dinámicamente el código de ejemplo para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	UpdateProductTags	La operación que desea ejecutar. Establezca el valor en UpdateProductTags.
ProductKey	String	Sí	a1BwAGV****	El ProductKey del producto. Un ProductKey es un GUID que IoT Platform emite para cada producto. Puede usar la consola de IoT Platform o llamar a la operación QueryProductList para consultar la información de todos los productos de la cuenta actual.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	El ID de la instancia. Consulte el ID de la instancia en la página Overview de la consola de IoT Platform. Importante Si su instancia tiene un ID, debe especificarlo en este parámetro. De lo contrario, la llamada falla. Si no se generó ninguna página Overview ni ningún ID para su instancia, no es necesario configurar este parámetro. Para obtener más información, consulte Descripción general.
ProductTag.N.TagValue	String	No	202	Los nuevos valores de las etiquetas del producto. Cada valor debe tener entre 1 y 128 caracteres, y puede contener letras, dígitos, guiones bajos (_) y guiones (-).
ProductTag.N.TagKey	String	No	room	Las claves de las etiquetas del producto. Cada clave debe tener entre 1 y 30 caracteres, y puede contener letras, dígitos y puntos (.). Nota Cada clave de etiqueta que especifique ya debe existir. Cada valor de etiqueta que especifique debe ser único.

Además de los parámetros de solicitud específicos de esta operación, debe especificar los parámetros de solicitud comunes al llamarla. Para obtener más información, consulte Parámetros de solicitud 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. 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 solicitud falla.
InvalidProductTags	Array of ProductTag		Las etiquetas de producto no válidas que se devuelven si la llamada falla. Los detalles se incluyen en el parámetro ProductTag.
ProductTag
TagKey	String	room	La clave de la etiqueta.
TagValue	String	123	El valor de la etiqueta.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	El ID de la solicitud.
Success	Boolean	true	Indica si la llamada fue exitosa. true false

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateProductTags
&ProductKey=a1h7knJ****
&ProductTag.1.TagKey=first
&ProductTag.1.TagValue=value1
&ProductTag.2.TagKey=second
&ProductTag.2.TagValue=value2
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<UpdateProductTagsResponse>
      <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
      <Success>true</Success>
</UpdateProductTagsResponse>

Formato JSON

{
  "RequestId": "92586B4B-FF78-494A-A22C-368E4293FBB7",
  "Success": true
}

Códigos de error

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