Partilhar via


ScheduledJobsClient.ScheduleDirectMethodAsync Método

Definição

Cria um novo trabalho para executar um método de dispositivo em um ou vários 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

Condição de consulta para avaliar a quais dispositivos o trabalho se aplica.

directMethodRequest
DirectMethodServiceRequest

Parâmetros de chamada de método.

startOnUtc
DateTimeOffset

Quando iniciar o trabalho em UTC.

scheduledJobsOptions
ScheduledJobsOptions

Parâmetros opcionais para o método de dispositivo agendado, ou seja: scheduledJobsOptions.JobId.JobId e scheduledJobsOptions.MaxExecutionTimeInSeconds.MaxExecutionTimeInSeconds.

cancellationToken
CancellationToken

Token de cancelamento de tarefa.

Retornos

Um objeto de trabalho.

Exceções

Quando o fornecido scheduledJobsOptions.JobId.JobId ou queryCondition ou startOnUtc é nulo.

Se o scheduledJobsOptions.JobId.JobId ou queryCondition estiver vazio ou espaço em branco.

Se o Hub IoT respondeu à solicitação com um código de status não bem-sucedido. Por exemplo, se a solicitação fornecida foi limitada, IotHubServiceException com ThrottlingException é lançada. Para obter uma lista completa de possíveis casos de erro, consulte IotHubServiceErrorCode.

Se a solicitação HTTP falhar devido a um problema subjacente, como conectividade de rede, falha de DNS ou validação de certificado do servidor.

Se o fornecido cancellationToken tiver solicitado o cancelamento.

Aplica-se a