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

DigitalTwinsClient.UpdateAsync 方法

定义

命名空间:

Microsoft.Azure.Devices

程序集:

Microsoft.Azure.Devices.dll

包:

Microsoft.Azure.Devices v2.0.0-preview002

汇报数字孪生体。

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.DigitalTwinUpdateResponse> UpdateAsync (string digitalTwinId, string jsonPatch, Microsoft.Azure.Devices.UpdateDigitalTwinOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member UpdateAsync : string * string * Microsoft.Azure.Devices.UpdateDigitalTwinOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DigitalTwinUpdateResponse>
override this.UpdateAsync : string * string * Microsoft.Azure.Devices.UpdateDigitalTwinOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DigitalTwinUpdateResponse>

Public Overridable Function UpdateAsync (digitalTwinId As String, jsonPatch As String, Optional requestOptions As UpdateDigitalTwinOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DigitalTwinUpdateResponse)

参数

digitalTwinId

String

数字孪生体的 ID。

jsonPatch

String

要对指定的数字孪生执行的 application/json-patch+json 操作。 可以使用 构造 JsonPatchDocument此修补程序。 有关更多详细信息，请参阅示例代码。

requestOptions

UpdateDigitalTwinOptions

此请求的可选设置。

cancellationToken

CancellationToken

cancellationToken。

返回

Task<DigitalTwinUpdateResponse>

数字孪生体的新 ETag 和数字孪生的 URI 位置。

例外

ArgumentNullException

当提供的 digitalTwinId 或 jsonPatch 为 null 时。

ArgumentException

当提供的 digitalTwinId 或 jsonPatch 为空或空格时。

IotHubServiceException

如果 IoT 中心使用不成功的状态代码响应请求，则引发。 例如，如果提供的请求受到限制， IotHubServiceException 则会引发 with ThrottlingException 。 有关可能的错误情况的完整列表，请参阅 IotHubServiceErrorCode。

HttpRequestException

如果 HTTP 请求因网络连接、DNS 故障或服务器证书验证等基础问题而失败。

OperationCanceledException

如果提供的 cancellationToken 已请求取消。

示例

string propertyName = “targetTemperature”;int propertyValue = 12;var propertyValues = new Dictionary<string， object> { { propertyName， propertyValue } }; var patchDocument = new JsonPatchDocument () ; patchDocument.AppendAdd (“/myComponentName”， propertyValues) ; string jsonPatch = patchDocument.ToString () ;DigitalTwinUpdateResponse updateResponse = await serviceClient.DigitalTwins.UpdateAsync (deviceId， jsonPatch) ;

注解

有关如何创建 json-patch 的详细信息，请参阅 https://docs.microsoft.com/azure/iot-pnp/howto-manage-digital-twin。