Freigeben über


IotHubDescriptionCollection.CreateOrUpdateAsync Methode

Definition

Erstellen oder aktualisieren Sie die Metadaten eines Iot Hubs. Das übliche Muster zum Ändern einer Eigenschaft besteht darin, die IoT Hub-Metadaten und Sicherheitsmetadaten abzurufen und sie dann mit den geänderten Werten in einem neuen Textkörper zu kombinieren, um den IoT Hub zu aktualisieren. Wenn bestimmte Eigenschaften im JSON-Code fehlen, kann das Aktualisieren IoT Hub dazu führen, dass diese Werte auf den Standardwert zurückgesetzt werden, was zu unerwartetem Verhalten führen kann.

  • Anforderungspfad/abonnements/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}
  • Vorgangs-IdIotHubResource_CreateOrUpdate
public virtual System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubDescriptionResource>> CreateOrUpdateAsync (Azure.WaitUntil waitUntil, string resourceName, Azure.ResourceManager.IotHub.IotHubDescriptionData data, string ifMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.IotHub.IotHubDescriptionData * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubDescriptionResource>>
override this.CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.IotHub.IotHubDescriptionData * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubDescriptionResource>>
Public Overridable Function CreateOrUpdateAsync (waitUntil As WaitUntil, resourceName As String, data As IotHubDescriptionData, Optional ifMatch As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ArmOperation(Of IotHubDescriptionResource))

Parameter

waitUntil
WaitUntil

Completed , wenn die Methode auf die Rückgabe warten soll, bis der zeitintensive Vorgang für den Dienst abgeschlossen ist; Started , wenn sie nach dem Starten des Vorgangs zurückgegeben werden soll. Weitere Informationen zu Vorgängen mit langer Ausführungszeit finden Sie unter Beispiele für Azure.Core-Long-Running-Vorgänge.

resourceName
String

Der Name des IoT-Hubs.

data
IotHubDescriptionData

Die IoT Hub-Metadaten und Sicherheitsmetadaten.

ifMatch
String

ETag des IoT Hub. Geben Sie zum Erstellen eines brandneuen IoT Hub nicht an. Erforderlich, um eine vorhandene IoT Hub zu aktualisieren.

cancellationToken
CancellationToken

Das zu verwendende Abbruchtoken.

Gibt zurück

Ausnahmen

resourceName ist eine leere Zeichenfolge und wurde erwartet, dass sie nicht leer ist.

resourceName oder data ist NULL.

Gilt für: