ScheduledJobsClient.ScheduleTwinUpdateAsync Método

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.Devices

Ensamblado:: Microsoft.Azure.Devices.dll

Paquete:: Microsoft.Azure.Devices v2.0.0-preview002

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea un nuevo trabajo para actualizar las etiquetas gemelas y las propiedades deseadas en uno o varios dispositivos.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.TwinScheduledJob> ScheduleTwinUpdateAsync (string queryCondition, Microsoft.Azure.Devices.ClientTwin twin, DateTimeOffset startOnUtc, Microsoft.Azure.Devices.ScheduledJobsOptions scheduledJobsOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ScheduleTwinUpdateAsync : string * Microsoft.Azure.Devices.ClientTwin * DateTimeOffset * Microsoft.Azure.Devices.ScheduledJobsOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.TwinScheduledJob>
override this.ScheduleTwinUpdateAsync : string * Microsoft.Azure.Devices.ClientTwin * DateTimeOffset * Microsoft.Azure.Devices.ScheduledJobsOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.TwinScheduledJob>

Public Overridable Function ScheduleTwinUpdateAsync (queryCondition As String, twin As ClientTwin, startOnUtc As DateTimeOffset, Optional scheduledJobsOptions As ScheduledJobsOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TwinScheduledJob)

Parámetros

queryCondition: String

Condición de consulta para evaluar en qué dispositivos se va a ejecutar el trabajo.

twin: ClientTwin

Objeto gemelo que se va a usar para la actualización.

startOnUtc: DateTimeOffset

Cuándo iniciar el trabajo, en UTC.

scheduledJobsOptions: ScheduledJobsOptions

Parámetros opcionales para la actualización de gemelos programada, es decir, scheduledJobsOptions.JobId.JobId y scheduledJobsOptions.MaxExecutionTimeInSeconds.MaxExecutionTimeInSeconds.

cancellationToken: CancellationToken

Token de cancelación de tareas.

Devoluciones

Task<TwinScheduledJob>

Objeto de trabajo.

Excepciones

ArgumentNullException

Cuando el proporcionado scheduledJobsOptions.JobId.JobId o queryCondition o twin o startOnUtcscheduledJobsOptions.MaxExecutionTimeInSeconds.MaxExecutionTimeInSeconds es null.

ArgumentException

Si el o scheduledJobsOptions.JobId.JobIdqueryCondition está vacío o el espacio en blanco.

IotHubServiceException

Si IoT Hub respondió a la solicitud con un código de estado no correcto. Por ejemplo, si la solicitud proporcionada se ha limitado, IotHubServiceException se produce con ThrottlingException . Para obtener una lista completa de los 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.

Se aplica a

Compartir a través de