ScheduledJobsClient.ScheduleDirectMethodAsync メソッド

定義

名前空間:

Microsoft.Azure.Devices

アセンブリ:

Microsoft.Azure.Devices.dll

パッケージ:

Microsoft.Azure.Devices v2.0.0-preview002

1 つまたは複数のデバイスでデバイス メソッドを実行する新しいジョブを作成します。

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)

パラメーター

queryCondition

String

クエリ条件を使用して、ジョブが適用されるデバイスを評価します。

directMethodRequest

DirectMethodServiceRequest

メソッド呼び出しパラメーター。

startOnUtc

DateTimeOffset

ジョブを UTC で開始するタイミング。

scheduledJobsOptions

ScheduledJobsOptions

スケジュールされたデバイス メソッドの省略可能なパラメーター (つまり、 scheduledJobsOptions.JobId.JobId と scheduledJobsOptions.MaxExecutionTimeInSeconds.MaxExecutionTimeInSeconds)。

cancellationToken

CancellationToken

タスクの取り消しトークン。

戻り値

Task<ScheduledJob>

ジョブ オブジェクト。

例外

ArgumentNullException

指定 scheduledJobsOptions.JobId.JobId された または queryConditionstartOnUtc が null の場合。

ArgumentException

または queryCondition がscheduledJobsOptions.JobId.JobId空または空白の場合。

IotHubServiceException

IoT ハブが失敗した状態コードで要求に応答した場合。 たとえば、指定された要求が調整された場合、 IotHubServiceException が ThrottlingException スローされます。 考えられるエラー ケースの完全な一覧については、「」を参照してください IotHubServiceErrorCode。

HttpRequestException

ネットワーク接続、DNS エラー、サーバー証明書の検証などの根本的な問題が原因で HTTP 要求が失敗した場合。

OperationCanceledException

指定 cancellationToken された がキャンセルを要求した場合。