ScheduledJobsClient.ScheduleDirectMethodAsync 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 ejecutar un método de dispositivo en uno o varios dispositivos.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ScheduledJob> ScheduleDirectMethodAsync (string queryCondition, Microsoft.Azure.Devices.DirectMethodServiceRequest directMethodRequest, DateTimeOffset startOnUtc, Microsoft.Azure.Devices.ScheduledJobsOptions scheduledJobsOptions, System.Threading.CancellationToken cancellationToken = default);

abstract member ScheduleDirectMethodAsync : string * Microsoft.Azure.Devices.DirectMethodServiceRequest * DateTimeOffset * Microsoft.Azure.Devices.ScheduledJobsOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ScheduledJob>
override this.ScheduleDirectMethodAsync : string * Microsoft.Azure.Devices.DirectMethodServiceRequest * DateTimeOffset * Microsoft.Azure.Devices.ScheduledJobsOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ScheduledJob>

Public Overridable Function ScheduleDirectMethodAsync (queryCondition As String, directMethodRequest As DirectMethodServiceRequest, startOnUtc As DateTimeOffset, scheduledJobsOptions As ScheduledJobsOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ScheduledJob)

Parámetros

queryCondition: String

Condición de consulta para evaluar a qué dispositivos se aplica el trabajo.

directMethodRequest: DirectMethodServiceRequest

Parámetros de llamada de método.

startOnUtc: DateTimeOffset

Cuándo iniciar el trabajo en UTC.

scheduledJobsOptions: ScheduledJobsOptions

Parámetros opcionales para el método de dispositivo programado, es decir, scheduledJobsOptions.JobId.JobId y scheduledJobsOptions.MaxExecutionTimeInSeconds.MaxExecutionTimeInSeconds.

cancellationToken: CancellationToken

Token de cancelación de tareas.

Devoluciones

Task<ScheduledJob>

Objeto de trabajo.

Excepciones

ArgumentNullException

Cuando el valor proporcionado scheduledJobsOptions.JobId.JobId o startOnUtcqueryCondition es null.

ArgumentException

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

IotHubServiceException

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.

Se aplica a

Compartir a través de