IotHubDescriptionCollection.CreateOrUpdate Methode

Definition

Namespace:

Azure.ResourceManager.IotHub

Assembly:

Azure.ResourceManager.IotHub.dll

Paket:

Azure.ResourceManager.IotHub v1.1.1

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 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.

• Request Path/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}
• Vorgang IdIotHubResource_CreateOrUpdate

public virtual Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubDescriptionResource> CreateOrUpdate (Azure.WaitUntil waitUntil, string resourceName, Azure.ResourceManager.IotHub.IotHubDescriptionData data, string ifMatch = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdate : Azure.WaitUntil * string * Azure.ResourceManager.IotHub.IotHubDescriptionData * string * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubDescriptionResource>
override this.CreateOrUpdate : Azure.WaitUntil * string * Azure.ResourceManager.IotHub.IotHubDescriptionData * string * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubDescriptionResource>

Public Overridable Function CreateOrUpdate (waitUntil As WaitUntil, resourceName As String, data As IotHubDescriptionData, Optional ifMatch As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ArmOperation(Of IotHubDescriptionResource)

Parameter

waitUntil

WaitUntil

Completed , wenn die Methode auf die Rückgabe warten soll, bis der lange ausgeführte Vorgang für den Dienst abgeschlossen ist; Started , wenn es nach dem Starten des Vorgangs zurückgegeben werden soll. Weitere Informationen zu Vorgängen mit langer Ausführung 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 nicht an, um eine brandneue IoT Hub zu erstellen. Erforderlich, um eine vorhandene IoT Hub zu aktualisieren.

cancellationToken

CancellationToken

Das zu verwendende Abbruchtoken.

Gibt zurück

ArmOperation<IotHubDescriptionResource>

Ausnahmen

ArgumentException

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

ArgumentNullException

resourceName oder data ist NULL.