Job Router Operations - Decline Job Offer
拒絕供應專案在作業上工作。
POST {endpoint}/routing/workers/{workerId}/offers/{offerId}:decline?api-version=2023-11-01URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string |
通訊資源的 URI |
|
offer
|
path | True |
string |
供應項目的標識碼。 |
|
worker
|
path | True |
string |
背景工作角色的標識碼。 |
|
api-version
|
query | True |
string |
用於此作業的 API 版本。 |
要求本文
| 名稱 | 類型 | Description |
|---|---|---|
| retryOfferAt |
string |
如果未提供 RetryOfferAt，除非背景工作取消註冊並重新註冊，否則此工作不會再次提供給拒絕此工作的背景工作。 如果提供 RetryOfferAt 時間，則作業將會在 UTC 的重試時間重新比對合格背景工作。 拒絕作業的背景工作也有資格在該時間進行作業。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
object |
要求成功。 |
| Other Status Codes |
非預期的錯誤回應。 標題 x-ms-error-code: string |
範例
Declines an offer to work on a job
範例要求
POST https://contoso.westus.communications.azure.com/routing/workers/DefaultWorker/offers/1d5896f3-8b54-40be-82d3-910323f5e2af:decline?api-version=2023-11-01
{
"retryOfferAt": "2023-05-26T00:00:00.0000000Z"
}
範例回覆
{}定義
| 名稱 | Description |
|---|---|
|
Azure. |
error 物件。 |
|
Azure. |
包含錯誤詳細數據的回應。 |
|
Azure. |
物件，包含錯誤的詳細資訊。 根據 Microsoft One API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。 |
|
Decline |
要求拒絕供應項目的承載。 |
Azure.Core.Foundations.Error
error 物件。
| 名稱 | 類型 | Description |
|---|---|---|
| code |
string |
其中一組伺服器定義的錯誤碼。 |
| details |
導致此錯誤之特定錯誤的詳細數據陣列。 |
|
| innererror |
物件，包含比目前對象有關錯誤更具體的資訊。 |
|
| message |
string |
人類可讀取的錯誤表示法。 |
| target |
string |
錯誤的目標。 |
Azure.Core.Foundations.ErrorResponse
包含錯誤詳細數據的回應。
| 名稱 | 類型 | Description |
|---|---|---|
| error |
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 |
內部錯誤。 |
DeclineJobOfferOptions
要求拒絕供應項目的承載。
| 名稱 | 類型 | Description |
|---|---|---|
| retryOfferAt |
string |
如果未提供 RetryOfferAt，除非背景工作取消註冊並重新註冊，否則此工作不會再次提供給拒絕此工作的背景工作。 如果提供 RetryOfferAt 時間，則作業將會在 UTC 的重試時間重新比對合格背景工作。 拒絕作業的背景工作也有資格在該時間進行作業。 |