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

Cree etiquetas para un producto.

Notas de uso

En una sola llamada se pueden crear hasta 10 etiquetas para un producto.
Cada producto admite un máximo de 100 etiquetas.

Importante

Debe especificar las claves y los valores de las etiquetas; de lo contrario, la llamada finaliza con errores. Para consultar 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, le recomendamos llamar a esta operación desde OpenAPI Explorer, ya que genera dinámicamente el código de ejemplo correspondiente a distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateProductTags	Operación que desea ejecutar. Establezca el valor en CreateProductTags.
ProductKey	String	Sí	a1BwAGV****	El ProductKey del producto. Un ProductKey es un GUID que IoT Platform emite para cada producto. Para consultar la información de todos los productos de la cuenta actual, utilice la consola de IoT Platform o llame a la operación QueryProductList.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	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 finaliza con errores. 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.TagKey	String	No	room	Claves de las etiquetas del producto. Cada clave debe tener entre 1 y 30 caracteres, y puede contener letras, dígitos y puntos (.). Importante `abc` es una clave reservada por IoT Platform. No puede establecer una clave con el valor `abc`. Si establece un `key` en abc, dicho valor se filtra automáticamente al consultar las etiquetas.
ProductTag.N.TagValue	String	No	TagValue	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 (-).

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	Código de error devuelto cuando la llamada finaliza con errores. Para obtener más información, consulte Códigos de error.
ErrorMessage	String	A system exception occurred.	Mensaje de error devuelto cuando la solicitud falla.
InvalidProductTags	Array of ProductTag		Etiquetas de producto no válidas devueltas cuando la llamada finaliza con errores.
ProductTag
TagKey	String	room	Clave de la etiqueta.
TagValue	String	123$	Valor de la etiqueta.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la solicitud.
Success	Boolean	true	Indica si la llamada se ejecutó correctamente. true: la llamada se ejecutó correctamente y las etiquetas se asociaron al producto. false: la llamada finalizó con errores. Este valor indica que no se pudieron asociar las etiquetas al producto.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateProductTags
&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

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

Formato JSON

{
  "RequestId": "354A4F9B-6B01-4498-8084-867F59720BA5",
  "Success": true
}

Códigos de error

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