你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Devices - Invoke Method

服务:

IoT Hub

API 版本:

2021-04-12

在设备上调用直接方法。 有关详细信息，请参阅https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-direct-methods。

POST https://fully-qualified-iothubname.azure-devices.net/twins/{deviceId}/methods?api-version=2021-04-12

URI 参数

名称	在	必需	类型	说明
deviceId	path	True	string	设备的唯一标识符。
api-version	query	True	string	Api 的版本。

请求正文

名称	类型	说明
connectTimeoutInSeconds	integer
methodName	string	要执行的方法的名称。
payload	object	JSON 格式的直接方法有效负载，最大大小为 128kb。
responseTimeoutInSeconds	integer

响应

名称	类型	说明
200 OK	CloudToDeviceMethodResult	没问题。

定义

名称	说明
CloudToDeviceMethod	在设备上执行直接方法的参数。
CloudToDeviceMethodResult	表示设备方法调用结果。

CloudToDeviceMethod

在设备上执行直接方法的参数。

名称	类型	说明
connectTimeoutInSeconds	integer
methodName	string	要执行的方法的名称。
payload	object	JSON 格式的直接方法有效负载，最大大小为 128kb。
responseTimeoutInSeconds	integer

CloudToDeviceMethodResult

表示设备方法调用结果。

名称	类型	说明
payload	object	方法调用结果有效负载。
status	integer	方法调用结果状态。