Todos los productos
Search
Centro de documentos

IoT Platform:ListProductTags

Última actualización: Sep 08, 2026

Consulta todas las etiquetas de un producto.

Límites

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

Nota

Los usuarios de 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. Esta herramienta genera de forma dinámica el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíListProductTags

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

ProductKeyStringSía1BwAGV****

El ProductKey del producto. Un ProductKey es un GUID que IoT Platform emite para un producto. Use la consola de IoT Platform o llame a la operación QueryProductList para consultar la información de todos los productos de la cuenta actual.

IotInstanceIdStringNoiot_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, configure este parámetro. De lo contrario, la llamada falla.
  • Si su instancia no tiene la página Overview ni un ID, no necesita establecer este parámetro.

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

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ámetroTipoEjemploDescripción
CodeStringiot.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.

DataArray of ProductTag

Las etiquetas del producto que se devuelven si la llamada es exitosa. Para obtener más información, consulte los parámetros incluidos en el parámetro ProductTag.

ProductTag
TagKeyStringroom

La clave de cada etiqueta.

TagValueString102

El valor de la etiqueta.

ErrorMessageStringA system exception occurred.

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

RequestIdStringE55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

El ID de la solicitud.

SuccessBooleantrue

Indica si la llamada fue exitosa.

  • true: la llamada fue exitosa.
  • false: la llamada finalizó con errores.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=ListProductTags
&ProductKey=a1h7knJ****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<ListProductTagsResponse>
      <Data>
            <ProductTag>
                  <TagValue>alterTable</TagValue>
                  <TagKey>binary</TagKey>
            </ProductTag>
            <ProductTag>
                  <TagValue>json2</TagValue>
                  <TagKey>extt</TagKey>
            </ProductTag>
            <ProductTag>
                  <TagValue>1234</TagValue>
                  <TagKey>Lock</TagKey>
            </ProductTag>
            <ProductTag>
                  <TagValue>support</TagValue>
                  <TagKey>Lockk</TagKey>
            </ProductTag>
            <ProductTag>
                  <TagValue>reen</TagValue>
                  <TagKey>Reen</TagKey>
            </ProductTag>
            <ProductTag>
                  <TagValue>try</TagValue>
                  <TagKey>Reenn</TagKey>
            </ProductTag>
            <ProductTag>
                  <TagValue>DropTable</TagValue>
                  <TagKey>roc</TagKey>
            </ProductTag>
      </Data>
      <RequestId>7FBE60F8-4AB5-4A8C-AFCB-F4F38851F01F</RequestId>
      <Success>true</Success>
</ListProductTagsResponse>

Formato JSON

{
  "Data": {
    "ProductTag": [
      {
        "TagValue": "alterTable",
        "TagKey": "binary"
      },
      {
        "TagValue": "json2",
        "TagKey": "extt"
      },
      {
        "TagValue": "1234",
        "TagKey": "Lock"
      },
      {
        "TagValue": "support",
        "TagKey": "Lockk"
      },
      {
        "TagValue": "reen",
        "TagKey": "Reen"
      },
      {
        "TagValue": "try",
        "TagKey": "Reenn"
      },
      {
        "TagValue": "DropTable",
        "TagKey": "roc"
      }
    ]
  },
  "RequestId": "7FBE60F8-4AB5-4A8C-AFCB-F4F38851F01F",
  "Success": true
}

Códigos de error

Para consultar la lista de códigos de error, visite el centro de errores de API.