DevicesClient.CreateWithTwinAsync メソッド

定義

名前空間:

Microsoft.Azure.Devices

アセンブリ:

Microsoft.Azure.Devices.dll

パッケージ:

Microsoft.Azure.Devices v2.0.0-preview002

初期ツイン状態の IoT ハブのレジストリにデバイス ID を作成します。

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

登録するデバイス ID。

twin

ClientTwin

デバイスの初期ツイン状態。

cancellationToken

CancellationToken

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

戻り値

Task<BulkRegistryOperationResult>

一括操作の結果。

例外

ArgumentNullException

指定されたデバイスまたはツインが null の場合。

IotHubServiceException

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

HttpRequestException

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

OperationCanceledException

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

注釈

この API は、このクライアントで定義されている一括作成/設定/削除 API と同じ基になるサービス API を使用します (例: CreateAsync(IEnumerable<Device>, CancellationToken))。