你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
ConfigurationsClient.SetAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
替换配置注册的可变字段。
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration> SetAsync(Microsoft.Azure.Devices.Configuration configuration, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);
abstract member SetAsync : Microsoft.Azure.Devices.Configuration * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration>
override this.SetAsync : Microsoft.Azure.Devices.Configuration * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration>
Public Overridable Function SetAsync (configuration As Configuration, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Configuration)
参数
- configuration
- Configuration
包含替换字段的配置对象。
- onlyIfUnchanged
- Boolean
如果为 false,则即使所提供的设备标识的 ETag 已过期,也会执行此操作。 如果为 true,则如果提供的配置具有过期的 ETag,则操作将引发 IotHubServiceException 。PreconditionFailed 可以使用 检索 GetAsync(String, CancellationToken)最新的 ETag。
- cancellationToken
- CancellationToken
允许取消操作的令牌。
返回
已替换 ETag 的配置对象。
例外
当提供的 configuration
为 null 时引发。
如果 IoT 中心使用不成功的状态代码响应请求,则引发。 例如,如果提供的请求受到限制, IotHubServiceException 则会引发 with ThrottlingException 。 有关可能的错误情况的完整列表,请参阅 IotHubServiceErrorCode。
如果 HTTP 请求因网络连接、DNS 故障或服务器证书验证等基础问题而失败。
如果提供的取消令牌已请求取消。