ScheduledJobsClient.ScheduleTwinUpdateAsync Método

Referência

Definição

Namespace:: Microsoft.Azure.Devices

Assembly:: Microsoft.Azure.Devices.dll

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um novo trabalho para atualizar marcas gêmeas e propriedades desejadas em um ou vários 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

Condição de consulta para avaliar em quais dispositivos executar o trabalho.

twin: ClientTwin

Objeto gêmeo a ser usado para a atualização.

startOnUtc: DateTimeOffset

Quando iniciar o trabalho, em UTC.

scheduledJobsOptions: ScheduledJobsOptions

Parâmetros opcionais para atualização de gêmeo agendada, ou seja: scheduledJobsOptions.JobId.JobId e scheduledJobsOptions.MaxExecutionTimeInSeconds.MaxExecutionTimeInSeconds.

cancellationToken: CancellationToken

Token de cancelamento de tarefa.

Retornos

Task<TwinScheduledJob>

Um objeto de trabalho.

Exceções

ArgumentNullException

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

ArgumentException

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

IotHubServiceException

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.

HttpRequestException

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.

OperationCanceledException

Se o fornecido cancellationToken tiver solicitado o cancelamento.

Aplica-se a

Compartilhar via