DevicesClient.CreateAsync Methode
Definition
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.
Überlädt
| CreateAsync(Device, CancellationToken) |
Erstellen Sie eine Geräteidentität in der Registrierung Ihres IoT Hubs. |
| CreateAsync(IEnumerable<Device>, CancellationToken) |
Erstellen Sie in einem Massenvorgang bis zu 100 neue Geräteidentitäten in der Registrierung Ihres IoT Hubs. |
CreateAsync(Device, CancellationToken)
Erstellen Sie eine Geräteidentität in der Registrierung Ihres IoT Hubs.
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)Parameter
- device
- Device
Die zu registrierende Geräteidentität.
- cancellationToken
- CancellationToken
Das Token, mit dem der Vorgang abgebrochen werden kann.
Gibt zurück
Das registrierte Gerät mit den generierten Schlüsseln und ETags.
Ausnahmen
Wenn das bereitgestellte Gerät NULL ist.
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.
Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems fehlschlägt, z. B. Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung.
Wenn das bereitgestellte Abbruchtoken den Abbruch angefordert hat.
Gilt für:
CreateAsync(IEnumerable<Device>, CancellationToken)
Erstellen Sie in einem Massenvorgang bis zu 100 neue Geräteidentitäten in der Registrierung Ihres IoT Hubs.
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)Parameter
- devices
- IEnumerable<Device>
Die Geräteidentitäten, die in der Registrierung Ihres IoT Hubs erstellt werden sollen. Darf 100 Geräte nicht überschreiten.
- cancellationToken
- CancellationToken
Das Token, mit dem der Vorgang abgebrochen werden kann.
Gibt zurück
Das Ergebnis des Massenvorgangs.
Ausnahmen
Wenn die bereitgestellte Gerätesammlung NULL ist.
Wenn die bereitgestellte Gerätesammlung leer ist.
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.
Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems fehlschlägt, z. B. Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung.
Wenn das bereitgestellte Abbruchtoken den Abbruch angefordert hat.
Hinweise
Für vorgänge mit größerer Skalierung sollten Sie die Verwendung von ImportAsync(ImportJobProperties, CancellationToken) verwenden, mit der Sie Geräte aus einem Azure Storage-Container importieren können.
Gilt für:
Azure SDK for .NET