你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
IotHubDescriptionCollection.CreateOrUpdate 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建或更新 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 中心的名称。
IoT 中心元数据和安全元数据。
- ifMatch
- String
IoT 中心的 ETag。 不要指定 用于创建全新的IoT 中心。 更新现有IoT 中心所必需的。
- cancellationToken
- CancellationToken
要使用的取消标记。
返回
例外
resourceName
是一个空字符串,预期为非空。
resourceName
或 data
为 null。