DevicesClient.CreateAsync メソッド

リファレンス

定義

名前空間:: Microsoft.Azure.Devices

アセンブリ:: Microsoft.Azure.Devices.dll

パッケージ:: Microsoft.Azure.Devices v2.0.0-preview002

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

CreateAsync(Device, CancellationToken)	IoT ハブのレジストリにデバイス ID を作成します。
CreateAsync(IEnumerable<Device>, CancellationToken)	IoT ハブのレジストリに最大 100 個の新しいデバイス ID を一括で作成します。

CreateAsync(Device, CancellationToken)

IoT ハブのレジストリにデバイス ID を作成します。

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

登録するデバイス ID。

cancellationToken: CancellationToken

操作を取り消すトークン。

戻り値

Task<Device>

生成されたキーと ETag を持つ登録済みデバイス。

例外

ArgumentNullException

指定されたデバイスが null の場合。

IotHubServiceException

IoT ハブが失敗した状態コードで要求に応答した場合。たとえば、指定された要求が調整された場合、 IotHubServiceException が ThrottlingException スローされます。考えられるエラーケースの完全な一覧については、「」を参照してください IotHubServiceErrorCode。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証などの根本的な問題が原因で HTTP 要求が失敗した場合。

OperationCanceledException

指定されたキャンセルトークンが取り消しを要求した場合。

適用対象

CreateAsync(IEnumerable<Device>, CancellationToken)

IoT ハブのレジストリに最大 100 個の新しいデバイス ID を一括で作成します。

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)