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

DevicesClient.CreateAsync 方法

参考

定义

命名空间:: Microsoft.Azure.Devices

程序集:: Microsoft.Azure.Devices.dll

包:: Microsoft.Azure.Devices v2.0.0-preview002

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

CreateAsync(Device, CancellationToken)	在 IoT 中心的注册表中创建设备标识。
CreateAsync(IEnumerable<Device>, CancellationToken)	在 IoT 中心的注册表中批量创建最多 100 个新设备标识。

CreateAsync(Device, CancellationToken)

在 IoT 中心的注册表中创建设备标识。

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device> CreateAsync(Microsoft.Azure.Devices.Device device, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateAsync : Microsoft.Azure.Devices.Device * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>
override this.CreateAsync : Microsoft.Azure.Devices.Device * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>

Public Overridable Function CreateAsync (device As Device, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Device)

参数

device: Device

要注册的设备标识。

cancellationToken: CancellationToken

允许取消操作的令牌。

Task<Device>

使用生成的密钥和 ETag 注册的设备。

例外

ArgumentNullException

当提供的设备为 null 时。

IotHubServiceException

如果 IoT 中心使用不成功的状态代码响应了请求。例如，如果提供的请求受到限制， IotHubServiceException 则会引发 with ThrottlingException 。有关可能的错误情况的完整列表，请参阅 IotHubServiceErrorCode。

HttpRequestException

如果 HTTP 请求因网络连接、DNS 故障或服务器证书验证等基础问题而失败。

OperationCanceledException

如果提供的取消令牌已请求取消。

适用于

CreateAsync(IEnumerable<Device>, CancellationToken)

在 IoT 中心的注册表中批量创建最多 100 个新设备标识。

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult> CreateAsync(System.Collections.Generic.IEnumerable<Microsoft.Azure.Devices.Device> devices, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateAsync : seq<Microsoft.Azure.Devices.Device> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
override this.CreateAsync : seq<Microsoft.Azure.Devices.Device> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>

Public Overridable Function CreateAsync (devices As IEnumerable(Of Device), Optional cancellationToken As CancellationToken = Nothing) As Task(Of BulkRegistryOperationResult)