Job Router Operations - Get Job

リファレンス

サービス:: Communication

API バージョン:: 2023-11-01

ID で既存のジョブを取得します。

GET {endpoint}/routing/jobs/{jobId}?api-version=2023-11-01

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string	通信リソースの URI
jobId	path	True	string	ジョブの ID。
api-version	query	True	string	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	RouterJob	要求は成功しました。ヘッダー ETag: string Last-Modified: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	予期しないエラー応答。ヘッダー x-ms-error-code: string

名前

型

説明

200 OK

RouterJob

要求は成功しました。

ヘッダー

ETag: string
Last-Modified: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

予期しないエラー応答。

ヘッダー

x-ms-error-code: string

セキュリティ

AadOauth2Auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize
Token URL (トークン URL): https://login.microsoftonline.com/common/oauth2/token

スコープ

名前	説明
https://communication.azure.com/.default

例

Retrieves an existing job by Id

要求のサンプル

HTTP

GET https://contoso.westus.communications.azure.com/routing/jobs/8780b28c-7079-4de1-9143-4d369289e958?api-version=2023-11-01

応答のサンプル

状態コード:: 200

{
  "id": "8780b28c-7079-4de1-9143-4d369289e958",
  "channelReference": "1d5896f3-8b54-40be-82d3-910323f5e2af",
  "status": "queued",
  "enqueuedAt": "2021-09-30T23:59:04.5311999+00:00",
  "channelId": "CustomVoiceChannel",
  "classificationPolicyId": null,
  "queueId": "MainQueue",
  "priority": 5,
  "dispositionCode": null,
  "requestedWorkerSelectors": [
    {
      "key": "Sales",
      "labelOperator": "equal",
      "value": true,
      "expiresAfterSeconds": null
    }
  ],
  "attachedWorkerSelectors": [],
  "labels": {},
  "assignments": {},
  "notes": [],
  "matchingMode": {
    "kind": "queueAndMatch"
  },
  "etag": "etag"
}

定義

名前	説明
Azure.Core.Foundations.Error	エラーオブジェクト。
Azure.Core.Foundations.ErrorResponse	エラーの詳細を含む応答。
Azure.Core.Foundations.InnerError	エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
JobMatchingModeKind	サポートされている一致モードの種類の判別子。
LabelOperator	ラベル値に対してサポートされている操作について説明します。
QueueAndMatchMode	ジョブが正常にキューに登録された後に、ジョブに一致するワーカーが自動的に開始される一致モードについて説明します。
RouterJob	ルーティングされる作業単位
RouterJobAssignment	worker へのジョブの割り当ての詳細。
RouterJobNote	ジョブにアタッチされたメモ。
RouterJobStatus	ジョブのさまざまな状態について説明します。
RouterWorkerSelector	worker 選択のラベルのセットに対して満たす必要がある条件について説明します。
RouterWorkerSelectorStatus	ワーカーセレクターの状態について説明します。
ScheduleAndSuspendMode	将来キューに登録されるジョブのスケジュール設定に使用される一致モードについて説明します。指定した時刻に、ジョブに一致するワーカーは自動的に開始されません。
SuspendMode	ジョブに一致するワーカーが中断される一致モードについて説明します。

Azure.Core.Foundations.Error

エラーオブジェクト。

名前	型	説明
code	string	サーバー定義の一連のエラーコードの 1 つ。
details	Azure.Core.Foundations.Error[]	この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innererror	Azure.Core.Foundations.InnerError	エラーに関する現在のオブジェクトよりも具体的な情報を含むオブジェクト。
message	string	エラーの人間が判読できる表現。
target	string	エラーのターゲット。

Azure.Core.Foundations.ErrorResponse

エラーの詳細を含む応答。

名前	型	説明
error	Azure.Core.Foundations.Error	エラーオブジェクト。

Azure.Core.Foundations.InnerError

エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

名前	型	説明
code	string	サーバー定義の一連のエラーコードの 1 つ。
innererror	Azure.Core.Foundations.InnerError	内部エラー。

JobMatchingModeKind

サポートされている一致モードの種類の判別子。

名前	型	説明
queueAndMatch	string	QueueAndMatchMode の識別子の値。
scheduleAndSuspend	string	ScheduleAndSuspendMode の識別子の値。
suspend	string	SuspendMode の識別子の値。

LabelOperator

ラベル値に対してサポートされている操作について説明します。

名前	型	説明
equal	string	等しい。
greaterThan	string	より大きい。
greaterThanOrEqual	string	以上。
lessThan	string	未満。
lessThanOrEqual	string	以下。
notEqual	string	等しくない。

QueueAndMatchMode

ジョブが正常にキューに登録された後に、ジョブに一致するワーカーが自動的に開始される一致モードについて説明します。

名前	型	説明
kind	string: queueAndMatch	JobMatchingMode のサブタイプを記述する型識別子。

RouterJob

ルーティングされる作業単位

名前	型	説明
assignments	<string, RouterJobAssignment>	ジョブの割り当てのコレクション。キーは AssignmentId です。
attachedWorkerSelectors	RouterWorkerSelector[]	分類ポリシーによってアタッチされたワーカーセレクターのコレクション。このジョブを処理するには、worker が満たす必要があります。
channelId	string	チャネル識別子。例えば。音声、チャットなど
channelReference	string	外部の親コンテキストへの参照(例:呼び出し ID。
classificationPolicyId	string	このジョブの分類に使用される分類ポリシーの ID。
dispositionCode	string	取り消されたジョブまたは終了したジョブの理由コード。
enqueuedAt	string	ジョブが UTC でキューに登録されたタイムスタンプ。
etag	string	このリソースのエンティティタグ。
id	string	ジョブの ID。
labels		ルールエンジンが決定を下すために使用する属性を識別するキーと値のペアのセット。値はプリミティブ値 (数値、文字列、ブール値) である必要があります。
matchingMode	JobMatchingMode: QueueAndMatchMode ScheduleAndSuspendMode SuspendMode	指定した場合、ジョブマッチングの実行方法を決定します。既定のモード: QueueAndMatchMode。
notes	RouterJobNote[]	ジョブに添付されたメモ。タイムスタンプで並べ替えられます。
priority	integer	このジョブの優先順位。値は、-100 ~ 100 の間である必要があります。
queueId	string	このジョブがキューに登録されているキューの ID。
requestedWorkerSelectors	RouterWorkerSelector[]	このジョブを処理するためにワーカーが満たす必要がある、手動で指定されたワーカーセレクターのコレクション。
scheduledAt	string	設定した場合、ジョブは特定の時刻にエンキューされるようにスケジュールされます。
status	RouterJobStatus	ジョブの状態。
tags		このジョブにアタッチされている非識別属性のセット。値はプリミティブ値 (数値、文字列、ブール値) である必要があります。

RouterJobAssignment

worker へのジョブの割り当ての詳細。

名前	型	説明
assignedAt	string	ジョブが UTC でワーカーに割り当てられたタイムスタンプ。
assignmentId	string	ジョブ割り当ての ID。
closedAt	string	ジョブが UTC で完了した後に閉じられたとマークされたときのタイムスタンプ。
completedAt	string	ジョブが UTC で割り当てられた後に完了としてマークされたときのタイムスタンプ。
workerId	string	ジョブに割り当てられている Worker の ID。

RouterJobNote

ジョブにアタッチされたメモ。

名前	型	説明
addedAt	string	ノートが UTC で追加された時刻。指定しない場合は、既定で現在の時刻になります。
message	string	メモに含まれるメッセージ。

RouterJobStatus

ジョブのさまざまな状態について説明します。

名前	型	説明
assigned	string	ジョブがワーカーに割り当てられている。
cancelled	string	ジョブが取り消されました。
classificationFailed	string	ジョブの分類プロセスが失敗しました。
closed	string	ジョブがワーカーによって閉じられました。
completed	string	ジョブはワーカーによって完了しました。
created	string	ジョブが作成されました。
pendingClassification	string	ジョブが分類されるのを待機しています。
pendingSchedule	string	ジョブは作成されましたが、まだスケジュールされていません。
queued	string	ジョブがキューに登録されました。
scheduleFailed	string	ジョブのスケジュール設定に失敗しました。
scheduled	string	ジョブが正常にスケジュールされました。
waitingForActivation	string	ジョブが中断状態にあり、更新を待機しています。

RouterWorkerSelector

worker 選択のラベルのセットに対して満たす必要がある条件について説明します。

名前	型	説明
expedite	boolean	このセレクターがアクティブである限り、ジョブをキューの先頭にプッシュします。
expiresAfterSeconds	number	このラベルセレクターが有効な時間 (秒単位) について説明します。
expiresAt	string	このワーカーセレクターが UTC で期限切れになる時刻。
key	string	クエリの対象となるラベルキー。
labelOperator	LabelOperator	ラベルの値とワーカーセレクターで定義されている値の比較方法について説明します。
status	RouterWorkerSelectorStatus	ワーカーセレクターの状態。
value		実際のラベル値と特定の演算子と比較する値。値はプリミティブ値 (数値、文字列、ブール値) である必要があります。

RouterWorkerSelectorStatus

ワーカーセレクターの状態について説明します。

名前	型	説明
active	string	ワーカーセレクターは有効です。
expired	string	ワーカーセレクターが無効です。

ScheduleAndSuspendMode

将来キューに登録されるジョブのスケジュール設定に使用される一致モードについて説明します。指定した時刻に、ジョブに一致するワーカーは自動的に開始されません。

名前	型	説明
kind	string: scheduleAndSuspend	JobMatchingMode のサブタイプを記述する型識別子。
scheduleAt	string	要求されたスケジュール時刻。

SuspendMode

ジョブに一致するワーカーが中断される一致モードについて説明します。

名前	型	説明
kind	string: suspend	JobMatchingMode のサブタイプを記述する型識別子。

次の方法で共有

Job Router Operations - Get Job

URI パラメーター

応答

セキュリティ

AadOauth2Auth

スコープ

例

Retrieves an existing job by Id

要求のサンプル

応答のサンプル

定義

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

JobMatchingModeKind

LabelOperator

QueueAndMatchMode

RouterJob

RouterJobAssignment

RouterJobNote

RouterJobStatus

RouterWorkerSelector

RouterWorkerSelectorStatus

ScheduleAndSuspendMode

SuspendMode

その他のリソース