IotHubDescriptionCollection.CreateOrUpdateAsync 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.
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.
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:
Azure SDK for .NET