DevicesClient.CreateWithTwinAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Devices

Assembly:: Microsoft.Azure.Devices.dll

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellen Sie eine Geräteidentität in der Registrierung Ihres IoT Hubs mit einem anfänglichen Zwillingsstatus.

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)

Parameter

device: Device

Die zu registrierende Geräteidentität.

twin: ClientTwin

Der anfängliche Zwillingszustand für das Gerät.

cancellationToken: CancellationToken

Das Token, mit dem der Vorgang abgebrochen werden kann.

Gibt zurück

Task<BulkRegistryOperationResult>

Das Ergebnis des Massenvorgangs.

Ausnahmen

ArgumentNullException

Wenn das bereitgestellte Gerät oder der angegebene Zwilling NULL ist.

IotHubServiceException

Wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status Code reagiert hat. Wenn beispielsweise die bereitgestellte Anforderung gedrosselt wurde, IotHubServiceException wird mit ThrottlingException ausgelöst. Eine vollständige Liste möglicher Fehlerfälle finden Sie unter IotHubServiceErrorCode.

HttpRequestException

Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung fehlschlägt.

OperationCanceledException

Wenn das bereitgestellte Abbruchtoken den Abbruch angefordert hat.

Hinweise

Diese API verwendet die gleiche zugrunde liegende Dienst-API wie die in diesem Client definierten Massenerstellungs-/Set/Delete-APIs, z. B CreateAsync(IEnumerable<Device>, CancellationToken). .

Gilt für:

Freigeben über