次の方法で共有


IotHubDescriptionCollection.CreateOrUpdateAsync メソッド

定義

IoT ハブのメタデータを作成または更新します。 プロパティを変更する通常のパターンは、IoT ハブのメタデータとセキュリティ メタデータを取得し、それらを新しい本文で変更された値と組み合わせて IoT ハブを更新することです。 JSON に特定のプロパティがない場合、IoT Hubを更新すると、これらの値が既定にフォールバックし、予期しない動作が発生する可能性があります。

  • 要求パス/サブスクリプション/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}
  • 操作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))

パラメーター

waitUntil
WaitUntil

Completed メソッドがサービスで実行時間の長い操作が完了するまで戻るのを待機する必要がある場合。 Started 操作を開始した後に が返される場合は 。 実行時間の長い操作の詳細については、「 Azure.Core Long-Running 操作のサンプル」を参照してください。

resourceName
String

IoT ハブの名前。

data
IotHubDescriptionData

IoT ハブのメタデータとセキュリティ メタデータ。

ifMatch
String

IoT Hubの ETag。 まったく新しいIoT Hubを作成するには、 を指定しないでください。 既存のIoT Hubを更新するために必要です。

cancellationToken
CancellationToken

使用する取り消しトークン。

戻り値

例外

resourceName は空の文字列であり、空でないと想定されていました。

resourceName または data が null です。

適用対象