ScheduledJobsClient.ScheduleDirectMethodAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Devices

Assembly:: Microsoft.Azure.Devices.dll

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt einen neuen Auftrag zum Ausführen einer Gerätemethode auf einem oder mehreren Geräten.

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)

Parameter

queryCondition: String

Abfragebedingung, um auszuwerten, auf welche Geräte der Auftrag angewendet wird.

directMethodRequest: DirectMethodServiceRequest

Methodenaufrufparameter.

startOnUtc: DateTimeOffset

Wann der Auftrag in UTC gestartet werden soll.

scheduledJobsOptions: ScheduledJobsOptions

Optionale Parameter für die geplante Gerätemethode, d. h scheduledJobsOptions.JobId.JobId . und scheduledJobsOptions.MaxExecutionTimeInSeconds.MaxExecutionTimeInSeconds.

cancellationToken: CancellationToken

Vorgangsabbruchtoken.

Gibt zurück

Task<ScheduledJob>

Ein Auftragsobjekt.

Ausnahmen

ArgumentNullException

Wenn das bereitgestellte scheduledJobsOptions.JobId.JobId oder oder queryConditionstartOnUtc null ist.

ArgumentException

Wenn der scheduledJobsOptions.JobId.JobId oder queryCondition leer oder ist.

IotHubServiceException

Wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status Code reagiert hat. Wenn beispielsweise die bereitgestellte Anforderung gedrosselt wurde, IotHubServiceException wird mit ThrottlingException ausgelöst. Eine vollständige Liste möglicher Fehlerfälle finden Sie unter IotHubServiceErrorCode.

HttpRequestException

Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung fehlschlägt.

OperationCanceledException

Wenn die bereitgestellte cancellationToken kündigung angefordert hat.

Gilt für:

Freigeben über