共用方式為

Job Router Operations - Get Job

  • 參考
服務:
Communication
API 版本:
2023-11-01

依標識符擷取現有的作業。

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

URI 參數

名稱 位於 必要 類型 Description
endpoint
 path True

string

通訊資源的 URI
jobId
 path True

string

作業的標識碼。
api-version
 query True

string

用於此作業的 API 版本。

回應

名稱 類型 Description
200 OK

RouterJob

要求已成功。

標題

  • ETag: string
  • Last-Modified: string
Other Status Codes

Azure.Core.Foundations.ErrorResponse

未預期的錯誤回應。

標題

x-ms-error-code: string

範例

Retrieves an existing job by Id

範例要求

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"
}

定義

名稱 Description
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

工作指派詳細數據給背景工作。
RouterJobNote

附加至作業的附註。
RouterJobStatus

描述作業的各種狀態。
RouterWorkerSelector

描述針對背景工作選取的一組標籤必須符合的條件。
RouterWorkerSelectorStatus

描述背景工作角色選取器的狀態。
ScheduleAndSuspendMode

描述比對模式，用於排程未來要排入佇列的作業。 在指定的時間，比對背景工作與作業將不會自動啟動。
SuspendMode

描述比對背景工作與作業暫停的比對模式。

Azure.Core.Foundations.Error

錯誤物件。

名稱 類型 Description
code

string

其中一組伺服器定義的錯誤碼。
details

Azure.Core.Foundations.Error[]

導致此錯誤之特定錯誤的詳細數據陣列。
innererror

Azure.Core.Foundations.InnerError

物件，包含比目前對象有關錯誤的更特定資訊。
message

string

人類看得懂的錯誤表示法。
target

string

錯誤的目標。

Azure.Core.Foundations.ErrorResponse

包含錯誤詳細數據的回應。

名稱 類型 Description
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。

名稱 類型 Description
code

string

其中一組伺服器定義的錯誤碼。
innererror

Azure.Core.Foundations.InnerError

內部錯誤。

JobMatchingModeKind

支援比對模式類型的鑒別子。

名稱 類型 Description
queueAndMatch

string

QueueAndMatchMode 的鑒別子值。
scheduleAndSuspend

string

ScheduleAndSuspendMode 的鑒別子值。
suspend

string

SuspendMode 的鑒別子值。

LabelOperator

描述標籤值上支援的作業。

名稱 類型 Description
equal

string

平等。
greaterThan

string

大於。
greaterThanOrEqual

string

大於或等於。
lessThan

string

小於。
lessThanOrEqual

string

小於或等於。
notEqual

string

不相等。

QueueAndMatchMode

描述比對模式，在作業成功排入佇列之後，會自動啟動比對工作與作業的比對模式。

名稱 類型 Description
kind string:

queueAndMatch

描述 JobMatchingMode 子類型的類型鑒別子。

RouterJob

要路由傳送的工作單位

名稱 類型 Description
assignments

<string,  RouterJobAssignment>

作業指派的集合。 索引鍵為 AssignmentId。
attachedWorkerSelectors

RouterWorkerSelector[]

分類原則所附加的背景工作選取器集合，背景工作角色必須滿足此條件才能處理此作業。
channelId

string

通道標識碼。例如語音、聊天等。
channelReference

string

外部父內容的參考，例如呼叫標識碼。
classificationPolicyId

string

用於分類此作業的分類原則標識碼。
dispositionCode

string

取消或已關閉作業的原因代碼。
enqueuedAt

string

作業排入 UTC 的時間戳。
etag

string

此資源的實體標籤。
id

string

作業的標識碼。
labels

一組索引鍵/值組，用來識別規則引擎用來做出決策的屬性。 值必須是基本值 - number、string、boolean。
matchingMode JobMatchingMode:

如果提供，將會決定作業比對的執行方式。默認模式：QueueAndMatchMode。
notes

RouterJobNote[]

附加至作業的附註，依時間戳排序。
priority

integer

此作業的優先順序。 值必須介於 -100 到 100 之間。
queueId

string

此作業排入佇列的佇列標識碼。
requestedWorkerSelectors

RouterWorkerSelector[]

手動指定的背景工作選取器集合，背景工作角色必須滿足此集合才能處理此作業。
scheduledAt

string

如果設定，作業將會排程在指定時間加入佇列。
status

RouterJobStatus

工作的狀態。
tags

附加至此作業的一組非識別屬性。 值必須是基本值 - number、string、boolean。

RouterJobAssignment

工作指派詳細數據給背景工作。

名稱 類型 Description
assignedAt

string

在UTC中將作業指派給背景工作時的時間戳。
assignmentId

string

作業指派的標識碼。
closedAt

string

作業在 UTC 完成之後標示為已關閉的時間戳。
completedAt

string

在UTC指派作業之後標記為已完成的時間戳。
workerId

string

指派給作業的背景工作識別碼。

RouterJobNote

附加至作業的附註。

名稱 類型 Description
addedAt

string

以 UTC 加入附注的時間。 如果未提供，則會預設為目前的時間。
message

string

附註中包含的訊息。

RouterJobStatus

描述作業的各種狀態。

名稱 類型 Description
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

描述針對背景工作選取的一組標籤必須符合的條件。

名稱 類型 Description
expedite

boolean

只要此選取器處於作用中狀態，即會將作業推送至佇列前端。
expiresAfterSeconds

number

描述此標籤選取器的有效時間，以秒為單位。
expiresAt

string

此背景工作角色選取器以UTC到期的時間。
key

string

要查詢的標籤索引鍵。
labelOperator

LabelOperator

描述標籤的值如何與背景工作選取器上定義的值進行比較。
status

RouterWorkerSelectorStatus

背景工作角色選取器的狀態。
value

要與實際標籤值與指定運算子比較的值。 值必須是基本值 - number、string、boolean。

RouterWorkerSelectorStatus

描述背景工作角色選取器的狀態。

名稱 類型 Description
active

string

背景工作選取器有效。
expired

string

背景工作選取器無效。

ScheduleAndSuspendMode

描述比對模式，用於排程未來要排入佇列的作業。 在指定的時間，比對背景工作與作業將不會自動啟動。

名稱 類型 Description
kind string:

scheduleAndSuspend

描述 JobMatchingMode 子類型的類型鑒別子。
scheduleAt

string

要求的排程時間。

SuspendMode

描述比對背景工作與作業暫停的比對模式。

名稱 類型 Description
kind string:

suspend

描述 JobMatchingMode 子類型的類型鑒別子。