你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

IotHubDescriptionCollection.CreateOrUpdate 方法

定义

创建或更新 IoT 中心的元数据。 修改属性的常用模式是检索 IoT 中心元数据和安全元数据,然后将它们与新正文中修改的值合并,以更新 IoT 中心。 如果 JSON 中缺少某些属性,更新IoT 中心可能会导致这些值回退为默认值,这可能会导致意外行为。

  • 请求路径/订阅/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}
  • 操作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)

参数

waitUntil
WaitUntil

Completed 如果方法应在服务上完成长时间运行的操作之前等待返回,则为 ; Started 如果它在启动操作后应返回,则为 。 有关长时间运行的操作的详细信息,请参阅 Azure.Core Long-Running 操作示例

resourceName
String

IoT 中心的名称。

data
IotHubDescriptionData

IoT 中心元数据和安全元数据。

ifMatch
String

IoT 中心的 ETag。 不要指定 用于创建全新的IoT 中心。 更新现有IoT 中心所必需的。

cancellationToken
CancellationToken

要使用的取消标记。

返回

例外

resourceName 是一个空字符串,预期为非空。

resourceNamedata 为 null。

适用于