DigitalTwinsClient.UpdateAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Devices

Ensamblado:

Microsoft.Azure.Devices.dll

Paquete:

Microsoft.Azure.Devices v2.0.0-preview002

Novedades un gemelo digital.

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)

Parámetros

digitalTwinId

String

Identificador del gemelo digital.

jsonPatch

String

Las operaciones application/json-patch+json que se realizarán en el gemelo digital especificado. Esta revisión se puede construir mediante JsonPatchDocument. Consulte el código de ejemplo para obtener más detalles.

requestOptions

UpdateDigitalTwinOptions

La configuración opcional de esta solicitud.

cancellationToken

CancellationToken

CancellationToken.

Devoluciones

Task<DigitalTwinUpdateResponse>

La nueva ETag para el gemelo digital y la ubicación del URI del gemelo digital.

Excepciones

ArgumentNullException

Cuando el valor proporcionado digitalTwinId o jsonPatch es null.

ArgumentException

Cuando el elemento proporcionado digitalTwinId o está vacío o jsonPatch espacio en blanco.

IotHubServiceException

Se produce si IoT Hub respondió a la solicitud con un código de estado no correcto. Por ejemplo, si se ha limitado la solicitud proporcionada, IotHubServiceException se produce con ThrottlingException . Para obtener una lista completa de posibles casos de error, vea IotHubServiceErrorCode.

HttpRequestException

Si se produce un error en la solicitud HTTP debido a un problema subyacente, como la conectividad de red, el error dns o la validación del certificado de servidor.

OperationCanceledException

Si el proporcionado cancellationToken ha solicitado la cancelación.

Ejemplos

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);

Comentarios

Para obtener más información sobre cómo crear json-patch, consulte https://docs.microsoft.com/azure/iot-pnp/howto-manage-digital-twin.