你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
TwinsClient.GetAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
GetAsync(String, CancellationToken) |
从 IoT 中心获取设备的孪生体。 |
GetAsync(String, String, CancellationToken) |
从 IoT 中心获取模块的孪生体。 |
GetAsync(String, CancellationToken)
从 IoT 中心获取设备的孪生体。
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin> GetAsync(string deviceId, System.Threading.CancellationToken cancellationToken = default);
abstract member GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
override this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
Public Overridable Function GetAsync (deviceId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ClientTwin)
参数
- deviceId
- String
设备 ID。
- cancellationToken
- CancellationToken
任务取消标记。
返回
设备孪生。
例外
当提供的 deviceId
为 null 时。
如果 为 deviceId
空或空格。
如果 IoT 中心使用未成功状态代码响应请求。 例如,如果提供的请求受到限制, IotHubServiceException 则会引发 和 ThrottlingException 。 有关可能的错误情况的完整列表,请参阅 IotHubServiceErrorCode。
如果 HTTP 请求因网络连接、DNS 故障或服务器证书验证等根本问题而失败。
如果提供的 cancellationToken
已请求取消。
适用于
GetAsync(String, String, CancellationToken)
从 IoT 中心获取模块的孪生体。
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin> GetAsync(string deviceId, string moduleId, System.Threading.CancellationToken cancellationToken = default);
abstract member GetAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
override this.GetAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
Public Overridable Function GetAsync (deviceId As String, moduleId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ClientTwin)
参数
- deviceId
- String
设备 ID。
- moduleId
- String
模块 ID。
- cancellationToken
- CancellationToken
任务取消标记。
返回
模块孪生。
例外
当提供的 deviceId
或 moduleId
为 null 时。
deviceId
如果 或 moduleId
为空或空白。
如果 IoT 中心使用未成功状态代码响应请求。 例如,如果提供的请求受到限制, IotHubServiceException 则会引发 和 ThrottlingException 。 有关可能的错误情况的完整列表,请参阅 IotHubServiceErrorCode。
如果 HTTP 请求因网络连接、DNS 故障或服务器证书验证等根本问题而失败。
如果提供的 cancellationToken
已请求取消。