Todos los productos
Search
Centro de documentos

IoT Platform:TransformClientId

Última actualización: Sep 03, 2026

Especifica un ClientID válido para un dispositivo que contiene varios ClientIDs y así evitar inicios de sesión no autorizados. Esta operación se aplica a la autenticación de certificado único por producto sin prerregistro.

Notas de uso

Llame a la operación QueryClientIds para consultar los ClientIDs de un dispositivo.

Límites

Cada cuenta de Alibaba Cloud admite un máximo de 10 consultas por segundo (QPS).

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 su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

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

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

ClientId String Sí 9rSz********UNMWj33f000112

El ClientID del dispositivo.

IotId String Sí BXPV9Ks3bxwM9fD****0000101

El ID del dispositivo.

IotInstanceId String No iot-02****43

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 configurar este parámetro. De lo contrario, la llamada fallará.
  • Si su instancia no tiene página Overview o ID, no es necesario establecer este parámetro.

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

Además de los parámetros específicos de la operación, debe especificar los parámetros de solicitud comunes al llamar a esta operación. Para obtener más información, consulte Parámetros de solicitud comunes.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
Code String Success

El código de respuesta. El valor Success indica que la llamada se realizó correctamente. Otros valores indican errores. Para obtener más información, consulte Códigos de error.

ErrorMessage String request parameter error

El mensaje de error devuelto si la llamada falla.

RequestId String 89F22330-BAEE-****-****-41BA46D6E267

El ID de la solicitud.

Success Boolean true

Indica si la llamada se realizó correctamente.

  • true: La llamada se realizó correctamente.
  • false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=TransformClientId
&ClientId=9rSz********UNMWj33f000112
&IotId=BXPV9Ks3bxwM9fD****0000101
&<Common request parameters>

Respuestas correctas de ejemplo

Formato XML

<TransformClientIdResponse>
  <RequestId>89F22330-BAEE-****-****-41BA46D6E267</RequestId>
  <Code>Success</Code>
  <Success>true</Success>
</TransformClientIdResponse>

Formato JSON

{
    "RequestId": "89F22330-BAEE-****-****-41BA46D6E267",
    "Code": "Success",
    "Success": true
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.