你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
DevicesClient.CreateWithTwinAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在 IoT 中心的注册表中创建具有初始孪生状态的设备标识。
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult> CreateWithTwinAsync (Microsoft.Azure.Devices.Device device, Microsoft.Azure.Devices.ClientTwin twin, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateWithTwinAsync : Microsoft.Azure.Devices.Device * Microsoft.Azure.Devices.ClientTwin * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
override this.CreateWithTwinAsync : Microsoft.Azure.Devices.Device * Microsoft.Azure.Devices.ClientTwin * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
Public Overridable Function CreateWithTwinAsync (device As Device, twin As ClientTwin, Optional cancellationToken As CancellationToken = Nothing) As Task(Of BulkRegistryOperationResult)
参数
- device
- Device
要注册的设备标识。
- twin
- ClientTwin
设备的初始孪生状态。
- cancellationToken
- CancellationToken
允许取消操作的令牌。
返回
批量操作的结果。
例外
当提供的设备或孪生体为 null 时。
如果 IoT 中心使用不成功的状态代码响应了请求。 例如,如果提供的请求受到限制, IotHubServiceException 则会引发 with ThrottlingException 。 有关可能的错误情况的完整列表,请参阅 IotHubServiceErrorCode。
如果 HTTP 请求因网络连接、DNS 故障或服务器证书验证等基础问题而失败。
如果提供的取消令牌已请求取消。
注解
此 API 使用与此客户端中定义的批量创建/设置/删除 API 相同的基础服务 API,例如 CreateAsync(IEnumerable<Device>, CancellationToken)。