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

Elimina una o más funciones del Thing Specification Language (TSL) de un producto. Las funciones pueden ser propiedades, servicios o eventos.

Notas de uso

Si el producto ya está publicado, debe llamar a la operación CancelReleaseProduct para cancelar la publicación antes de invocar la operación DeleteThingModel.
Si una función nueva o un módulo TSL personalizado del producto no se ha publicado, puede llamar a la operación DeleteThingModel para eliminar dicha función o módulo TSL personalizado.
Al llamar a la operación DeleteThingModel, especifique el parámetro ProductKey y como mínimo uno de los siguientes parámetros: FunctionBlockId, PropertyIdentifier.N, ServiceIdentifier.N y EventIdentifier.N. A continuación se describe el funcionamiento de la operación DeleteThingModel:
- Si solo especifica los parámetros ProductKey y FunctionBlockId, la operación elimina el módulo TSL personalizado indicado del producto especificado.
- Si especifica el parámetro ProductKey junto con el parámetro PropertyIdentifier.N, ServiceIdentifier.N o EventIdentifier.N, la operación elimina una o más funciones indicadas del módulo TSL predeterminado del producto especificado. La eliminación solo se realiza si las funciones existen. Si los identificadores de función que especifique en los parámetros PropertyIdentifier.N, ServiceIdentifier.N y EventIdentifier.N no existen en el módulo TSL predeterminado, la operación devuelve un mensaje de error que indica que las funciones especificadas no existen.
- Si especifica los parámetros ProductKey y FunctionBlockId junto con el parámetro PropertyIdentifier.N, ServiceIdentifier.N o EventIdentifier.N, la operación elimina una o más funciones indicadas del módulo TSL personalizado especificado dentro del producto indicado. La eliminación solo se realiza si las funciones existen. Si los identificadores de función que especifique en los parámetros PropertyIdentifier.N, ServiceIdentifier.N y EventIdentifier.N no existen en el módulo TSL personalizado, la operación devuelve un mensaje de error que indica que las funciones especificadas no existen.
  
  Nota
  Especifique hasta 10 identificadores de función en el parámetro PropertyIdentifier.N, ServiceIdentifier.N o EventIdentifier.N.
Después de llamar a la operación DeleteThingModel para eliminar una o más funciones de un producto, invoque la operación PublishThingModel para volver a publicar el modelo TSL del producto. De este modo, los cambios surten efecto.

Límites de QPS

Esta operación de API admite hasta cinco llamadas por segundo por cuenta.

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

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DeleteThingModel	La operación que desea realizar. Establezca el valor en DeleteThingModel.
IotInstanceId	String	No	iot-cn-0pp1n8t****	El ID de la instancia. Consulte el ID de la instancia en la pestaña Overview de la consola de IoT Platform. Importante Si la instancia tiene un ID, especifique este parámetro. De lo contrario, la solicitud falla. Si la pestaña Overview o el ID de la instancia no se muestran en la consola de IoT Platform, omita este parámetro. Para obtener más información sobre las instancias, consulte Descripción general.
FunctionBlockId	String	No	BatteryModule	El ID del módulo TSL personalizado. Cada ID es único dentro de un producto. Si especifica el parámetro FunctionBlockId junto con el parámetro PropertyIdentifier.N, ServiceIdentifier.N o EventIdentifier.N, la operación elimina una o más funciones especificadas del módulo TSL personalizado indicado. Si omite el parámetro FunctionBlockId, la operación elimina una o más funciones especificadas del módulo TSL predeterminado. Si especifica el parámetro FunctionBlockId sin especificar los parámetros PropertyIdentifier.N, ServiceIdentifier.N y EventIdentifier.N, la operación elimina el módulo TSL personalizado especificado y todas las funciones contenidas en dicho módulo.
ProductKey	String	No	a1BwAGV****	La clave ProductKey del producto.
PropertyIdentifier.N	RepeatList	No	Temperature	Los ID de las propiedades que desea eliminar. Especifique hasta 10 ID de propiedades.
ServiceIdentifier.N	RepeatList	No	Set	Los ID de los servicios que desea eliminar. Especifique hasta 10 ID de servicios.
EventIdentifier.N	RepeatList	No	OfflineAlert	Los ID de los eventos que desea eliminar. Especifique hasta 10 ID de eventos.
ResourceGroupId	String	No	rg-acfm4l5tcwd****	El ID del resource group. Importante IoT Platform admite la gestión de resource groups únicamente por instancia. El parámetro ResourceGroupId no es válido. Omita este parámetro.

Además de los parámetros de solicitud específicos de la operación mencionados anteriormente, especifique los parámetros de solicitud comunes al llamar a esta operación. 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 devuelto si la solicitud falla. Para obtener más información sobre los códigos de error, consulte Códigos de error.
ErrorMessage	String	A system exception occurred.	El mensaje de error devuelto si la solicitud falla.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud se realizó correctamente. Valores válidos: true false

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=DeleteThingModel
&ProductKeySource=a1rYuVF****
&PropertyIdentifier.1=speed
&ServiceIdentifier.1=SetSpeed
&EventIdentifier.1=SpeedAlarm
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<DeleteThingModelResponse>
  <RequestId>9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E</RequestId>
  <Success>true</Success>
</DeleteThingModelResponse>

Formato JSON

{
  "RequestId": "9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E",
  "Success": true
}

Códigos de error

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.